diff --git a/pom.xml b/pom.xml
index 880d6df..fc42816 100644
--- a/pom.xml
+++ b/pom.xml
@@ -26,7 +26,9 @@
 <!--        <module>yudao-module-iot</module>-->
 <!--        <module>yudao-module-mes</module>-->
 <!--        <module>yudao-module-wms</module>-->
-<!--        <module>yudao-module-im</module>-->
+<!--        <module>yudao-module-hrm</module>-->
+<!--        <module>yudao-module-fms</module>-->
+        <!--        <module>yudao-module-im</module>-->
 <!-- 请参考 https://doc.iocoder.cn/ai/build/ 文档，完成 AI 模块的启动！！！ -->
 <!--        <module>yudao-module-ai</module>-->
     </modules>
diff --git a/yudao-dependencies/pom.xml b/yudao-dependencies/pom.xml
index 952fd22..7233496 100644
--- a/yudao-dependencies/pom.xml
+++ b/yudao-dependencies/pom.xml
@@ -58,6 +58,7 @@
         <hutool-5.version>5.8.46</hutool-5.version>
         <hutool-6.version>6.0.0-M22</hutool-6.version>
         <fastexcel.version>1.3.0</fastexcel.version>
+        <aviator.version>5.3.3</aviator.version>
         <velocity.version>2.4.1</velocity.version>
         <fastjson2.version>2.0.63</fastjson2.version>
         <guava.version>33.6.0-jre</guava.version>
@@ -506,6 +507,12 @@
             </dependency>
 
             <dependency>
+                <groupId>com.googlecode.aviator</groupId>
+                <artifactId>aviator</artifactId>
+                <version>${aviator.version}</version>
+            </dependency>
+
+            <dependency>
                 <groupId>org.apache.tika</groupId>
                 <artifactId>tika-core</artifactId> <!-- 文件类型的识别 -->
                 <version>${tika-core.version}</version>
diff --git a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtils.java b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtils.java
index b2db78b..c772692 100644
--- a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtils.java
+++ b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtils.java
@@ -4,8 +4,10 @@ import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.collection.CollectionUtil;
 import cn.hutool.core.util.ArrayUtil;
 import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
 import com.google.common.collect.ImmutableMap;
 
+import java.math.BigDecimal;
 import java.util.*;
 import java.util.function.*;
 import java.util.stream.Collectors;
@@ -33,6 +35,34 @@ public class CollectionUtils {
         return from.stream().anyMatch(predicate);
     }
 
+    public static <T> long sum(Collection<T> from, ToLongFunction<T> valueFunc) {
+        if (CollUtil.isEmpty(from)) {
+            return 0L;
+        }
+        return from.stream().mapToLong(valueFunc).sum();
+    }
+
+    public static <T> BigDecimal sumBigDecimal(Collection<T> from, Function<T, BigDecimal> valueFunc) {
+        if (CollUtil.isEmpty(from)) {
+            return BigDecimal.ZERO;
+        }
+        return from.stream().map(valueFunc).map(NumberUtils::zeroIfNull).reduce(BigDecimal.ZERO, BigDecimal::add);
+    }
+
+    public static <T> long count(Collection<T> from, Predicate<T> predicate) {
+        if (CollUtil.isEmpty(from)) {
+            return 0L;
+        }
+        return from.stream().filter(predicate).count();
+    }
+
+    public static <T, R> long distinctCount(Collection<T> from, Function<T, R> keyMapper) {
+        if (CollUtil.isEmpty(from)) {
+            return 0L;
+        }
+        return from.stream().map(keyMapper).filter(Objects::nonNull).distinct().count();
+    }
+
     public static <T> List<T> filterList(Collection<T> from, Predicate<T> predicate) {
         if (CollUtil.isEmpty(from)) {
             return new ArrayList<>();
@@ -124,6 +154,15 @@ public class CollectionUtils {
         return from.stream().filter(filter).map(func).filter(Objects::nonNull).collect(Collectors.toSet());
     }
 
+    public static <T, U, S extends Set<U>> S convertSetBySupplier(
+            Collection<T> from, Function<T, U> func, Supplier<S> supplier) {
+        if (CollUtil.isEmpty(from)) {
+            return supplier.get();
+        }
+        return from.stream().map(func).filter(Objects::nonNull)
+                .collect(Collectors.toCollection(supplier));
+    }
+
     public static <T, U> Set<U> convertLinkedSet(Collection<T> from, Function<T, U> func) {
         if (CollUtil.isEmpty(from)) {
             return new LinkedHashSet<>();
@@ -398,4 +437,4 @@ public class CollectionUtils {
         return list;
     }
 
-}
\ No newline at end of file
+}
diff --git a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtils.java b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtils.java
index f942d6e..a78eda1 100644
--- a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtils.java
+++ b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtils.java
@@ -6,6 +6,9 @@ import cn.hutool.core.date.LocalDateTimeUtil;
 import cn.hutool.core.lang.Assert;
 import cn.hutool.core.util.StrUtil;
 import cn.iocoder.yudao.framework.common.enums.DateIntervalEnum;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
 
 import java.sql.Timestamp;
 import java.time.*;
@@ -14,13 +17,16 @@ import java.time.format.DateTimeParseException;
 import java.time.temporal.ChronoUnit;
 import java.time.temporal.TemporalAdjusters;
 import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
 import java.util.List;
 import java.util.TimeZone;
+import java.util.stream.Collectors;
 
 import static cn.hutool.core.date.DatePattern.*;
 
 /**
- * 时间工具类，用于 {@link LocalDateTime}
+ * 时间工具类，用于 {@link LocalDate}、{@link LocalDateTime}
  *
  * @author 芋道源码
  */
@@ -54,6 +60,16 @@ public class LocalDateTimeUtils {
         }
     }
 
+    /**
+     * 解析年月字符串为 {@link YearMonth}，格式为 yyyy-MM
+     *
+     * @param month 年月字符串
+     * @return 年月
+     */
+    public static YearMonth parseYearMonth(String month) {
+        return YearMonth.parse(month, NORM_MONTH_FORMATTER);
+    }
+
     public static LocalDateTime addTime(Duration duration) {
         return LocalDateTime.now().plus(duration);
     }
@@ -70,6 +86,319 @@ public class LocalDateTimeUtils {
         return date.isAfter(LocalDateTime.now());
     }
 
+    public static boolean beforeOrEqualNow(LocalDateTime time) {
+        LocalDateTime now = LocalDateTime.now();
+        return time.isBefore(now) || time.isEqual(now);
+    }
+
+    public static boolean beforeNow(LocalDate date) {
+        return date.isBefore(LocalDate.now());
+    }
+
+    public static boolean beforeOrEqualNow(LocalDate date) {
+        LocalDate today = LocalDate.now();
+        return date.isBefore(today) || date.isEqual(today);
+    }
+
+    public static boolean afterNow(LocalDate date) {
+        return date.isAfter(LocalDate.now());
+    }
+
+    /**
+     * 判断时间是否处于一月
+     *
+     * @param time 时间
+     * @return 是否处于一月
+     */
+    public static boolean isJanuary(LocalDateTime time) {
+        return time.getMonthValue() == 1;
+    }
+
+    /**
+     * 判断第一个日期是否早于或等于第二个日期
+     *
+     * @param firstDate 第一个日期
+     * @param secondDate 第二个日期
+     * @return 是否早于或等于
+     */
+    public static boolean isBeforeOrEqual(LocalDate firstDate, LocalDate secondDate) {
+        return firstDate.isBefore(secondDate) || firstDate.isEqual(secondDate);
+    }
+
+    /**
+     * 判断第一个日期是否晚于或等于第二个日期
+     *
+     * @param firstDate 第一个日期
+     * @param secondDate 第二个日期
+     * @return 是否晚于或等于
+     */
+    public static boolean isAfterOrEqual(LocalDate firstDate, LocalDate secondDate) {
+        return firstDate.isAfter(secondDate) || firstDate.isEqual(secondDate);
+    }
+
+    /**
+     * 判断第一个时间是否早于或等于第二个时间
+     *
+     * @param firstTime 第一个时间
+     * @param secondTime 第二个时间
+     * @return 是否早于或等于
+     */
+    public static boolean isBeforeOrEqual(LocalDateTime firstTime, LocalDateTime secondTime) {
+        return firstTime.isBefore(secondTime) || firstTime.isEqual(secondTime);
+    }
+
+    /**
+     * 判断第一个时间是否晚于或等于第二个时间
+     *
+     * @param firstTime 第一个时间
+     * @param secondTime 第二个时间
+     * @return 是否晚于或等于
+     */
+    public static boolean isAfterOrEqual(LocalDateTime firstTime, LocalDateTime secondTime) {
+        return firstTime.isAfter(secondTime) || firstTime.isEqual(secondTime);
+    }
+
+    /**
+     * 判断时间范围是否有效
+     *
+     * @param beginTime 开始时间
+     * @param endTime 结束时间
+     * @return 开始、结束时间非空，且结束时间晚于开始时间时返回 {@code true}
+     */
+    public static boolean isTimeRangeValid(LocalDateTime beginTime, LocalDateTime endTime) {
+        return beginTime != null && endTime != null && endTime.isAfter(beginTime);
+    }
+
+    /**
+     * 判断时间范围是否存在有效边界
+     *
+     * @param times 时间范围
+     * @return 任一边界非空时返回 {@code true}
+     */
+    public static boolean isTimeRangePresent(LocalDateTime[] times) {
+        return ArrayUtils.get(times, 0) != null || ArrayUtils.get(times, 1) != null;
+    }
+
+    /**
+     * 判断指定日期是否位于闭区间内
+     *
+     * @param beginDate 开始日期
+     * @param endDate 结束日期
+     * @param date 指定日期
+     * @return 是否位于闭区间内
+     */
+    public static boolean isBetween(LocalDate beginDate, LocalDate endDate, LocalDate date) {
+        return beginDate != null && endDate != null && date != null
+                && isAfterOrEqual(date, beginDate) && isBeforeOrEqual(date, endDate);
+    }
+
+    /**
+     * 判断指定日期是否不在闭区间内
+     *
+     * @param beginDate 开始日期
+     * @param endDate 结束日期
+     * @param date 指定日期
+     * @return 是否不在闭区间内；任一参数为空时返回 {@code true}
+     */
+    public static boolean isNotBetween(LocalDate beginDate, LocalDate endDate, LocalDate date) {
+        return !isBetween(beginDate, endDate, date);
+    }
+
+    /**
+     * 判断指定时间是否位于闭区间内
+     *
+     * @param beginTime 开始时间
+     * @param endTime 结束时间
+     * @param time 指定时间
+     * @return 是否位于闭区间内
+     */
+    public static boolean isBetween(LocalDateTime beginTime, LocalDateTime endTime, LocalDateTime time) {
+        return beginTime != null && endTime != null && time != null
+                && isAfterOrEqual(time, beginTime) && isBeforeOrEqual(time, endTime);
+    }
+
+    /**
+     * 判断指定时间是否不在闭区间内
+     *
+     * @param beginTime 开始时间
+     * @param endTime 结束时间
+     * @param time 指定时间
+     * @return 是否不在闭区间内；任一参数为空时返回 {@code true}
+     */
+    public static boolean isNotBetween(LocalDateTime beginTime, LocalDateTime endTime, LocalDateTime time) {
+        return !isBetween(beginTime, endTime, time);
+    }
+
+    /**
+     * 计算两个日期之间经过的完整年数
+     *
+     * @param beginDate 开始日期
+     * @param endDate 结束日期
+     * @return 完整年数；日期为空或开始日期晚于结束日期时，返回 0
+     */
+    public static int getYearsBetween(LocalDate beginDate, LocalDate endDate) {
+        if (beginDate == null || endDate == null || beginDate.isAfter(endDate)) {
+            return 0;
+        }
+        return Period.between(beginDate, endDate).getYears();
+    }
+
+    /**
+     * 从时间范围列表中扣除指定时间范围
+     *
+     * @param sourceRanges 原时间范围列表
+     * @param excludedRange 需要扣除的时间范围
+     * @return 扣除后的时间范围列表
+     */
+    public static List<TimeRange> subtractTimeRanges(List<TimeRange> sourceRanges, TimeRange excludedRange) {
+        List<TimeRange> result = new ArrayList<>();
+        for (TimeRange sourceRange : sourceRanges) {
+            TimeRange overlap = intersectTimeRange(sourceRange, excludedRange);
+            if (overlap == null) {
+                result.add(sourceRange);
+                continue;
+            }
+            if (sourceRange.getStartTime().isBefore(overlap.getStartTime())) {
+                result.add(new TimeRange(sourceRange.getStartTime(), overlap.getStartTime()));
+            }
+            if (overlap.getEndTime().isBefore(sourceRange.getEndTime())) {
+                result.add(new TimeRange(overlap.getEndTime(), sourceRange.getEndTime()));
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 合并重叠或首尾相接的时间范围
+     *
+     * @param timeRanges 时间范围列表
+     * @return 合并后的时间范围列表
+     */
+    public static List<TimeRange> mergeTimeRanges(List<TimeRange> timeRanges) {
+        if (CollUtil.isEmpty(timeRanges)) {
+            return Collections.emptyList();
+        }
+        List<TimeRange> sortedRanges = timeRanges.stream()
+                .sorted(Comparator.comparing(TimeRange::getStartTime))
+                .collect(Collectors.toList());
+        List<TimeRange> result = new ArrayList<>();
+        TimeRange currentRange = CollUtil.getFirst(sortedRanges);
+        for (int i = 1; i < sortedRanges.size(); i++) {
+            TimeRange nextRange = sortedRanges.get(i);
+            if (nextRange.getStartTime().isAfter(currentRange.getEndTime())) {
+                result.add(currentRange);
+                currentRange = nextRange;
+                continue;
+            }
+            LocalDateTime endTime = currentRange.getEndTime().isAfter(nextRange.getEndTime())
+                    ? currentRange.getEndTime() : nextRange.getEndTime();
+            currentRange = new TimeRange(currentRange.getStartTime(), endTime);
+        }
+        result.add(currentRange);
+        return result;
+    }
+
+    /**
+     * 计算两个时间范围列表的交集
+     *
+     * @param firstRanges 第一组时间范围
+     * @param secondRanges 第二组时间范围
+     * @return 合并后的交集时间范围列表
+     */
+    public static List<TimeRange> intersectTimeRanges(
+            List<TimeRange> firstRanges, List<TimeRange> secondRanges) {
+        List<TimeRange> result = new ArrayList<>();
+        for (TimeRange firstRange : firstRanges) {
+            for (TimeRange secondRange : secondRanges) {
+                TimeRange overlap = intersectTimeRange(firstRange, secondRange);
+                if (overlap != null) {
+                    result.add(overlap);
+                }
+            }
+        }
+        return mergeTimeRanges(result);
+    }
+
+    /**
+     * 计算两个时间范围的交集
+     *
+     * @param firstRange 第一个时间范围
+     * @param secondRange 第二个时间范围
+     * @return 交集时间范围；没有交集时返回 {@code null}
+     */
+    public static TimeRange intersectTimeRange(TimeRange firstRange, TimeRange secondRange) {
+        LocalDateTime startTime = firstRange.getStartTime().isAfter(secondRange.getStartTime())
+                ? firstRange.getStartTime() : secondRange.getStartTime();
+        LocalDateTime endTime = firstRange.getEndTime().isBefore(secondRange.getEndTime())
+                ? firstRange.getEndTime() : secondRange.getEndTime();
+        return endTime.isAfter(startTime) ? new TimeRange(startTime, endTime) : null;
+    }
+
+    /**
+     * 计算时间范围的总分钟数
+     *
+     * @param timeRanges 时间范围列表
+     * @return 总分钟数
+     */
+    public static int calculateDurationMinutes(List<TimeRange> timeRanges) {
+        return timeRanges.stream()
+                .mapToInt(range -> Math.toIntExact(Duration.between(
+                        range.getStartTime(), range.getEndTime()).toMinutes()))
+                .sum();
+    }
+
+    /**
+     * 构建日期范围内每天对应的时间范围
+     *
+     * 当结束时刻早于或等于开始时刻时，按跨天时间范围处理。
+     *
+     * @param beginDate 开始日期
+     * @param endDate 结束日期
+     * @param beginTime 每日开始时刻
+     * @param endTime 每日结束时刻
+     * @return 每日时间范围列表
+     */
+    public static List<TimeRange> buildDailyTimeRanges(
+            LocalDate beginDate, LocalDate endDate, LocalTime beginTime, LocalTime endTime) {
+        if (beginDate == null || endDate == null || beginTime == null || endTime == null
+                || beginDate.isAfter(endDate)) {
+            return Collections.emptyList();
+        }
+        List<TimeRange> result = new ArrayList<>();
+        for (LocalDate date = beginDate; isBeforeOrEqual(date, endDate); date = date.plusDays(1)) {
+            LocalDateTime rangeBeginTime = date.atTime(beginTime);
+            LocalDateTime rangeEndTime = date.atTime(endTime);
+            if (rangeEndTime.isBefore(rangeBeginTime) || rangeEndTime.isEqual(rangeBeginTime)) {
+                rangeEndTime = rangeEndTime.plusDays(1);
+            }
+            result.add(new TimeRange(rangeBeginTime, rangeEndTime));
+        }
+        return result;
+    }
+
+    /**
+     * 查找包含指定时刻的每日时间范围
+     *
+     * 每日时间范围允许跨天，因此会同时检查基准日期的前一天、当天和后一天。
+     * 范围匹配使用左右闭区间。
+     *
+     * @param date 基准日期
+     * @param beginTime 每日开始时刻
+     * @param endTime 每日结束时刻
+     * @param time 指定时刻
+     * @return 包含指定时刻的时间范围；不存在时返回 {@code null}
+     */
+    public static TimeRange findDailyTimeRange(
+            LocalDate date, LocalTime beginTime, LocalTime endTime, LocalDateTime time) {
+        if (date == null || time == null) {
+            return null;
+        }
+        List<TimeRange> timeRanges = buildDailyTimeRanges(
+                date.minusDays(1), date.plusDays(1), beginTime, endTime);
+        return CollUtil.findOne(timeRanges, timeRange -> isBetween(
+                timeRange.getStartTime(), timeRange.getEndTime(), time));
+    }
+
     /**
      * 将 Unix 秒时间戳转换为默认时区的本地时间
      *
@@ -185,6 +514,62 @@ public class LocalDateTimeUtils {
     }
 
     /**
+     * 获得指定日期的开始时间
+     *
+     * @param date 日期
+     * @return 当日开始时间；日期为空时返回 {@code null}
+     */
+    public static LocalDateTime getDayBeginTime(LocalDate date) {
+        return date == null ? null : date.atStartOfDay();
+    }
+
+    /**
+     * 获得指定时间所在日期的开始时间
+     *
+     * @param time 时间
+     * @return 当日开始时间；时间为空时返回 {@code null}
+     */
+    public static LocalDateTime getDayBeginTime(LocalDateTime time) {
+        return time == null ? null : getDayBeginTime(time.toLocalDate());
+    }
+
+    /**
+     * 获得指定日期的结束时间
+     *
+     * @param date 日期
+     * @return 当日结束时间；日期为空时返回 {@code null}
+     */
+    public static LocalDateTime getDayEndTime(LocalDate date) {
+        return date == null ? null : date.atTime(LocalTime.MAX);
+    }
+
+    /**
+     * 获得自然日期范围对应的日期时间闭区间
+     *
+     * @param beginDate 开始日期
+     * @param endDate 结束日期
+     * @return 从开始日期零点到结束日期最后时刻的闭区间；两个日期都为空时返回 {@code null}
+     */
+    public static LocalDateTime[] getDateTimeRange(LocalDate beginDate, LocalDate endDate) {
+        if (beginDate == null && endDate == null) {
+            return null;
+        }
+        return new LocalDateTime[]{getDayBeginTime(beginDate), getDayEndTime(endDate)};
+    }
+
+    /**
+     * 获得指定月份的日期时间闭区间
+     *
+     * @param year 年份
+     * @param month 月份
+     * @return 从当月月初零点到月末最后时刻的闭区间
+     */
+    public static LocalDateTime[] getMonthDateTimeRange(int year, int month) {
+        LocalDate monthBeginDate = LocalDate.of(year, month, 1);
+        return getDateTimeRange(monthBeginDate, monthBeginDate.with(TemporalAdjusters.lastDayOfMonth()));
+    }
+
+    /**
      * 获取指定日期所在的月份的开始时间
      * 例如：2023-09-30 00:00:00,000
      *
@@ -196,6 +581,16 @@ public class LocalDateTimeUtils {
     }
 
     /**
+     * 获取指定日期的开始时间
+     *
+     * @param date 日期
+     * @return 当日开始时间
+     */
+    public static LocalDateTime beginOfDay(LocalDateTime date) {
+        return date.with(LocalTime.MIN);
+    }
+
+    /**
      * 获取指定日期所在的月份的最后时间
      * 例如：2023-09-30 23:59:59,999
      *
@@ -207,6 +602,82 @@ public class LocalDateTimeUtils {
     }
 
     /**
+     * 获得指定年月的月初时间
+     *
+     * @param year 年份
+     * @param month 月份
+     * @return 月初时间
+     */
+    public static LocalDateTime getMonthBeginTime(int year, int month) {
+        return LocalDateTime.of(year, month, 1, 0, 0);
+    }
+
+    /**
+     * 获得指定年月的月初时间
+     *
+     * @param month 年月
+     * @return 月初时间
+     */
+    public static LocalDateTime getMonthBeginTime(YearMonth month) {
+        return getMonthBeginTime(month.getYear(), month.getMonthValue());
+    }
+
+    /**
+     * 获得指定年月的下月月初时间
+     *
+     * @param year 年份
+     * @param month 月份
+     * @return 下月月初时间
+     */
+    public static LocalDateTime getNextMonthBeginTime(int year, int month) {
+        return getMonthBeginTime(year, month).plusMonths(1);
+    }
+
+    /**
+     * 获得指定年月的下月月初时间
+     *
+     * @param month 年月
+     * @return 下月月初时间
+     */
+    public static LocalDateTime getNextMonthBeginTime(YearMonth month) {
+        return getMonthBeginTime(month).plusMonths(1);
+    }
+
+    /**
+     * 判断两个时间段是否存在正时长的重叠
+     *
+     * @param beginTime1 第一个范围的开始时间
+     * @param endTime1 第一个范围的结束时间
+     * @param beginTime2 第二个范围的开始时间
+     * @param endTime2 第二个范围的结束时间
+     * @return 是否存在正时长的重叠
+     */
+    public static boolean isOverlap(LocalDateTime beginTime1, LocalDateTime endTime1,
+                                    LocalDateTime beginTime2, LocalDateTime endTime2) {
+        if (beginTime1 == null || endTime1 == null || beginTime2 == null || endTime2 == null) {
+            return false;
+        }
+        return beginTime1.isBefore(endTime2) && endTime1.isAfter(beginTime2);
+    }
+
+    /**
+     * 判断两个左右闭合的时间范围是否重叠
+     *
+     * @param beginTime1 第一个范围的开始时间
+     * @param endTime1 第一个范围的结束时间
+     * @param beginTime2 第二个范围的开始时间
+     * @param endTime2 第二个范围的结束时间
+     * @return 是否重叠
+     */
+    public static boolean isClosedRangeOverlap(LocalDateTime beginTime1, LocalDateTime endTime1,
+                                               LocalDateTime beginTime2, LocalDateTime endTime2) {
+        if (beginTime1 == null || endTime1 == null || beginTime2 == null || endTime2 == null) {
+            return false;
+        }
+        return isBeforeOrEqual(beginTime1, endTime2) && isAfterOrEqual(endTime1, beginTime2);
+    }
+
+    /**
      * 获得指定日期所在季度
      *
      * @param date 日期
@@ -353,7 +824,11 @@ public class LocalDateTimeUtils {
      * @return 日期列表，包含开始日期
      */
     public static List<LocalDate> getDateList(LocalDate startDate, int days) {
-        return startDate.datesUntil(startDate.plusDays(days)).toList();
+        List<LocalDate> dateList = new ArrayList<>(days);
+        for (int i = 0; i < days; i++) {
+            dateList.add(startDate.plusDays(i));
+        }
+        return dateList;
     }
 
     /**
@@ -433,4 +908,23 @@ public class LocalDateTimeUtils {
         return sourceDateTime.atZone(zoneId).toEpochSecond();
     }
 
+    /**
+     * 时间范围
+     */
+    @Getter
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    public static class TimeRange {
+
+        /**
+         * 开始时间
+         */
+        private final LocalDateTime startTime;
+        /**
+         * 结束时间
+         */
+        private final LocalDateTime endTime;
+
+    }
+
 }
diff --git a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/MoneyUtils.java b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/MoneyUtils.java
index 90888d7..7028151 100644
--- a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/MoneyUtils.java
+++ b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/MoneyUtils.java
@@ -97,6 +97,39 @@ public class MoneyUtils {
     }
 
     /**
+     * 格式化金额，默认进行四舍五入
+     *
+     * 位数：{@link #PRICE_SCALE}。金额为空时，按 0 处理。
+     *
+     * @param price 金额
+     * @return 格式化后的金额
+     */
+    public static BigDecimal priceScale(BigDecimal price) {
+        return (price == null ? BigDecimal.ZERO : price).setScale(PRICE_SCALE, RoundingMode.HALF_UP);
+    }
+
+    /**
+     * 金额相加，默认进行四舍五入
+     *
+     * 位数：{@link #PRICE_SCALE}。忽略空金额，没有有效金额时返回 0。
+     *
+     * @param prices 金额数组
+     * @return 金额相加结果
+     */
+    public static BigDecimal priceAdd(BigDecimal... prices) {
+        BigDecimal result = BigDecimal.ZERO;
+        if (prices == null) {
+            return priceScale(result);
+        }
+        for (BigDecimal price : prices) {
+            if (price != null) {
+                result = result.add(price);
+            }
+        }
+        return priceScale(result);
+    }
+
+    /**
      * 金额相乘，默认进行四舍五入
      *
      * 位数：{@link #PRICE_SCALE}
@@ -109,7 +142,7 @@ public class MoneyUtils {
         if (price == null || count == null) {
             return null;
         }
-        return price.multiply(count).setScale(PRICE_SCALE, RoundingMode.HALF_UP);
+        return priceScale(price.multiply(count));
     }
 
     /**
diff --git a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/NumberUtils.java b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/NumberUtils.java
index c2787f4..544a797 100644
--- a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/NumberUtils.java
+++ b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/number/NumberUtils.java
@@ -2,10 +2,12 @@ package cn.iocoder.yudao.framework.common.util.number;
 
 import cn.hutool.core.collection.CollUtil;
 import cn.hutool.core.util.NumberUtil;
+import cn.hutool.core.util.ReUtil;
 import cn.hutool.core.util.StrUtil;
 
 import java.math.BigDecimal;
 import java.util.List;
+import java.util.regex.Pattern;
 
 /**
  * 数字的工具类，补全 {@link cn.hutool.core.util.NumberUtil} 的功能
@@ -14,6 +16,13 @@ import java.util.List;
  */
 public class NumberUtils {
 
+    private static final Pattern FIRST_BIG_DECIMAL_PATTERN = Pattern.compile("-?\\d+(?:\\.\\d+)?");
+
+    /**
+     * 一百，用于百分数和比例计算
+     */
+    public static final BigDecimal ONE_HUNDRED = new BigDecimal("100");
+
     public static Long parseLong(String str) {
         return StrUtil.isNotEmpty(str) ? Long.valueOf(str) : null;
     }
@@ -22,6 +31,30 @@ public class NumberUtils {
         return StrUtil.isNotEmpty(str) ? Integer.valueOf(str) : null;
     }
 
+    /**
+     * 获得数字，为 null 时返回 {@link BigDecimal#ZERO}
+     *
+     * @param value 数字
+     * @return 数字
+     */
+    public static BigDecimal zeroIfNull(BigDecimal value) {
+        return value == null ? BigDecimal.ZERO : value;
+    }
+
+    /**
+     * 从文本中解析首个数字
+     *
+     * @param text 文本
+     * @return 数字；不存在时返回 {@link BigDecimal#ZERO}
+     */
+    public static BigDecimal parseFirstBigDecimal(String text) {
+        if (StrUtil.isEmpty(text)) {
+            return BigDecimal.ZERO;
+        }
+        String number = ReUtil.getGroup0(FIRST_BIG_DECIMAL_PATTERN, text.replace(",", ""));
+        return NumberUtil.toBigDecimal(number);
+    }
+
     public static boolean isAllNumber(List<String> values) {
         if (CollUtil.isEmpty(values)) {
             return false;
diff --git a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/object/PageUtils.java b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/object/PageUtils.java
index cf077db..472fff8 100644
--- a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/object/PageUtils.java
+++ b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/object/PageUtils.java
@@ -5,10 +5,13 @@ import cn.hutool.core.lang.func.Func1;
 import cn.hutool.core.lang.func.LambdaUtil;
 import cn.hutool.core.util.ArrayUtil;
 import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
 import cn.iocoder.yudao.framework.common.pojo.SortablePageParam;
 import cn.iocoder.yudao.framework.common.pojo.SortingField;
 import org.springframework.util.Assert;
 
+import java.util.List;
+
 import static java.util.Collections.singletonList;
 
 /**
@@ -25,6 +28,27 @@ public class PageUtils {
     }
 
     /**
+     * 对内存列表进行分页
+     *
+     * @param list 数据列表
+     * @param pageParam 分页参数
+     * @param <T> 数据类型
+     * @return 分页结果
+     */
+    public static <T> PageResult<T> buildPageResult(List<T> list, PageParam pageParam) {
+        if (CollUtil.isEmpty(list)) {
+            return PageResult.empty();
+        }
+        long total = list.size();
+        if (PageParam.PAGE_SIZE_NONE.equals(pageParam.getPageSize())) {
+            return new PageResult<>(list, total);
+        }
+        int fromIndex = Math.toIntExact(Math.min(getStart(pageParam), total));
+        int toIndex = Math.toIntExact(Math.min((long) fromIndex + pageParam.getPageSize(), total));
+        return new PageResult<>(list.subList(fromIndex, toIndex), total);
+    }
+
+    /**
      * 构建排序字段（默认倒序）
      *
      * @param func 排序字段的 Lambda 表达式
diff --git a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/servlet/ServletUtils.java b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/servlet/ServletUtils.java
index 905f5d5..3501bcc 100644
--- a/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/servlet/ServletUtils.java
+++ b/yudao-framework/yudao-common/src/main/java/cn/iocoder/yudao/framework/common/util/servlet/ServletUtils.java
@@ -2,6 +2,7 @@ package cn.iocoder.yudao.framework.common.util.servlet;
 
 import cn.hutool.core.util.StrUtil;
 import cn.hutool.extra.servlet.JakartaServletUtil;
+import cn.iocoder.yudao.framework.common.util.http.HttpUtils;
 import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
 import jakarta.servlet.ServletRequest;
 import jakarta.servlet.http.HttpServletRequest;
@@ -11,6 +12,7 @@ import org.springframework.web.context.request.RequestAttributes;
 import org.springframework.web.context.request.RequestContextHolder;
 import org.springframework.web.context.request.ServletRequestAttributes;
 
+import java.io.IOException;
 import java.util.Map;
 
 /**
@@ -102,4 +104,11 @@ public class ServletUtils {
         return JakartaServletUtil.getHeaderMap(request);
     }
 
+    public static void writeAttachment(HttpServletResponse response, String filename, byte[] content)
+            throws IOException {
+        response.getOutputStream().write(content);
+        response.addHeader("Content-Disposition", "attachment;filename=" + HttpUtils.encodeUtf8(filename));
+        response.setContentType(MediaType.APPLICATION_OCTET_STREAM_VALUE);
+    }
+
 }
diff --git a/yudao-framework/yudao-common/src/test/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtilsTest.java b/yudao-framework/yudao-common/src/test/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtilsTest.java
index 0e44645..f0aaa63 100644
--- a/yudao-framework/yudao-common/src/test/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtilsTest.java
+++ b/yudao-framework/yudao-common/src/test/java/cn/iocoder/yudao/framework/common/util/collection/CollectionUtilsTest.java
@@ -6,7 +6,9 @@ import org.junit.jupiter.api.Test;
 
 import java.util.Arrays;
 import java.util.Collection;
+import java.util.Collections;
 import java.util.List;
+import java.util.TreeSet;
 import java.util.function.BiFunction;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
@@ -27,6 +29,38 @@ public class CollectionUtilsTest {
     }
 
     @Test
+    public void testSum() {
+        assertEquals(6L, CollectionUtils.sum(Arrays.asList(1L, 2L, 3L), Long::longValue));
+        assertEquals(0L, CollectionUtils.sum(Collections.<Long>emptyList(), Long::longValue));
+    }
+
+    @Test
+    public void testCount() {
+        assertEquals(2L, CollectionUtils.count(Arrays.asList(1, 2, 3, 4), value -> value % 2 == 0));
+        assertEquals(0L, CollectionUtils.count(Collections.emptyList(), value -> true));
+    }
+
+    @Test
+    public void testDistinctCount() {
+        assertEquals(3L, CollectionUtils.distinctCount(Arrays.asList("a", "b", "a", "c"), value -> value));
+        assertEquals(0L, CollectionUtils.distinctCount(Collections.emptyList(), value -> value));
+    }
+
+    @Test
+    public void testConvertSet_withSupplier() {
+        // 调用，并断言：按指定 Set 类型完成转换、去重和排序
+        TreeSet<Integer> result = CollectionUtils.convertSetBySupplier(
+                Arrays.asList("3", "1", null, "3", "2"),
+                value -> value == null ? null : Integer.valueOf(value), TreeSet::new);
+        assertEquals(Arrays.asList(1, 2, 3), Arrays.asList(result.toArray(new Integer[0])));
+
+        // 调用，并断言：空集合仍返回指定 Set 类型
+        result = CollectionUtils.convertSetBySupplier(Collections.<String>emptyList(),
+                Integer::valueOf, TreeSet::new);
+        assertEquals(TreeSet.class, result.getClass());
+    }
+
+    @Test
     public void testDiffList() {
         // 准备参数
         Collection<Dog> oldList = Arrays.asList(
diff --git a/yudao-framework/yudao-common/src/test/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtilsTest.java b/yudao-framework/yudao-common/src/test/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtilsTest.java
new file mode 100644
index 0000000..abb7a66
--- /dev/null
+++ b/yudao-framework/yudao-common/src/test/java/cn/iocoder/yudao/framework/common/util/date/LocalDateTimeUtilsTest.java
@@ -0,0 +1,342 @@
+package cn.iocoder.yudao.framework.common.util.date;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.TimeRange;
+import org.junit.jupiter.api.Test;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * {@link LocalDateTimeUtils} 的单元测试
+ *
+ * @author 芋道源码
+ */
+public class LocalDateTimeUtilsTest {
+
+    @Test
+    public void testDateCompare() {
+        // 准备参数
+        LocalDate firstDate = LocalDate.of(2026, 7, 23);
+        LocalDate secondDate = LocalDate.of(2026, 7, 24);
+
+        // 调用，并断言
+        assertTrue(LocalDateTimeUtils.isBeforeOrEqual(firstDate, secondDate));
+        assertTrue(LocalDateTimeUtils.isBeforeOrEqual(secondDate, secondDate));
+        assertFalse(LocalDateTimeUtils.isBeforeOrEqual(secondDate, firstDate));
+        assertTrue(LocalDateTimeUtils.isAfterOrEqual(secondDate, firstDate));
+        assertTrue(LocalDateTimeUtils.isAfterOrEqual(secondDate, secondDate));
+        assertFalse(LocalDateTimeUtils.isAfterOrEqual(firstDate, secondDate));
+    }
+
+    @Test
+    public void testDateTimeCompare() {
+        // 准备参数
+        LocalDateTime firstTime = LocalDateTime.of(2026, 7, 24, 9, 0);
+        LocalDateTime secondTime = LocalDateTime.of(2026, 7, 24, 18, 0);
+
+        // 调用，并断言
+        assertTrue(LocalDateTimeUtils.isBeforeOrEqual(firstTime, secondTime));
+        assertTrue(LocalDateTimeUtils.isBeforeOrEqual(secondTime, secondTime));
+        assertFalse(LocalDateTimeUtils.isBeforeOrEqual(secondTime, firstTime));
+        assertTrue(LocalDateTimeUtils.isAfterOrEqual(secondTime, firstTime));
+        assertTrue(LocalDateTimeUtils.isAfterOrEqual(secondTime, secondTime));
+        assertFalse(LocalDateTimeUtils.isAfterOrEqual(firstTime, secondTime));
+    }
+
+    @Test
+    public void testIsTimeRangeValid() {
+        // 准备参数
+        LocalDateTime beginTime = LocalDateTime.of(2026, 7, 24, 9, 0);
+        LocalDateTime endTime = LocalDateTime.of(2026, 7, 24, 18, 0);
+
+        // 调用，并断言
+        assertTrue(LocalDateTimeUtils.isTimeRangeValid(beginTime, endTime));
+        assertFalse(LocalDateTimeUtils.isTimeRangeValid(beginTime, beginTime));
+        assertFalse(LocalDateTimeUtils.isTimeRangeValid(endTime, beginTime));
+        assertFalse(LocalDateTimeUtils.isTimeRangeValid(null, endTime));
+        assertFalse(LocalDateTimeUtils.isTimeRangeValid(beginTime, null));
+    }
+
+    @Test
+    public void testIsTimeRangePresent() {
+        // 准备参数
+        LocalDateTime time = LocalDateTime.of(2026, 7, 24, 9, 0);
+
+        // 调用，并断言：空数组和双空边界都不是有效范围
+        assertFalse(LocalDateTimeUtils.isTimeRangePresent(null));
+        assertFalse(LocalDateTimeUtils.isTimeRangePresent(new LocalDateTime[0]));
+        assertFalse(LocalDateTimeUtils.isTimeRangePresent(new LocalDateTime[]{null, null}));
+
+        // 调用，并断言：单边或双边存在即为有效范围
+        assertTrue(LocalDateTimeUtils.isTimeRangePresent(new LocalDateTime[]{time}));
+        assertTrue(LocalDateTimeUtils.isTimeRangePresent(new LocalDateTime[]{null, time}));
+        assertTrue(LocalDateTimeUtils.isTimeRangePresent(new LocalDateTime[]{time, time.plusHours(1)}));
+    }
+
+    @Test
+    public void testGetDayTime() {
+        // 准备参数
+        LocalDate date = LocalDate.of(2026, 7, 24);
+        LocalDateTime time = date.atTime(15, 30);
+
+        // 调用，并断言
+        assertEquals(LocalDateTime.of(2026, 7, 24, 0, 0),
+                LocalDateTimeUtils.getDayBeginTime(date));
+        assertEquals(LocalDateTime.of(2026, 7, 24, 0, 0),
+                LocalDateTimeUtils.getDayBeginTime(time));
+        assertNull(LocalDateTimeUtils.getDayBeginTime((LocalDateTime) null));
+        assertEquals(LocalDateTime.of(date, LocalTime.MAX),
+                LocalDateTimeUtils.getDayEndTime(date));
+    }
+
+    @Test
+    public void testGetDateTimeRange() {
+        // 准备参数
+        LocalDate beginDate = LocalDate.of(2026, 7, 1);
+        LocalDate endDate = LocalDate.of(2026, 7, 31);
+
+        // 调用，并断言：左右两端均为闭区间边界
+        LocalDateTime[] result = LocalDateTimeUtils.getDateTimeRange(beginDate, endDate);
+        assertEquals(beginDate.atStartOfDay(), result[0]);
+        assertEquals(endDate.atTime(LocalTime.MAX), result[1]);
+
+        // 调用，并断言：支持单边范围
+        result = LocalDateTimeUtils.getDateTimeRange(beginDate, null);
+        assertEquals(beginDate.atStartOfDay(), result[0]);
+        assertNull(result[1]);
+        result = LocalDateTimeUtils.getDateTimeRange(null, endDate);
+        assertNull(result[0]);
+        assertEquals(endDate.atTime(LocalTime.MAX), result[1]);
+
+        // 调用，并断言：两个边界都为空时不生成范围
+        assertNull(LocalDateTimeUtils.getDateTimeRange(null, null));
+    }
+
+    @Test
+    public void testGetMonthDateTimeRange() {
+        // 调用：闰年二月
+        LocalDateTime[] result = LocalDateTimeUtils.getMonthDateTimeRange(2024, 2);
+
+        // 断言：完整包含闰年二月的首尾时刻
+        assertEquals(LocalDateTime.of(2024, 2, 1, 0, 0), result[0]);
+        assertEquals(LocalDate.of(2024, 2, 29).atTime(LocalTime.MAX), result[1]);
+    }
+
+    @Test
+    public void testGetMonthBeginTime() {
+        // 准备参数
+        YearMonth month = YearMonth.of(2026, 12);
+
+        // 调用，并断言
+        assertEquals(LocalDateTime.of(2026, 12, 1, 0, 0),
+                LocalDateTimeUtils.getMonthBeginTime(month));
+        assertEquals(LocalDateTime.of(2027, 1, 1, 0, 0),
+                LocalDateTimeUtils.getNextMonthBeginTime(month));
+    }
+
+    @Test
+    public void testIsBetween() {
+        // 准备参数
+        LocalDate beginDate = LocalDate.of(2026, 7, 23);
+        LocalDate endDate = LocalDate.of(2026, 7, 25);
+        LocalDateTime beginTime = beginDate.atTime(9, 0);
+        LocalDateTime endTime = beginDate.atTime(18, 0);
+
+        // 调用，并断言：日期闭区间
+        assertTrue(LocalDateTimeUtils.isBetween(beginDate, endDate, beginDate));
+        assertTrue(LocalDateTimeUtils.isBetween(beginDate, endDate, LocalDate.of(2026, 7, 24)));
+        assertTrue(LocalDateTimeUtils.isBetween(beginDate, endDate, endDate));
+        assertFalse(LocalDateTimeUtils.isBetween(beginDate, endDate, LocalDate.of(2026, 7, 26)));
+        assertFalse(LocalDateTimeUtils.isBetween(beginDate, endDate, null));
+        assertFalse(LocalDateTimeUtils.isNotBetween(beginDate, endDate, beginDate));
+        assertTrue(LocalDateTimeUtils.isNotBetween(beginDate, endDate, LocalDate.of(2026, 7, 26)));
+        assertTrue(LocalDateTimeUtils.isNotBetween(beginDate, endDate, null));
+
+        // 调用，并断言：时间闭区间
+        assertTrue(LocalDateTimeUtils.isBetween(beginTime, endTime, beginTime));
+        assertTrue(LocalDateTimeUtils.isBetween(beginTime, endTime, beginDate.atTime(12, 0)));
+        assertTrue(LocalDateTimeUtils.isBetween(beginTime, endTime, endTime));
+        assertFalse(LocalDateTimeUtils.isBetween(beginTime, endTime, beginDate.atTime(18, 1)));
+        assertFalse(LocalDateTimeUtils.isBetween(beginTime, endTime, (LocalDateTime) null));
+        assertFalse(LocalDateTimeUtils.isNotBetween(beginTime, endTime, endTime));
+        assertTrue(LocalDateTimeUtils.isNotBetween(beginTime, endTime, beginDate.atTime(18, 1)));
+        assertTrue(LocalDateTimeUtils.isNotBetween(beginTime, endTime, null));
+    }
+
+    @Test
+    public void testIsClosedRangeOverlap() {
+        // 准备参数
+        LocalDateTime firstBeginTime = LocalDateTime.of(2026, 7, 24, 9, 0);
+        LocalDateTime firstEndTime = LocalDateTime.of(2026, 7, 24, 12, 0);
+
+        // 调用，并断言：首尾相接属于闭区间重叠
+        assertTrue(LocalDateTimeUtils.isClosedRangeOverlap(
+                firstBeginTime, firstEndTime, firstEndTime, firstEndTime.plusHours(1)));
+        assertTrue(LocalDateTimeUtils.isClosedRangeOverlap(
+                firstBeginTime, firstEndTime, firstBeginTime.minusHours(1), firstBeginTime));
+        assertFalse(LocalDateTimeUtils.isClosedRangeOverlap(
+                firstBeginTime, firstEndTime, firstEndTime.plusNanos(1), firstEndTime.plusHours(1)));
+        assertFalse(LocalDateTimeUtils.isClosedRangeOverlap(
+                firstBeginTime, firstEndTime, null, firstEndTime));
+    }
+
+    @Test
+    public void testSubtractTimeRanges() {
+        // 准备参数
+        LocalDate date = LocalDate.of(2026, 7, 24);
+        TimeRange sourceRange = new TimeRange(date.atTime(9, 0), date.atTime(18, 0));
+
+        // 调用：扣除原时段中间的一段
+        List<TimeRange> result = LocalDateTimeUtils.subtractTimeRanges(
+                Collections.singletonList(sourceRange),
+                new TimeRange(date.atTime(12, 0), date.atTime(13, 0)));
+
+        // 断言：原时段被拆分为两段
+        assertEquals(2, result.size());
+        assertTimeRange(CollUtil.getFirst(result), date.atTime(9, 0), date.atTime(12, 0));
+        assertTimeRange(result.get(1), date.atTime(13, 0), date.atTime(18, 0));
+
+        // 调用，并断言：扣除时段完整覆盖原时段
+        result = LocalDateTimeUtils.subtractTimeRanges(
+                Collections.singletonList(sourceRange),
+                new TimeRange(date.atTime(8, 0), date.atTime(19, 0)));
+        assertTrue(result.isEmpty());
+
+        // 调用：扣除时段与原时段首尾相接
+        result = LocalDateTimeUtils.subtractTimeRanges(
+                Collections.singletonList(sourceRange),
+                new TimeRange(date.atTime(18, 0), date.atTime(19, 0)));
+        // 断言：两个时段仅首尾相接，没有正时长交集，原时段保持不变
+        assertEquals(1, result.size());
+        assertTimeRange(CollUtil.getFirst(result), date.atTime(9, 0), date.atTime(18, 0));
+    }
+
+    @Test
+    public void testMergeTimeRanges() {
+        // 准备参数
+        LocalDate date = LocalDate.of(2026, 7, 24);
+        List<TimeRange> timeRanges = Arrays.asList(
+                new TimeRange(date.atTime(13, 0), date.atTime(14, 0)),
+                new TimeRange(date.atTime(9, 0), date.atTime(11, 0)),
+                new TimeRange(date.atTime(10, 0), date.atTime(13, 0)),
+                new TimeRange(date.atTime(16, 0), date.atTime(17, 0)));
+
+        // 调用
+        List<TimeRange> result = LocalDateTimeUtils.mergeTimeRanges(timeRanges);
+
+        // 断言：重叠或首尾相接的时段被合并，独立时段保持不变
+        assertEquals(2, result.size());
+        assertTimeRange(CollUtil.getFirst(result), date.atTime(9, 0), date.atTime(14, 0));
+        assertTimeRange(result.get(1), date.atTime(16, 0), date.atTime(17, 0));
+        // 调用，并断言：空列表
+        assertTrue(LocalDateTimeUtils.mergeTimeRanges(Collections.emptyList()).isEmpty());
+    }
+
+    @Test
+    public void testIntersectTimeRanges() {
+        // 准备参数
+        LocalDate date = LocalDate.of(2026, 7, 24);
+        List<TimeRange> firstRanges = Arrays.asList(
+                new TimeRange(date.atTime(9, 0), date.atTime(12, 0)),
+                new TimeRange(date.atTime(13, 0), date.atTime(18, 0)));
+        List<TimeRange> secondRanges = Arrays.asList(
+                new TimeRange(date.atTime(10, 0), date.atTime(14, 0)),
+                new TimeRange(date.atTime(17, 0), date.atTime(19, 0)));
+
+        // 调用
+        List<TimeRange> result = LocalDateTimeUtils.intersectTimeRanges(firstRanges, secondRanges);
+
+        // 断言
+        assertEquals(3, result.size());
+        assertTimeRange(CollUtil.getFirst(result), date.atTime(10, 0), date.atTime(12, 0));
+        assertTimeRange(result.get(1), date.atTime(13, 0), date.atTime(14, 0));
+        assertTimeRange(result.get(2), date.atTime(17, 0), date.atTime(18, 0));
+        // 调用，并断言：两个时段仅首尾相接时不生成零时长交集
+        assertNull(LocalDateTimeUtils.intersectTimeRange(
+                new TimeRange(date.atTime(9, 0), date.atTime(10, 0)),
+                new TimeRange(date.atTime(10, 0), date.atTime(11, 0))));
+    }
+
+    @Test
+    public void testCalculateDurationMinutes() {
+        // 准备参数
+        LocalDate date = LocalDate.of(2026, 7, 24);
+        List<TimeRange> timeRanges = Arrays.asList(
+                new TimeRange(date.atTime(9, 0), date.atTime(10, 0)),
+                new TimeRange(date.atTime(13, 0), date.atTime(14, 30)));
+
+        // 调用，并断言
+        assertEquals(150, LocalDateTimeUtils.calculateDurationMinutes(timeRanges));
+        // 调用，并断言：空列表
+        assertEquals(0, LocalDateTimeUtils.calculateDurationMinutes(Collections.emptyList()));
+    }
+
+    @Test
+    public void testBuildDailyTimeRanges() {
+        // 准备参数
+        LocalDate beginDate = LocalDate.of(2026, 7, 24);
+        LocalDate endDate = LocalDate.of(2026, 7, 25);
+
+        // 调用：构建跨天时间范围
+        List<TimeRange> result = LocalDateTimeUtils.buildDailyTimeRanges(
+                beginDate, endDate, LocalTime.of(22, 0), LocalTime.of(6, 0));
+
+        // 断言
+        assertEquals(2, result.size());
+        assertTimeRange(CollUtil.getFirst(result), beginDate.atTime(22, 0), beginDate.plusDays(1).atTime(6, 0));
+        assertTimeRange(result.get(1), endDate.atTime(22, 0), endDate.plusDays(1).atTime(6, 0));
+
+        // 调用：每日开始和结束时刻相同
+        result = LocalDateTimeUtils.buildDailyTimeRanges(
+                beginDate, beginDate, LocalTime.of(9, 0), LocalTime.of(9, 0));
+        // 断言：按完整一天处理
+        assertEquals(1, result.size());
+        assertTimeRange(CollUtil.getFirst(result), beginDate.atTime(9, 0), beginDate.plusDays(1).atTime(9, 0));
+
+        // 调用，并断言：开始日期晚于结束日期
+        assertTrue(LocalDateTimeUtils.buildDailyTimeRanges(
+                endDate, beginDate, LocalTime.of(9, 0), LocalTime.of(18, 0)).isEmpty());
+    }
+
+    @Test
+    public void testFindDailyTimeRange() {
+        // 准备参数
+        LocalDate date = LocalDate.of(2026, 7, 8);
+
+        // 调用，并断言普通时间范围的左右边界
+        TimeRange result = LocalDateTimeUtils.findDailyTimeRange(
+                date, LocalTime.of(8, 0), LocalTime.of(10, 0), date.atTime(8, 0));
+        assertEquals(date.atTime(8, 0), result.getStartTime());
+        assertEquals(date.atTime(10, 0), result.getEndTime());
+        assertNotNull(LocalDateTimeUtils.findDailyTimeRange(
+                date, LocalTime.of(8, 0), LocalTime.of(10, 0), date.atTime(10, 0)));
+
+        // 调用，并断言跨日时间范围
+        result = LocalDateTimeUtils.findDailyTimeRange(
+                date, LocalTime.of(20, 0), LocalTime.of(6, 0), date.plusDays(1).atTime(5, 0));
+        assertEquals(date.atTime(20, 0), result.getStartTime());
+        assertEquals(date.plusDays(1).atTime(6, 0), result.getEndTime());
+        assertNull(LocalDateTimeUtils.findDailyTimeRange(
+                date, LocalTime.of(8, 0), LocalTime.of(10, 0), date.atTime(12, 0)));
+    }
+
+    private static void assertTimeRange(TimeRange timeRange,
+                                        LocalDateTime expectedStartTime,
+                                        LocalDateTime expectedEndTime) {
+        assertEquals(expectedStartTime, timeRange.getStartTime());
+        assertEquals(expectedEndTime, timeRange.getEndTime());
+    }
+
+}
diff --git a/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/convert/StringListConvert.java b/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/convert/StringListConvert.java
new file mode 100644
index 0000000..edb243e
--- /dev/null
+++ b/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/convert/StringListConvert.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.framework.excel.core.convert;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.idev.excel.converters.Converter;
+import cn.idev.excel.metadata.GlobalConfiguration;
+import cn.idev.excel.metadata.data.WriteCellData;
+import cn.idev.excel.metadata.property.ExcelContentProperty;
+
+import java.util.List;
+
+/**
+ * Excel 字符串列表转换器
+ *
+ * @author 芋道源码
+ */
+public class StringListConvert implements Converter<List<String>> {
+
+    @Override
+    public WriteCellData<String> convertToExcelData(List<String> value,
+            ExcelContentProperty contentProperty, GlobalConfiguration globalConfiguration) {
+        return new WriteCellData<>(CollUtil.isEmpty(value) ? "" : String.join("/", value));
+    }
+
+}
diff --git a/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/util/ExcelUtils.java b/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/util/ExcelUtils.java
index f4f17ec..d771d18 100644
--- a/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/util/ExcelUtils.java
+++ b/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/util/ExcelUtils.java
@@ -1,7 +1,9 @@
 package cn.iocoder.yudao.framework.excel.core.util;
 
 import cn.idev.excel.FastExcelFactory;
+import cn.idev.excel.context.AnalysisContext;
 import cn.idev.excel.converters.longconverter.LongStringConverter;
+import cn.idev.excel.read.listener.ReadListener;
 import cn.iocoder.yudao.framework.common.util.http.HttpUtils;
 import cn.iocoder.yudao.framework.excel.core.handler.ColumnWidthMatchStyleStrategy;
 import cn.iocoder.yudao.framework.excel.core.handler.SelectSheetWriteHandler;
@@ -10,7 +12,10 @@ import org.springframework.web.multipart.MultipartFile;
 
 import java.io.IOException;
 import java.io.InputStream;
+import java.util.ArrayList;
+import java.util.Collections;
 import java.util.List;
+import java.util.Map;
 
 /**
  * Excel 工具类
@@ -44,7 +49,33 @@ public class ExcelUtils {
         response.setContentType("application/vnd.ms-excel;charset=UTF-8");
     }
 
+    /**
+     * 将动态表头和数据以 Excel 响应给前端
+     *
+     * @param response 响应
+     * @param filename 文件名
+     * @param sheetName Excel sheet 名
+     * @param head Excel head 头
+     * @param data 数据列表
+     * @throws IOException 写入失败的情况
+     */
+    public static void write(HttpServletResponse response, String filename, String sheetName,
+                             List<List<String>> head, List<List<Object>> data) throws IOException {
+        // 输出 Excel
+        FastExcelFactory.write(response.getOutputStream())
+                .autoCloseStream(false) // 不要自动关闭，交给 Servlet 自己处理
+                .registerWriteHandler(new ColumnWidthMatchStyleStrategy()) // 基于 column 长度，自动适配。最大 255 宽度
+                .registerConverter(new LongStringConverter()) // 避免 Long 类型丢失精度
+                .head(head).sheet(sheetName).doWrite(data);
+        // 设置 header 和 contentType。写在最后的原因是，避免报错时，响应 contentType 已经被修改了
+        response.addHeader("Content-Disposition", "attachment;filename=" + HttpUtils.encodeUtf8(filename));
+        response.setContentType("application/vnd.ms-excel;charset=UTF-8");
+    }
+
     public static <T> List<T> read(MultipartFile file, Class<T> head) throws IOException {
+        if (file == null || file.isEmpty()) {
+            return Collections.emptyList();
+        }
         // 参考 https://t.zsxq.com/zM77F 帖子，增加 try 处理，兼容 windows 场景
         try (InputStream inputStream = file.getInputStream()) {
             return FastExcelFactory.read(inputStream, head, null)
@@ -53,4 +84,64 @@ public class ExcelUtils {
         }
     }
 
+    /**
+     * 读取指定数量以内的 Excel 数据，达到上限后停止继续解析。
+     *
+     * @param file Excel 文件，可为空
+     * @param head Excel 表头类型
+     * @param maxRowCount 最大读取行数
+     * @return Excel 数据
+     */
+    public static <T> List<T> read(MultipartFile file, Class<T> head, int maxRowCount) throws IOException {
+        if (file == null || file.isEmpty()) {
+            return Collections.emptyList();
+        }
+        if (maxRowCount <= 0) {
+            throw new IllegalArgumentException("maxRowCount must be greater than 0");
+        }
+        List<T> rows = new ArrayList<>(Math.min(maxRowCount, 1024));
+        try (InputStream inputStream = file.getInputStream()) {
+            FastExcelFactory.read(inputStream, head, new ReadListener<T>() {
+
+                @Override
+                public void invoke(T data, AnalysisContext context) {
+                    rows.add(data);
+                }
+
+                @Override
+                public void doAfterAllAnalysed(AnalysisContext context) {
+                    // 无需处理
+                }
+
+                @Override
+                public boolean hasNext(AnalysisContext context) {
+                    return rows.size() < maxRowCount;
+                }
+
+            }).autoCloseStream(false).doReadAll();
+        }
+        return rows;
+    }
+
+    /**
+     * 读取动态表头 Excel 数据
+     *
+     * @param file Excel 文件，可为空
+     * @return 按列下标存储的行数据
+     * @throws IOException 读取失败
+     */
+    public static List<Map<Integer, String>> read(MultipartFile file) throws IOException {
+        if (file == null || file.isEmpty()) {
+            return Collections.emptyList();
+        }
+        // 参考 https://t.zsxq.com/zM77F 帖子，增加 try 处理，兼容 windows 场景
+        try (InputStream inputStream = file.getInputStream()) {
+            return FastExcelFactory.read(inputStream)
+                    .autoCloseStream(false) // 不要自动关闭，交给 Servlet 自己处理
+                    .headRowNumber(1)
+                    .sheet()
+                    .doReadSync();
+        }
+    }
+
 }
diff --git a/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/util/PoiExcelUtils.java b/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/util/PoiExcelUtils.java
new file mode 100644
index 0000000..933d348
--- /dev/null
+++ b/yudao-framework/yudao-spring-boot-starter-excel/src/main/java/cn/iocoder/yudao/framework/excel/core/util/PoiExcelUtils.java
@@ -0,0 +1,226 @@
+package cn.iocoder.yudao.framework.excel.core.util;
+
+import cn.hutool.core.util.NumberUtil;
+import cn.hutool.core.util.StrUtil;
+import lombok.experimental.UtilityClass;
+import org.apache.poi.ss.usermodel.BorderStyle;
+import org.apache.poi.ss.usermodel.Cell;
+import org.apache.poi.ss.usermodel.CellStyle;
+import org.apache.poi.ss.usermodel.ClientAnchor;
+import org.apache.poi.ss.usermodel.Comment;
+import org.apache.poi.ss.usermodel.CreationHelper;
+import org.apache.poi.ss.usermodel.DataFormatter;
+import org.apache.poi.ss.usermodel.FillPatternType;
+import org.apache.poi.ss.usermodel.Font;
+import org.apache.poi.ss.usermodel.FormulaEvaluator;
+import org.apache.poi.ss.usermodel.HorizontalAlignment;
+import org.apache.poi.ss.usermodel.IndexedColors;
+import org.apache.poi.ss.usermodel.Row;
+import org.apache.poi.ss.usermodel.Sheet;
+import org.apache.poi.ss.usermodel.VerticalAlignment;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.ss.util.CellRangeAddress;
+
+import java.math.BigDecimal;
+import java.util.Collection;
+
+/**
+ * 原生 POI 的 Excel 工具类
+ *
+ * 全局 {@link ExcelUtils}（FastExcel）无法表达单元格锁定、公式、动态列等复杂模板时，各模块基于本类实现自定义 Excel 读写
+ *
+ * @author 芋道源码
+ */
+@UtilityClass
+public class PoiExcelUtils {
+
+    /**
+     * 读取公式计算值必须 DataFormatter + FormulaEvaluator，hutool 没有更简的等价写法
+     */
+    private static final DataFormatter DATA_FORMATTER = new DataFormatter();
+
+    // ==================== 读取 ====================
+
+    /**
+     * 读取单元格文本，公式单元格取公式计算值
+     *
+     * @param row 行
+     * @param column 列
+     * @param evaluator 公式计算器，不需要求值时传 null
+     * @return 文本，空单元格返回空字符串
+     */
+    public static String getCellText(Row row, Integer column, FormulaEvaluator evaluator) {
+        if (row == null || column == null || row.getCell(column) == null) {
+            return "";
+        }
+        return evaluator == null
+                ? DATA_FORMATTER.formatCellValue(row.getCell(column))
+                : DATA_FORMATTER.formatCellValue(row.getCell(column), evaluator);
+    }
+
+    /**
+     * 读取单元格数字，兼容千分位文本
+     *
+     * @param row 行
+     * @param column 列
+     * @param evaluator 公式计算器，不需要求值时传 null
+     * @return 数字，空单元格返回 null；格式不正确时抛出 {@link NumberFormatException}
+     */
+    public static BigDecimal getDecimal(Row row, Integer column, FormulaEvaluator evaluator) {
+        String value = getCellText(row, column, evaluator).replace(",", "");
+        return StrUtil.isBlank(value) ? null : NumberUtil.toBigDecimal(value);
+    }
+
+    /**
+     * 判断指定列是否全部为空
+     *
+     * @param row 行
+     * @param evaluator 公式计算器，不需要求值时传 null
+     * @param columns 列数组
+     * @return 是否全部为空
+     */
+    public static boolean isEmptyRow(Row row, FormulaEvaluator evaluator, Collection<Integer> columns) {
+        if (row == null) {
+            return true;
+        }
+        for (Integer column : columns) {
+            if (StrUtil.isNotBlank(getCellText(row, column, evaluator))) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    // ==================== 写入 ====================
+
+    /**
+     * 写入文本单元格，null 按空字符串处理
+     */
+    public static void writeText(Row row, int column, String value, CellStyle style) {
+        Cell cell = row.createCell(column);
+        cell.setCellValue(StrUtil.nullToEmpty(value));
+        cell.setCellStyle(style);
+    }
+
+    /**
+     * 写入数字单元格，null 时留空
+     */
+    public static void writeNumber(Row row, int column, BigDecimal value, CellStyle style) {
+        Cell cell = row.createCell(column);
+        if (value != null) {
+            cell.setCellValue(value.doubleValue());
+        }
+        cell.setCellStyle(style);
+    }
+
+    /**
+     * 写入公式单元格
+     */
+    public static void writeFormula(Row row, int column, String formula, CellStyle style) {
+        Cell cell = row.createCell(column);
+        cell.setCellFormula(formula);
+        cell.setCellStyle(style);
+    }
+
+    /**
+     * 写入跨两行的合并表头
+     */
+    public static void mergeHeader(Sheet sheet, Row firstRow, Row secondRow,
+                                   int beginColumn, int endColumn, String title, CellStyle style) {
+        sheet.addMergedRegion(new CellRangeAddress(firstRow.getRowNum(), secondRow.getRowNum(),
+                beginColumn, endColumn));
+        Cell cell = firstRow.createCell(beginColumn);
+        cell.setCellValue(title);
+        cell.setCellStyle(style);
+        secondRow.createCell(beginColumn).setCellStyle(style);
+    }
+
+    /**
+     * 添加单元格批注
+     *
+     * @param cell 单元格
+     * @param text 批注内容
+     */
+    public static void addComment(Cell cell, String text) {
+        CreationHelper helper = cell.getSheet().getWorkbook().getCreationHelper();
+        ClientAnchor anchor = helper.createClientAnchor();
+        anchor.setCol1(cell.getColumnIndex());
+        anchor.setCol2(cell.getColumnIndex() + 3);
+        anchor.setRow1(cell.getRowIndex());
+        anchor.setRow2(cell.getRowIndex() + 3);
+        Comment comment = cell.getSheet().createDrawingPatriarch().createCellComment(anchor);
+        comment.setString(helper.createRichTextString(text));
+        cell.setCellComment(comment);
+    }
+
+    // ==================== 样式 ====================
+
+    /**
+     * 创建细边框样式
+     */
+    public static CellStyle createBorderStyle(Workbook workbook) {
+        CellStyle style = workbook.createCellStyle();
+        style.setBorderTop(BorderStyle.THIN);
+        style.setBorderRight(BorderStyle.THIN);
+        style.setBorderBottom(BorderStyle.THIN);
+        style.setBorderLeft(BorderStyle.THIN);
+        return style;
+    }
+
+    /**
+     * 创建数据单元格样式：细边框、垂直居中，可指定锁定和填充色
+     *
+     * @param workbook 工作簿
+     * @param locked 是否锁定，配合 protectSheet 使用
+     * @param fillColor 填充色，传 null 时不填充
+     */
+    public static CellStyle createDataStyle(Workbook workbook, boolean locked, IndexedColors fillColor) {
+        CellStyle style = createBorderStyle(workbook);
+        style.setLocked(locked);
+        if (fillColor != null) {
+            style.setFillForegroundColor(fillColor.getIndex());
+            style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
+        }
+        style.setVerticalAlignment(VerticalAlignment.CENTER);
+        return style;
+    }
+
+    /**
+     * 基于已有样式创建数字格式样式
+     */
+    public static CellStyle createNumberStyle(Workbook workbook, CellStyle base, String format) {
+        CellStyle style = workbook.createCellStyle();
+        style.cloneStyleFrom(base);
+        style.setDataFormat(workbook.createDataFormat().getFormat(format));
+        return style;
+    }
+
+    /**
+     * 创建表头样式：细边框、指定填充色、加粗居中
+     */
+    public static CellStyle createHeaderStyle(Workbook workbook, IndexedColors fillColor) {
+        CellStyle style = createBorderStyle(workbook);
+        style.setFillForegroundColor(fillColor.getIndex());
+        style.setFillPattern(FillPatternType.SOLID_FOREGROUND);
+        style.setAlignment(HorizontalAlignment.CENTER);
+        style.setVerticalAlignment(VerticalAlignment.CENTER);
+        Font font = workbook.createFont();
+        font.setBold(true);
+        style.setFont(font);
+        return style;
+    }
+
+    /**
+     * 创建标题样式：大号加粗居中
+     */
+    public static CellStyle createTitleStyle(Workbook workbook) {
+        CellStyle style = workbook.createCellStyle();
+        style.setAlignment(HorizontalAlignment.CENTER);
+        Font font = workbook.createFont();
+        font.setBold(true);
+        font.setFontHeightInPoints((short) 20);
+        style.setFont(font);
+        return style;
+    }
+
+}
diff --git a/yudao-framework/yudao-spring-boot-starter-excel/src/test/java/cn/iocoder/yudao/framework/excel/core/util/ExcelUtilsTest.java b/yudao-framework/yudao-spring-boot-starter-excel/src/test/java/cn/iocoder/yudao/framework/excel/core/util/ExcelUtilsTest.java
new file mode 100644
index 0000000..c6964d5
--- /dev/null
+++ b/yudao-framework/yudao-spring-boot-starter-excel/src/test/java/cn/iocoder/yudao/framework/excel/core/util/ExcelUtilsTest.java
@@ -0,0 +1,61 @@
+package cn.iocoder.yudao.framework.excel.core.util;
+
+import cn.idev.excel.FastExcelFactory;
+import cn.idev.excel.annotation.ExcelProperty;
+import org.junit.jupiter.api.Test;
+import org.springframework.mock.web.MockMultipartFile;
+
+import java.io.ByteArrayOutputStream;
+import java.util.Arrays;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/**
+ * {@link ExcelUtils} 的单元测试
+ *
+ * @author 芋道源码
+ */
+public class ExcelUtilsTest {
+
+    @Test
+    public void testRead_maxRowCount() throws Exception {
+        // mock 数据
+        ByteArrayOutputStream outputStream = new ByteArrayOutputStream();
+        FastExcelFactory.write(outputStream, TestRow.class).sheet().doWrite(Arrays.asList(
+                new TestRow("员工一"), new TestRow("员工二"), new TestRow("员工三")));
+        MockMultipartFile file = new MockMultipartFile(
+                "file", "employees.xlsx", null, outputStream.toByteArray());
+
+        // 调用
+        List<TestRow> rows = ExcelUtils.read(file, TestRow.class, 2);
+
+        // 断言
+        assertEquals(2, rows.size());
+        assertEquals("员工一", rows.get(0).getName());
+        assertEquals("员工二", rows.get(1).getName());
+    }
+
+    public static class TestRow {
+
+        @ExcelProperty("姓名")
+        private String name;
+
+        public TestRow() {
+        }
+
+        public TestRow(String name) {
+            this.name = name;
+        }
+
+        public String getName() {
+            return name;
+        }
+
+        public void setName(String name) {
+            this.name = name;
+        }
+
+    }
+
+}
diff --git a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/mapper/BaseMapperX.java b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/mapper/BaseMapperX.java
index 08bdf19..79e95fe 100644
--- a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/mapper/BaseMapperX.java
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/mapper/BaseMapperX.java
@@ -145,6 +145,18 @@ public interface BaseMapperX<T> extends MPJBaseMapper<T> {
     }
 
     /**
+     * 获得满足条件的第 1 条记录，并使用 FOR UPDATE 锁定。
+     *
+     * 注意：需要在事务中调用，否则锁会立即释放。
+     *
+     * @param queryWrapper 查询条件
+     * @return 实体
+     */
+    default T selectFirstOneForUpdate(LambdaQueryWrapper<T> queryWrapper) {
+        return selectOne(queryWrapper.last("LIMIT 1 FOR UPDATE"));
+    }
+
+    /**
      * 获取满足条件的第 1 条记录
      *
      * 目的：解决并发场景下，插入多条记录后，使用 selectOne 会报错的问题
diff --git a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/LambdaQueryWrapperX.java b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/LambdaQueryWrapperX.java
index b766199..b5cbcd3 100644
--- a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/LambdaQueryWrapperX.java
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/LambdaQueryWrapperX.java
@@ -7,6 +7,7 @@ import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.core.toolkit.support.SFunction;
 import org.springframework.util.StringUtils;
 
+import java.time.LocalDateTime;
 import java.util.Collection;
 
 /**
@@ -107,6 +108,24 @@ public class LambdaQueryWrapperX<T> extends LambdaQueryWrapper<T> {
         return betweenIfPresent(column, val1, val2);
     }
 
+    /**
+     * 拼接两个闭区间的重叠条件
+     *
+     * <p>记录区间与查询区间重叠的条件为：记录开始值小于等于查询结束值，
+     * 且记录结束值大于等于查询开始值。不能使用单字段 {@code BETWEEN} 代替，
+     * 否则会漏掉完整覆盖查询区间的记录。</p>
+     *
+     * @param beginColumn 记录开始值字段
+     * @param endColumn 记录结束值字段
+     * @param times 查询闭区间
+     * @return 查询条件
+     */
+    public LambdaQueryWrapperX<T> betweenIfPresent(
+            SFunction<T, ?> beginColumn, SFunction<T, ?> endColumn, LocalDateTime[] times) {
+        return leIfPresent(beginColumn, ArrayUtils.get(times, 1))
+                .geIfPresent(endColumn, ArrayUtils.get(times, 0));
+    }
+
     // ========== 重写父类方法，方便链式调用 ==========
 
     @Override
diff --git a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/QueryWrapperX.java b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/QueryWrapperX.java
index bff0122..525d575 100644
--- a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/QueryWrapperX.java
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/query/QueryWrapperX.java
@@ -102,16 +102,9 @@ public class QueryWrapperX<T> extends QueryWrapper<T> {
     }
 
     public QueryWrapperX<T> betweenIfPresent(String column, Object[] values) {
-        if (values != null && values.length != 0 && values[0] != null && values[1] != null) {
-            return (QueryWrapperX<T>) super.between(column, values[0], values[1]);
-        }
-        if (values != null && values.length != 0 && values[0] != null) {
-            return (QueryWrapperX<T>) ge(column, values[0]);
-        }
-        if (values != null && values.length != 0 && values[1] != null) {
-            return (QueryWrapperX<T>) le(column, values[1]);
-        }
-        return this;
+        Object val1 = values != null && values.length > 0 ? values[0] : null;
+        Object val2 = values != null && values.length > 1 ? values[1] : null;
+        return betweenIfPresent(column, val1, val2);
     }
 
     // ========== 重写父类方法，方便链式调用 ==========
diff --git a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtils.java b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtils.java
index ab4612c..1cdf7f1 100644
--- a/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtils.java
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/src/main/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtils.java
@@ -24,6 +24,8 @@ import java.util.ArrayList;
 import java.util.Collection;
 import java.util.List;
 import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+import java.util.stream.IntStream;
 
 /**
  * MyBatis 工具类
@@ -179,6 +181,28 @@ public class MyBatisUtils {
         return findInSet(columnName, paramIndex);
     }
 
+    /**
+     * 跨数据库的 find_in_set 实现，适用于同一字段匹配多个参数的场景
+     *
+     * 每个参数生成一个 find_in_set 条件，并使用 OR 连接。
+     *
+     * @param columnName 字段名称
+     * @param values 参数集合
+     * @return sql
+     */
+    public static String findInSet(String columnName, Collection<?> values) {
+        return findInSet(JdbcUtils.getDbType(), columnName, values);
+    }
+
+    static String findInSet(DbType dbType, String columnName, Collection<?> values) {
+        if (CollUtil.isEmpty(values)) {
+            throw new IllegalArgumentException("Values cannot be empty");
+        }
+        return IntStream.range(0, values.size())
+                .mapToObj(index -> findInSet(dbType, columnName, index))
+                .collect(Collectors.joining(" OR "));
+    }
+
     private static String findInSet(String columnName, int paramIndex) {
         DbType dbType = JdbcUtils.getDbType();
         return findInSet(dbType, columnName, paramIndex);
diff --git a/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/query/LambdaQueryWrapperXTest.java b/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/query/LambdaQueryWrapperXTest.java
new file mode 100644
index 0000000..e708e96
--- /dev/null
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/query/LambdaQueryWrapperXTest.java
@@ -0,0 +1,67 @@
+package cn.iocoder.yudao.framework.mybatis.core.query;
+
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.core.MybatisConfiguration;
+import com.baomidou.mybatisplus.core.metadata.TableInfoHelper;
+import lombok.Data;
+import org.apache.ibatis.builder.MapperBuilderAssistant;
+import org.junit.jupiter.api.BeforeAll;
+import org.junit.jupiter.api.Test;
+
+import java.time.LocalDateTime;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * {@link LambdaQueryWrapperX} 的单元测试
+ *
+ * @author 芋道源码
+ */
+public class LambdaQueryWrapperXTest {
+
+    @BeforeAll
+    public static void initTableInfo() {
+        TableInfoHelper.initTableInfo(new MapperBuilderAssistant(new MybatisConfiguration(), ""), TestDO.class);
+    }
+
+    @Test
+    public void testBetweenIfPresent_overlap() {
+        // 调用，并断言：空范围不追加条件
+        assertEquals("", new LambdaQueryWrapperX<TestDO>()
+                .betweenIfPresent(TestDO::getStartTime, TestDO::getEndTime, null)
+                .getSqlSegment());
+
+        // 调用，并断言：双边范围使用闭区间重叠条件
+        LocalDateTime beginTime = LocalDateTime.of(2026, 8, 1, 0, 0);
+        LocalDateTime endTime = LocalDateTime.of(2026, 8, 31, 23, 59);
+        String sqlSegment = new LambdaQueryWrapperX<TestDO>()
+                .betweenIfPresent(TestDO::getStartTime, TestDO::getEndTime,
+                        new LocalDateTime[]{beginTime, endTime})
+                .getSqlSegment();
+        assertTrue(sqlSegment.contains("start_time <="));
+        assertTrue(sqlSegment.contains("end_time >="));
+
+        // 调用，并断言：单边范围只追加对应的重叠边界
+        sqlSegment = new LambdaQueryWrapperX<TestDO>()
+                .betweenIfPresent(TestDO::getStartTime, TestDO::getEndTime,
+                        new LocalDateTime[]{beginTime})
+                .getSqlSegment();
+        assertTrue(sqlSegment.contains("end_time >="));
+        sqlSegment = new LambdaQueryWrapperX<TestDO>()
+                .betweenIfPresent(TestDO::getStartTime, TestDO::getEndTime,
+                        new LocalDateTime[]{null, endTime})
+                .getSqlSegment();
+        assertTrue(sqlSegment.contains("start_time <="));
+    }
+
+    @Data
+    @TableName("test_data")
+    private static class TestDO {
+
+        private LocalDateTime startTime;
+        private LocalDateTime endTime;
+
+    }
+
+}
diff --git a/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/query/QueryWrapperXTest.java b/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/query/QueryWrapperXTest.java
new file mode 100644
index 0000000..09a2674
--- /dev/null
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/query/QueryWrapperXTest.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.framework.mybatis.core.query;
+
+import org.junit.jupiter.api.Test;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * {@link QueryWrapperX} 的单元测试
+ *
+ * @author 芋道源码
+ */
+public class QueryWrapperXTest {
+
+    @Test
+    public void testBetweenIfPresent_array() {
+        // 调用，并断言：空范围不追加条件
+        assertEquals("", new QueryWrapperX<>().betweenIfPresent("create_time", (Object[]) null).getSqlSegment());
+        assertEquals("", new QueryWrapperX<>().betweenIfPresent("create_time", new Object[0]).getSqlSegment());
+
+        // 调用，并断言：单边范围安全降级为大于等于或小于等于
+        assertTrue(new QueryWrapperX<>().betweenIfPresent("create_time", new Object[]{1})
+                .getSqlSegment().contains("create_time >="));
+        assertTrue(new QueryWrapperX<>().betweenIfPresent("create_time", new Object[]{null, 2})
+                .getSqlSegment().contains("create_time <="));
+
+        // 调用，并断言：双边范围使用左右闭合的 BETWEEN
+        assertTrue(new QueryWrapperX<>().betweenIfPresent("create_time", new Object[]{1, 2})
+                .getSqlSegment().contains("create_time BETWEEN"));
+    }
+
+}
diff --git a/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtilsTest.java b/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtilsTest.java
index abe8891..b74558c 100644
--- a/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtilsTest.java
+++ b/yudao-framework/yudao-spring-boot-starter-mybatis/src/test/java/cn/iocoder/yudao/framework/mybatis/core/util/MyBatisUtilsTest.java
@@ -10,6 +10,7 @@ import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
 import org.junit.jupiter.api.Test;
 
 import java.util.Arrays;
+import java.util.Collections;
 import java.util.List;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
@@ -129,6 +130,14 @@ public class MyBatisUtilsTest {
     }
 
     @Test
+    public void testFindInSet_multipleValues() {
+        assertEquals("FIND_IN_SET({0}, tag_ids) <> 0 OR FIND_IN_SET({1}, tag_ids) <> 0",
+                MyBatisUtils.findInSet(DbType.MYSQL, "tag_ids", Arrays.asList(1L, 2L)));
+        assertThrows(IllegalArgumentException.class,
+                () -> MyBatisUtils.findInSet(DbType.MYSQL, "tag_ids", Collections.emptyList()));
+    }
+
+    @Test
     public void testFindInSet_applyBindsValue() {
         // 准备参数
         QueryWrapper<Object> query = new QueryWrapper<>();
diff --git a/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApi.java b/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApi.java
index b8ccad6..7f1b9cf 100644
--- a/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApi.java
+++ b/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApi.java
@@ -19,6 +19,13 @@ public interface BpmProcessInstanceApi {
      */
     String createProcessInstance(Long userId, @Valid BpmProcessInstanceCreateReqDTO reqDTO);
 
-
+    /**
+     * 发起人取消运行中的流程实例（提供给内部）
+     *
+     * @param userId 发起人用户编号
+     * @param processInstanceId 流程实例编号
+     * @param reason 取消原因
+     */
+    void cancelProcessInstanceByStartUser(Long userId, String processInstanceId, String reason);
 
 }
diff --git a/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApiImpl.java b/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApiImpl.java
index 5ebb12f..5377314 100644
--- a/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApiImpl.java
+++ b/yudao-module-bpm/src/main/java/cn/iocoder/yudao/module/bpm/api/task/BpmProcessInstanceApiImpl.java
@@ -1,6 +1,7 @@
 package cn.iocoder.yudao.module.bpm.api.task;
 
 import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO;
+import cn.iocoder.yudao.module.bpm.controller.admin.task.vo.instance.BpmProcessInstanceCancelReqVO;
 import cn.iocoder.yudao.module.bpm.service.task.BpmProcessInstanceService;
 import jakarta.annotation.Resource;
 import jakarta.validation.Valid;
@@ -25,4 +26,10 @@ public class BpmProcessInstanceApiImpl implements BpmProcessInstanceApi {
         return processInstanceService.createProcessInstance(userId, reqDTO);
     }
 
+    @Override
+    public void cancelProcessInstanceByStartUser(Long userId, String processInstanceId, String reason) {
+        processInstanceService.cancelProcessInstanceByStartUser(userId,
+                new BpmProcessInstanceCancelReqVO().setId(processInstanceId).setReason(reason));
+    }
+
 }
diff --git a/yudao-module-fms/pom.xml b/yudao-module-fms/pom.xml
new file mode 100644
index 0000000..dc91b66
--- /dev/null
+++ b/yudao-module-fms/pom.xml
@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    <parent>
+        <groupId>cn.iocoder.boot</groupId>
+        <artifactId>yudao</artifactId>
+        <version>${revision}</version>
+    </parent>
+
+    <artifactId>yudao-module-fms</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>
+        fms 包下，财务管理（Financial Management System）
+        例如说：凭证、账簿、报表、结账等等
+    </description>
+
+    <dependencies>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-system</artifactId>
+            <version>${revision}</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-infra</artifactId>
+            <version>${revision}</version>
+        </dependency>
+
+        <!-- Web 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-web</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-security</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-excel</artifactId>
+        </dependency>
+
+        <!-- DB 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-mybatis</artifactId>
+        </dependency>
+
+        <!-- 现金流量表公式计算 -->
+        <dependency>
+            <groupId>com.googlecode.aviator</groupId>
+            <artifactId>aviator</artifactId>
+        </dependency>
+
+        <!-- Test 测试相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+</project>
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingPeriodController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingPeriodController.java
new file mode 100644
index 0000000..c93d72d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingPeriodController.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingOverviewRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 结账期间")
+@RestController
+@RequestMapping("/fms/closing/period")
+@Validated
+public class FmsClosingPeriodController {
+
+    @Resource
+    private FmsClosingPeriodService closingPeriodService;
+
+    @GetMapping("/current-month")
+    @Operation(summary = "获得当前会计期间")
+    public CommonResult<String> getCurrentMonth(@RequestParam("accountSetId") @NotNull Long accountSetId) {
+        return success(closingPeriodService.getCurrentMonth(accountSetId, getLoginUserId()));
+    }
+
+    @GetMapping("/overview")
+    @Operation(summary = "获得结账概况")
+    @PreAuthorize("@ss.hasPermission('fms:closing:query')")
+    public CommonResult<FmsClosingOverviewRespVO> getClosingOverview(@Valid FmsClosingQueryReqVO queryReqVO) {
+        return success(closingPeriodService.getClosingOverview(queryReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/close")
+    @Operation(summary = "结账")
+    @PreAuthorize("@ss.hasPermission('fms:closing:close')")
+    public CommonResult<Boolean> closePeriod(@Valid @RequestBody FmsClosingQueryReqVO queryReqVO) {
+        closingPeriodService.closePeriod(queryReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/cancel")
+    @Operation(summary = "反结账")
+    @PreAuthorize("@ss.hasPermission('fms:closing:cancel')")
+    public CommonResult<Boolean> cancelClosePeriod(@Valid FmsClosingQueryReqVO queryReqVO) {
+        closingPeriodService.cancelClosePeriod(queryReqVO, getLoginUserId());
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingSchemeController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingSchemeController.java
new file mode 100644
index 0000000..5e95e44
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingSchemeController.java
@@ -0,0 +1,86 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossSettingsSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsSpecialClosingSettingsSaveReqVO;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 结账方案")
+@RestController
+@RequestMapping("/fms/closing/scheme")
+@Validated
+public class FmsClosingSchemeController {
+
+    @Resource
+    private FmsClosingSchemeService closingSchemeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得结账方案列表")
+    @PreAuthorize("@ss.hasPermission('fms:closing:query')")
+    public CommonResult<List<FmsClosingSchemeRespVO>> getClosingSchemeList(@Valid FmsClosingQueryReqVO queryReqVO) {
+        return success(closingSchemeService.getClosingSchemeList(queryReqVO, getLoginUserId()));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建结账方案")
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Long> createClosingScheme(@Valid @RequestBody FmsClosingSchemeSaveReqVO createReqVO) {
+        return success(closingSchemeService.createClosingScheme(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改结账方案")
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Boolean> updateClosingScheme(@Valid @RequestBody FmsClosingSchemeSaveReqVO updateReqVO) {
+        closingSchemeService.updateClosingScheme(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/update-profit-loss-settings")
+    @Operation(summary = "保存结转损益设置")
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Long> saveProfitLossSettings(@Valid @RequestBody FmsProfitLossSettingsSaveReqVO saveReqVO) {
+        return success(closingSchemeService.saveProfitLossSettings(saveReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update-special-settings")
+    @Operation(summary = "保存专用结转设置")
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Boolean> updateSpecialClosingSettings(@Valid @RequestBody FmsSpecialClosingSettingsSaveReqVO updateReqVO) {
+        closingSchemeService.updateSpecialClosingSettings(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除结账方案")
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Boolean> deleteClosingScheme(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                     @RequestParam("id") @NotNull Long id) {
+        closingSchemeService.deleteClosingScheme(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingTemplateController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingTemplateController.java
new file mode 100644
index 0000000..9fb6dc1
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingTemplateController.java
@@ -0,0 +1,78 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingTemplateRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingTemplateSaveReqVO;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingTemplateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 结账模板")
+@RestController
+@RequestMapping("/fms/closing/template")
+@Validated
+public class FmsClosingTemplateController {
+
+    @Resource
+    private FmsClosingTemplateService closingTemplateService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得结账模板列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:closing:query')")
+    public CommonResult<List<FmsClosingTemplateRespVO>> getClosingTemplateList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        return success(closingTemplateService.getClosingTemplateList(accountSetId, getLoginUserId()));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建结账模板")
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Long> createClosingTemplate(
+            @Valid @RequestBody FmsClosingTemplateSaveReqVO createReqVO) {
+        return success(closingTemplateService.createClosingTemplate(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新结账模板")
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Boolean> updateClosingTemplate(
+            @Valid @RequestBody FmsClosingTemplateSaveReqVO updateReqVO) {
+        closingTemplateService.updateClosingTemplate(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除结账模板")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "id", description = "结账模板编号", required = true, example = "1024")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:closing:update')")
+    public CommonResult<Boolean> deleteClosingTemplate(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                       @RequestParam("id") @NotNull Long id) {
+        closingTemplateService.deleteClosingTemplate(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingVoucherController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingVoucherController.java
new file mode 100644
index 0000000..4aa1d3b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/FmsClosingVoucherController.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingVoucherGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossGenerateReqVO;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 结转凭证")
+@RestController
+@RequestMapping("/fms/closing/voucher")
+@Validated
+public class FmsClosingVoucherController {
+
+    @Resource
+    private FmsClosingVoucherService closingVoucherService;
+
+    @PostMapping("/generate-profit-loss")
+    @Operation(summary = "生成结转损益凭证")
+    @PreAuthorize("@ss.hasPermission('fms:closing:profit-loss')")
+    public CommonResult<Long> generateProfitLossVoucher(@Valid @RequestBody FmsProfitLossGenerateReqVO generateReqVO) {
+        return success(closingVoucherService.generateProfitLossVoucher(generateReqVO, getLoginUserId()));
+    }
+
+    @PostMapping("/generate-scheme")
+    @Operation(summary = "生成结账方案凭证")
+    @PreAuthorize("@ss.hasPermission('fms:closing:profit-loss')")
+    public CommonResult<Long> generateClosingSchemeVoucher(@Valid @RequestBody FmsClosingSchemeGenerateReqVO generateReqVO) {
+        return success(closingVoucherService.generateClosingSchemeVoucher(generateReqVO, getLoginUserId()));
+    }
+
+    @PostMapping("/generate-list")
+    @Operation(summary = "批量生成结转凭证")
+    @PreAuthorize("@ss.hasPermission('fms:closing:profit-loss')")
+    public CommonResult<List<Long>> generateClosingVoucherList(@Valid @RequestBody FmsClosingVoucherGenerateReqVO generateReqVO) {
+        return success(closingVoucherService.generateClosingVoucherList(generateReqVO, getLoginUserId()));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingOverviewRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingOverviewRespVO.java
new file mode 100644
index 0000000..e12f59f
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingOverviewRespVO.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 结账概况 Response VO")
+@Data
+public class FmsClosingOverviewRespVO {
+
+    @Schema(description = "会计期间", example = "2026-08")
+    private String month;
+
+    @Schema(description = "是否已结账")
+    private Boolean closed;
+
+    @Schema(description = "是否要求凭证审核")
+    private Boolean voucherReviewRequired;
+
+    @Schema(description = "未审核凭证数量", example = "2")
+    private Long pendingVoucherCount;
+
+    @Schema(description = "凭证数量", example = "12")
+    private Long voucherCount;
+
+    @Schema(description = "损益类科目余额", example = "9100.00")
+    private BigDecimal profitLossBalance;
+
+    @Schema(description = "资产负债表差额", example = "0.00")
+    private BigDecimal balanceSheetDifference;
+
+    @Schema(description = "结转损益凭证编号", example = "1024")
+    private Long profitLossVoucherId;
+
+    @Schema(description = "初始余额是否试算平衡")
+    private Boolean initialBalanceBalanced;
+
+    @Schema(description = "凭证编号是否连续")
+    private Boolean voucherNumberContinuous;
+
+    @Schema(description = "需要结转损益时是否已生成凭证")
+    private Boolean profitLossVoucherGenerated;
+
+    @Schema(description = "利润表勾稽是否平衡")
+    private Boolean incomeStatementBalanced;
+
+    @Schema(description = "利润表未纳入公式的科目数量", example = "0")
+    private Integer incomeStatementUnmappedSubjectCount;
+
+    @Schema(description = "资产负债表损益是否已结转")
+    private Boolean balanceSheetProfitLossTransferred;
+
+    @Schema(description = "资产负债表是否平衡")
+    private Boolean balanceSheetBalanced;
+
+    @Schema(description = "资产负债表未纳入公式的科目数量", example = "0")
+    private Integer balanceSheetUnmappedSubjectCount;
+
+    @Schema(description = "是否满足全部结账条件")
+    private Boolean canClose;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingQueryReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingQueryReqVO.java
new file mode 100644
index 0000000..04e1521
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingQueryReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 结账查询 Request VO")
+@Data
+public class FmsClosingQueryReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "目标会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotBlank(message = "会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "会计期间格式不正确")
+    private String month;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeGenerateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeGenerateReqVO.java
new file mode 100644
index 0000000..14cfa82
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeGenerateReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 结账方案生成凭证 Request VO")
+@Data
+public class FmsClosingSchemeGenerateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "方案编号不能为空")
+    private Long id;
+
+    @Schema(description = "会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotBlank(message = "会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "会计期间格式不正确")
+    private String month;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeRespVO.java
new file mode 100644
index 0000000..30c3e58
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeRespVO.java
@@ -0,0 +1,90 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 结账方案 Response VO")
+@Data
+public class FmsClosingSchemeRespVO {
+
+    @Schema(description = "方案编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", example = "1")
+    private Long accountSetId;
+
+    @Schema(description = "方案名称", example = "结转本月房租")
+    private String name;
+
+    @Schema(description = "是否期末结转")
+    private Boolean periodEnd;
+
+    @Schema(description = "来源科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "取数规则", example = "0")
+    private Integer formulaRule;
+
+    @Schema(description = "取数时间类型", example = "1")
+    private Integer timeType;
+
+    @Schema(description = "凭证字编号", example = "11")
+    private Long voucherWordId;
+
+    @Schema(description = "凭证摘要", example = "结转损益")
+    private String digest;
+
+    @Schema(description = "结转凭证类型", example = "2")
+    private Integer voucherType;
+
+    @Schema(description = "以前年度损益调整科目编号", example = "1024")
+    private Long priorYearAdjustmentSubjectId;
+
+    @Schema(description = "以前年度损益调整结转科目编号", example = "1025")
+    private Long adjustmentClosingSubjectId;
+
+    @Schema(description = "其他损益结转科目编号", example = "1026")
+    private Long otherClosingSubjectId;
+
+    @Schema(description = "是否按余额反向结转")
+    private Boolean reverseBalance;
+
+    @Schema(description = "结转日期", example = "31")
+    private Integer closingDay;
+
+    @Schema(description = "类型", example = "1")
+    private Integer type;
+
+    @Schema(description = "结转科目规则数组")
+    private List<SubjectRule> subjects;
+
+    @Schema(description = "待结转金额", example = "12000.00")
+    private BigDecimal balance;
+
+    @Schema(description = "当前期间已生成凭证编号数组")
+    private List<Long> voucherIds;
+
+    @Schema(description = "管理后台 - FMS 结账方案科目规则")
+    @Data
+    public static class SubjectRule {
+
+        @Schema(description = "科目编号", example = "1024")
+        private Long subjectId;
+
+        @Schema(description = "科目编码快照", example = "6602")
+        private String subjectCode;
+
+        @Schema(description = "摘要", example = "结转本月房租")
+        private String digest;
+
+        @Schema(description = "借贷方向", example = "1")
+        private Integer direction;
+
+        @Schema(description = "金额比例", example = "100")
+        private BigDecimal amountRatio;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeSaveReqVO.java
new file mode 100644
index 0000000..80d6b9f
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingSchemeSaveReqVO.java
@@ -0,0 +1,89 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 结账方案保存 Request VO")
+@Data
+public class FmsClosingSchemeSaveReqVO {
+
+    @Schema(description = "方案编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "方案名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "结转本月房租")
+    @NotBlank(message = "方案名称不能为空")
+    @Size(max = 255, message = "方案名称长度不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "是否期末结转", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "是否期末结转不能为空")
+    private Boolean periodEnd;
+
+    @Schema(description = "来源科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "来源科目不能为空")
+    private Long subjectId;
+
+    @Schema(description = "取数规则", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "取数规则不能为空")
+    @InEnum(FmsFormulaRuleEnum.class)
+    private Integer formulaRule;
+
+    @Schema(description = "取数时间类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "取数时间类型不能为空")
+    @InEnum(FmsClosingTimeTypeEnum.class)
+    private Integer timeType;
+
+    @Schema(description = "凭证字编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+    @NotNull(message = "凭证字不能为空")
+    private Long voucherWordId;
+
+    @Schema(description = "结转科目规则数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "结转科目规则不能为空")
+    @Size(min = 2, message = "结转科目规则至少需要两条")
+    private List<SubjectRule> subjects;
+
+    @Schema(description = "管理后台 - FMS 结账方案科目规则")
+    @Data
+    public static class SubjectRule {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "科目不能为空")
+        private Long subjectId;
+
+        @Schema(description = "摘要", requiredMode = Schema.RequiredMode.REQUIRED, example = "结转本月房租")
+        @NotBlank(message = "摘要不能为空")
+        @Size(max = 500, message = "摘要长度不能超过 500 个字符")
+        private String digest;
+
+        @Schema(description = "借贷方向", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "借贷方向不能为空")
+        @InEnum(FmsDebitCreditDirectionEnum.class)
+        private Integer direction;
+
+        @Schema(description = "金额比例", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+        @NotNull(message = "金额比例不能为空")
+        @DecimalMin(value = "0", inclusive = false, message = "金额比例必须大于 0")
+        @DecimalMax(value = "100", message = "金额比例不能超过 100")
+        private BigDecimal amountRatio;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingTemplateRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingTemplateRespVO.java
new file mode 100644
index 0000000..0789aad
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingTemplateRespVO.java
@@ -0,0 +1,70 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 结账模板 Response VO")
+@Data
+public class FmsClosingTemplateRespVO {
+
+    @Schema(description = "模板编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long accountSetId;
+
+    @Schema(description = "系统预置编码", example = "daily-travel-reimbursement")
+    private String presetCode;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "报销差旅费")
+    private String name;
+
+    @Schema(description = "模板分类", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer category;
+
+    @Schema(description = "是否期末结转", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean periodEnd;
+
+    @Schema(description = "来源科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "取数规则", example = "0")
+    private Integer formulaRule;
+
+    @Schema(description = "取数时间类型", example = "1")
+    private Integer timeType;
+
+    @Schema(description = "结转科目规则数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<SubjectRule> subjects;
+
+    @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    @Schema(description = "管理后台 - FMS 结账模板科目规则")
+    @Data
+    public static class SubjectRule {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long subjectId;
+
+        @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "560107")
+        private String subjectCode;
+
+        @Schema(description = "摘要", requiredMode = Schema.RequiredMode.REQUIRED, example = "报销差旅费")
+        private String digest;
+
+        @Schema(description = "借贷方向", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        private Integer direction;
+
+        @Schema(description = "金额比例", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+        private BigDecimal amountRatio;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingTemplateSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingTemplateSaveReqVO.java
new file mode 100644
index 0000000..af914a3
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingTemplateSaveReqVO.java
@@ -0,0 +1,92 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTemplateCategoryEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 结账模板保存 Request VO")
+@Data
+public class FmsClosingTemplateSaveReqVO {
+
+    @Schema(description = "模板编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "报销差旅费")
+    @NotBlank(message = "模板名称不能为空")
+    @Size(max = 255, message = "模板名称长度不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "模板分类", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "模板分类不能为空")
+    @InEnum(FmsClosingTemplateCategoryEnum.class)
+    private Integer category;
+
+    @Schema(description = "是否期末结转", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "是否期末结转不能为空")
+    private Boolean periodEnd;
+
+    @Schema(description = "来源科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "取数规则", example = "0")
+    @InEnum(FmsFormulaRuleEnum.class)
+    private Integer formulaRule;
+
+    @Schema(description = "取数时间类型", example = "1")
+    @InEnum(FmsClosingTimeTypeEnum.class)
+    private Integer timeType;
+
+    @Schema(description = "结转科目规则数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "结转科目规则不能为空")
+    @Size(min = 2, message = "结转科目规则至少需要两条")
+    private List<SubjectRule> subjects;
+
+    @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @NotNull(message = "显示顺序不能为空")
+    private Integer sort;
+
+    @Schema(description = "管理后台 - FMS 结账模板科目规则")
+    @Data
+    public static class SubjectRule {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "科目不能为空")
+        private Long subjectId;
+
+        @Schema(description = "摘要", requiredMode = Schema.RequiredMode.REQUIRED, example = "报销差旅费")
+        @NotBlank(message = "摘要不能为空")
+        @Size(max = 500, message = "摘要长度不能超过 500 个字符")
+        private String digest;
+
+        @Schema(description = "借贷方向", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "借贷方向不能为空")
+        @InEnum(FmsDebitCreditDirectionEnum.class)
+        private Integer direction;
+
+        @Schema(description = "金额比例", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+        @NotNull(message = "金额比例不能为空")
+        @DecimalMin(value = "0", inclusive = false, message = "金额比例必须大于 0")
+        @DecimalMax(value = "100", message = "金额比例不能超过 100")
+        private BigDecimal amountRatio;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingVoucherGenerateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingVoucherGenerateReqVO.java
new file mode 100644
index 0000000..36970d8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsClosingVoucherGenerateReqVO.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 批量生成结转凭证 Request VO")
+@Data
+public class FmsClosingVoucherGenerateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "方案编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "方案编号不能为空")
+    private List<@NotNull(message = "方案编号不能为空") Long> ids;
+
+    @Schema(description = "会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotBlank(message = "会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "会计期间格式不正确")
+    private String month;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsProfitLossGenerateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsProfitLossGenerateReqVO.java
new file mode 100644
index 0000000..d48e181
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsProfitLossGenerateReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 生成结转损益凭证 Request VO")
+@Data
+public class FmsProfitLossGenerateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotBlank(message = "会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "会计期间格式不正确")
+    private String month;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsProfitLossSettingsSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsProfitLossSettingsSaveReqVO.java
new file mode 100644
index 0000000..85e5908
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsProfitLossSettingsSaveReqVO.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingVoucherTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 结转损益设置保存 Request VO")
+@Data
+public class FmsProfitLossSettingsSaveReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "凭证字编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+    @NotNull(message = "凭证字不能为空")
+    private Long voucherWordId;
+
+    @Schema(description = "凭证摘要", requiredMode = Schema.RequiredMode.REQUIRED, example = "结转损益")
+    @NotBlank(message = "凭证摘要不能为空")
+    @Size(max = 500, message = "凭证摘要长度不能超过 500 个字符")
+    private String digest;
+
+    @Schema(description = "结转凭证类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "结转凭证类型不能为空")
+    @InEnum(FmsClosingVoucherTypeEnum.class)
+    private Integer voucherType;
+
+    @Schema(description = "以前年度损益调整科目编号", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "1024")
+    @NotNull(message = "以前年度损益调整科目不能为空")
+    private Long priorYearAdjustmentSubjectId;
+
+    @Schema(description = "以前年度损益调整结转科目编号", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "1025")
+    @NotNull(message = "以前年度损益调整结转科目不能为空")
+    private Long adjustmentClosingSubjectId;
+
+    @Schema(description = "其他损益结转科目编号", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "1026")
+    @NotNull(message = "其他损益结转科目不能为空")
+    private Long otherClosingSubjectId;
+
+    @Schema(description = "是否按余额反向结转", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "结转方式不能为空")
+    private Boolean reverseBalance;
+
+    @Schema(description = "结转日期", requiredMode = Schema.RequiredMode.REQUIRED, example = "31")
+    @NotNull(message = "结转日期不能为空")
+    @Min(value = 1, message = "结转日期不能小于 1")
+    @Max(value = 31, message = "结转日期不能大于 31")
+    private Integer closingDay;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsSpecialClosingSettingsSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsSpecialClosingSettingsSaveReqVO.java
new file mode 100644
index 0000000..5e19ab5
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/closing/vo/FmsSpecialClosingSettingsSaveReqVO.java
@@ -0,0 +1,65 @@
+package cn.iocoder.yudao.module.fms.controller.admin.closing.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 专用结转设置保存 Request VO")
+@Data
+public class FmsSpecialClosingSettingsSaveReqVO {
+
+    @Schema(description = "方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "方案编号不能为空")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "凭证字编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+    @NotNull(message = "凭证字不能为空")
+    private Long voucherWordId;
+
+    @Schema(description = "结转科目规则数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "结转科目规则不能为空")
+    @Size(min = 2, message = "结转科目规则至少需要两条")
+    private List<SubjectRule> subjects;
+
+    @Schema(description = "管理后台 - FMS 专用结转科目规则")
+    @Data
+    public static class SubjectRule {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "科目不能为空")
+        private Long subjectId;
+
+        @Schema(description = "摘要", requiredMode = Schema.RequiredMode.REQUIRED, example = "计提所得税")
+        @NotBlank(message = "摘要不能为空")
+        @Size(max = 500, message = "摘要长度不能超过 500 个字符")
+        private String digest;
+
+        @Schema(description = "借贷方向", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "借贷方向不能为空")
+        @InEnum(FmsDebitCreditDirectionEnum.class)
+        private Integer direction;
+
+        @Schema(description = "金额比例", requiredMode = Schema.RequiredMode.REQUIRED, example = "25")
+        @NotNull(message = "金额比例不能为空")
+        @DecimalMin(value = "0", inclusive = false, message = "金额比例必须大于 0")
+        @DecimalMax(value = "100", message = "金额比例不能超过 100")
+        private BigDecimal amountRatio;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAccountSetController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAccountSetController.java
new file mode 100644
index 0000000..d139d75
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAccountSetController.java
@@ -0,0 +1,105 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetInitializeReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountUserService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 账套")
+@RestController
+@RequestMapping("/fms/config/account-set")
+@Validated
+public class FmsAccountSetController {
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsAccountUserService accountUserService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建账套")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:create')")
+    public CommonResult<Long> createAccountSet(@Valid @RequestBody FmsAccountSetSaveReqVO createReqVO) {
+        return success(accountSetService.createAccountSet(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新账套")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:update')")
+    public CommonResult<Boolean> updateAccountSet(@Valid @RequestBody FmsAccountSetSaveReqVO updateReqVO) {
+        accountSetService.updateAccountSet(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/initialize")
+    @Operation(summary = "初始化账套")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:initialize')")
+    public CommonResult<Boolean> initializeAccountSet(
+            @Valid @RequestBody FmsAccountSetInitializeReqVO initializeReqVO) {
+        accountSetService.initializeAccountSet(initializeReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得账套")
+    @Parameter(name = "id", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:query')")
+    public CommonResult<FmsAccountSetRespVO> getAccountSet(@RequestParam("id") Long id) {
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(id, getLoginUserId());
+        FmsAccountUserDO accountUser = accountUserService.getAccountUser(id, getLoginUserId());
+        return success(buildAccountSetRespVO(accountSet, accountUser));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得当前用户账套列表")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:query')")
+    public CommonResult<List<FmsAccountSetRespVO>> getAccountSetList() {
+        List<FmsAccountUserDO> accountUsers = accountUserService.getAccountUserList(getLoginUserId());
+        Map<Long, FmsAccountSetDO> accountSetMap = accountSetService.getAccountSetMap(
+                convertSet(accountUsers, FmsAccountUserDO::getAccountSetId));
+        return success(buildAccountSetRespVOList(accountSetMap, accountUsers));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private FmsAccountSetRespVO buildAccountSetRespVO(
+            FmsAccountSetDO accountSet, FmsAccountUserDO accountUser) {
+        return BeanUtils.toBean(accountSet, FmsAccountSetRespVO.class)
+                .setDefaultStatus(accountUser.getDefaultStatus()).setFounder(accountUser.getFounder())
+                .setLevel(accountUser.getLevel());
+    }
+
+    private List<FmsAccountSetRespVO> buildAccountSetRespVOList(
+            Map<Long, FmsAccountSetDO> accountSetMap, List<FmsAccountUserDO> accountUsers) {
+        return convertList(accountUsers, accountUser -> buildAccountSetRespVO(
+                accountSetMap.get(accountUser.getAccountSetId()), accountUser));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAccountUserController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAccountUserController.java
new file mode 100644
index 0000000..d055ab7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAccountUserController.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountuser.FmsAccountUserRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountuser.FmsAccountUserUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountUserService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.MapUtils.findAndThen;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 账套用户")
+@RestController
+@RequestMapping("/fms/config/account-user")
+@Validated
+public class FmsAccountUserController {
+
+    @Resource
+    private FmsAccountUserService accountUserService;
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private DeptApi deptApi;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得账套用户列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:authorize')")
+    public CommonResult<List<FmsAccountUserRespVO>> getAccountUserList(
+            @RequestParam("accountSetId") Long accountSetId) {
+        List<FmsAccountUserDO> accountUsers = accountUserService.getAccountUserList(
+                accountSetId, getLoginUserId());
+        return success(buildAccountUserRespVOList(accountUsers));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新账套用户列表")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:authorize')")
+    public CommonResult<Boolean> updateAccountUserList(
+            @Valid @RequestBody FmsAccountUserUpdateReqVO updateReqVO) {
+        accountUserService.updateAccountUserList(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/update-default-status")
+    @Operation(summary = "更新默认账套状态")
+    @PreAuthorize("@ss.hasPermission('fms:config:account-set:query')")
+    public CommonResult<Boolean> updateAccountSetDefaultStatus(@RequestParam("accountSetId") Long accountSetId) {
+        accountUserService.updateAccountSetDefaultStatus(accountSetId, getLoginUserId());
+        return success(true);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<FmsAccountUserRespVO> buildAccountUserRespVOList(List<FmsAccountUserDO> accountUsers) {
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(accountUsers, FmsAccountUserDO::getUserId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(userMap.values(), AdminUserRespDTO::getDeptId));
+        return convertList(accountUsers, accountUser -> {
+            FmsAccountUserRespVO respVO = BeanUtils.toBean(accountUser, FmsAccountUserRespVO.class);
+            findAndThen(userMap, accountUser.getUserId(), user -> {
+                respVO.setNickname(user.getNickname()).setMobile(user.getMobile())
+                        .setEmail(user.getEmail()).setStatus(user.getStatus());
+                findAndThen(deptMap, user.getDeptId(), dept -> respVO.setDeptName(dept.getName()));
+            });
+            return respVO;
+        });
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAuxiliaryItemController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAuxiliaryItemController.java
new file mode 100644
index 0000000..9abc515
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAuxiliaryItemController.java
@@ -0,0 +1,228 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemStatusReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryItemService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 辅助核算项目")
+@RestController
+@RequestMapping("/fms/config/auxiliary-item")
+@Validated
+public class FmsAuxiliaryItemController {
+
+    @Resource
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建辅助核算项目")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:create')")
+    public CommonResult<Long> createAuxiliaryItem(@Valid @RequestBody FmsAuxiliaryItemSaveReqVO createReqVO) {
+        return success(auxiliaryItemService.createAuxiliaryItem(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新辅助核算项目")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:update')")
+    public CommonResult<Boolean> updateAuxiliaryItem(
+            @Valid @RequestBody FmsAuxiliaryItemSaveReqVO updateReqVO) {
+        auxiliaryItemService.updateAuxiliaryItem(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "删除辅助核算项目")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "ids", description = "辅助核算项目编号数组", required = true, example = "[1024]")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:delete')")
+    public CommonResult<Boolean> deleteAuxiliaryItemList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("ids") @NotEmpty List<Long> ids) {
+        auxiliaryItemService.deleteAuxiliaryItemList(accountSetId, ids, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/update-status")
+    @Operation(summary = "更新辅助核算项目状态")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:update')")
+    public CommonResult<Boolean> updateAuxiliaryItemStatus(
+            @Valid @RequestBody FmsAuxiliaryItemStatusReqVO reqVO) {
+        auxiliaryItemService.updateAuxiliaryItemStatus(
+                reqVO.getAccountSetId(), reqVO.getId(), reqVO.getStatus(), getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得辅助核算项目")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "id", description = "辅助核算项目编号", required = true, example = "1024")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:query')")
+    public CommonResult<FmsAuxiliaryItemRespVO> getAuxiliaryItem(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                                 @RequestParam("id") @NotNull Long id) {
+        FmsAuxiliaryItemDO item = auxiliaryItemService.getAuxiliaryItem(accountSetId, id, getLoginUserId());
+        return success(BeanUtils.toBean(item, FmsAuxiliaryItemRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得辅助核算项目分页")
+    @PreAuthorize("@ss.hasAnyPermissions('fms:config:auxiliary:query', 'fms:voucher:create', "
+            + "'fms:voucher:update')")
+    public CommonResult<PageResult<FmsAuxiliaryItemRespVO>> getAuxiliaryItemPage(
+            @Valid FmsAuxiliaryItemPageReqVO pageReqVO) {
+        PageResult<FmsAuxiliaryItemDO> pageResult = auxiliaryItemService
+                .getAuxiliaryItemPage(pageReqVO, getLoginUserId());
+        return success(BeanUtils.toBean(pageResult, FmsAuxiliaryItemRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得辅助核算项目精简列表", description = "只包含启用的项目，主要用于前端下拉选项")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "auxiliaryTypeId", description = "辅助核算类别编号", required = true,
+                    example = "1024")
+    })
+    public CommonResult<List<FmsAuxiliaryItemRespVO>> getAuxiliaryItemSimpleList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("auxiliaryTypeId") @NotNull Long auxiliaryTypeId) {
+        List<FmsAuxiliaryItemDO> list = auxiliaryItemService
+                .getAuxiliaryItemListByAccountSetIdAndAuxiliaryTypeIdAndStatus(
+                        accountSetId, auxiliaryTypeId, CommonStatusEnum.ENABLE.getStatus(), getLoginUserId());
+        return success(convertList(list, item -> new FmsAuxiliaryItemRespVO()
+                .setId(item.getId()).setCode(item.getCode()).setName(item.getName())));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出辅助核算项目")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportAuxiliaryItemExcel(
+            @Valid FmsAuxiliaryItemPageReqVO pageReqVO, HttpServletResponse response) throws IOException {
+        pageReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<FmsAuxiliaryItemDO> list = auxiliaryItemService
+                .getAuxiliaryItemPage(pageReqVO, getLoginUserId()).getList();
+        FmsAuxiliaryTypeDO auxiliaryType = auxiliaryTypeService.getAuxiliaryType(
+                pageReqVO.getAccountSetId(), pageReqVO.getAuxiliaryTypeId(), getLoginUserId());
+        ExcelUtils.write(response, auxiliaryType.getName() + ".xlsx", "辅助核算项目",
+                buildAuxiliaryItemExcelHead(auxiliaryType.getType()), buildAuxiliaryItemExcelData(list,
+                        auxiliaryType.getType()));
+    }
+
+    @GetMapping("/get-import-template")
+    @Operation(summary = "获得辅助核算项目导入模板")
+    @Parameter(name = "type", description = "辅助核算类别类型", required = true, example = "1")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getAuxiliaryItemImportTemplate(
+            @RequestParam("type") @InEnum(FmsAuxiliaryTypeEnum.class) Integer type,
+            HttpServletResponse response) throws IOException {
+        FmsAuxiliaryItemImportExcelVO example = new FmsAuxiliaryItemImportExcelVO()
+                .setCode("001").setName("示例项目").setRemark("示例备注");
+        if (FmsAuxiliaryTypeEnum.INVENTORY.getType().equals(type)) {
+            example.setSpecification("标准版").setUnit("个");
+        }
+        ExcelUtils.write(response, "辅助核算项目导入模板.xlsx", "辅助核算项目",
+                FmsAuxiliaryItemImportExcelVO.class, Collections.singletonList(example));
+    }
+
+    @PostMapping("/import")
+    @Operation(summary = "导入辅助核算项目")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true),
+            @Parameter(name = "auxiliaryTypeId", description = "辅助核算类别编号", required = true),
+            @Parameter(name = "file", description = "Excel 文件", required = true)
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<FmsAuxiliaryItemImportRespVO> importAuxiliaryItem(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("auxiliaryTypeId") @NotNull Long auxiliaryTypeId,
+            @RequestParam("file") MultipartFile file) throws Exception {
+        List<FmsAuxiliaryItemImportExcelVO> importItems = ExcelUtils.read(
+                file, FmsAuxiliaryItemImportExcelVO.class);
+        return success(auxiliaryItemService.importAuxiliaryItemList(
+                accountSetId, auxiliaryTypeId, importItems, getLoginUserId()));
+    }
+
+    /** 构建辅助核算项目导出的动态表头 */
+    private List<List<String>> buildAuxiliaryItemExcelHead(Integer type) {
+        if (FmsAuxiliaryTypeEnum.CUSTOMER.getType().equals(type)
+                || FmsAuxiliaryTypeEnum.SUPPLIER.getType().equals(type)) {
+            return Arrays.asList(Collections.singletonList("编码"), Collections.singletonList("名称"),
+                    Collections.singletonList("备注"));
+        }
+        if (FmsAuxiliaryTypeEnum.INVENTORY.getType().equals(type)) {
+            return Arrays.asList(Collections.singletonList("编码"), Collections.singletonList("名称"),
+                    Collections.singletonList("规格"), Collections.singletonList("单位"));
+        }
+        return Arrays.asList(Collections.singletonList("编码"), Collections.singletonList("名称"));
+    }
+
+    /** 构建辅助核算项目导出的动态数据 */
+    private List<List<Object>> buildAuxiliaryItemExcelData(List<FmsAuxiliaryItemDO> items, Integer type) {
+        List<List<Object>> rows = new ArrayList<>(items.size());
+        for (FmsAuxiliaryItemDO item : items) {
+            if (FmsAuxiliaryTypeEnum.CUSTOMER.getType().equals(type)
+                    || FmsAuxiliaryTypeEnum.SUPPLIER.getType().equals(type)) {
+                rows.add(Arrays.asList(item.getCode(), item.getName(), item.getRemark()));
+            } else if (FmsAuxiliaryTypeEnum.INVENTORY.getType().equals(type)) {
+                rows.add(Arrays.asList(item.getCode(), item.getName(), item.getSpecification(), item.getUnit()));
+            } else {
+                rows.add(Arrays.asList(item.getCode(), item.getName()));
+            }
+        }
+        return rows;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAuxiliaryTypeController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAuxiliaryTypeController.java
new file mode 100644
index 0000000..b44f548
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsAuxiliaryTypeController.java
@@ -0,0 +1,92 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliarytype.FmsAuxiliaryTypeRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliarytype.FmsAuxiliaryTypeSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 辅助核算类别")
+@RestController
+@RequestMapping("/fms/config/auxiliary-type")
+@Validated
+public class FmsAuxiliaryTypeController {
+
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建辅助核算类别")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:create')")
+    public CommonResult<Long> createAuxiliaryType(@Valid @RequestBody FmsAuxiliaryTypeSaveReqVO createReqVO) {
+        return success(auxiliaryTypeService.createAuxiliaryType(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新辅助核算类别")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:update')")
+    public CommonResult<Boolean> updateAuxiliaryType(@Valid @RequestBody FmsAuxiliaryTypeSaveReqVO updateReqVO) {
+        auxiliaryTypeService.updateAuxiliaryType(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除辅助核算类别")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "id", description = "辅助核算类别编号", required = true, example = "1024")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:delete')")
+    public CommonResult<Boolean> deleteAuxiliaryType(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("id") @NotNull Long id) {
+        auxiliaryTypeService.deleteAuxiliaryType(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得辅助核算类别列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:auxiliary:query')")
+    public CommonResult<List<FmsAuxiliaryTypeRespVO>> getAuxiliaryTypeList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        return success(BeanUtils.toBean(auxiliaryTypeService.getAuxiliaryTypeList(
+                accountSetId, getLoginUserId()), FmsAuxiliaryTypeRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得辅助核算类别精简列表", description = "主要用于前端的下拉选项")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    public CommonResult<List<FmsAuxiliaryTypeRespVO>> getAuxiliaryTypeSimpleList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        List<FmsAuxiliaryTypeDO> list = auxiliaryTypeService.getAuxiliaryTypeList(
+                accountSetId, getLoginUserId());
+        return success(convertList(list, auxiliaryType -> new FmsAuxiliaryTypeRespVO()
+                .setId(auxiliaryType.getId()).setName(auxiliaryType.getName()).setType(auxiliaryType.getType())));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsCurrencyController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsCurrencyController.java
new file mode 100644
index 0000000..0f583b1
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsCurrencyController.java
@@ -0,0 +1,92 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.currency.FmsCurrencyRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.currency.FmsCurrencySaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsCurrencyService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 币别")
+@RestController
+@RequestMapping("/fms/config/currency")
+@Validated
+public class FmsCurrencyController {
+
+    @Resource
+    private FmsCurrencyService currencyService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建币别")
+    @PreAuthorize("@ss.hasPermission('fms:config:currency:create')")
+    public CommonResult<Long> createCurrency(@Valid @RequestBody FmsCurrencySaveReqVO createReqVO) {
+        return success(currencyService.createCurrency(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新币别")
+    @PreAuthorize("@ss.hasPermission('fms:config:currency:update')")
+    public CommonResult<Boolean> updateCurrency(@Valid @RequestBody FmsCurrencySaveReqVO updateReqVO) {
+        currencyService.updateCurrency(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除币别")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "id", description = "币别编号", required = true, example = "1024")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:currency:delete')")
+    public CommonResult<Boolean> deleteCurrency(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("id") @NotNull Long id) {
+        currencyService.deleteCurrency(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得币别列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:currency:query')")
+    public CommonResult<List<FmsCurrencyRespVO>> getCurrencyList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        List<FmsCurrencyDO> list = currencyService.getCurrencyList(accountSetId, getLoginUserId());
+        return success(BeanUtils.toBean(list, FmsCurrencyRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得币别精简列表", description = "主要用于前端的下拉选项")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    public CommonResult<List<FmsCurrencyRespVO>> getCurrencySimpleList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        List<FmsCurrencyDO> list = currencyService.getCurrencyList(accountSetId, getLoginUserId());
+        return success(convertList(list, currency -> new FmsCurrencyRespVO()
+                .setId(currency.getId()).setCode(currency.getCode()).setName(currency.getName())
+                .setExchangeRate(currency.getExchangeRate()).setStandard(currency.getStandard())));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsDigestController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsDigestController.java
new file mode 100644
index 0000000..3eafb82
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsDigestController.java
@@ -0,0 +1,91 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.digest.FmsDigestRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.digest.FmsDigestSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsDigestDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsDigestService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+/**
+ * FMS 常用摘要 Controller
+ *
+ * @author 芋道源码
+ */
+@Tag(name = "管理后台 - FMS 常用摘要")
+@RestController
+@RequestMapping("/fms/config/digest")
+@Validated
+public class FmsDigestController {
+
+    @Resource
+    private FmsDigestService digestService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建常用摘要")
+    @PreAuthorize("@ss.hasPermission('fms:config:digest:create')")
+    public CommonResult<Long> createDigest(@Valid @RequestBody FmsDigestSaveReqVO createReqVO) {
+        return success(digestService.createDigest(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改常用摘要")
+    @PreAuthorize("@ss.hasPermission('fms:config:digest:update')")
+    public CommonResult<Boolean> updateDigest(@Valid @RequestBody FmsDigestSaveReqVO updateReqVO) {
+        digestService.updateDigest(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除常用摘要")
+    @Parameter(name = "id", description = "常用摘要编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:digest:delete')")
+    public CommonResult<Boolean> deleteDigest(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                              @RequestParam("id") @NotNull Long id) {
+        digestService.deleteDigest(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得常用摘要管理列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:digest:query')")
+    public CommonResult<List<FmsDigestRespVO>> getDigestList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        List<FmsDigestDO> list = digestService.getDigestList(accountSetId, getLoginUserId());
+        return success(BeanUtils.toBean(list, FmsDigestRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得常用摘要精简列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    public CommonResult<List<FmsDigestRespVO>> getDigestSimpleList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        List<FmsDigestDO> list = digestService.getDigestList(accountSetId, getLoginUserId());
+        return success(convertList(list, digest -> new FmsDigestRespVO()
+                .setId(digest.getId()).setAccountSetId(digest.getAccountSetId()).setContent(digest.getContent())));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsFinanceIndicatorController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsFinanceIndicatorController.java
new file mode 100644
index 0000000..5ea15d5
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsFinanceIndicatorController.java
@@ -0,0 +1,86 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeindicator.FmsFinanceIndicatorRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeindicator.FmsFinanceIndicatorSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceIndicatorDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceIndicatorService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 财务指标")
+@RestController
+@RequestMapping("/fms/config/finance-indicator")
+@Validated
+public class FmsFinanceIndicatorController {
+
+    @Resource
+    private FmsFinanceIndicatorService financeIndicatorService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建首页财务指标")
+    @PreAuthorize("@ss.hasPermission('fms:config:finance-indicator:create')")
+    public CommonResult<Long> create(@Valid @RequestBody FmsFinanceIndicatorSaveReqVO reqVO) {
+        return success(financeIndicatorService.createFinanceIndicator(reqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改首页财务指标")
+    @PreAuthorize("@ss.hasPermission('fms:config:finance-indicator:update')")
+    public CommonResult<Boolean> update(@Valid @RequestBody FmsFinanceIndicatorSaveReqVO reqVO) {
+        financeIndicatorService.updateFinanceIndicator(reqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除首页财务指标")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @Parameter(name = "id", description = "指标编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:finance-indicator:delete')")
+    public CommonResult<Boolean> delete(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                        @RequestParam("id") @NotNull Long id) {
+        financeIndicatorService.deleteFinanceIndicator(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得首页财务指标")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @Parameter(name = "id", description = "指标编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:finance-indicator:query')")
+    public CommonResult<FmsFinanceIndicatorRespVO> get(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                       @RequestParam("id") @NotNull Long id) {
+        FmsFinanceIndicatorDO indicator = financeIndicatorService.getFinanceIndicator(accountSetId, id, getLoginUserId());
+        return success(BeanUtils.toBean(indicator, FmsFinanceIndicatorRespVO.class));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得首页财务指标列表")
+    @PreAuthorize("@ss.hasPermission('fms:config:finance-indicator:query')")
+    public CommonResult<List<FmsFinanceIndicatorRespVO>> getList(@RequestParam("accountSetId") @NotNull Long accountSetId) {
+        List<FmsFinanceIndicatorDO> list = financeIndicatorService.getFinanceIndicatorList(accountSetId,
+                getLoginUserId());
+        return success(BeanUtils.toBean(list, FmsFinanceIndicatorRespVO.class));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsFinanceParameterController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsFinanceParameterController.java
new file mode 100644
index 0000000..931b949
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsFinanceParameterController.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeparameter.FmsFinanceParameterRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeparameter.FmsFinanceParameterUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 财务参数")
+@RestController
+@RequestMapping("/fms/config/finance-parameter")
+@Validated
+public class FmsFinanceParameterController {
+
+    @Resource
+    private FmsFinanceParameterService financeParameterService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得财务参数")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:finance-parameter:query')")
+    public CommonResult<FmsFinanceParameterRespVO> getFinanceParameter(
+            @RequestParam("accountSetId") Long accountSetId) {
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(
+                accountSetId, getLoginUserId());
+        return success(BeanUtils.toBean(financeParameter, FmsFinanceParameterRespVO.class));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新财务参数")
+    @PreAuthorize("@ss.hasPermission('fms:config:finance-parameter:update')")
+    public CommonResult<Boolean> updateFinanceParameter(
+            @Valid @RequestBody FmsFinanceParameterUpdateReqVO updateReqVO) {
+        financeParameterService.updateFinanceParameter(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsInitialBalanceController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsInitialBalanceController.java
new file mode 100644
index 0000000..16498bc
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsInitialBalanceController.java
@@ -0,0 +1,136 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.servlet.ServletUtils;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsTrialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceExcelVO;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.servlet.http.HttpServletResponse;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_IMPORT_TEMPLATE_INVALID;
+
+@Tag(name = "管理后台 - FMS 初始余额")
+@RestController
+@RequestMapping("/fms/config/initial-balance")
+@Validated
+public class FmsInitialBalanceController {
+
+    @Resource
+    private FmsInitialBalanceService initialBalanceService;
+    @Resource
+    private FmsAccountSetService accountSetService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得初始余额列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @Parameter(name = "subjectType", description = "科目类型", required = true, example = "1")
+    @PreAuthorize("@ss.hasPermission('fms:config:initial-balance:query')")
+    public CommonResult<List<FmsInitialBalanceRespVO>> getInitialBalanceList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("subjectType") @NotNull Integer subjectType) {
+        return success(initialBalanceService.getInitialBalanceList(accountSetId, subjectType, getLoginUserId()));
+    }
+
+    @PutMapping("/save")
+    @Operation(summary = "保存初始余额")
+    @PreAuthorize("@ss.hasPermission('fms:config:initial-balance:update')")
+    public CommonResult<Boolean> saveInitialBalance(@Valid @RequestBody FmsInitialBalanceSaveReqVO saveReqVO) {
+        initialBalanceService.saveInitialBalance(saveReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/trial-balance")
+    @Operation(summary = "获得试算平衡结果")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:initial-balance:query')")
+    public CommonResult<FmsTrialBalanceRespVO> getTrialBalance(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        return success(initialBalanceService.getTrialBalance(accountSetId, getLoginUserId()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出初始余额")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:initial-balance:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportInitialBalance(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            HttpServletResponse response) throws IOException {
+        // 1. 读取初始余额列表，并展开为 Excel 行
+        List<FmsInitialBalanceExcelVO> rows = FmsInitialBalanceExcelHelper.toRows(
+                initialBalanceService.getInitialBalanceList(accountSetId, null, getLoginUserId()), true);
+        // 2. 输出 Excel
+        ExcelUtils.write(response, "财务初始余额.xlsx", "财务初始余额",
+                FmsInitialBalanceExcelVO.class, rows);
+    }
+
+    @GetMapping("/get-import-template")
+    @Operation(summary = "获得初始余额导入模板")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:initial-balance:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getInitialBalanceImportTemplate(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                HttpServletResponse response)
+            throws IOException {
+        // 1. 读取初始余额列表，并展开为 Excel 行
+        Long userId = getLoginUserId();
+        List<FmsInitialBalanceRespVO> initialBalances = initialBalanceService.getInitialBalanceList(accountSetId, null, userId);
+        List<FmsInitialBalanceExcelVO> rows = FmsInitialBalanceExcelHelper.toRows(initialBalances, false);
+        // 2. 生成导入模板，一月启用时只需要录入期初余额
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        byte[] content = FmsInitialBalanceExcelHelper.writeTemplate(
+                rows, LocalDateTimeUtils.isJanuary(accountSet.getStartTime()));
+        // 3. 写入响应
+        ServletUtils.writeAttachment(response, "财务初始余额导入模板.xlsx", content);
+    }
+
+    @PostMapping("/import")
+    @Operation(summary = "导入初始余额")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:initial-balance:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<Integer> importInitialBalance(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("file") MultipartFile file) throws IOException {
+        // 1. 读取 Excel
+        List<FmsInitialBalanceExcelVO> rows;
+        try {
+            rows = FmsInitialBalanceExcelHelper.read(file);
+        } catch (IllegalArgumentException | IOException ex) {
+            throw exception(INITIAL_BALANCE_IMPORT_TEMPLATE_INVALID);
+        }
+        // 2. 导入数据
+        return success(initialBalanceService.importInitialBalance(accountSetId, rows, getLoginUserId()));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsInitialBalanceExcelHelper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsInitialBalanceExcelHelper.java
new file mode 100644
index 0000000..8b0d445
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsInitialBalanceExcelHelper.java
@@ -0,0 +1,343 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceExcelVO;
+import lombok.experimental.UtilityClass;
+import org.apache.poi.ss.usermodel.Cell;
+import org.apache.poi.ss.usermodel.CellStyle;
+import org.apache.poi.ss.usermodel.FormulaEvaluator;
+import org.apache.poi.ss.usermodel.IndexedColors;
+import org.apache.poi.ss.usermodel.Row;
+import org.apache.poi.ss.usermodel.Sheet;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.ss.usermodel.WorkbookFactory;
+import org.apache.poi.ss.util.CellRangeAddress;
+import org.apache.poi.xssf.usermodel.XSSFWorkbook;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.number.NumberUtils.zeroIfNull;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.createDataStyle;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.createHeaderStyle;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.createNumberStyle;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.getCellText;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.getDecimal;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.isEmptyRow;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.mergeHeader;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.writeFormula;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.writeNumber;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.writeText;
+
+/**
+ * FMS 初始余额 Excel 工具
+ *
+ * @author 芋道源码
+ */
+@UtilityClass
+public final class FmsInitialBalanceExcelHelper {
+
+    private static final String TEMPLATE_SHEET_NAME = "初始余额模板";
+
+    /**
+     * 展开初始余额平铺列表为 Excel 行
+     *
+     * 父级科目仅在 includeParent 时输出行；启用辅助核算且存在明细的科目按明细逐行输出
+     */
+    public static List<FmsInitialBalanceExcelVO> toRows(List<FmsInitialBalanceRespVO> results,
+            boolean includeParent) {
+        Set<Long> parentIds = convertSet(results, FmsInitialBalanceRespVO::getParentId);
+        List<FmsInitialBalanceExcelVO> rows = new ArrayList<>();
+        results.forEach(result -> {
+            if (parentIds.contains(result.getSubjectId())) {
+                if (includeParent) {
+                    rows.add(buildRow(result, null));
+                }
+                return;
+            }
+            if (Boolean.FALSE.equals(result.getAuxiliaryAccounting())
+                    || CollUtil.isEmpty(result.getAssistBalances())) {
+                rows.add(buildRow(result, null));
+                return;
+            }
+            result.getAssistBalances().forEach(assist -> rows.add(buildRow(result, assist)));
+        });
+        return rows;
+    }
+
+    /**
+     * 构建单个科目或辅助核算明细对应的 Excel 行
+     */
+    private static FmsInitialBalanceExcelVO buildRow(FmsInitialBalanceRespVO result,
+                                                     FmsInitialBalanceRespVO.AssistBalance assist) {
+        FmsInitialBalanceExcelVO row = new FmsInitialBalanceExcelVO()
+                .setSubjectCode(result.getSubjectCode()).setSubjectName(result.getSubjectName())
+                .setDirectionName(FmsDebitCreditDirectionEnum.valueOf(result.getBalanceDirection()).getName())
+                .setSubjectType(result.getType()).setQuantityAccounting(result.getQuantityAccounting())
+                .setAuxiliaryAccounting(result.getAuxiliaryAccounting());
+        if (assist == null) {
+            copyAmounts(result, row);
+        } else {
+            // 辅助核算项目拼接为“类别:名称/类别:名称”，与导入解析的格式对应
+            Map<Long, String> auxiliaryTypeNameMap = convertMap(result.getAuxiliaryConfigs(),
+                    FmsInitialBalanceRespVO.AuxiliaryConfig::getAuxiliaryTypeId,
+                    FmsInitialBalanceRespVO.AuxiliaryConfig::getName);
+            row.setAuxiliaryItems(String.join("/", convertList(assist.getAuxiliaries(),
+                    item -> auxiliaryTypeNameMap.get(item.getTypeId()) + ":" + item.getName())));
+            copyAmounts(assist, row);
+        }
+        return row;
+    }
+
+    private static void copyAmounts(FmsInitialBalanceRespVO source, FmsInitialBalanceExcelVO target) {
+        target.setOpeningAmount(zeroIfNull(source.getOpeningAmount()))
+                .setOpeningQuantity(zeroIfNull(source.getOpeningQuantity()))
+                .setYearDebitAmount(zeroIfNull(source.getYearDebitAmount()))
+                .setYearDebitQuantity(zeroIfNull(source.getYearDebitQuantity()))
+                .setYearCreditAmount(zeroIfNull(source.getYearCreditAmount()))
+                .setYearCreditQuantity(zeroIfNull(source.getYearCreditQuantity()))
+                .setYearOpeningAmount(zeroIfNull(source.getYearOpeningAmount()))
+                .setYearOpeningQuantity(zeroIfNull(source.getYearOpeningQuantity()))
+                .setProfitLossAmount(zeroIfNull(source.getProfitLossAmount()))
+                .setProfitLossQuantity(zeroIfNull(source.getProfitLossQuantity()));
+    }
+
+    private static void copyAmounts(FmsInitialBalanceRespVO.AssistBalance source,
+            FmsInitialBalanceExcelVO target) {
+        target.setOpeningAmount(zeroIfNull(source.getOpeningAmount()))
+                .setOpeningQuantity(zeroIfNull(source.getOpeningQuantity()))
+                .setYearDebitAmount(zeroIfNull(source.getYearDebitAmount()))
+                .setYearDebitQuantity(zeroIfNull(source.getYearDebitQuantity()))
+                .setYearCreditAmount(zeroIfNull(source.getYearCreditAmount()))
+                .setYearCreditQuantity(zeroIfNull(source.getYearCreditQuantity()))
+                .setYearOpeningAmount(zeroIfNull(source.getYearOpeningAmount()))
+                .setYearOpeningQuantity(zeroIfNull(source.getYearOpeningQuantity()))
+                .setProfitLossAmount(zeroIfNull(source.getProfitLossAmount()))
+                .setProfitLossQuantity(zeroIfNull(source.getProfitLossQuantity()));
+    }
+
+    /**
+     * 生成导入模板
+     *
+     * 模板锁定系统生成列，年初余额列写入公式，并通过 protectSheet 防止误改
+     */
+    public static byte[] writeTemplate(List<FmsInitialBalanceExcelVO> rows,
+            boolean january) throws IOException {
+        try (Workbook workbook = new XSSFWorkbook(); ByteArrayOutputStream output = new ByteArrayOutputStream()) {
+            // 1. 写入表头，一月启用时只保留期初余额
+            Sheet sheet = workbook.createSheet(TEMPLATE_SHEET_NAME);
+            writeHeaders(workbook, sheet, 0, january);
+            // 2. 写入科目数据，系统生成列锁定，可填写列解锁
+            CellStyle lockedStyle = createDataStyle(workbook, true, IndexedColors.GREY_25_PERCENT);
+            CellStyle editableStyle = createDataStyle(workbook, false, IndexedColors.WHITE);
+            CellStyle numberLockedStyle = createNumberStyle(workbook, lockedStyle, "#,##0.0000");
+            CellStyle amountLockedStyle = createNumberStyle(workbook, lockedStyle, "#,##0.00");
+            CellStyle numberEditableStyle = createNumberStyle(workbook, editableStyle, "#,##0.0000");
+            CellStyle amountEditableStyle = createNumberStyle(workbook, editableStyle, "#,##0.00");
+            for (int index = 0; index < rows.size(); index++) {
+                writeDataRow(sheet.createRow(index + 2), rows.get(index), january, true,
+                        lockedStyle, editableStyle, numberLockedStyle, amountLockedStyle,
+                        numberEditableStyle, amountEditableStyle);
+            }
+            // 3. 保护工作表并补充填写说明
+            sheet.protectSheet("yudao-fms");
+            sheet.createFreezePane(4, 2);
+            writeInstructions(workbook);
+            workbook.write(output);
+            return output.toByteArray();
+        }
+    }
+
+    /**
+     * 读取导入文件
+     *
+     * 按模板表头校验文件合法性，年初余额等公式单元格取公式计算值；不限制导入行数
+     */
+    public static List<FmsInitialBalanceExcelVO> read(MultipartFile file) throws IOException {
+        try (Workbook workbook = WorkbookFactory.create(file.getInputStream())) {
+            // 1. 校验模板 sheet 和表头
+            Sheet sheet = workbook.getSheet(TEMPLATE_SHEET_NAME);
+            if (sheet == null || !hasValidHeaders(sheet)) {
+                throw new IllegalArgumentException("初始余额模板表头不正确");
+            }
+            // 2. 逐行解析，跳过空行
+            FormulaEvaluator evaluator = workbook.getCreationHelper().createFormulaEvaluator();
+            boolean january = sheet.getRow(1).getLastCellNum() <= 6;
+            List<FmsInitialBalanceExcelVO> rows = new ArrayList<>();
+            for (int rowIndex = 2; rowIndex <= sheet.getLastRowNum(); rowIndex++) {
+                Row row = sheet.getRow(rowIndex);
+                if (isEmptyRow(row, evaluator, Arrays.asList(0, 1, 3, 4, 5))) {
+                    continue;
+                }
+                rows.add(parseRow(row, january, evaluator));
+            }
+            return rows;
+        }
+    }
+
+    /**
+     * 写入双行表头，数量和金额成组；一月启用时只保留期初余额组
+     */
+    private static void writeHeaders(Workbook workbook, Sheet sheet, int rowIndex, boolean january) {
+        CellStyle style = createHeaderStyle(workbook, IndexedColors.GREY_25_PERCENT);
+        int lastColumn = january ? 5 : 13;
+        Row firstRow = sheet.createRow(rowIndex);
+        Row secondRow = sheet.createRow(rowIndex + 1);
+        mergeHeader(sheet, firstRow, secondRow, 0, 0, "科目编码", style);
+        mergeHeader(sheet, firstRow, secondRow, 1, 1, "科目名称", style);
+        mergeHeader(sheet, firstRow, secondRow, 2, 2, "方向", style);
+        mergeHeader(sheet, firstRow, secondRow, 3, 3, "辅助核算项目", style);
+        writeGroupHeader(sheet, firstRow, secondRow, 4, "期初余额", style);
+        if (!january) {
+            writeGroupHeader(sheet, firstRow, secondRow, 6, "本年累计借方", style);
+            writeGroupHeader(sheet, firstRow, secondRow, 8, "本年累计贷方", style);
+            writeGroupHeader(sheet, firstRow, secondRow, 10, "年初余额", style);
+            writeGroupHeader(sheet, firstRow, secondRow, 12, "实际损益发生额", style);
+        }
+        for (int column = 0; column <= lastColumn; column++) {
+            sheet.setColumnWidth(column, column == 1 || column == 3 ? 7_000 : 4_000);
+        }
+        firstRow.setHeightInPoints(28);
+        secondRow.setHeightInPoints(24);
+    }
+
+    /**
+     * 写入“数量/金额”成组表头，第一行合并组名，第二行拆出数量和金额
+     */
+    private static void writeGroupHeader(Sheet sheet, Row firstRow, Row secondRow,
+                                         int beginColumn, String title, CellStyle style) {
+        sheet.addMergedRegion(new CellRangeAddress(firstRow.getRowNum(), firstRow.getRowNum(), beginColumn, beginColumn + 1));
+        Cell groupCell = firstRow.createCell(beginColumn);
+        groupCell.setCellValue(title);
+        groupCell.setCellStyle(style);
+        firstRow.createCell(beginColumn + 1).setCellStyle(style);
+        Cell quantityCell = secondRow.createCell(beginColumn);
+        quantityCell.setCellValue("数量");
+        quantityCell.setCellStyle(style);
+        Cell amountCell = secondRow.createCell(beginColumn + 1);
+        amountCell.setCellValue("金额");
+        amountCell.setCellStyle(style);
+    }
+
+    /**
+     * 写入一行数据
+     *
+     * 模板模式下按科目配置解锁可填写单元格（数量列仅数量核算科目可填，损益列仅损益类科目可填），
+     * 年初余额列写入“期初 ± 累计借贷”公式
+     */
+    private static void writeDataRow(Row excelRow, FmsInitialBalanceExcelVO data,
+                                     boolean january, boolean template, CellStyle lockedStyle, CellStyle editableStyle,
+                                     CellStyle numberLockedStyle, CellStyle amountLockedStyle,
+                                     CellStyle numberEditableStyle, CellStyle amountEditableStyle) {
+        writeText(excelRow, 0, data.getSubjectCode(), lockedStyle);
+        writeText(excelRow, 1, data.getSubjectName(), lockedStyle);
+        writeText(excelRow, 2, data.getDirectionName(), lockedStyle);
+        writeText(excelRow, 3, data.getAuxiliaryItems(),
+                template && Boolean.TRUE.equals(data.getAuxiliaryAccounting()) ? editableStyle : lockedStyle);
+        writeNumber(excelRow, 4, data.getOpeningQuantity(),
+                template && Boolean.TRUE.equals(data.getQuantityAccounting())
+                        ? numberEditableStyle : numberLockedStyle);
+        writeNumber(excelRow, 5, data.getOpeningAmount(), template ? amountEditableStyle : amountLockedStyle);
+        if (january) {
+            return;
+        }
+        writeNumber(excelRow, 6, data.getYearDebitQuantity(),
+                template && Boolean.TRUE.equals(data.getQuantityAccounting())
+                        ? numberEditableStyle : numberLockedStyle);
+        writeNumber(excelRow, 7, data.getYearDebitAmount(), template ? amountEditableStyle : amountLockedStyle);
+        writeNumber(excelRow, 8, data.getYearCreditQuantity(),
+                template && Boolean.TRUE.equals(data.getQuantityAccounting())
+                        ? numberEditableStyle : numberLockedStyle);
+        writeNumber(excelRow, 9, data.getYearCreditAmount(), template ? amountEditableStyle : amountLockedStyle);
+        if (template) {
+            String quantityFormula = "借".equals(data.getDirectionName())
+                    ? "E" + (excelRow.getRowNum() + 1) + "-G" + (excelRow.getRowNum() + 1)
+                    + "+I" + (excelRow.getRowNum() + 1)
+                    : "E" + (excelRow.getRowNum() + 1) + "+G" + (excelRow.getRowNum() + 1)
+                    + "-I" + (excelRow.getRowNum() + 1);
+            String amountFormula = "借".equals(data.getDirectionName())
+                    ? "F" + (excelRow.getRowNum() + 1) + "-H" + (excelRow.getRowNum() + 1)
+                    + "+J" + (excelRow.getRowNum() + 1)
+                    : "F" + (excelRow.getRowNum() + 1) + "+H" + (excelRow.getRowNum() + 1)
+                    + "-J" + (excelRow.getRowNum() + 1);
+            writeFormula(excelRow, 10, quantityFormula, numberLockedStyle);
+            writeFormula(excelRow, 11, amountFormula, amountLockedStyle);
+        } else {
+            writeNumber(excelRow, 10, data.getYearOpeningQuantity(), numberLockedStyle);
+            writeNumber(excelRow, 11, data.getYearOpeningAmount(), amountLockedStyle);
+        }
+        boolean profitLoss = FmsSubjectTypeEnum.PROFIT_LOSS.getType().equals(data.getSubjectType());
+        writeNumber(excelRow, 12, profitLoss ? data.getProfitLossQuantity() : null,
+                template && profitLoss && Boolean.TRUE.equals(data.getQuantityAccounting())
+                        ? numberEditableStyle : numberLockedStyle);
+        writeNumber(excelRow, 13, profitLoss ? data.getProfitLossAmount() : null,
+                template && profitLoss ? amountEditableStyle : amountLockedStyle);
+    }
+
+    /**
+     * 解析一行数据，公式单元格通过 evaluator 取计算值
+     */
+    private static FmsInitialBalanceExcelVO parseRow(Row row, boolean january, FormulaEvaluator evaluator) {
+        FmsInitialBalanceExcelVO result = new FmsInitialBalanceExcelVO()
+                .setRowNumber(row.getRowNum() + 1)
+                .setSubjectCode(getCellText(row, 0, evaluator))
+                .setSubjectName(getCellText(row, 1, evaluator))
+                .setDirectionName(getCellText(row, 2, evaluator))
+                .setAuxiliaryItems(getCellText(row, 3, evaluator))
+                .setOpeningQuantity(getDecimal(row, 4, evaluator))
+                .setOpeningAmount(getDecimal(row, 5, evaluator));
+        if (!january) {
+            result.setYearDebitQuantity(getDecimal(row, 6, evaluator))
+                    .setYearDebitAmount(getDecimal(row, 7, evaluator))
+                    .setYearCreditQuantity(getDecimal(row, 8, evaluator))
+                    .setYearCreditAmount(getDecimal(row, 9, evaluator))
+                    .setYearOpeningQuantity(getDecimal(row, 10, evaluator))
+                    .setYearOpeningAmount(getDecimal(row, 11, evaluator))
+                    .setProfitLossQuantity(getDecimal(row, 12, evaluator))
+                    .setProfitLossAmount(getDecimal(row, 13, evaluator));
+        }
+        return result;
+    }
+
+    private static boolean hasValidHeaders(Sheet sheet) {
+        Row firstRow = sheet.getRow(0);
+        Row secondRow = sheet.getRow(1);
+        return firstRow != null && secondRow != null
+                && "科目编码".equals(getCellText(firstRow, 0, null))
+                && "科目名称".equals(getCellText(firstRow, 1, null))
+                && "方向".equals(getCellText(firstRow, 2, null))
+                && "辅助核算项目".equals(getCellText(firstRow, 3, null))
+                && "期初余额".equals(getCellText(firstRow, 4, null))
+                && "数量".equals(getCellText(secondRow, 4, null))
+                && "金额".equals(getCellText(secondRow, 5, null));
+    }
+
+    private static void writeInstructions(Workbook workbook) {
+        Sheet sheet = workbook.createSheet("填写说明");
+        String[] instructions = {
+                "1. 灰色单元格由系统生成，请勿修改",
+                "2. 仅末级科目可以导入初始余额",
+                "3. 辅助核算项目使用“类别:名称/类别:名称”格式，例如“客户:北京客户/部门:销售部”",
+                "4. 数量核算科目可填写数量，金额和数量不能小于 0",
+                "5. 年初余额由期初余额和本年累计发生额自动计算"
+        };
+        for (int index = 0; index < instructions.length; index++) {
+            sheet.createRow(index).createCell(0).setCellValue(instructions[index]);
+        }
+        sheet.setColumnWidth(0, 20_000);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsSubjectController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsSubjectController.java
new file mode 100644
index 0000000..516b686
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsSubjectController.java
@@ -0,0 +1,195 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectDeleteReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectStatusReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectUsageRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 会计科目")
+@RestController
+@RequestMapping("/fms/config/subject")
+@Validated
+public class FmsSubjectController {
+
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建科目")
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:create')")
+    public CommonResult<Long> createSubject(@Valid @RequestBody FmsSubjectSaveReqVO createReqVO) {
+        return success(subjectService.createSubject(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新科目")
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:update')")
+    public CommonResult<Boolean> updateSubject(@Valid @RequestBody FmsSubjectSaveReqVO updateReqVO) {
+        subjectService.updateSubject(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "删除科目")
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:delete')")
+    public CommonResult<Boolean> deleteSubjectList(@Valid @RequestBody FmsSubjectDeleteReqVO deleteReqVO) {
+        subjectService.deleteSubjectList(deleteReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/update-status")
+    @Operation(summary = "更新科目状态")
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:update')")
+    public CommonResult<Boolean> updateSubjectStatus(@Valid @RequestBody FmsSubjectStatusReqVO statusReqVO) {
+        subjectService.updateSubjectStatus(statusReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得科目")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "id", description = "科目编号", required = true, example = "1024")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:query')")
+    public CommonResult<FmsSubjectRespVO> getSubject(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                     @RequestParam("id") @NotNull Long id) {
+        FmsSubjectDO subject = subjectService.getSubject(accountSetId, id, getLoginUserId());
+        return success(buildSubjectRespVO(subject));
+    }
+
+    @GetMapping("/get-usage")
+    @Operation(summary = "获得科目使用情况")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "id", description = "科目编号", required = true, example = "1024")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:query')")
+    public CommonResult<FmsSubjectUsageRespVO> getSubjectUsage(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("id") @NotNull Long id) {
+        return success(subjectService.getSubjectUsage(accountSetId, id, getLoginUserId()));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得科目列表")
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:query')")
+    public CommonResult<List<FmsSubjectRespVO>> getSubjectList(@Valid FmsSubjectListReqVO listReqVO) {
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO, getLoginUserId());
+        return success(buildSubjectRespVOList(subjects));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得科目精简列表")
+    public CommonResult<List<FmsSubjectRespVO>> getSubjectSimpleList(@Valid FmsSubjectListReqVO listReqVO) {
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO, getLoginUserId());
+        return success(convertList(subjects, subject -> new FmsSubjectRespVO()
+                .setId(subject.getId()).setParentId(subject.getParentId())
+                .setCode(subject.getCode()).setName(subject.getName()).setType(subject.getType())
+                .setBalanceDirection(subject.getBalanceDirection()).setStatus(subject.getStatus())
+                .setLevel(subject.getLevel()).setAuxiliaryTypeIds(subject.getAuxiliaryTypeIds())
+                .setQuantityAccounting(subject.getQuantityAccounting()).setQuantityUnit(subject.getQuantityUnit())));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出科目")
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportSubject(@Valid FmsSubjectListReqVO listReqVO,
+            HttpServletResponse response) throws IOException {
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO, getLoginUserId());
+        ExcelUtils.write(response, "科目设置.xlsx", "科目设置", FmsSubjectRespVO.class,
+                buildSubjectRespVOList(subjects));
+    }
+
+    @GetMapping("/get-import-template")
+    @Operation(summary = "获得科目导入模板")
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getSubjectImportTemplate(HttpServletResponse response) throws IOException {
+        List<FmsSubjectImportExcelVO> list = Arrays.asList(
+                FmsSubjectImportExcelVO.builder().code("1001").name("库存现金")
+                        .parentSubjectCode("0").balanceDirection("借").categoryName("流动资产").build(),
+                FmsSubjectImportExcelVO.builder().code("100101").name("人民币现金")
+                        .parentSubjectCode("1001").balanceDirection("借").categoryName("流动资产")
+                        .auxiliaryNames("部门/职员").build());
+        ExcelUtils.write(response, "科目导入模板.xlsx", "科目列表", FmsSubjectImportExcelVO.class, list);
+    }
+
+    @PostMapping("/import")
+    @Operation(summary = "导入科目")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "file", description = "Excel 文件", required = true)
+    })
+    @PreAuthorize("@ss.hasPermission('fms:config:subject:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<FmsSubjectImportRespVO> importSubject(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("file") MultipartFile file) throws IOException {
+        List<FmsSubjectImportExcelVO> importSubjects = ExcelUtils.read(file, FmsSubjectImportExcelVO.class);
+        return success(subjectService.importSubjectList(accountSetId, importSubjects, getLoginUserId()));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<FmsSubjectRespVO> buildSubjectRespVOList(List<FmsSubjectDO> subjects) {
+        Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap = auxiliaryTypeService.getAuxiliaryTypeMap(
+                convertSetByFlatMap(subjects, FmsSubjectDO::getAuxiliaryTypeIds, List::stream));
+        return convertList(subjects, subject -> {
+            FmsSubjectRespVO subjectVO = BeanUtils.toBean(subject, FmsSubjectRespVO.class)
+                    .setCategoryDictValue(subject.getType() + "-" + subject.getCategory());
+            subjectVO.setAuxiliaryTypeNames(convertList(subject.getAuxiliaryTypeIds(),
+                    auxiliaryTypeId -> auxiliaryTypeMap.get(auxiliaryTypeId).getName()));
+            if (Boolean.FALSE.equals(subject.getQuantityAccounting())) {
+                subjectVO.setQuantityUnit("");
+            }
+            return subjectVO;
+        });
+    }
+
+    private FmsSubjectRespVO buildSubjectRespVO(FmsSubjectDO subject) {
+        return subject == null ? null
+                : CollUtil.getFirst(buildSubjectRespVOList(Collections.singletonList(subject)));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherTemplateCategoryController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherTemplateCategoryController.java
new file mode 100644
index 0000000..6201f0d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherTemplateCategoryController.java
@@ -0,0 +1,89 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplatecategory.FmsVoucherTemplateCategoryRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplatecategory.FmsVoucherTemplateCategorySaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateCategoryDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherTemplateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 凭证模板分类")
+@RestController
+@RequestMapping("/fms/config/voucher-template-category")
+@Validated
+public class FmsVoucherTemplateCategoryController {
+
+    @Resource
+    private FmsVoucherTemplateService voucherTemplateService;
+    @Resource
+    private FmsAccountSetService accountSetService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建凭证模板分类")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template-category:create')")
+    public CommonResult<Long> createTemplateCategory(
+            @Valid @RequestBody FmsVoucherTemplateCategorySaveReqVO createReqVO) {
+        return success(voucherTemplateService.createTemplateCategory(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改凭证模板分类")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template-category:update')")
+    public CommonResult<Boolean> updateTemplateCategory(
+            @Valid @RequestBody FmsVoucherTemplateCategorySaveReqVO updateReqVO) {
+        voucherTemplateService.updateTemplateCategory(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除凭证模板分类")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template-category:delete')")
+    public CommonResult<Boolean> deleteTemplateCategory(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                        @RequestParam("id") @NotNull Long id) {
+        voucherTemplateService.deleteTemplateCategory(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得凭证模板分类列表")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template-category:query')")
+    public CommonResult<List<FmsVoucherTemplateCategoryRespVO>> getTemplateCategoryList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        accountSetService.validateAccountSetReadPermission(accountSetId, getLoginUserId());
+        List<FmsVoucherTemplateCategoryDO> categories = voucherTemplateService.getTemplateCategoryList(accountSetId);
+        return success(BeanUtils.toBean(categories, FmsVoucherTemplateCategoryRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得凭证模板分类精简列表", description = "主要用于前端的下拉选项")
+    public CommonResult<List<FmsVoucherTemplateCategoryRespVO>> getTemplateCategorySimpleList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        accountSetService.validateAccountSetReadPermission(accountSetId, getLoginUserId());
+        List<FmsVoucherTemplateCategoryDO> categories = voucherTemplateService.getTemplateCategoryList(accountSetId);
+        return success(convertList(categories, category -> new FmsVoucherTemplateCategoryRespVO()
+                .setId(category.getId()).setName(category.getName())));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherTemplateController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherTemplateController.java
new file mode 100644
index 0000000..e5a8ce2
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherTemplateController.java
@@ -0,0 +1,100 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate.FmsVoucherTemplateRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate.FmsVoucherTemplateSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateCategoryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherTemplateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.MapUtils.findAndThen;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 凭证模板")
+@RestController
+@RequestMapping("/fms/config/voucher-template")
+@Validated
+public class FmsVoucherTemplateController {
+
+    @Resource
+    private FmsVoucherTemplateService voucherTemplateService;
+    @Resource
+    private FmsAccountSetService accountSetService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建凭证模板")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template:create')")
+    public CommonResult<Long> createVoucherTemplate(
+            @Valid @RequestBody FmsVoucherTemplateSaveReqVO createReqVO) {
+        return success(voucherTemplateService.createVoucherTemplate(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改凭证模板")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template:update')")
+    public CommonResult<Boolean> updateVoucherTemplate(
+            @Valid @RequestBody FmsVoucherTemplateSaveReqVO updateReqVO) {
+        voucherTemplateService.updateVoucherTemplate(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除凭证模板")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template:delete')")
+    public CommonResult<Boolean> deleteVoucherTemplate(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                       @RequestParam("id") @NotNull Long id) {
+        voucherTemplateService.deleteVoucherTemplate(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得凭证模板列表")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-template:query')")
+    public CommonResult<List<FmsVoucherTemplateRespVO>> getVoucherTemplateList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        accountSetService.validateAccountSetReadPermission(accountSetId, getLoginUserId());
+        return success(buildVoucherTemplateRespVOList(accountSetId));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得凭证模板精简列表", description = "主要用于录凭证时套用凭证模板")
+    public CommonResult<List<FmsVoucherTemplateRespVO>> getVoucherTemplateSimpleList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        accountSetService.validateAccountSetReadPermission(accountSetId, getLoginUserId());
+        return success(buildVoucherTemplateRespVOList(accountSetId));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<FmsVoucherTemplateRespVO> buildVoucherTemplateRespVOList(Long accountSetId) {
+        Map<Long, FmsVoucherTemplateCategoryDO> categoryMap =
+                voucherTemplateService.getTemplateCategoryMap(accountSetId);
+        List<FmsVoucherTemplateDO> templates = voucherTemplateService.getVoucherTemplateList(accountSetId);
+        return BeanUtils.toBean(templates, FmsVoucherTemplateRespVO.class, template -> {
+            findAndThen(categoryMap, template.getCategoryId(),
+                    category -> template.setCategoryName(category.getName()));
+        });
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherWordController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherWordController.java
new file mode 100644
index 0000000..00e8ce6
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/FmsVoucherWordController.java
@@ -0,0 +1,93 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.voucherword.FmsVoucherWordRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.voucherword.FmsVoucherWordSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+/**
+ * FMS 凭证字 Controller
+ *
+ * @author 芋道源码
+ */
+@Tag(name = "管理后台 - FMS 凭证字")
+@RestController
+@RequestMapping("/fms/config/voucher-word")
+@Validated
+public class FmsVoucherWordController {
+
+    @Resource
+    private FmsVoucherWordService voucherWordService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建凭证字")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-word:create')")
+    public CommonResult<Long> createVoucherWord(@Valid @RequestBody FmsVoucherWordSaveReqVO createReqVO) {
+        return success(voucherWordService.createVoucherWord(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改凭证字")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-word:update')")
+    public CommonResult<Boolean> updateVoucherWord(@Valid @RequestBody FmsVoucherWordSaveReqVO updateReqVO) {
+        voucherWordService.updateVoucherWord(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除凭证字")
+    @Parameter(name = "id", description = "凭证字编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-word:delete')")
+    public CommonResult<Boolean> deleteVoucherWord(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("id") @NotNull Long id) {
+        voucherWordService.deleteVoucherWord(accountSetId, id, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得凭证字管理列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:config:voucher-word:query')")
+    public CommonResult<List<FmsVoucherWordRespVO>> getVoucherWordList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        List<FmsVoucherWordDO> list = voucherWordService.getVoucherWordList(accountSetId, getLoginUserId());
+        return success(BeanUtils.toBean(list, FmsVoucherWordRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得凭证字精简列表")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    public CommonResult<List<FmsVoucherWordRespVO>> getVoucherWordSimpleList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId) {
+        return success(convertList(voucherWordService.getVoucherWordList(
+                accountSetId, getLoginUserId()), voucherWord -> new FmsVoucherWordRespVO()
+                .setId(voucherWord.getId()).setName(voucherWord.getName())
+                .setDefaultStatus(voucherWord.getDefaultStatus())));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetInitializeReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetInitializeReqVO.java
new file mode 100644
index 0000000..ac0996c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetInitializeReqVO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountingStandardEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsCurrencyPresetEnum;
+import cn.iocoder.yudao.module.fms.enums.ledger.FmsLedgerBalanceModeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - FMS 账套初始化 Request VO")
+@Data
+public class FmsAccountSetInitializeReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "本位币编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "RMB")
+    @NotBlank(message = "本位币不能为空")
+    @InEnum(value = FmsCurrencyPresetEnum.class, message = "本位币必须是 {value}")
+    private String currencyCode;
+
+    @Schema(description = "启用期间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "启用期间不能为空")
+    private LocalDateTime startTime;
+
+    @Schema(description = "会计制度", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "会计制度不能为空")
+    @InEnum(value = FmsAccountingStandardEnum.class, message = "会计制度必须是 {value}")
+    private Integer standard;
+
+    @Schema(description = "科目层级", requiredMode = Schema.RequiredMode.REQUIRED, example = "4")
+    @NotNull(message = "科目层级不能为空")
+    @Min(value = 1, message = "科目层级不能小于 1")
+    @Max(value = 8, message = "科目层级不能大于 8")
+    private Integer level;
+
+    @Schema(description = "科目编码规则", requiredMode = Schema.RequiredMode.REQUIRED, example = "4-2-2-2")
+    @NotBlank(message = "科目编码规则不能为空")
+    @Size(max = 64, message = "科目编码规则不能超过 64 个字符")
+    private String subjectCodeRule;
+
+    @Schema(description = "账簿余额方向模式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账簿余额方向模式不能为空")
+    @InEnum(FmsLedgerBalanceModeEnum.class)
+    private Integer ledgerBalanceMode;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetRespVO.java
new file mode 100644
index 0000000..7ae198a
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetRespVO.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - FMS 账套 Response VO")
+@Data
+public class FmsAccountSetRespVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "公司编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "WK001")
+    private String companyCode;
+
+    @Schema(description = "公司名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "测试科技有限公司")
+    private String companyName;
+
+    @Schema(description = "公司简介", example = "专注企业数字化服务")
+    private String companyProfile;
+
+    @Schema(description = "所在行业", example = "软件和信息技术服务业")
+    private String industry;
+
+    @Schema(description = "所在地", example = "上海市浦东新区")
+    private String location;
+
+    @Schema(description = "法人代表", example = "张三")
+    private String legalRepresentative;
+
+    @Schema(description = "法人身份证号", example = "310101199001011234")
+    private String legalRepresentativeIdNumber;
+
+    @Schema(description = "营业执照号", example = "91310000MA1K123456")
+    private String businessLicenseNumber;
+
+    @Schema(description = "组织机构代码", example = "MA1K12345")
+    private String organizationCode;
+
+    @Schema(description = "备注", example = "一般纳税人")
+    private String remark;
+
+    @Schema(description = "联系人", example = "李四")
+    private String contactName;
+
+    @Schema(description = "办公电话", example = "021-12345678")
+    private String officeTelephone;
+
+    @Schema(description = "手机号码", example = "15601691399")
+    private String mobile;
+
+    @Schema(description = "传真号码", example = "021-87654321")
+    private String faxNumber;
+
+    @Schema(description = "QQ 号码", example = "12345678")
+    private String qqNumber;
+
+    @Schema(description = "邮箱", example = "finance@example.com")
+    private String email;
+
+    @Schema(description = "其他联系方式", example = "企业微信：wk-finance")
+    private String otherContact;
+
+    @Schema(description = "详细地址", example = "张江高科技园区 1 号楼")
+    private String address;
+
+    @Schema(description = "币种编号", example = "1024")
+    private Long currencyId;
+
+    @Schema(description = "启用期间")
+    private LocalDateTime startTime;
+
+    @Schema(description = "会计制度", example = "1")
+    private Integer standard;
+
+    @Schema(description = "是否已初始化", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean initialized;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    // ==================== 来自 FmsAccountUserDO ====================
+
+    @Schema(description = "是否默认账套", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean defaultStatus;
+
+    @Schema(description = "是否账套创建人", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean founder;
+
+    @Schema(description = "当前用户的成员权限级别", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetSaveReqVO.java
new file mode 100644
index 0000000..10b1601
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountset/FmsAccountSetSaveReqVO.java
@@ -0,0 +1,110 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 账套新增/修改 Request VO")
+@Data
+public class FmsAccountSetSaveReqVO {
+
+    @Schema(description = "账套编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "公司编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "WK001")
+    @NotBlank(message = "公司编码不能为空")
+    @Size(max = 64, message = "公司编码不能超过 64 个字符")
+    @DiffLogField(name = "公司编码")
+    private String companyCode;
+
+    @Schema(description = "公司名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "测试科技有限公司")
+    @NotBlank(message = "公司名称不能为空")
+    @Size(max = 255, message = "公司名称不能超过 255 个字符")
+    @DiffLogField(name = "公司名称")
+    private String companyName;
+
+    @Schema(description = "公司简介", example = "专注企业数字化服务")
+    @Size(max = 500, message = "公司简介不能超过 500 个字符")
+    @DiffLogField(name = "公司简介")
+    private String companyProfile;
+
+    @Schema(description = "所在行业", example = "软件和信息技术服务业")
+    @Size(max = 255, message = "所在行业不能超过 255 个字符")
+    @DiffLogField(name = "所在行业")
+    private String industry;
+
+    @Schema(description = "所在地", example = "上海市浦东新区")
+    @Size(max = 255, message = "所在地不能超过 255 个字符")
+    @DiffLogField(name = "所在地")
+    private String location;
+
+    @Schema(description = "法人代表", example = "张三")
+    @Size(max = 255, message = "法人代表不能超过 255 个字符")
+    @DiffLogField(name = "法人代表")
+    private String legalRepresentative;
+
+    @Schema(description = "法人身份证号", example = "310101199001011234")
+    @Size(max = 255, message = "法人身份证号不能超过 255 个字符")
+    @DiffLogField(name = "法人身份证号")
+    private String legalRepresentativeIdNumber;
+
+    @Schema(description = "营业执照号", example = "91310000MA1K123456")
+    @Size(max = 255, message = "营业执照号不能超过 255 个字符")
+    @DiffLogField(name = "营业执照号")
+    private String businessLicenseNumber;
+
+    @Schema(description = "组织机构代码", example = "MA1K12345")
+    @Size(max = 255, message = "组织机构代码不能超过 255 个字符")
+    @DiffLogField(name = "组织机构代码")
+    private String organizationCode;
+
+    @Schema(description = "备注", example = "一般纳税人")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    @DiffLogField(name = "备注")
+    private String remark;
+
+    @Schema(description = "联系人", example = "李四")
+    @Size(max = 255, message = "联系人不能超过 255 个字符")
+    @DiffLogField(name = "联系人")
+    private String contactName;
+
+    @Schema(description = "办公电话", example = "021-12345678")
+    @Size(max = 32, message = "办公电话不能超过 32 个字符")
+    @DiffLogField(name = "办公电话")
+    private String officeTelephone;
+
+    @Schema(description = "手机号码", example = "15601691399")
+    @Size(max = 32, message = "手机号码不能超过 32 个字符")
+    @DiffLogField(name = "手机号码")
+    private String mobile;
+
+    @Schema(description = "传真号码", example = "021-87654321")
+    @Size(max = 32, message = "传真号码不能超过 32 个字符")
+    @DiffLogField(name = "传真号码")
+    private String faxNumber;
+
+    @Schema(description = "QQ 号码", example = "12345678")
+    @Size(max = 255, message = "QQ 号码不能超过 255 个字符")
+    @DiffLogField(name = "QQ 号码")
+    private String qqNumber;
+
+    @Schema(description = "邮箱", example = "finance@example.com")
+    @Email(message = "邮箱格式不正确")
+    @Size(max = 255, message = "邮箱不能超过 255 个字符")
+    @DiffLogField(name = "邮箱")
+    private String email;
+
+    @Schema(description = "其他联系方式", example = "企业微信：wk-finance")
+    @Size(max = 255, message = "其他联系方式不能超过 255 个字符")
+    @DiffLogField(name = "其他联系方式")
+    private String otherContact;
+
+    @Schema(description = "详细地址", example = "张江高科技园区 1 号楼")
+    @Size(max = 255, message = "详细地址不能超过 255 个字符")
+    @DiffLogField(name = "详细地址")
+    private String address;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountuser/FmsAccountUserRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountuser/FmsAccountUserRespVO.java
new file mode 100644
index 0000000..d841f70
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountuser/FmsAccountUserRespVO.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountuser;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 账套用户 Response VO")
+@Data
+public class FmsAccountUserRespVO {
+
+    @Schema(description = "后台用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long userId;
+
+    @Schema(description = "用户昵称", example = "芋道")
+    private String nickname;
+
+    @Schema(description = "部门名称", example = "财务部")
+    private String deptName;
+
+    @Schema(description = "手机号码", example = "15601691399")
+    private String mobile;
+
+    @Schema(description = "用户邮箱", example = "finance@example.com")
+    private String email;
+
+    @Schema(description = "用户状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "是否默认账套", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean defaultStatus;
+
+    @Schema(description = "是否账套创建人", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean founder;
+
+    @Schema(description = "成员权限级别", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountuser/FmsAccountUserUpdateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountuser/FmsAccountUserUpdateReqVO.java
new file mode 100644
index 0000000..16565f1
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/accountuser/FmsAccountUserUpdateReqVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountuser;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountUserLevelEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 账套用户更新 Request VO")
+@Data
+public class FmsAccountUserUpdateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "账套成员数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "账套成员数组不能为空")
+    @Size(max = 100, message = "单个账套最多授权 100 名成员")
+    @Valid
+    private List<Member> members;
+
+    @Schema(description = "管理后台 - FMS 账套成员")
+    @Data
+    public static class Member {
+
+        @Schema(description = "后台用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "成员用户编号不能为空")
+        private Long userId;
+
+        @Schema(description = "成员权限级别", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+        @NotNull(message = "成员权限级别不能为空")
+        @InEnum(FmsAccountUserLevelEnum.class)
+        private Integer level;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemImportExcelVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemImportExcelVO.java
new file mode 100644
index 0000000..6a15e3c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemImportExcelVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem;
+
+import cn.idev.excel.annotation.ExcelProperty;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * FMS 辅助核算项目 Excel 导入 VO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class FmsAuxiliaryItemImportExcelVO {
+
+    @ExcelProperty("编码")
+    @NotBlank(message = "编码不能为空")
+    @Size(max = 64, message = "编码长度不能超过 64 个字符")
+    private String code;
+
+    @ExcelProperty("名称")
+    @NotBlank(message = "名称不能为空")
+    @Size(max = 255, message = "名称长度不能超过 255 个字符")
+    private String name;
+
+    @ExcelProperty("备注")
+    @Size(max = 500, message = "备注长度不能超过 500 个字符")
+    private String remark;
+
+    @ExcelProperty("规格")
+    @Size(max = 255, message = "规格长度不能超过 255 个字符")
+    private String specification;
+
+    @ExcelProperty("单位")
+    @Size(max = 255, message = "单位长度不能超过 255 个字符")
+    private String unit;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemImportRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemImportRespVO.java
new file mode 100644
index 0000000..8cb7a35
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemImportRespVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * FMS 辅助核算项目导入结果 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 辅助核算项目导入结果 Response VO")
+@Data
+public class FmsAuxiliaryItemImportRespVO {
+
+    @Schema(description = "总数量", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer totalCount;
+
+    @Schema(description = "成功编码数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> successItemCodes;
+
+    @Schema(description = "失败原因 Map", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Map<String, String> failureReasons;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemPageReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemPageReqVO.java
new file mode 100644
index 0000000..2707058
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemPageReqVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * FMS 辅助核算项目分页 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 辅助核算项目分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class FmsAuxiliaryItemPageReqVO extends PageParam {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "辅助核算类别编号不能为空")
+    private Long auxiliaryTypeId;
+
+    @Schema(description = "关键词，匹配编码或名称", example = "测试")
+    private String search;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemRespVO.java
new file mode 100644
index 0000000..f41a550
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemRespVO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * FMS 辅助核算项目 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 辅助核算项目 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsAuxiliaryItemRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long accountSetId;
+
+    @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long auxiliaryTypeId;
+
+    @Schema(description = "编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "KH001")
+    @ExcelProperty("编码")
+    private String code;
+
+    @Schema(description = "名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "上海测试数字科技有限公司")
+    @ExcelProperty("名称")
+    private String name;
+
+    @Schema(description = "备注", example = "重点客户")
+    @ExcelProperty("备注")
+    private String remark;
+
+    @Schema(description = "规格", example = "标准版")
+    @ExcelProperty("规格")
+    private String specification;
+
+    @Schema(description = "单位", example = "台")
+    @ExcelProperty("单位")
+    private String unit;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer status;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemSaveReqVO.java
new file mode 100644
index 0000000..0d16e1b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemSaveReqVO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * FMS 辅助核算项目创建或修改 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 辅助核算项目创建或修改 Request VO")
+@Data
+public class FmsAuxiliaryItemSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "辅助核算类别编号不能为空")
+    private Long auxiliaryTypeId;
+
+    @Schema(description = "编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "KH001")
+    @NotBlank(message = "编码不能为空")
+    @Size(max = 64, message = "编码长度不能超过 64 个字符")
+    private String code;
+
+    @Schema(description = "名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "上海测试数字科技有限公司")
+    @NotBlank(message = "名称不能为空")
+    @Size(max = 255, message = "名称长度不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "备注", example = "重点客户")
+    @Size(max = 500, message = "备注长度不能超过 500 个字符")
+    private String remark;
+
+    @Schema(description = "规格", example = "标准版")
+    @Size(max = 255, message = "规格长度不能超过 255 个字符")
+    private String specification;
+
+    @Schema(description = "单位", example = "台")
+    @Size(max = 255, message = "单位长度不能超过 255 个字符")
+    private String unit;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemStatusReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemStatusReqVO.java
new file mode 100644
index 0000000..ed29d9e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliaryitem/FmsAuxiliaryItemStatusReqVO.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * FMS 辅助核算项目状态更新 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 辅助核算项目状态更新 Request VO")
+@Data
+public class FmsAuxiliaryItemStatusReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "编号不能为空")
+    private Long id;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliarytype/FmsAuxiliaryTypeRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliarytype/FmsAuxiliaryTypeRespVO.java
new file mode 100644
index 0000000..ba027b7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliarytype/FmsAuxiliaryTypeRespVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliarytype;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * FMS 辅助核算类别 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 辅助核算类别 Response VO")
+@Data
+public class FmsAuxiliaryTypeRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "客户")
+    private String name;
+
+    @Schema(description = "是否系统预置", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean systemPreset;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long accountSetId;
+
+    @Schema(description = "类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliarytype/FmsAuxiliaryTypeSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliarytype/FmsAuxiliaryTypeSaveReqVO.java
new file mode 100644
index 0000000..db5508c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/auxiliarytype/FmsAuxiliaryTypeSaveReqVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliarytype;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * FMS 辅助核算类别创建或修改 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 辅助核算类别创建或修改 Request VO")
+@Data
+public class FmsAuxiliaryTypeSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "门店")
+    @NotBlank(message = "名称不能为空")
+    @Size(max = 255, message = "名称长度不能超过 255 个字符")
+    private String name;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/currency/FmsCurrencyRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/currency/FmsCurrencyRespVO.java
new file mode 100644
index 0000000..9c7a6a8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/currency/FmsCurrencyRespVO.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.currency;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * FMS 币别 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 币别 Response VO")
+@Data
+public class FmsCurrencyRespVO {
+
+    @Schema(description = "币别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long accountSetId;
+
+    @Schema(description = "币别编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "USD")
+    private String code;
+
+    @Schema(description = "币别名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "美元")
+    private String name;
+
+    @Schema(description = "汇率", requiredMode = Schema.RequiredMode.REQUIRED, example = "7.120000")
+    private BigDecimal exchangeRate;
+
+    @Schema(description = "是否本位币", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean standard;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/currency/FmsCurrencySaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/currency/FmsCurrencySaveReqVO.java
new file mode 100644
index 0000000..7839f87
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/currency/FmsCurrencySaveReqVO.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.currency;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 币别保存 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 币别保存 Request VO")
+@Data
+public class FmsCurrencySaveReqVO {
+
+    @Schema(description = "币别编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "币别编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "USD")
+    @NotBlank(message = "币别编码不能为空")
+    @Size(max = 64, message = "币别编码长度不能超过 64 个字符")
+    @Pattern(regexp = "^[A-Za-z][A-Za-z0-9_]*$", message = "币别编码必须以字母开头，只能包含字母、数字和下划线")
+    private String code;
+
+    @Schema(description = "币别名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "美元")
+    @NotBlank(message = "币别名称不能为空")
+    @Size(max = 255, message = "币别名称长度不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "汇率", requiredMode = Schema.RequiredMode.REQUIRED, example = "7.120000")
+    @NotNull(message = "汇率不能为空")
+    @DecimalMin(value = "0", inclusive = false, message = "汇率必须大于 0")
+    @Digits(integer = 12, fraction = 6, message = "汇率最多 12 位整数和 6 位小数")
+    private BigDecimal exchangeRate;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/digest/FmsDigestRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/digest/FmsDigestRespVO.java
new file mode 100644
index 0000000..029e16d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/digest/FmsDigestRespVO.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.digest;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * FMS 常用摘要 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 常用摘要 Response VO")
+@Data
+public class FmsDigestRespVO {
+
+    @Schema(description = "常用摘要编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long accountSetId;
+
+    @Schema(description = "摘要内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "购买办公用品")
+    private String content;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/digest/FmsDigestSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/digest/FmsDigestSaveReqVO.java
new file mode 100644
index 0000000..2b296a0
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/digest/FmsDigestSaveReqVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.digest;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * FMS 常用摘要保存 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 常用摘要保存 Request VO")
+@Data
+public class FmsDigestSaveReqVO {
+
+    @Schema(description = "常用摘要编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "摘要内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "购买办公用品")
+    @NotBlank(message = "摘要内容不能为空")
+    @Size(max = 500, message = "摘要内容长度不能超过 500 个字符")
+    private String content;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeindicator/FmsFinanceIndicatorRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeindicator/FmsFinanceIndicatorRespVO.java
new file mode 100644
index 0000000..410e1c3
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeindicator/FmsFinanceIndicatorRespVO.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeindicator;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+// TODO DONE @AI：字段 Swagger 注解和空行已补齐。
+@Schema(description = "管理后台 - FMS 财务指标 Response VO")
+@Data
+public class FmsFinanceIndicatorRespVO {
+
+    @Schema(description = "指标编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", example = "1")
+    private Long accountSetId;
+
+    @Schema(description = "指标名称", example = "现金")
+    private String name;
+
+    @Schema(description = "指标编码", example = "cash")
+    private String code;
+
+    @Schema(description = "取数报表类型", example = "1")
+    private Integer type;
+
+    @Schema(description = "指标公式")
+    private String formula;
+
+    @Schema(description = "展示顺序", example = "10")
+    private Integer sort;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeindicator/FmsFinanceIndicatorSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeindicator/FmsFinanceIndicatorSaveReqVO.java
new file mode 100644
index 0000000..91eabdc
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeindicator/FmsFinanceIndicatorSaveReqVO.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeindicator;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsFinanceIndicatorTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+// TODO DONE @AI：字段空行已对齐现有 SaveReqVO。
+@Schema(description = "管理后台 - FMS 财务指标保存 Request VO")
+@Data
+public class FmsFinanceIndicatorSaveReqVO {
+
+    @Schema(description = "指标编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "指标名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "现金")
+    @NotBlank(message = "指标名称不能为空")
+    @Size(max = 100, message = "指标名称长度不能超过 100 个字符")
+    private String name;
+
+    @Schema(description = "指标编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "cash")
+    @NotBlank(message = "指标编码不能为空")
+    @Size(max = 64, message = "指标编码长度不能超过 64 个字符")
+    private String code;
+
+    @Schema(description = "取数报表类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "取数报表类型不能为空")
+    @InEnum(FmsFinanceIndicatorTypeEnum.class)
+    private Integer type;
+
+    @Schema(description = "指标公式，支持 L1+L2 或科目公式 JSON", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotBlank(message = "指标公式不能为空")
+    @Size(max = 2000, message = "指标公式长度不能超过 2000 个字符")
+    private String formula;
+
+    @Schema(description = "展示顺序", example = "10")
+    @NotNull(message = "展示顺序不能为空")
+    private Integer sort;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeparameter/FmsFinanceParameterRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeparameter/FmsFinanceParameterRespVO.java
new file mode 100644
index 0000000..2e31efb
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeparameter/FmsFinanceParameterRespVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeparameter;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 财务参数 Response VO")
+@Data
+public class FmsFinanceParameterRespVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long accountSetId;
+
+    @Schema(description = "科目层级", requiredMode = Schema.RequiredMode.REQUIRED, example = "4")
+    private Integer level;
+
+    @Schema(description = "科目编码规则", requiredMode = Schema.RequiredMode.REQUIRED, example = "4-2-2-2")
+    private String subjectCodeRule;
+
+    @Schema(description = "账簿余额方向模式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer ledgerBalanceMode;
+
+    @Schema(description = "结账前是否要求凭证审核", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean voucherReviewRequired;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeparameter/FmsFinanceParameterUpdateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeparameter/FmsFinanceParameterUpdateReqVO.java
new file mode 100644
index 0000000..6299af4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/financeparameter/FmsFinanceParameterUpdateReqVO.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeparameter;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.ledger.FmsLedgerBalanceModeEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountingStandardEnum;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 财务参数更新 Request VO")
+@Data
+public class FmsFinanceParameterUpdateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "会计制度", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "会计制度不能为空")
+    @InEnum(FmsAccountingStandardEnum.class)
+    @DiffLogField(name = "会计制度")
+    private Integer standard;
+
+    @Schema(description = "科目层级", requiredMode = Schema.RequiredMode.REQUIRED, example = "4")
+    @NotNull(message = "科目层级不能为空")
+    @Min(value = 1, message = "科目层级不能小于 1")
+    @Max(value = 8, message = "科目层级不能大于 8")
+    @DiffLogField(name = "科目层级")
+    private Integer level;
+
+    @Schema(description = "科目编码规则", requiredMode = Schema.RequiredMode.REQUIRED, example = "4-2-2-2")
+    @NotBlank(message = "科目编码规则不能为空")
+    @Size(max = 64, message = "科目编码规则不能超过 64 个字符")
+    @DiffLogField(name = "科目编码规则")
+    private String subjectCodeRule;
+
+    @Schema(description = "账簿余额方向模式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账簿余额方向模式不能为空")
+    @InEnum(FmsLedgerBalanceModeEnum.class)
+    @DiffLogField(name = "账簿余额方向")
+    private Integer ledgerBalanceMode;
+
+    @Schema(description = "结账前是否要求凭证审核", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "结账前凭证审核设置不能为空")
+    @DiffLogField(name = "凭证审核后才允许结账")
+    private Boolean voucherReviewRequired;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceExcelVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceExcelVO.java
new file mode 100644
index 0000000..df1e229
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceExcelVO.java
@@ -0,0 +1,105 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 初始余额 Excel VO
+ *
+ * @author 芋道源码
+ */
+@Data
+@ExcelIgnoreUnannotated
+public class FmsInitialBalanceExcelVO {
+
+    /**
+     * Excel 行号
+     */
+    private Integer rowNumber;
+    /**
+     * 科目编码
+     */
+    @ExcelProperty("科目编码")
+    private String subjectCode;
+    /**
+     * 科目名称
+     */
+    @ExcelProperty("科目名称")
+    private String subjectName;
+    /**
+     * 余额方向名称
+     */
+    @ExcelProperty("方向")
+    private String directionName;
+    /**
+     * 辅助核算项目，格式为“类别:名称/类别:名称”
+     */
+    @ExcelProperty("辅助核算项目")
+    private String auxiliaryItems;
+    /**
+     * 科目类型
+     */
+    private Integer subjectType;
+    /**
+     * 是否启用数量核算
+     */
+    private Boolean quantityAccounting;
+    /**
+     * 是否启用辅助核算
+     */
+    private Boolean auxiliaryAccounting;
+    /**
+     * 期初数量
+     */
+    @ExcelProperty("期初数量")
+    private BigDecimal openingQuantity;
+    /**
+     * 期初金额
+     */
+    @ExcelProperty("期初金额")
+    private BigDecimal openingAmount;
+    /**
+     * 本年累计借方数量
+     */
+    @ExcelProperty("本年累计借方数量")
+    private BigDecimal yearDebitQuantity;
+    /**
+     * 本年累计借方金额
+     */
+    @ExcelProperty("本年累计借方金额")
+    private BigDecimal yearDebitAmount;
+    /**
+     * 本年累计贷方数量
+     */
+    @ExcelProperty("本年累计贷方数量")
+    private BigDecimal yearCreditQuantity;
+    /**
+     * 本年累计贷方金额
+     */
+    @ExcelProperty("本年累计贷方金额")
+    private BigDecimal yearCreditAmount;
+    /**
+     * 年初数量
+     */
+    @ExcelProperty("年初数量")
+    private BigDecimal yearOpeningQuantity;
+    /**
+     * 年初金额
+     */
+    @ExcelProperty("年初金额")
+    private BigDecimal yearOpeningAmount;
+    /**
+     * 实际损益发生数量
+     */
+    @ExcelProperty("实际损益发生数量")
+    private BigDecimal profitLossQuantity;
+    /**
+     * 实际损益发生金额
+     */
+    @ExcelProperty("实际损益发生金额")
+    private BigDecimal profitLossAmount;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceRespVO.java
new file mode 100644
index 0000000..8a8cfc2
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceRespVO.java
@@ -0,0 +1,154 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 初始余额 Response VO")
+@Data
+public class FmsInitialBalanceRespVO {
+
+    @Schema(description = "初始余额编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String subjectCode;
+
+    @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String subjectName;
+
+    @Schema(description = "上级科目编号", example = "1024")
+    private Long parentId;
+
+    @Schema(description = "科目类型", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer type;
+
+    @Schema(description = "余额方向", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer balanceDirection;
+
+    @Schema(description = "是否启用数量核算", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean quantityAccounting;
+
+    @Schema(description = "数量单位")
+    private String quantityUnit;
+
+    @Schema(description = "是否启用辅助核算", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean auxiliaryAccounting;
+
+    @Schema(description = "期初金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000.00")
+    private BigDecimal openingAmount;
+
+    @Schema(description = "期初数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10.0000")
+    private BigDecimal openingQuantity;
+
+    @Schema(description = "本年累计借方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    private BigDecimal yearDebitAmount;
+
+    @Schema(description = "本年累计借方数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.0000")
+    private BigDecimal yearDebitQuantity;
+
+    @Schema(description = "本年累计贷方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "50.00")
+    private BigDecimal yearCreditAmount;
+
+    @Schema(description = "本年累计贷方数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.0000")
+    private BigDecimal yearCreditQuantity;
+
+    @Schema(description = "年初金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "950.00")
+    private BigDecimal yearOpeningAmount;
+
+    @Schema(description = "年初数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10.0000")
+    private BigDecimal yearOpeningQuantity;
+
+    @Schema(description = "实际损益发生额", requiredMode = Schema.RequiredMode.REQUIRED, example = "0.00")
+    private BigDecimal profitLossAmount;
+
+    @Schema(description = "实际损益发生数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.0000")
+    private BigDecimal profitLossQuantity;
+
+    @Schema(description = "辅助核算配置数组")
+    private List<AuxiliaryConfig> auxiliaryConfigs;
+
+    @Schema(description = "辅助核算余额数组")
+    private List<AssistBalance> assistBalances;
+
+    @Schema(description = "管理后台 - FMS 初始余额辅助核算配置")
+    @Data
+    public static class AuxiliaryConfig {
+
+        @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long auxiliaryTypeId;
+
+        @Schema(description = "辅助核算类型", requiredMode = Schema.RequiredMode.REQUIRED)
+        private Integer type;
+
+        @Schema(description = "辅助核算类别名称", requiredMode = Schema.RequiredMode.REQUIRED)
+        private String name;
+
+    }
+
+    @Schema(description = "管理后台 - FMS 初始余额辅助核算余额")
+    @Data
+    public static class AssistBalance {
+
+        @Schema(description = "辅助核算组合编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long assistCombinationId;
+
+        @Schema(description = "辅助核算项目数组", requiredMode = Schema.RequiredMode.REQUIRED)
+        private List<AuxiliaryItem> auxiliaries;
+
+        @Schema(description = "期初金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000.00")
+        private BigDecimal openingAmount;
+
+        @Schema(description = "期初数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10.0000")
+        private BigDecimal openingQuantity;
+
+        @Schema(description = "本年累计借方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+        private BigDecimal yearDebitAmount;
+
+        @Schema(description = "本年累计借方数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.0000")
+        private BigDecimal yearDebitQuantity;
+
+        @Schema(description = "本年累计贷方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "50.00")
+        private BigDecimal yearCreditAmount;
+
+        @Schema(description = "本年累计贷方数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.0000")
+        private BigDecimal yearCreditQuantity;
+
+        @Schema(description = "年初金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "950.00")
+        private BigDecimal yearOpeningAmount;
+
+        @Schema(description = "年初数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10.0000")
+        private BigDecimal yearOpeningQuantity;
+
+        @Schema(description = "实际损益发生额", requiredMode = Schema.RequiredMode.REQUIRED, example = "0.00")
+        private BigDecimal profitLossAmount;
+
+        @Schema(description = "实际损益发生数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.0000")
+        private BigDecimal profitLossQuantity;
+
+    }
+
+    @Schema(description = "管理后台 - FMS 初始余额辅助核算项目")
+    @Data
+    public static class AuxiliaryItem {
+
+        @Schema(description = "辅助核算类型", requiredMode = Schema.RequiredMode.REQUIRED)
+        private Integer type;
+
+        @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long typeId;
+
+        @Schema(description = "辅助核算项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long itemId;
+
+        @Schema(description = "辅助核算项目名称", requiredMode = Schema.RequiredMode.REQUIRED)
+        private String name;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceSaveReqVO.java
new file mode 100644
index 0000000..6f8b2a7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsInitialBalanceSaveReqVO.java
@@ -0,0 +1,91 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 初始余额保存 Request VO")
+@Data
+public class FmsInitialBalanceSaveReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "科目余额数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "科目余额不能为空")
+    private List<Balance> balances;
+
+    @Data
+    public static class Balance extends Amounts {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "科目编号不能为空")
+        private Long subjectId;
+
+        @Schema(description = "辅助核算余额数组")
+        @Valid
+        private List<AssistBalance> assistBalances;
+
+    }
+
+    @Data
+    public static class AssistBalance extends Amounts {
+
+        @Schema(description = "辅助核算项目编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+        @NotEmpty(message = "辅助核算项目不能为空")
+        private List<Long> auxiliaryItemIds;
+    }
+
+    @Data
+    public static class Amounts {
+
+        @Schema(description = "期初金额", example = "1000.00")
+        @DecimalMin(value = "0", message = "期初金额不能小于 0")
+        private BigDecimal openingAmount;
+
+        @Schema(description = "期初数量", example = "10.0000")
+        @DecimalMin(value = "0", message = "期初数量不能小于 0")
+        private BigDecimal openingQuantity;
+
+        @Schema(description = "本年累计借方金额", example = "100.00")
+        @DecimalMin(value = "0", message = "本年累计借方金额不能小于 0")
+        private BigDecimal yearDebitAmount;
+
+        @Schema(description = "本年累计借方数量", example = "1.0000")
+        @DecimalMin(value = "0", message = "本年累计借方数量不能小于 0")
+        private BigDecimal yearDebitQuantity;
+
+        @Schema(description = "本年累计贷方金额", example = "50.00")
+        @DecimalMin(value = "0", message = "本年累计贷方金额不能小于 0")
+        private BigDecimal yearCreditAmount;
+
+        @Schema(description = "本年累计贷方数量", example = "1.0000")
+        @DecimalMin(value = "0", message = "本年累计贷方数量不能小于 0")
+        private BigDecimal yearCreditQuantity;
+
+        @Schema(description = "年初金额", example = "950.00")
+        @DecimalMin(value = "0", message = "年初金额不能小于 0")
+        private BigDecimal yearOpeningAmount;
+
+        @Schema(description = "年初数量", example = "10.0000")
+        @DecimalMin(value = "0", message = "年初数量不能小于 0")
+        private BigDecimal yearOpeningQuantity;
+
+        @Schema(description = "实际损益发生额", example = "0.00")
+        @DecimalMin(value = "0", message = "实际损益发生额不能小于 0")
+        private BigDecimal profitLossAmount;
+
+        @Schema(description = "实际损益发生数量", example = "1.0000")
+        @DecimalMin(value = "0", message = "实际损益发生数量不能小于 0")
+        private BigDecimal profitLossQuantity;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsTrialBalanceRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsTrialBalanceRespVO.java
new file mode 100644
index 0000000..94a1689
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/initialbalance/FmsTrialBalanceRespVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 试算平衡 Response VO")
+@Data
+public class FmsTrialBalanceRespVO {
+
+    @Schema(description = "期初借方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000.00")
+    private BigDecimal openingDebitAmount;
+
+    @Schema(description = "期初贷方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1000.00")
+    private BigDecimal openingCreditAmount;
+
+    @Schema(description = "期初差额", requiredMode = Schema.RequiredMode.REQUIRED, example = "0.00")
+    private BigDecimal openingDifferenceAmount;
+
+    @Schema(description = "本年累计借方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    private BigDecimal yearDebitAmount;
+
+    @Schema(description = "本年累计贷方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    private BigDecimal yearCreditAmount;
+
+    @Schema(description = "本年累计差额", requiredMode = Schema.RequiredMode.REQUIRED, example = "0.00")
+    private BigDecimal yearDifferenceAmount;
+
+    @Schema(description = "是否平衡", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean balanced;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectDeleteReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectDeleteReqVO.java
new file mode 100644
index 0000000..34b84fc
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectDeleteReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * FMS 科目删除 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 科目删除 Request VO")
+@Data
+public class FmsSubjectDeleteReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "科目编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "科目编号数组不能为空")
+    private List<Long> ids;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectImportExcelVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectImportExcelVO.java
new file mode 100644
index 0000000..07a8dcf
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectImportExcelVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import cn.idev.excel.annotation.ExcelProperty;
+import jakarta.validation.constraints.NotBlank;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+/**
+ * FMS 科目 Excel 导入 VO
+ *
+ * @author 芋道源码
+ */
+@Data
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+public class FmsSubjectImportExcelVO {
+
+    @ExcelProperty("科目编码")
+    @NotBlank(message = "科目编码不能为空")
+    private String code;
+
+    @ExcelProperty("科目名称")
+    @NotBlank(message = "科目名称不能为空")
+    private String name;
+
+    @ExcelProperty("上级科目编码")
+    private String parentSubjectCode;
+
+    @ExcelProperty("余额方向")
+    @NotBlank(message = "余额方向不能为空")
+    private String balanceDirection;
+
+    @ExcelProperty("类别")
+    @NotBlank(message = "类别不能为空")
+    private String categoryName;
+
+    @ExcelProperty("辅助核算")
+    private String auxiliaryNames;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectImportRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectImportRespVO.java
new file mode 100644
index 0000000..f1691a8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectImportRespVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - FMS 科目导入结果 Response VO")
+@Data
+public class FmsSubjectImportRespVO {
+
+    @Schema(description = "总数量", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer totalCount;
+
+    @Schema(description = "成功科目编码数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> successSubjectCodes;
+
+    @Schema(description = "失败原因 Map", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Map<String, String> failureReasons;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectListReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectListReqVO.java
new file mode 100644
index 0000000..cd84baa
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectListReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+/**
+ * FMS 科目列表 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 科目列表 Request VO")
+@Data
+public class FmsSubjectListReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "科目类型", example = "1")
+    @InEnum(FmsSubjectTypeEnum.class)
+    private Integer type;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectRespVO.java
new file mode 100644
index 0000000..9a4bf25
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectRespVO.java
@@ -0,0 +1,92 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.framework.excel.core.convert.StringListConvert;
+import cn.iocoder.yudao.module.fms.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.module.infra.enums.DictTypeConstants.BOOLEAN_STRING;
+
+/**
+ * FMS 科目 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 科目 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsSubjectRespVO {
+
+    @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long accountSetId;
+
+    @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    @ExcelProperty(value = "编码", index = 0)
+    private String code;
+
+    @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "库存现金")
+    @ExcelProperty(value = "名称", index = 1)
+    private String name;
+
+    @Schema(description = "上级科目编号", example = "1024")
+    private Long parentId;
+
+    @Schema(description = "科目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+    @Schema(description = "科目类别", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer category;
+
+    @JsonIgnore // 仅 excel 导出使用
+    @ExcelProperty(value = "类别", index = 2, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.SUBJECT_CATEGORY)
+    private String categoryDictValue;
+
+    @Schema(description = "余额方向", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @ExcelProperty(value = "余额方向", index = 3, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.DEBIT_CREDIT_DIRECTION)
+    private Integer balanceDirection;
+
+    @Schema(description = "辅助核算类别编号数组")
+    private List<Long> auxiliaryTypeIds;
+
+    @Schema(description = "外币核算币别编号数组")
+    private List<Long> currencyIds;
+
+    @Schema(description = "是否启用数量核算", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean quantityAccounting;
+
+    @Schema(description = "数量单位", example = "件")
+    @ExcelProperty(value = "数量", index = 5)
+    private String quantityUnit;
+
+    @Schema(description = "是否现金及现金等价物", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty(value = "是否现金项", index = 6, converter = DictConvert.class)
+    @DictFormat(BOOLEAN_STRING)
+    private Boolean cash;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer status;
+
+    @Schema(description = "层级", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer level;
+
+    @Schema(description = "辅助核算类别名称数组")
+    @ExcelProperty(value = "辅助核算", index = 4, converter = StringListConvert.class)
+    private List<String> auxiliaryTypeNames;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectSaveReqVO.java
new file mode 100644
index 0000000..9ce9779
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectSaveReqVO.java
@@ -0,0 +1,113 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectCategoryEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * FMS 科目保存 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 科目保存 Request VO")
+@Data
+public class FmsSubjectSaveReqVO {
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    @NotBlank(message = "科目编码不能为空")
+    @Size(max = 64, message = "科目编码长度不能超过 64 个字符")
+    private String code;
+
+    @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "库存现金")
+    @NotBlank(message = "科目名称不能为空")
+    @Size(max = 255, message = "科目名称长度不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "上级科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "上级科目编号不能为空")
+    private Long parentId;
+
+    @Schema(description = "科目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "科目类型不能为空")
+    @InEnum(FmsSubjectTypeEnum.class)
+    private Integer type;
+
+    @Schema(description = "科目类别", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "科目类别不能为空")
+    private Integer category;
+
+    @Schema(description = "余额方向", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "余额方向不能为空")
+    @InEnum(FmsDebitCreditDirectionEnum.class)
+    private Integer balanceDirection;
+
+    @Schema(description = "辅助核算类别编号数组")
+    @NotNull(message = "辅助核算类别编号数组不能为空")
+    private List<Long> auxiliaryTypeIds;
+
+    @Schema(description = "外币核算币别编号数组")
+    @NotNull(message = "外币核算币别编号数组不能为空")
+    private List<Long> currencyIds;
+
+    @Schema(description = "是否启用数量核算", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "是否启用数量核算不能为空")
+    private Boolean quantityAccounting;
+
+    @Schema(description = "数量单位", example = "件")
+    @Size(max = 255, message = "数量单位长度不能超过 255 个字符")
+    private String quantityUnit;
+
+    @Schema(description = "是否现金及现金等价物", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "是否现金及现金等价物不能为空")
+    private Boolean cash;
+
+    @Schema(description = "是否迁移上级科目历史数据")
+    private Boolean migrateParentData;
+
+    @Schema(description = "辅助核算历史数据迁移项目数组")
+    private List<AuxiliaryMapping> auxiliaryMappings;
+
+    @AssertTrue(message = "科目类别与科目类型不匹配")
+    public boolean isCategoryValid() {
+        return type == null || category == null || FmsSubjectCategoryEnum.valueOf(type, category) != null;
+    }
+
+    @AssertTrue(message = "启用数量核算时数量单位不能为空")
+    public boolean isQuantityUnitValid() {
+        return !Boolean.TRUE.equals(quantityAccounting) || StrUtil.isNotBlank(quantityUnit);
+    }
+
+    /**
+     * 辅助核算历史数据迁移项目
+     */
+    @Data
+    public static class AuxiliaryMapping {
+
+        @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "辅助核算类别编号不能为空")
+        private Long typeId;
+
+        @Schema(description = "辅助核算项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "辅助核算项目编号不能为空")
+        private Long itemId;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectStatusReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectStatusReqVO.java
new file mode 100644
index 0000000..80d8685
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectStatusReqVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * FMS 科目状态更新 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 科目状态更新 Request VO")
+@Data
+public class FmsSubjectStatusReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "科目编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "科目编号数组不能为空")
+    private List<Long> ids;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "状态不能为空")
+    @InEnum(CommonStatusEnum.class)
+    private Integer status;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectUsageRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectUsageRespVO.java
new file mode 100644
index 0000000..1d0939f
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/subject/FmsSubjectUsageRespVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+/**
+ * FMS 科目使用情况 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 科目使用情况 Response VO")
+@Data
+public class FmsSubjectUsageRespVO {
+
+    @Schema(description = "下级科目数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Long childCount;
+
+    @Schema(description = "凭证分录数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Long voucherEntryCount;
+
+    @Schema(description = "初始余额数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long initialBalanceCount;
+
+    @Schema(description = "辅助核算组合数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    private Long auxiliaryCombinationCount;
+
+    @Schema(description = "包含数量数据的记录数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long quantityDataCount;
+
+    @Schema(description = "是否已被业务使用", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean used;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateEntryVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateEntryVO.java
new file mode 100644
index 0000000..45c3751
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateEntryVO.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证模板分录 VO")
+@Data
+public class FmsVoucherTemplateEntryVO {
+
+    @Schema(description = "摘要内容", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotBlank(message = "摘要不能为空")
+    @Size(max = 500, message = "摘要长度不能超过 500 个字符")
+    private String digest;
+
+    @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "科目不能为空")
+    private Long subjectId;
+
+    @Schema(description = "数量")
+    @DecimalMin(value = "0", message = "数量不能小于 0")
+    @Digits(integer = 14, fraction = 4, message = "数量最多保留 4 位小数")
+    private BigDecimal quantity;
+
+    @Schema(description = "单价")
+    @DecimalMin(value = "0", message = "单价不能小于 0")
+    @Digits(integer = 12, fraction = 6, message = "单价最多保留 6 位小数")
+    private BigDecimal unitPrice;
+
+    @Schema(description = "借方金额")
+    @Digits(integer = 16, fraction = 2, message = "借方金额最多保留 2 位小数")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额")
+    @Digits(integer = 16, fraction = 2, message = "贷方金额最多保留 2 位小数")
+    private BigDecimal creditAmount;
+
+    @Schema(description = "辅助核算项目数组")
+    @Valid
+    private List<AuxiliaryItem> auxiliaries;
+
+    @Schema(description = "管理后台 - FMS 凭证模板分录辅助核算项目")
+    @Data
+    public static class AuxiliaryItem {
+
+        @Schema(description = "辅助核算类型")
+        private Integer type;
+
+        @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED)
+        @NotNull(message = "辅助核算类别不能为空")
+        private Long typeId;
+
+        @Schema(description = "辅助核算项目编号", requiredMode = Schema.RequiredMode.REQUIRED)
+        @NotNull(message = "辅助核算项目不能为空")
+        private Long itemId;
+
+        @Schema(description = "辅助核算项目名称")
+        private String name;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateRespVO.java
new file mode 100644
index 0000000..736c8c4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateRespVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证模板 Response VO")
+@Data
+public class FmsVoucherTemplateRespVO {
+
+    @Schema(description = "模板编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long accountSetId;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String name;
+
+    @Schema(description = "分类编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long categoryId;
+
+    @Schema(description = "分类名称", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String categoryName;
+
+    @Schema(description = "凭证模板分录数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<FmsVoucherTemplateEntryVO> entries;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateSaveReqVO.java
new file mode 100644
index 0000000..1c53561
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplate/FmsVoucherTemplateSaveReqVO.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证模板保存 Request VO")
+@Data
+public class FmsVoucherTemplateSaveReqVO {
+
+    @Schema(description = "模板编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "办公用品采购")
+    @NotBlank(message = "模板名称不能为空")
+    @Size(max = 255, message = "模板名称长度不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "分类编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "模板分类不能为空")
+    private Long categoryId;
+
+    @Schema(description = "凭证模板分录数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "凭证模板分录不能为空")
+    @Size(min = 2, message = "凭证模板至少需要两条分录")
+    private List<FmsVoucherTemplateEntryVO> entries;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplatecategory/FmsVoucherTemplateCategoryRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplatecategory/FmsVoucherTemplateCategoryRespVO.java
new file mode 100644
index 0000000..c82bac6
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplatecategory/FmsVoucherTemplateCategoryRespVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplatecategory;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 凭证模板分类 Response VO")
+@Data
+public class FmsVoucherTemplateCategoryRespVO {
+
+    @Schema(description = "分类编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long accountSetId;
+
+    @Schema(description = "分类名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "日常收支")
+    private String name;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplatecategory/FmsVoucherTemplateCategorySaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplatecategory/FmsVoucherTemplateCategorySaveReqVO.java
new file mode 100644
index 0000000..73777fd
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/vouchertemplatecategory/FmsVoucherTemplateCategorySaveReqVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplatecategory;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 凭证模板分类保存 Request VO")
+@Data
+public class FmsVoucherTemplateCategorySaveReqVO {
+
+    @Schema(description = "分类编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "分类名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "日常收支")
+    @NotBlank(message = "分类名称不能为空")
+    @Size(max = 255, message = "分类名称长度不能超过 255 个字符")
+    private String name;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/voucherword/FmsVoucherWordRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/voucherword/FmsVoucherWordRespVO.java
new file mode 100644
index 0000000..49fcad9
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/voucherword/FmsVoucherWordRespVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.voucherword;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+/**
+ * FMS 凭证字 Response VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 凭证字 Response VO")
+@Data
+public class FmsVoucherWordRespVO {
+
+    @Schema(description = "凭证字编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "凭证字", requiredMode = Schema.RequiredMode.REQUIRED, example = "记")
+    private String name;
+
+    @Schema(description = "打印标题", example = "记账凭证")
+    private String printTitle;
+
+    @Schema(description = "是否默认凭证字", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean defaultStatus;
+
+    @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer sort;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long accountSetId;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/voucherword/FmsVoucherWordSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/voucherword/FmsVoucherWordSaveReqVO.java
new file mode 100644
index 0000000..1753ddf
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/config/vo/voucherword/FmsVoucherWordSaveReqVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.fms.controller.admin.config.vo.voucherword;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+/**
+ * FMS 凭证字保存 Request VO
+ *
+ * @author 芋道源码
+ */
+@Schema(description = "管理后台 - FMS 凭证字保存 Request VO")
+@Data
+public class FmsVoucherWordSaveReqVO {
+
+    @Schema(description = "凭证字编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "凭证字", requiredMode = Schema.RequiredMode.REQUIRED, example = "记")
+    @NotBlank(message = "凭证字不能为空")
+    @Size(max = 255, message = "凭证字长度不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "打印标题", example = "记账凭证")
+    @Size(max = 255, message = "打印标题长度不能超过 255 个字符")
+    private String printTitle;
+
+    @Schema(description = "是否默认凭证字", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "是否默认凭证字不能为空")
+    private Boolean defaultStatus;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/FmsHomeController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/FmsHomeController.java
new file mode 100644
index 0000000..45322b5
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/FmsHomeController.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.fms.controller.admin.home;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeMetricDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeRespVO;
+import cn.iocoder.yudao.module.fms.service.home.FmsHomeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 首页")
+@RestController
+@RequestMapping("/fms/home")
+@Validated
+public class FmsHomeController {
+
+    @Resource
+    private FmsHomeService homeService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得首页")
+    @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('fms:home:query')")
+    public CommonResult<FmsHomeRespVO> getHome(@RequestParam("accountSetId") @NotNull Long accountSetId) {
+        return success(homeService.getHome(accountSetId, getLoginUserId()));
+    }
+
+    @GetMapping("/metric-detail")
+    @Operation(summary = "获得财务指标明细")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true, example = "1024"),
+            @Parameter(name = "metricKey", description = "财务指标标识", required = true, example = "income")
+    })
+    @PreAuthorize("@ss.hasPermission('fms:home:query')")
+    public CommonResult<FmsHomeMetricDetailRespVO> getMetricDetail(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("metricKey") @NotBlank String metricKey) {
+        return success(homeService.getMetricDetail(accountSetId, metricKey, getLoginUserId()));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/vo/FmsHomeMetricDetailRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/vo/FmsHomeMetricDetailRespVO.java
new file mode 100644
index 0000000..fdc7e11
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/vo/FmsHomeMetricDetailRespVO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.fms.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 首页财务指标明细 Response VO")
+@Data
+public class FmsHomeMetricDetailRespVO {
+
+    @Schema(description = "指标标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "income")
+    private String key;
+
+    @Schema(description = "指标名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "收入")
+    private String name;
+
+    @Schema(description = "财务指标趋势数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<Trend> trends;
+
+    @Schema(description = "当期科目构成数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<Structure> structure;
+
+    @Schema(description = "管理后台 - FMS 首页财务指标趋势 Response VO")
+    @Data
+    public static class Trend {
+
+        @Schema(description = "会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+        private String month;
+
+        @Schema(description = "指标金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "10000.00")
+        private BigDecimal amount;
+
+    }
+
+    @Schema(description = "管理后台 - FMS 首页财务指标科目构成 Response VO")
+    @Data
+    public static class Structure {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long subjectId;
+
+        @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "5001")
+        private String subjectCode;
+
+        @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "主营业务收入")
+        private String subjectName;
+
+        @Schema(description = "科目金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "8000.00")
+        private BigDecimal amount;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/vo/FmsHomeRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/vo/FmsHomeRespVO.java
new file mode 100644
index 0000000..fc0a97c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/home/vo/FmsHomeRespVO.java
@@ -0,0 +1,64 @@
+package cn.iocoder.yudao.module.fms.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 首页 Response VO")
+@Data
+public class FmsHomeRespVO {
+
+    @Schema(description = "当前会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    private String currentMonth;
+
+    @Schema(description = "当期财务指标数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<Metric> metrics;
+
+    @Schema(description = "财务指标趋势数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<Trend> trends;
+
+    @Schema(description = "管理后台 - FMS 首页财务指标 Response VO")
+    @Data
+    public static class Metric {
+
+        @Schema(description = "指标标识", requiredMode = Schema.RequiredMode.REQUIRED, example = "income")
+        private String key;
+
+        @Schema(description = "指标名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "收入")
+        private String name;
+
+        @Schema(description = "指标金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "10000.00")
+        private BigDecimal amount;
+
+    }
+
+    @Schema(description = "管理后台 - FMS 首页财务指标趋势 Response VO")
+    @Data
+    public static class Trend {
+
+        @Schema(description = "会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+        private String month;
+
+        @Schema(description = "动态财务指标数组", requiredMode = Schema.RequiredMode.REQUIRED)
+        private List<Metric> metrics;
+
+        @Schema(description = "收入", requiredMode = Schema.RequiredMode.REQUIRED)
+        private BigDecimal income;
+
+        @Schema(description = "成本", requiredMode = Schema.RequiredMode.REQUIRED)
+        private BigDecimal operatingCost;
+
+        @Schema(description = "利润", requiredMode = Schema.RequiredMode.REQUIRED)
+        private BigDecimal profit;
+
+        @Schema(description = "费用", requiredMode = Schema.RequiredMode.REQUIRED)
+        private BigDecimal expense;
+
+        @Schema(description = "其他", requiredMode = Schema.RequiredMode.REQUIRED)
+        private BigDecimal other;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerController.java
new file mode 100644
index 0000000..5b606e4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerController.java
@@ -0,0 +1,236 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerAuxiliaryListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarybalance.FmsLedgerAuxiliaryBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarydetail.FmsLedgerAuxiliaryDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailExportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.general.FmsLedgerGeneralRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.multicolumn.FmsLedgerMultiColumnRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitydetail.FmsLedgerQuantityDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitygeneral.FmsLedgerQuantityGeneralRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 账簿")
+@RestController
+@RequestMapping("/fms/ledger")
+@Validated
+public class FmsLedgerController {
+
+    @Resource
+    private FmsLedgerService ledgerService;
+
+    // ==================== 明细账 ====================
+
+    @GetMapping("/detail/list")
+    @Operation(summary = "获得明细账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:detail:query')")
+    public CommonResult<List<FmsLedgerDetailRespVO>> getDetailList(@Valid FmsLedgerListReqVO listReqVO) {
+        return success(ledgerService.getDetailList(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/detail/subject-list")
+    @Operation(summary = "获得指定期间有发生额的明细账科目")
+    public CommonResult<List<FmsSubjectRespVO>> getDetailSubjectList(@Valid FmsLedgerListReqVO listReqVO) {
+        // TODO @AI：先查询出来，list 变量；然后在去 convert；字段不多，倒是可以考虑 beanutils 去 copy 下？
+        return success(convertList(ledgerService.getDetailSubjectList(listReqVO, getLoginUserId()), subject ->
+                new FmsSubjectRespVO().setId(subject.getId()).setParentId(subject.getParentId())
+                        .setCode(subject.getCode()).setName(subject.getName()).setType(subject.getType())
+                        .setBalanceDirection(subject.getBalanceDirection()).setStatus(subject.getStatus())
+                        .setLevel(subject.getLevel()).setAuxiliaryTypeIds(subject.getAuxiliaryTypeIds())
+                        .setQuantityAccounting(subject.getQuantityAccounting()).setQuantityUnit(subject.getQuantityUnit())));
+    }
+
+    @GetMapping("/detail/export-excel")
+    @Operation(summary = "导出明细账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:detail:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportDetail(@Valid FmsLedgerListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        List<FmsLedgerDetailExportRespVO> rows = convertList(
+                ledgerService.getDetailList(listReqVO, getLoginUserId()), item ->
+                        BeanUtils.toBean(item, FmsLedgerDetailExportRespVO.class)
+                                .setSubject(item.getSubjectCode() + " " + item.getSubjectName()));
+        ExcelUtils.write(response, "明细账.xls", "明细账", FmsLedgerDetailExportRespVO.class, rows);
+    }
+
+    // ==================== 总账 ====================
+
+    @GetMapping("/general/list")
+    @Operation(summary = "获得总账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:general:query')")
+    public CommonResult<List<FmsLedgerGeneralRespVO>> getGeneralList(@Valid FmsLedgerListReqVO listReqVO) {
+        return success(ledgerService.getGeneralList(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/general/export-excel")
+    @Operation(summary = "导出总账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:general:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportGeneral(@Valid FmsLedgerListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        ExcelUtils.write(response, "总账.xls", "总账", FmsLedgerGeneralRespVO.class,
+                ledgerService.getGeneralList(listReqVO, getLoginUserId()));
+    }
+
+    // ==================== 科目余额表 ====================
+
+    @GetMapping("/subject-balance/list")
+    @Operation(summary = "获得科目余额表")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:subject-balance:query')")
+    public CommonResult<List<FmsLedgerSubjectBalanceRespVO>> getSubjectBalanceList(@Valid FmsLedgerListReqVO listReqVO) {
+        return success(ledgerService.getSubjectBalanceList(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/subject-balance/export-excel")
+    @Operation(summary = "导出科目余额表")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:subject-balance:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportSubjectBalance(@Valid FmsLedgerListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        ExcelUtils.write(response, "科目余额表.xls", "科目余额表", FmsLedgerSubjectBalanceRespVO.class,
+                flattenSubjectBalanceList(ledgerService.getSubjectBalanceList(listReqVO, getLoginUserId())));
+    }
+
+    // ==================== 多栏账 ====================
+
+    @GetMapping("/multi-column/list")
+    @Operation(summary = "获得多栏账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:multi-column:query')")
+    public CommonResult<FmsLedgerMultiColumnRespVO> getMultiColumn(@Valid FmsLedgerListReqVO listReqVO) {
+        return success(ledgerService.getMultiColumn(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/multi-column/export-excel")
+    @Operation(summary = "导出多栏账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:multi-column:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportMultiColumn(@Valid FmsLedgerListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        FmsLedgerMultiColumnRespVO result = ledgerService.getMultiColumn(listReqVO, getLoginUserId());
+        ExcelUtils.write(response, "多栏账.xls", "多栏账",
+                FmsLedgerMultiColumnExcelHelper.buildHead(result),
+                FmsLedgerMultiColumnExcelHelper.buildData(result));
+    }
+
+    // ==================== 核算项目明细账 ====================
+
+    @GetMapping("/auxiliary-detail/list")
+    @Operation(summary = "获得核算项目明细账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:detail:query')")
+    public CommonResult<List<FmsLedgerAuxiliaryDetailRespVO>> getAuxiliaryDetailList(@Valid FmsLedgerAuxiliaryListReqVO listReqVO) {
+        return success(ledgerService.getAuxiliaryDetailList(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/auxiliary-detail/export-excel")
+    @Operation(summary = "导出核算项目明细账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:detail:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportAuxiliaryDetail(@Valid FmsLedgerAuxiliaryListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        ExcelUtils.write(response, "核算项目明细账.xls", "核算项目明细账",
+                FmsLedgerAuxiliaryDetailRespVO.class,
+                ledgerService.getAuxiliaryDetailList(listReqVO, getLoginUserId()));
+    }
+
+    // ==================== 核算项目余额表 ====================
+
+    @GetMapping("/auxiliary-balance/list")
+    @Operation(summary = "获得核算项目余额表")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:subject-balance:query')")
+    public CommonResult<List<FmsLedgerAuxiliaryBalanceRespVO>> getAuxiliaryBalanceList(@Valid FmsLedgerAuxiliaryListReqVO listReqVO) {
+        return success(ledgerService.getAuxiliaryBalanceList(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/auxiliary-balance/export-excel")
+    @Operation(summary = "导出核算项目余额表")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:subject-balance:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportAuxiliaryBalance(@Valid FmsLedgerAuxiliaryListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        ExcelUtils.write(response, "核算项目余额表.xls", "核算项目余额表",
+                FmsLedgerAuxiliaryBalanceRespVO.class,
+                ledgerService.getAuxiliaryBalanceList(listReqVO, getLoginUserId()));
+    }
+
+    // ==================== 数量金额明细账 ====================
+
+    @GetMapping("/quantity-detail/list")
+    @Operation(summary = "获得数量金额明细账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:detail:query')")
+    public CommonResult<List<FmsLedgerQuantityDetailRespVO>> getQuantityDetailList(@Valid FmsLedgerListReqVO listReqVO) {
+        return success(ledgerService.getQuantityDetailList(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/quantity-detail/export-excel")
+    @Operation(summary = "导出数量金额明细账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:detail:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportQuantityDetail(@Valid FmsLedgerListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        ExcelUtils.write(response, "数量金额明细账.xls", "数量金额明细账",
+                FmsLedgerQuantityDetailRespVO.class,
+                ledgerService.getQuantityDetailList(listReqVO, getLoginUserId()));
+    }
+
+    // ==================== 数量金额总账 ====================
+
+    @GetMapping("/quantity-general/list")
+    @Operation(summary = "获得数量金额总账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:general:query')")
+    public CommonResult<List<FmsLedgerQuantityGeneralRespVO>> getQuantityGeneralList(@Valid FmsLedgerListReqVO listReqVO) {
+        return success(ledgerService.getQuantityGeneralList(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/quantity-general/export-excel")
+    @Operation(summary = "导出数量金额总账")
+    @PreAuthorize("@ss.hasPermission('fms:ledger:general:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportQuantityGeneral(@Valid FmsLedgerListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        ExcelUtils.write(response, "数量金额总账.xls", "数量金额总账",
+                FmsLedgerQuantityGeneralRespVO.class,
+                flattenQuantityGeneralList(ledgerService.getQuantityGeneralList(
+                        listReqVO, getLoginUserId())));
+    }
+
+    private static List<FmsLedgerSubjectBalanceRespVO> flattenSubjectBalanceList(List<FmsLedgerSubjectBalanceRespVO> list) {
+        List<FmsLedgerSubjectBalanceRespVO> result = new ArrayList<>();
+        list.forEach(item -> {
+            result.add(item);
+            result.addAll(flattenSubjectBalanceList(item.getChildren()));
+        });
+        return result;
+    }
+
+    private static List<FmsLedgerQuantityGeneralRespVO> flattenQuantityGeneralList(List<FmsLedgerQuantityGeneralRespVO> list) {
+        List<FmsLedgerQuantityGeneralRespVO> result = new ArrayList<>();
+        list.forEach(item -> {
+            if (Boolean.TRUE.equals(item.getQuantityAccounting()) || CollUtil.isNotEmpty(item.getChildren())) {
+                result.add(item);
+            }
+            result.addAll(flattenQuantityGeneralList(item.getChildren()));
+        });
+        return result;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerMultiColumnExcelHelper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerMultiColumnExcelHelper.java
new file mode 100644
index 0000000..79ec67b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerMultiColumnExcelHelper.java
@@ -0,0 +1,81 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.multicolumn.FmsLedgerMultiColumnRespVO;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+
+/**
+ * FMS 多栏账 Excel 构建工具
+ *
+ * @author 芋道源码
+ */
+public class FmsLedgerMultiColumnExcelHelper {
+
+    private FmsLedgerMultiColumnExcelHelper() {
+    }
+
+    /**
+     * 构建多栏账动态表头
+     *
+     * @param result 多栏账结果
+     * @return 动态表头
+     */
+    public static List<List<String>> buildHead(FmsLedgerMultiColumnRespVO result) {
+        List<List<String>> head = new ArrayList<>();
+        head.add(Arrays.asList("日期", "日期"));
+        head.add(Arrays.asList("凭证字号", "凭证字号"));
+        head.add(Arrays.asList("摘要", "摘要"));
+        head.add(Arrays.asList("发生额", "借方"));
+        head.add(Arrays.asList("发生额", "贷方"));
+        head.add(Arrays.asList("余额", "方向"));
+        head.add(Arrays.asList("余额", "金额"));
+        for (FmsLedgerMultiColumnRespVO.Column column : getColumns(result,
+                FmsDebitCreditDirectionEnum.DEBIT.getType())) {
+            head.add(Arrays.asList(FmsDebitCreditDirectionEnum.DEBIT.getName(),
+                    column.getSubjectCode() + "/" + column.getSubjectName()));
+        }
+        for (FmsLedgerMultiColumnRespVO.Column column : getColumns(result,
+                FmsDebitCreditDirectionEnum.CREDIT.getType())) {
+            head.add(Arrays.asList(FmsDebitCreditDirectionEnum.CREDIT.getName(),
+                    column.getSubjectCode() + "/" + column.getSubjectName()));
+        }
+        return head;
+    }
+
+    /**
+     * 构建多栏账动态数据
+     *
+     * @param result 多栏账结果
+     * @return 动态数据
+     */
+    public static List<List<Object>> buildData(FmsLedgerMultiColumnRespVO result) {
+        List<FmsLedgerMultiColumnRespVO.Column> debitColumns = getColumns(
+                result, FmsDebitCreditDirectionEnum.DEBIT.getType());
+        List<FmsLedgerMultiColumnRespVO.Column> creditColumns = getColumns(
+                result, FmsDebitCreditDirectionEnum.CREDIT.getType());
+        List<List<Object>> data = new ArrayList<>();
+        for (FmsLedgerDetailRespVO row : CollUtil.emptyIfNull(result.getRows())) {
+            List<Object> values = new ArrayList<>(Arrays.asList(row.getAccountDate(), row.getVoucherNumber(),
+                    row.getDigest(), row.getDebitAmount(), row.getCreditAmount(),
+                    row.getBalanceDirection(), row.getBalance()));
+            debitColumns.forEach(column -> values.add(row.getColumnAmounts().get(column.getSubjectId())));
+            creditColumns.forEach(column -> values.add(row.getColumnAmounts().get(column.getSubjectId())));
+            data.add(values);
+        }
+        return data;
+    }
+
+    private static List<FmsLedgerMultiColumnRespVO.Column> getColumns(
+            FmsLedgerMultiColumnRespVO result, Integer balanceDirection) {
+        return filterList(CollUtil.emptyIfNull(result.getColumns()),
+                column -> balanceDirection.equals(column.getBalanceDirection()));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerAuxiliaryListReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerAuxiliaryListReqVO.java
new file mode 100644
index 0000000..7c7305b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerAuxiliaryListReqVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 核算项目账簿列表查询 Request VO")
+@Data
+public class FmsLedgerAuxiliaryListReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "开始会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotNull(message = "开始会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "开始会计期间格式不正确")
+    private String startMonth;
+
+    @Schema(description = "结束会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-12")
+    @NotNull(message = "结束会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "结束会计期间格式不正确")
+    private String endMonth;
+
+    @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "辅助核算类别编号不能为空")
+    private Long auxiliaryTypeId;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "辅助核算项目编号", example = "1024")
+    private Long auxiliaryItemId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerEntryVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerEntryVO.java
new file mode 100644
index 0000000..15c7206
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerEntryVO.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo;
+
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * FMS 账簿凭证分录 VO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class FmsLedgerEntryVO {
+
+    /**
+     * 分录编号
+     */
+    private Long entryId;
+    /**
+     * 凭证编号
+     */
+    private Long voucherId;
+    /**
+     * 科目编号
+     */
+    private Long subjectId;
+    /**
+     * 凭证日期
+     */
+    private LocalDateTime voucherTime;
+    /**
+     * 凭证号
+     */
+    private Integer voucherNumber;
+    /**
+     * 凭证字名称
+     */
+    private String voucherWordName;
+    /**
+     * 摘要内容
+     */
+    private String digest;
+    /**
+     * 借方金额
+     */
+    private BigDecimal debitAmount;
+    /**
+     * 贷方金额
+     */
+    private BigDecimal creditAmount;
+    /**
+     * 数量
+     */
+    private BigDecimal quantity;
+    /**
+     * 单价
+     */
+    private BigDecimal unitPrice;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 辅助核算组合编号
+     */
+    private Long assistCombinationId;
+    /**
+     * 辅助核算项目数组
+     */
+    private List<FmsVoucherEntryDO.AuxiliaryItem> auxiliaries;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerListReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerListReqVO.java
new file mode 100644
index 0000000..8de281c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/FmsLedgerListReqVO.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 账簿列表查询 Request VO")
+@Data
+public class FmsLedgerListReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "开始会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotNull(message = "开始会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "开始会计期间格式不正确")
+    private String startMonth;
+
+    @Schema(description = "结束会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-12")
+    @NotNull(message = "结束会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "结束会计期间格式不正确")
+    private String endMonth;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "起始科目编号", example = "1024")
+    private Long startSubjectId;
+
+    @Schema(description = "结束科目编号", example = "2048")
+    private Long endSubjectId;
+
+    @Schema(description = "最小科目级次", example = "1")
+    @Min(value = 1, message = "最小科目级次不能小于 1")
+    @Max(value = 10, message = "最小科目级次不能大于 10")
+    private Integer minLevel;
+
+    @Schema(description = "最大科目级次", example = "4")
+    @Min(value = 1, message = "最大科目级次不能小于 1")
+    @Max(value = 10, message = "最大科目级次不能大于 10")
+    private Integer maxLevel;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/auxiliarybalance/FmsLedgerAuxiliaryBalanceRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/auxiliarybalance/FmsLedgerAuxiliaryBalanceRespVO.java
new file mode 100644
index 0000000..c4f53e0
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/auxiliarybalance/FmsLedgerAuxiliaryBalanceRespVO.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarybalance;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 核算项目余额 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsLedgerAuxiliaryBalanceRespVO {
+
+    @Schema(description = "辅助核算项目编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long auxiliaryItemId;
+
+    @Schema(description = "编码", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("编码")
+    private String code;
+
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("项目名称")
+    private String name;
+
+    @Schema(description = "期初借方余额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("期初借方")
+    private BigDecimal openingDebitAmount;
+
+    @Schema(description = "期初贷方余额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("期初贷方")
+    private BigDecimal openingCreditAmount;
+
+    @Schema(description = "本期借方发生额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("本期借方")
+    private BigDecimal periodDebitAmount;
+
+    @Schema(description = "本期贷方发生额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("本期贷方")
+    private BigDecimal periodCreditAmount;
+
+    @Schema(description = "本年累计借方发生额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("本年累计借方")
+    private BigDecimal yearDebitAmount;
+
+    @Schema(description = "本年累计贷方发生额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("本年累计贷方")
+    private BigDecimal yearCreditAmount;
+
+    @Schema(description = "期末借方余额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("期末借方")
+    private BigDecimal endingDebitAmount;
+
+    @Schema(description = "期末贷方余额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("期末贷方")
+    private BigDecimal endingCreditAmount;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/auxiliarydetail/FmsLedgerAuxiliaryDetailRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/auxiliarydetail/FmsLedgerAuxiliaryDetailRespVO.java
new file mode 100644
index 0000000..5b8aee3
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/auxiliarydetail/FmsLedgerAuxiliaryDetailRespVO.java
@@ -0,0 +1,72 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarydetail;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Schema(description = "管理后台 - FMS 核算项目明细账 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsLedgerAuxiliaryDetailRespVO {
+
+    public static final Integer ROW_TYPE_OPENING = 1;
+    public static final Integer ROW_TYPE_VOUCHER = 2;
+    public static final Integer ROW_TYPE_PERIOD_TOTAL = 3;
+    public static final Integer ROW_TYPE_YEAR_TOTAL = 4;
+
+    @Schema(description = "行类型", example = "2")
+    private Integer rowType;
+
+    @Schema(description = "分录编号", example = "1024")
+    private Long entryId;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目编码", example = "1001")
+    private String subjectCode;
+
+    @Schema(description = "科目名称", example = "库存现金")
+    private String subjectName;
+
+    @Schema(description = "会计期间", example = "2026-08")
+    private String period;
+
+    @Schema(description = "日期")
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    @ExcelProperty("日期")
+    private LocalDate accountDate;
+
+    @Schema(description = "凭证编号", example = "1024")
+    private Long voucherId;
+
+    @Schema(description = "凭证字号", example = "记-1")
+    @ExcelProperty("凭证字号")
+    private String voucherNumber;
+
+    @Schema(description = "摘要", example = "报销办公用品")
+    @ExcelProperty("摘要")
+    private String digest;
+
+    @Schema(description = "借方金额")
+    @ExcelProperty("借方")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额")
+    @ExcelProperty("贷方")
+    private BigDecimal creditAmount;
+
+    @Schema(description = "余额方向", example = "借")
+    @ExcelProperty("方向")
+    private String balanceDirection;
+
+    @Schema(description = "余额")
+    @ExcelProperty("余额")
+    private BigDecimal balance;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/detail/FmsLedgerDetailExportRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/detail/FmsLedgerDetailExportRespVO.java
new file mode 100644
index 0000000..3dd6606
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/detail/FmsLedgerDetailExportRespVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+/**
+ * FMS 明细账导出 Response VO
+ *
+ * @author 芋道源码
+ */
+@Data
+@ExcelIgnoreUnannotated
+public class FmsLedgerDetailExportRespVO {
+
+    @ExcelProperty("科目")
+    private String subject;
+
+    @ExcelProperty("日期")
+    private LocalDate accountDate;
+
+    @ExcelProperty("凭证字号")
+    private String voucherNumber;
+
+    @ExcelProperty("摘要")
+    private String digest;
+
+    @ExcelProperty("借方")
+    private BigDecimal debitAmount;
+
+    @ExcelProperty("贷方")
+    private BigDecimal creditAmount;
+
+    @ExcelProperty("方向")
+    private String balanceDirection;
+
+    @ExcelProperty("余额")
+    private BigDecimal balance;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/detail/FmsLedgerDetailRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/detail/FmsLedgerDetailRespVO.java
new file mode 100644
index 0000000..a0f67ec
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/detail/FmsLedgerDetailRespVO.java
@@ -0,0 +1,94 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Schema(description = "管理后台 - FMS 账簿明细 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsLedgerDetailRespVO {
+
+    public static final Integer ROW_TYPE_OPENING = 1;
+    public static final Integer ROW_TYPE_VOUCHER = 2;
+    public static final Integer ROW_TYPE_PERIOD_TOTAL = 3;
+    public static final Integer ROW_TYPE_YEAR_TOTAL = 4;
+    public static final Integer ROW_TYPE_ENDING = 5;
+
+    @Schema(description = "行类型", example = "2")
+    private Integer rowType;
+
+    @Schema(description = "分录编号", example = "1024")
+    private Long entryId;
+
+    @Schema(description = "分录科目编号", example = "1024")
+    private Long entrySubjectId;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目编码", example = "1001")
+    private String subjectCode;
+
+    @Schema(description = "科目名称", example = "库存现金")
+    private String subjectName;
+
+    @Schema(description = "会计期间", example = "2026-08")
+    private String period;
+
+    @Schema(description = "日期")
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    @ExcelProperty("日期")
+    private LocalDate accountDate;
+
+    @Schema(description = "凭证编号", example = "1024")
+    private Long voucherId;
+
+    @Schema(description = "凭证字号", example = "记-1")
+    @ExcelProperty("凭证字号")
+    private String voucherNumber;
+
+    @Schema(description = "摘要", example = "报销办公用品")
+    @ExcelProperty("摘要")
+    private String digest;
+
+    @Schema(description = "借方金额")
+    @ExcelProperty("借方")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额")
+    @ExcelProperty("贷方")
+    private BigDecimal creditAmount;
+
+    @Schema(description = "余额方向", example = "借")
+    @ExcelProperty("方向")
+    private String balanceDirection;
+
+    @Schema(description = "余额")
+    @ExcelProperty("余额")
+    private BigDecimal balance;
+
+    @Schema(description = "借方数量")
+    private BigDecimal debitQuantity;
+
+    @Schema(description = "贷方数量")
+    private BigDecimal creditQuantity;
+
+    @Schema(description = "结存数量")
+    private BigDecimal balanceQuantity;
+
+    @Schema(description = "单价")
+    private BigDecimal unitPrice;
+
+    @Schema(description = "计量单位", example = "件")
+    private String quantityUnit;
+
+    @Schema(description = "多栏账科目金额")
+    private java.util.Map<Long, BigDecimal> columnAmounts;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/general/FmsLedgerGeneralRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/general/FmsLedgerGeneralRespVO.java
new file mode 100644
index 0000000..12afe27
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/general/FmsLedgerGeneralRespVO.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.general;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 总账 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsLedgerGeneralRespVO {
+
+    @Schema(description = "行类型", example = "2")
+    private Integer rowType;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目编码", example = "1001")
+    @ExcelProperty("科目编码")
+    private String subjectCode;
+
+    @Schema(description = "科目名称", example = "库存现金")
+    @ExcelProperty("科目名称")
+    private String subjectName;
+
+    @Schema(description = "会计期间", example = "2026-08")
+    @ExcelProperty("期间")
+    private String period;
+
+    @Schema(description = "摘要", example = "本期合计")
+    @ExcelProperty("摘要")
+    private String digest;
+
+    @Schema(description = "借方金额")
+    @ExcelProperty("借方")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额")
+    @ExcelProperty("贷方")
+    private BigDecimal creditAmount;
+
+    @Schema(description = "余额方向", example = "借")
+    @ExcelProperty("方向")
+    private String balanceDirection;
+
+    @Schema(description = "余额")
+    @ExcelProperty("余额")
+    private BigDecimal balance;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/multicolumn/FmsLedgerMultiColumnRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/multicolumn/FmsLedgerMultiColumnRespVO.java
new file mode 100644
index 0000000..e2af0d7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/multicolumn/FmsLedgerMultiColumnRespVO.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.multicolumn;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailRespVO;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 多栏账 Response VO")
+@Data
+@Accessors(chain = true)
+public class FmsLedgerMultiColumnRespVO {
+
+    @Schema(description = "动态科目列")
+    private List<Column> columns;
+
+    @Schema(description = "账簿行")
+    private List<FmsLedgerDetailRespVO> rows;
+
+    @Schema(description = "管理后台 - FMS 多栏账科目列 Response VO")
+    @Data
+    public static class Column {
+
+        @Schema(description = "科目编号", example = "1024")
+        private Long subjectId;
+
+        @Schema(description = "科目编码", example = "560101")
+        private String subjectCode;
+
+        @Schema(description = "科目名称", example = "办公用品")
+        private String subjectName;
+
+        @Schema(description = "余额方向", example = "1")
+        private Integer balanceDirection;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/quantitydetail/FmsLedgerQuantityDetailRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/quantitydetail/FmsLedgerQuantityDetailRespVO.java
new file mode 100644
index 0000000..3317ccb
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/quantitydetail/FmsLedgerQuantityDetailRespVO.java
@@ -0,0 +1,104 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitydetail;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+
+@Schema(description = "管理后台 - FMS 数量金额明细账 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsLedgerQuantityDetailRespVO {
+
+    public static final Integer ROW_TYPE_OPENING = 1;
+    public static final Integer ROW_TYPE_VOUCHER = 2;
+    public static final Integer ROW_TYPE_PERIOD_TOTAL = 3;
+    public static final Integer ROW_TYPE_YEAR_TOTAL = 4;
+
+    @Schema(description = "行类型", example = "2")
+    private Integer rowType;
+
+    @Schema(description = "分录编号", example = "1024")
+    private Long entryId;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目编码", example = "1405")
+    private String subjectCode;
+
+    @Schema(description = "科目名称", example = "库存商品")
+    private String subjectName;
+
+    @Schema(description = "会计期间", example = "2026-08")
+    private String period;
+
+    @Schema(description = "日期")
+    @JsonFormat(pattern = "yyyy-MM-dd")
+    @ExcelProperty("日期")
+    private LocalDate accountDate;
+
+    @Schema(description = "凭证编号", example = "1024")
+    private Long voucherId;
+
+    @Schema(description = "凭证字号", example = "记-1")
+    @ExcelProperty("凭证字号")
+    private String voucherNumber;
+
+    @Schema(description = "摘要", example = "采购商品")
+    @ExcelProperty("摘要")
+    private String digest;
+
+    @Schema(description = "借方金额")
+    @ExcelProperty("借方金额")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额")
+    @ExcelProperty("贷方金额")
+    private BigDecimal creditAmount;
+
+    @Schema(description = "余额方向", example = "借")
+    @ExcelProperty("方向")
+    private String balanceDirection;
+
+    @Schema(description = "余额")
+    @ExcelProperty("结存金额")
+    private BigDecimal balance;
+
+    @Schema(description = "借方数量")
+    @ExcelProperty("借方数量")
+    private BigDecimal debitQuantity;
+
+    @Schema(description = "贷方数量")
+    @ExcelProperty("贷方数量")
+    private BigDecimal creditQuantity;
+
+    @Schema(description = "结存数量")
+    @ExcelProperty("结存数量")
+    private BigDecimal balanceQuantity;
+
+    @Schema(description = "单价")
+    @ExcelProperty("分录单价")
+    private BigDecimal unitPrice;
+
+    @ExcelProperty("期初单价")
+    private BigDecimal openingUnitPrice;
+
+    @ExcelProperty("本期单价")
+    private BigDecimal periodUnitPrice;
+
+    @ExcelProperty("累计单价")
+    private BigDecimal yearUnitPrice;
+
+    @ExcelProperty("期末单价")
+    private BigDecimal endingUnitPrice;
+
+    @Schema(description = "计量单位", example = "件")
+    @ExcelProperty("单位")
+    private String quantityUnit;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/quantitygeneral/FmsLedgerQuantityGeneralRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/quantitygeneral/FmsLedgerQuantityGeneralRespVO.java
new file mode 100644
index 0000000..2f44668
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/quantitygeneral/FmsLedgerQuantityGeneralRespVO.java
@@ -0,0 +1,120 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitygeneral;
+
+import cn.idev.excel.annotation.ExcelIgnore;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 数量金额总账 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsLedgerQuantityGeneralRespVO {
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目编码", example = "1405")
+    @ExcelProperty({"科目", "编码"})
+    private String subjectCode;
+
+    @Schema(description = "科目名称", example = "库存商品")
+    @ExcelProperty({"科目", "名称"})
+    private String subjectName;
+
+    @Schema(description = "科目级次", example = "1")
+    private Integer level;
+
+    @Schema(description = "是否启用数量核算")
+    private Boolean quantityAccounting;
+
+    @Schema(description = "计量单位", example = "件")
+    @ExcelProperty({"基础信息", "单位"})
+    private String quantityUnit;
+
+    @Schema(description = "期初余额方向", example = "借")
+    @ExcelProperty({"期初余额", "方向"})
+    private String openingBalanceDirection;
+
+    @Schema(description = "期初数量")
+    @ExcelProperty({"期初余额", "数量"})
+    private BigDecimal openingQuantity;
+
+    @Schema(description = "期初单价")
+    @ExcelProperty({"期初余额", "单价"})
+    private BigDecimal openingUnitPrice;
+
+    @Schema(description = "期初借方余额")
+    @ExcelIgnore
+    private BigDecimal openingDebitAmount;
+
+    @Schema(description = "期初贷方余额")
+    @ExcelIgnore
+    private BigDecimal openingCreditAmount;
+
+    @ExcelProperty({"期初余额", "金额"})
+    private BigDecimal openingAmount;
+
+    @Schema(description = "本期借方数量")
+    @ExcelProperty({"本期借方", "数量"})
+    private BigDecimal periodDebitQuantity;
+
+    @Schema(description = "本期借方发生额")
+    @ExcelProperty({"本期借方", "金额"})
+    private BigDecimal periodDebitAmount;
+
+    @Schema(description = "本期贷方数量")
+    @ExcelProperty({"本期贷方", "数量"})
+    private BigDecimal periodCreditQuantity;
+
+    @Schema(description = "本期贷方发生额")
+    @ExcelProperty({"本期贷方", "金额"})
+    private BigDecimal periodCreditAmount;
+
+    @Schema(description = "本年累计借方数量")
+    @ExcelProperty({"本年累计借方", "数量"})
+    private BigDecimal yearDebitQuantity;
+
+    @Schema(description = "本年累计借方发生额")
+    @ExcelProperty({"本年累计借方", "金额"})
+    private BigDecimal yearDebitAmount;
+
+    @Schema(description = "本年累计贷方数量")
+    @ExcelProperty({"本年累计贷方", "数量"})
+    private BigDecimal yearCreditQuantity;
+
+    @Schema(description = "本年累计贷方发生额")
+    @ExcelProperty({"本年累计贷方", "金额"})
+    private BigDecimal yearCreditAmount;
+
+    @Schema(description = "期末余额方向", example = "借")
+    @ExcelProperty({"期末余额", "方向"})
+    private String endingBalanceDirection;
+
+    @Schema(description = "期末数量")
+    @ExcelProperty({"期末余额", "数量"})
+    private BigDecimal endingQuantity;
+
+    @Schema(description = "期末单价")
+    @ExcelProperty({"期末余额", "单价"})
+    private BigDecimal endingUnitPrice;
+
+    @Schema(description = "期末借方余额")
+    @ExcelIgnore
+    private BigDecimal endingDebitAmount;
+
+    @Schema(description = "期末贷方余额")
+    @ExcelIgnore
+    private BigDecimal endingCreditAmount;
+
+    @ExcelProperty({"期末余额", "金额"})
+    private BigDecimal endingAmount;
+
+    @Schema(description = "下级科目")
+    private List<FmsLedgerQuantityGeneralRespVO> children = new ArrayList<>();
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/subjectbalance/FmsLedgerSubjectBalanceRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/subjectbalance/FmsLedgerSubjectBalanceRespVO.java
new file mode 100644
index 0000000..5249b9d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/vo/subjectbalance/FmsLedgerSubjectBalanceRespVO.java
@@ -0,0 +1,116 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 科目余额 Response VO")
+@Data
+@Accessors(chain = true)
+@ExcelIgnoreUnannotated
+public class FmsLedgerSubjectBalanceRespVO {
+
+    public static final int NODE_TYPE_SUBJECT = 1;
+    public static final int NODE_TYPE_AUXILIARY_COMBINATION = 2;
+
+    @Schema(description = "节点唯一键", example = "S:1024")
+    private String nodeKey;
+
+    @Schema(description = "节点类型", example = "1")
+    private Integer nodeType;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "辅助核算组合编号", example = "2048")
+    private Long assistCombinationId;
+
+    @Schema(description = "科目编码", example = "1001")
+    @ExcelProperty("科目编码")
+    private String subjectCode;
+
+    @Schema(description = "科目名称", example = "库存现金")
+    @ExcelProperty("科目名称")
+    private String subjectName;
+
+    @Schema(description = "科目级次", example = "1")
+    private Integer level;
+
+    @Schema(description = "是否启用数量核算")
+    private Boolean quantityAccounting;
+
+    @Schema(description = "计量单位", example = "件")
+    private String quantityUnit;
+
+    @Schema(description = "期初借方余额")
+    @ExcelProperty("期初借方")
+    private BigDecimal openingDebitAmount;
+
+    @Schema(description = "期初贷方余额")
+    @ExcelProperty("期初贷方")
+    private BigDecimal openingCreditAmount;
+
+    @Schema(description = "期初余额方向", example = "借")
+    private String openingBalanceDirection;
+
+    @Schema(description = "期初数量")
+    private BigDecimal openingQuantity;
+
+    @Schema(description = "期初单价")
+    private BigDecimal openingUnitPrice;
+
+    @Schema(description = "本期借方发生额")
+    @ExcelProperty("本期借方")
+    private BigDecimal periodDebitAmount;
+
+    @Schema(description = "本期贷方发生额")
+    @ExcelProperty("本期贷方")
+    private BigDecimal periodCreditAmount;
+
+    @Schema(description = "本期借方数量")
+    private BigDecimal periodDebitQuantity;
+
+    @Schema(description = "本期贷方数量")
+    private BigDecimal periodCreditQuantity;
+
+    @Schema(description = "本年累计借方发生额")
+    @ExcelProperty("本年累计借方")
+    private BigDecimal yearDebitAmount;
+
+    @Schema(description = "本年累计贷方发生额")
+    @ExcelProperty("本年累计贷方")
+    private BigDecimal yearCreditAmount;
+
+    @Schema(description = "本年累计借方数量")
+    private BigDecimal yearDebitQuantity;
+
+    @Schema(description = "本年累计贷方数量")
+    private BigDecimal yearCreditQuantity;
+
+    @Schema(description = "期末借方余额")
+    @ExcelProperty("期末借方")
+    private BigDecimal endingDebitAmount;
+
+    @Schema(description = "期末贷方余额")
+    @ExcelProperty("期末贷方")
+    private BigDecimal endingCreditAmount;
+
+    @Schema(description = "期末余额方向", example = "借")
+    private String endingBalanceDirection;
+
+    @Schema(description = "期末数量")
+    private BigDecimal endingQuantity;
+
+    @Schema(description = "期末单价")
+    private BigDecimal endingUnitPrice;
+
+    @Schema(description = "下级科目")
+    private List<FmsLedgerSubjectBalanceRespVO> children = new ArrayList<>();
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsBalanceSheetController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsBalanceSheetController.java
new file mode 100644
index 0000000..fc97b43
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsBalanceSheetController.java
@@ -0,0 +1,72 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetRowRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.service.report.FmsBalanceSheetService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 资产负债表")
+@RestController
+@RequestMapping("/fms/report/balance-sheet")
+@Validated
+public class FmsBalanceSheetController {
+
+    @Resource
+    private FmsBalanceSheetService balanceSheetService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得资产负债表")
+    @PreAuthorize("@ss.hasPermission('fms:report:balance-sheet:query')")
+    public CommonResult<List<FmsBalanceSheetRowRespVO>> getBalanceSheet(@Valid FmsReportListReqVO listReqVO) {
+        return success(balanceSheetService.getBalanceSheet(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出资产负债表")
+    @PreAuthorize("@ss.hasPermission('fms:report:balance-sheet:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportBalanceSheet(@Valid FmsReportListReqVO listReqVO,
+                                   HttpServletResponse response) throws IOException {
+        List<FmsBalanceSheetRowRespVO> list = balanceSheetService.getBalanceSheet(listReqVO, getLoginUserId());
+        ExcelUtils.write(response, "资产负债表.xls", "资产负债表", FmsBalanceSheetRowRespVO.class, list);
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新资产负债表公式")
+    @PreAuthorize("@ss.hasPermission('fms:report:balance-sheet:update')")
+    public CommonResult<Boolean> updateBalanceSheetFormula(@Valid @RequestBody FmsReportFormulaUpdateReqVO updateReqVO) {
+        balanceSheetService.updateBalanceSheetFormula(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/check")
+    @Operation(summary = "检查资产负债表")
+    @PreAuthorize("@ss.hasPermission('fms:report:balance-sheet:query')")
+    public CommonResult<FmsBalanceSheetCheckRespVO> checkBalanceSheet(@Valid FmsReportListReqVO listReqVO) {
+        return success(balanceSheetService.checkBalanceSheet(listReqVO, getLoginUserId()));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsCashFlowStatementController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsCashFlowStatementController.java
new file mode 100644
index 0000000..c8e0dc6
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsCashFlowStatementController.java
@@ -0,0 +1,102 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowStatementUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.service.report.FmsCashFlowStatementService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 现金流量表")
+@RestController
+@RequestMapping("/fms/report/cash-flow-statement")
+@Validated
+public class FmsCashFlowStatementController {
+
+    @Resource
+    private FmsCashFlowStatementService cashFlowStatementService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得现金流量表")
+    @PreAuthorize("@ss.hasPermission('fms:report:cash-flow-statement:query')")
+    public CommonResult<List<FmsReportItemRespVO>> getCashFlowStatement(
+            @Valid FmsReportListReqVO listReqVO) {
+        return success(cashFlowStatementService.getCashFlowStatement(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出现金流量表")
+    @PreAuthorize("@ss.hasPermission('fms:report:cash-flow-statement:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportCashFlowStatement(@Valid FmsReportListReqVO listReqVO,
+                                        HttpServletResponse response) throws IOException {
+        List<FmsReportItemRespVO> list = cashFlowStatementService.getCashFlowStatement(
+                listReqVO, getLoginUserId());
+        ExcelUtils.write(response, "现金流量表.xls", "现金流量表", FmsReportItemRespVO.class, list);
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新现金流量表")
+    @PreAuthorize("@ss.hasPermission('fms:report:cash-flow-statement:update')")
+    public CommonResult<Boolean> updateCashFlowStatement(
+            @Valid @RequestBody FmsCashFlowStatementUpdateReqVO updateReqVO) {
+        cashFlowStatementService.updateCashFlowStatement(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/check")
+    @Operation(summary = "检查现金流量表")
+    @PreAuthorize("@ss.hasPermission('fms:report:cash-flow-statement:query')")
+    public CommonResult<FmsCashFlowCheckRespVO> checkCashFlowStatement(
+            @Valid FmsReportListReqVO listReqVO) {
+        return success(cashFlowStatementService.checkCashFlowStatement(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/adjustment/list")
+    @Operation(summary = "获得现金流量辅助数据列表")
+    @PreAuthorize("@ss.hasPermission('fms:report:cash-flow-statement:query')")
+    public CommonResult<List<FmsCashFlowAdjustmentRespVO>> getCashFlowAdjustmentList(@Valid FmsReportListReqVO listReqVO) {
+        return success(cashFlowStatementService.getCashFlowAdjustmentList(listReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/adjustment/update")
+    @Operation(summary = "更新现金流量辅助数据")
+    @PreAuthorize("@ss.hasPermission('fms:report:cash-flow-statement:update')")
+    public CommonResult<Boolean> updateCashFlowAdjustment(@Valid @RequestBody FmsCashFlowAdjustmentUpdateReqVO updateReqVO) {
+        cashFlowStatementService.updateCashFlowAdjustment(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/adjustment/update-formula")
+    @Operation(summary = "更新现金流量辅助数据公式")
+    @PreAuthorize("@ss.hasPermission('fms:report:cash-flow-statement:update')")
+    public CommonResult<Boolean> updateCashFlowAdjustmentFormula(@Valid @RequestBody FmsReportFormulaUpdateReqVO updateReqVO) {
+        cashFlowStatementService.updateCashFlowAdjustmentFormula(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsIncomeStatementController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsIncomeStatementController.java
new file mode 100644
index 0000000..43e0778
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/FmsIncomeStatementController.java
@@ -0,0 +1,71 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.income.FmsIncomeStatementCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - FMS 利润表")
+@RestController
+@RequestMapping("/fms/report/income-statement")
+@Validated
+public class FmsIncomeStatementController {
+
+    @Resource
+    private FmsIncomeStatementService incomeStatementService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得利润表")
+    @PreAuthorize("@ss.hasPermission('fms:report:income-statement:query')")
+    public CommonResult<List<FmsReportItemRespVO>> getIncomeStatement(@Valid FmsReportListReqVO listReqVO) {
+        return success(incomeStatementService.getIncomeStatement(listReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出利润表")
+    @PreAuthorize("@ss.hasPermission('fms:report:income-statement:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportIncomeStatement(@Valid FmsReportListReqVO listReqVO, HttpServletResponse response) throws IOException {
+        List<FmsReportItemRespVO> list = incomeStatementService.getIncomeStatement(listReqVO, getLoginUserId());
+        ExcelUtils.write(response, "利润表.xls", "利润表", FmsReportItemRespVO.class, list);
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新利润表公式")
+    @PreAuthorize("@ss.hasPermission('fms:report:income-statement:update')")
+    public CommonResult<Boolean> updateIncomeStatementFormula(@Valid @RequestBody FmsReportFormulaUpdateReqVO updateReqVO) {
+        incomeStatementService.updateIncomeStatementFormula(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/check")
+    @Operation(summary = "检查利润表")
+    @PreAuthorize("@ss.hasPermission('fms:report:income-statement:query')")
+    public CommonResult<FmsIncomeStatementCheckRespVO> checkIncomeStatement(@Valid FmsReportListReqVO listReqVO) {
+        return success(incomeStatementService.checkIncomeStatement(listReqVO, getLoginUserId()));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportFormulaRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportFormulaRespVO.java
new file mode 100644
index 0000000..368dae0
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportFormulaRespVO.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 报表公式项 Response VO")
+@Data
+public class FmsReportFormulaRespVO {
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目名称", example = "库存现金")
+    private String subjectName;
+
+    @Schema(description = "科目编码", example = "1001")
+    private String subjectNumber;
+
+    @Schema(description = "运算符", example = "+")
+    private String operator;
+
+    @Schema(description = "取数规则", example = "0")
+    private Integer rules;
+
+    @Schema(description = "期初金额", example = "100.00")
+    private BigDecimal openingAmount;
+
+    @Schema(description = "期末金额", example = "200.00")
+    private BigDecimal closingAmount;
+
+    @Schema(description = "本期金额", example = "100.00")
+    private BigDecimal currentAmount;
+
+    @Schema(description = "本年累计金额", example = "200.00")
+    private BigDecimal yearAmount;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportFormulaUpdateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportFormulaUpdateReqVO.java
new file mode 100644
index 0000000..5d24f2e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportFormulaUpdateReqVO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+import java.util.ArrayList;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 报表公式更新 Request VO")
+@Data
+public class FmsReportFormulaUpdateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "配置编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "配置编号不能为空")
+    private Long id;
+
+    @Schema(description = "公式项数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "公式项数组不能为空")
+    @Valid
+    private List<Formula> formulas = new ArrayList<>();
+
+    @Schema(description = "管理后台 - FMS 报表公式项 Request VO")
+    @Data
+    public static class Formula {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "科目编号不能为空")
+        private Long subjectId;
+
+        @Schema(description = "运算符", requiredMode = Schema.RequiredMode.REQUIRED, example = "+")
+        @NotNull(message = "运算符不能为空")
+        @Pattern(regexp = "[+-]", message = "运算符必须是 + 或 -")
+        private String operator;
+
+        @Schema(description = "取数规则", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+        @NotNull(message = "取数规则不能为空")
+        @InEnum(value = FmsFormulaRuleEnum.class, message = "取数规则必须是 {value}")
+        private Integer rules;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportItemRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportItemRespVO.java
new file mode 100644
index 0000000..2820415
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportItemRespVO.java
@@ -0,0 +1,49 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 财务报表项目 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsReportItemRespVO {
+
+    @Schema(description = "配置编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "项目名称", example = "货币资金")
+    @ExcelProperty("项目")
+    private String name;
+
+    @Schema(description = "行次", example = "1")
+    @ExcelProperty("行次")
+    private Integer rowNo;
+
+    @Schema(description = "层级", example = "2")
+    private Integer level;
+
+    @Schema(description = "是否可编辑", example = "true")
+    private Boolean editable;
+
+    @Schema(description = "公式")
+    private String formula;
+
+    @Schema(description = "期初金额", example = "100.00")
+    private BigDecimal openingAmount;
+
+    @Schema(description = "期末金额", example = "200.00")
+    private BigDecimal closingAmount;
+
+    @Schema(description = "本年累计金额", example = "200.00")
+    @ExcelProperty("本年累计金额")
+    private BigDecimal yearAmount;
+
+    @Schema(description = "本期金额", example = "100.00")
+    @ExcelProperty("本期金额")
+    private BigDecimal currentAmount;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportListReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportListReqVO.java
new file mode 100644
index 0000000..008a59c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/FmsReportListReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 财务报表查询 Request VO")
+@Data
+public class FmsReportListReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "开始会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotNull(message = "开始会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "开始会计期间格式不正确")
+    private String startMonth;
+
+    @Schema(description = "结束会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotNull(message = "结束会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "结束会计期间格式不正确")
+    private String endMonth;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/balance/FmsBalanceSheetCheckRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/balance/FmsBalanceSheetCheckRespVO.java
new file mode 100644
index 0000000..31e2582
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/balance/FmsBalanceSheetCheckRespVO.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 资产负债表检查 Response VO")
+@Data
+public class FmsBalanceSheetCheckRespVO {
+
+    @Schema(description = "报表是否平衡", example = "true")
+    private Boolean balanced;
+
+    @Schema(description = "初始余额是否平衡", example = "true")
+    private Boolean initialBalanceBalanced;
+
+    @Schema(description = "损益是否已结转", example = "true")
+    private Boolean profitLossTransferred;
+
+    @Schema(description = "年初余额差额", example = "0.00")
+    private BigDecimal openingDifferenceAmount;
+
+    @Schema(description = "期末余额差额", example = "0.00")
+    private BigDecimal closingDifferenceAmount;
+
+    @Schema(description = "未纳入报表公式的科目")
+    private List<UnmappedSubject> unmappedSubjects;
+
+    @Schema(description = "管理后台 - FMS 未纳入报表公式的科目")
+    @Data
+    public static class UnmappedSubject {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long id;
+
+        @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+        private String code;
+
+        @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "库存现金")
+        private String name;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/balance/FmsBalanceSheetRowRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/balance/FmsBalanceSheetRowRespVO.java
new file mode 100644
index 0000000..18fe2ca
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/balance/FmsBalanceSheetRowRespVO.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 资产负债表行 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsBalanceSheetRowRespVO {
+
+    @Schema(description = "行编号", example = "1")
+    private Integer rowId;
+
+    @Schema(description = "资产项目配置编号", example = "1024")
+    private Long assetId;
+
+    @Schema(description = "资产项目名称", example = "货币资金")
+    @ExcelProperty("资产")
+    private String assetName;
+
+    @Schema(description = "资产项目行次", example = "1")
+    @ExcelProperty("行次")
+    private Integer assetRowNo;
+
+    @Schema(description = "资产项目期末余额", example = "200.00")
+    @ExcelProperty("期末余额")
+    private BigDecimal assetClosingAmount;
+
+    @Schema(description = "资产项目年初余额", example = "100.00")
+    @ExcelProperty("年初余额")
+    private BigDecimal assetOpeningAmount;
+
+    @Schema(description = "资产项目层级", example = "2")
+    private Integer assetLevel;
+
+    @Schema(description = "资产项目是否可编辑", example = "true")
+    private Boolean assetEditable;
+
+    @Schema(description = "资产项目公式")
+    private String assetFormula;
+
+    @Schema(description = "负债和所有者权益项目配置编号", example = "1024")
+    private Long liabilityId;
+
+    @Schema(description = "负债和所有者权益项目名称", example = "短期借款")
+    @ExcelProperty("负债和所有者权益")
+    private String liabilityName;
+
+    @Schema(description = "负债和所有者权益项目行次", example = "31")
+    @ExcelProperty("行次")
+    private Integer liabilityRowNo;
+
+    @Schema(description = "负债和所有者权益项目期末余额", example = "200.00")
+    @ExcelProperty("期末余额")
+    private BigDecimal liabilityClosingAmount;
+
+    @Schema(description = "负债和所有者权益项目年初余额", example = "100.00")
+    @ExcelProperty("年初余额")
+    private BigDecimal liabilityOpeningAmount;
+
+    @Schema(description = "负债和所有者权益项目层级", example = "2")
+    private Integer liabilityLevel;
+
+    @Schema(description = "负债和所有者权益项目是否可编辑", example = "true")
+    private Boolean liabilityEditable;
+
+    @Schema(description = "负债和所有者权益项目公式")
+    private String liabilityFormula;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowAdjustmentRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowAdjustmentRespVO.java
new file mode 100644
index 0000000..17e9503
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowAdjustmentRespVO.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 现金流量辅助数据 Response VO")
+@Data
+public class FmsCashFlowAdjustmentRespVO {
+
+    @Schema(description = "数据编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "项目名称", example = "支付给职工的工资")
+    private String name;
+
+    @Schema(description = "行次", example = "1")
+    private Integer rowNo;
+
+    @Schema(description = "公式")
+    private String formula;
+
+    @Schema(description = "说明")
+    private String remark;
+
+    @Schema(description = "是否可编辑", example = "true")
+    private Boolean editable;
+
+    @Schema(description = "本期金额", example = "100.00")
+    private BigDecimal currentAmount;
+
+    @Schema(description = "本年累计金额", example = "200.00")
+    private BigDecimal yearAmount;
+
+    @Schema(description = "层级", example = "1")
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowAdjustmentUpdateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowAdjustmentUpdateReqVO.java
new file mode 100644
index 0000000..2462db8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowAdjustmentUpdateReqVO.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 现金流量辅助数据更新 Request VO")
+@Data
+public class FmsCashFlowAdjustmentUpdateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "辅助数据项", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "辅助数据项不能为空")
+    @Valid
+    private List<Item> items = new ArrayList<>();
+
+    @Schema(description = "管理后台 - FMS 现金流量辅助数据更新项 Request VO")
+    @Data
+    public static class Item {
+
+        @Schema(description = "数据编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "数据编号不能为空")
+        private Long id;
+
+        @Schema(description = "本期金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+        @NotNull(message = "本期金额不能为空")
+        private BigDecimal currentAmount;
+
+        @Schema(description = "本年累计金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "200.00")
+        @NotNull(message = "本年累计金额不能为空")
+        private BigDecimal yearAmount;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowCheckRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowCheckRespVO.java
new file mode 100644
index 0000000..09654d8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowCheckRespVO.java
@@ -0,0 +1,18 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow;
+
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - FMS 现金流量表检查 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsCashFlowCheckRespVO extends FmsBalanceSheetCheckRespVO {
+
+    @Schema(description = "资产负债表是否满足现金流量表取数条件", example = "true")
+    private Boolean balanceSheetReady;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowStatementUpdateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowStatementUpdateReqVO.java
new file mode 100644
index 0000000..7801cc4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/cashflow/FmsCashFlowStatementUpdateReqVO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 现金流量表修改 Request VO")
+@Data
+public class FmsCashFlowStatementUpdateReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "开始会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotNull(message = "开始会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "开始会计期间格式不正确")
+    private String startMonth;
+
+    @Schema(description = "结束会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotNull(message = "结束会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "结束会计期间格式不正确")
+    private String endMonth;
+
+    @Schema(description = "现金流量表项目", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "现金流量表项目不能为空")
+    @Valid
+    private List<Item> items = new ArrayList<>();
+
+    @Schema(description = "管理后台 - FMS 现金流量表修改项 Request VO")
+    @Data
+    public static class Item {
+
+        @Schema(description = "报表项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "报表项目编号不能为空")
+        private Long id;
+
+        @Schema(description = "本期金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+        @NotNull(message = "本期金额不能为空")
+        private BigDecimal currentAmount;
+
+        @Schema(description = "本年累计金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "200.00")
+        @NotNull(message = "本年累计金额不能为空")
+        private BigDecimal yearAmount;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/income/FmsIncomeStatementCheckRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/income/FmsIncomeStatementCheckRespVO.java
new file mode 100644
index 0000000..5a67733
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/report/vo/income/FmsIncomeStatementCheckRespVO.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.fms.controller.admin.report.vo.income;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 利润表检查 Response VO")
+@Data
+public class FmsIncomeStatementCheckRespVO {
+
+    @Schema(description = "净利润与未分配利润变动是否一致", example = "true")
+    private Boolean balanced;
+
+    @Schema(description = "利润表与资产负债表勾稽差额", example = "0.00")
+    private BigDecimal differenceAmount;
+
+    @Schema(description = "未纳入报表公式的科目")
+    private List<UnmappedSubject> unmappedSubjects;
+
+    @Schema(description = "管理后台 - FMS 未纳入报表公式的科目")
+    @Data
+    public static class UnmappedSubject {
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long id;
+
+        @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+        private String code;
+
+        @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "库存现金")
+        private String name;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/FmsVoucherController.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/FmsVoucherController.java
new file mode 100644
index 0000000..1d84d8f
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/FmsVoucherController.java
@@ -0,0 +1,380 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.servlet.ServletUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherAttachmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherExportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportTemplateVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherMoveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherReviewReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherTidyReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.enums.common.FmsBalanceDirectionEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import cn.iocoder.yudao.module.infra.api.file.FileApi;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.stream.Stream;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertListByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.pojo.PageParam.PAGE_SIZE_NONE;
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+
+@Tag(name = "管理后台 - FMS 凭证")
+@RestController
+@RequestMapping("/fms/voucher")
+@Validated
+public class FmsVoucherController {
+
+    @Resource
+    private FmsVoucherService voucherService;
+    @Resource
+    private FmsClosingVoucherService closingVoucherService;
+    @Resource
+    private FmsVoucherWordService voucherWordService;
+    @Resource
+    private FmsLedgerService ledgerService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private FileApi fileApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建凭证")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:create')")
+    public CommonResult<Long> createVoucher(@Valid @RequestBody FmsVoucherSaveReqVO createReqVO) {
+        return success(voucherService.createVoucher(createReqVO, getLoginUserId()));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新凭证")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:update')")
+    public CommonResult<Boolean> updateVoucher(@Valid @RequestBody FmsVoucherSaveReqVO updateReqVO) {
+        voucherService.updateVoucher(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/update-attachments")
+    @Operation(summary = "更新凭证附件")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:update')")
+    public CommonResult<Boolean> updateVoucherAttachments(
+            @Valid @RequestBody FmsVoucherAttachmentUpdateReqVO updateReqVO) {
+        voucherService.updateVoucherAttachments(updateReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "删除凭证")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:delete')")
+    public CommonResult<Boolean> deleteVoucherList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("ids") @NotEmpty List<Long> ids) {
+        voucherService.deleteVoucherList(accountSetId, ids, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/update-review-status")
+    @Operation(summary = "审核或反审核凭证")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:review')")
+    public CommonResult<Boolean> updateVoucherReviewStatus(@Valid @RequestBody FmsVoucherReviewReqVO reviewReqVO) {
+        voucherService.updateVoucherReviewStatus(reviewReqVO.getAccountSetId(),
+                reviewReqVO.getIds(), reviewReqVO.getStatus(), getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/tidy")
+    @Operation(summary = "整理凭证")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:tidy')")
+    public CommonResult<Boolean> tidyVoucher(@Valid @RequestBody FmsVoucherTidyReqVO tidyReqVO) {
+        voucherService.tidyVoucher(tidyReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @PutMapping("/move")
+    @Operation(summary = "移动凭证")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:move')")
+    public CommonResult<Boolean> moveVoucher(@Valid @RequestBody FmsVoucherMoveReqVO moveReqVO) {
+        voucherService.moveVoucher(moveReqVO, getLoginUserId());
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得凭证详情")
+    @PreAuthorize("@ss.hasAnyPermissions('fms:voucher:query', 'fms:voucher:update')")
+    public CommonResult<FmsVoucherRespVO> getVoucher(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                     @RequestParam("id") @NotNull Long id) {
+        FmsVoucherDO voucher = voucherService.getVoucher(accountSetId, id, getLoginUserId());
+        return success(buildVoucherRespVO(accountSetId, voucher));
+    }
+
+    @GetMapping("/subject-balance-list")
+    @Operation(summary = "获得凭证科目余额列表")
+    @PreAuthorize("@ss.hasAnyPermissions('fms:voucher:query', 'fms:voucher:create', 'fms:voucher:update')")
+    public CommonResult<List<FmsVoucherSubjectBalanceRespVO>> getVoucherSubjectBalanceList(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("month") @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "会计期间格式不正确") String month) {
+        List<FmsLedgerSubjectBalanceRespVO> balances = ledgerService.getSubjectBalanceList(
+                new FmsLedgerListReqVO().setAccountSetId(accountSetId).setStartMonth(month).setEndMonth(month), getLoginUserId());
+        // 拼接 VO 返回
+        List<FmsVoucherSubjectBalanceRespVO> respVOList = new ArrayList<>();
+        appendVoucherSubjectBalanceRespVOList(respVOList, balances);
+        return success(respVOList);
+    }
+
+    @GetMapping("/auxiliary-balance")
+    @Operation(summary = "获得凭证辅助核算组合余额")
+    @PreAuthorize("@ss.hasAnyPermissions('fms:voucher:query', 'fms:voucher:create', 'fms:voucher:update')")
+    public CommonResult<FmsVoucherSubjectBalanceRespVO> getVoucherAuxiliaryBalance(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("month")
+            @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "会计期间格式不正确") String month,
+            @RequestParam("subjectId") @NotNull Long subjectId,
+            @RequestParam("auxiliaryItemIds") @NotEmpty List<Long> auxiliaryItemIds) {
+        BigDecimal signedBalance = ledgerService.getAuxiliaryCombinationBalance(
+                accountSetId, month, subjectId, auxiliaryItemIds, getLoginUserId());
+        return success(new FmsVoucherSubjectBalanceRespVO().setSubjectId(subjectId)
+                .setBalanceDirection(FmsBalanceDirectionEnum.valueOf(signedBalance).getName())
+                .setBalance(signedBalance.abs()));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得凭证分页")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:query')")
+    public CommonResult<PageResult<FmsVoucherRespVO>> getVoucherPage(@Valid FmsVoucherPageReqVO pageReqVO) {
+        PageResult<FmsVoucherDO> pageResult = voucherService.getVoucherPage(pageReqVO, getLoginUserId());
+        return success(new PageResult<>(
+                buildVoucherRespVOList(pageReqVO.getAccountSetId(), pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/print-list")
+    @Operation(summary = "获得待打印凭证列表")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:print')")
+    public CommonResult<List<FmsVoucherRespVO>> getVoucherPrintList(@Valid FmsVoucherPageReqVO queryReqVO) {
+        queryReqVO.setPageSize(PAGE_SIZE_NONE);
+        List<FmsVoucherDO> vouchers = voucherService.getVoucherPage(queryReqVO, getLoginUserId()).getList();
+        return success(buildVoucherRespVOList(queryReqVO.getAccountSetId(), vouchers));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出凭证")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportVoucherExcel(@Valid FmsVoucherPageReqVO exportReqVO, HttpServletResponse response)
+            throws IOException {
+        exportReqVO.setPageSize(PAGE_SIZE_NONE);
+        List<FmsVoucherDO> list = voucherService.getVoucherPage(exportReqVO, getLoginUserId()).getList();
+        List<FmsVoucherRespVO> vouchers = buildVoucherRespVOList(exportReqVO.getAccountSetId(), list);
+        ExcelUtils.write(response, "凭证列表.xls", "凭证列表", FmsVoucherExportRespVO.class,
+                buildVoucherExportRespVOList(vouchers));
+    }
+
+    @GetMapping("/get-import-template")
+    @Operation(summary = "获得凭证导入模板")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getVoucherImportTemplate(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                         HttpServletResponse response) throws IOException {
+        FmsVoucherImportTemplateVO templateData = voucherService.getVoucherImportTemplateData(accountSetId, getLoginUserId());
+        ServletUtils.writeAttachment(response, "凭证导入模板.xlsx", FmsVoucherImportExcelHelper.writeTemplate(templateData));
+    }
+
+    @PostMapping("/import")
+    @Operation(summary = "导入凭证")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true),
+            @Parameter(name = "file", description = "Excel 文件", required = true)
+    })
+    @PreAuthorize("@ss.hasPermission('fms:voucher:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<FmsVoucherImportRespVO> importVoucher(@RequestParam("accountSetId") @NotNull Long accountSetId,
+                                                              @RequestParam("file") MultipartFile file) throws IOException {
+        FmsVoucherImportTemplateVO templateData = voucherService.getVoucherImportTemplateData(accountSetId, getLoginUserId());
+        // 1. 解析导入文件
+        List<FmsVoucherImportExcelVO> rows;
+        try {
+            rows = FmsVoucherImportExcelHelper.read(file, templateData.getAuxiliaryTypes());
+        } catch (IllegalArgumentException | IOException exception) {
+            throw exception(VOUCHER_IMPORT_TEMPLATE_INVALID);
+        }
+        // 2. 导入凭证
+        FmsVoucherImportRespVO respVO = voucherService.importVoucher(
+                accountSetId, rows, getLoginUserId());
+
+        // 3. 生成错误数据文件
+        if (CollUtil.isNotEmpty(respVO.getErrorRows())) {
+            byte[] errorFile = FmsVoucherImportExcelHelper.writeErrorFile(respVO.getErrorRows());
+            respVO.setErrorFileUrl(fileApi.createFile(errorFile,
+                    "凭证导入错误数据.xlsx", "fms/voucher/import",
+                    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"));
+        }
+        return success(respVO);
+    }
+
+    @GetMapping("/statistics/list")
+    @Operation(summary = "获得凭证汇总")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:statistics:query')")
+    public CommonResult<List<FmsVoucherStatisticsRespVO>> getVoucherStatisticsList(@Valid FmsVoucherStatisticsReqVO queryReqVO) {
+        return success(voucherService.getVoucherStatisticsList(queryReqVO, getLoginUserId()));
+    }
+
+    @GetMapping("/statistics/export-excel")
+    @Operation(summary = "导出凭证汇总")
+    @PreAuthorize("@ss.hasPermission('fms:voucher:statistics:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportVoucherStatisticsExcel(
+            @Valid FmsVoucherStatisticsReqVO queryReqVO, HttpServletResponse response) throws IOException {
+        List<FmsVoucherStatisticsRespVO> list = voucherService.getVoucherStatisticsList(queryReqVO, getLoginUserId());
+        ExcelUtils.write(response, "凭证汇总表.xls", "凭证汇总", FmsVoucherStatisticsRespVO.class, list);
+    }
+
+    @GetMapping("/next-number")
+    @Operation(summary = "获得下一凭证号")
+    @Parameters({
+            @Parameter(name = "accountSetId", description = "账套编号", required = true),
+            @Parameter(name = "voucherWordId", description = "凭证字编号", required = true),
+            @Parameter(name = "voucherTime", description = "凭证日期", required = true)
+    })
+    @PreAuthorize("@ss.hasAnyPermissions('fms:voucher:query', 'fms:voucher:create', 'fms:voucher:update')")
+    public CommonResult<Integer> getNextVoucherNumber(
+            @RequestParam("accountSetId") @NotNull Long accountSetId,
+            @RequestParam("voucherWordId") @NotNull Long voucherWordId,
+            @RequestParam("voucherTime") @NotNull
+            @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) LocalDateTime voucherTime) {
+        return success(voucherService.getNextVoucherNumber(accountSetId, voucherWordId, voucherTime, getLoginUserId()));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private FmsVoucherRespVO buildVoucherRespVO(Long accountSetId, FmsVoucherDO voucher) {
+        return CollUtil.getFirst(buildVoucherRespVOList(
+                accountSetId, Collections.singletonList(voucher)));
+    }
+
+    private void appendVoucherSubjectBalanceRespVOList(
+            List<FmsVoucherSubjectBalanceRespVO> respVOList,
+            List<FmsLedgerSubjectBalanceRespVO> balances) {
+        balances.forEach(balance -> {
+            BigDecimal debitAmount = balance.getEndingDebitAmount() != null
+                    ? balance.getEndingDebitAmount() : BigDecimal.ZERO;
+            BigDecimal creditAmount = balance.getEndingCreditAmount() != null
+                    ? balance.getEndingCreditAmount() : BigDecimal.ZERO;
+            respVOList.add(new FmsVoucherSubjectBalanceRespVO().setSubjectId(balance.getSubjectId())
+                    .setBalanceDirection(balance.getEndingBalanceDirection())
+                    .setBalance(debitAmount.add(creditAmount)));
+            appendVoucherSubjectBalanceRespVOList(respVOList, balance.getChildren());
+        });
+    }
+
+    private List<FmsVoucherRespVO> buildVoucherRespVOList(
+            Long accountSetId, List<FmsVoucherDO> vouchers) {
+        if (CollUtil.isEmpty(vouchers)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量查询凭证字、分录和用户
+        Set<Long> voucherIds = convertSet(vouchers, FmsVoucherDO::getId);
+        Map<Long, FmsVoucherWordDO> voucherWordMap = voucherWordService.getVoucherWordMap(accountSetId);
+        Map<Long, List<FmsVoucherEntryDO>> entryMap = voucherService.getVoucherEntryMap(voucherIds);
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(convertListByFlatMap(
+                vouchers, voucher -> Stream.of(NumberUtils.parseLong(voucher.getCreator()),
+                        voucher.getReviewerUserId())));
+        Set<Long> closingVoucherIds = closingVoucherService.getClosingVoucherIdSet(accountSetId, voucherIds);
+
+        // 2. 拼接凭证响应
+        return convertList(vouchers, voucher -> {
+            FmsVoucherRespVO respVO = BeanUtils.toBean(voucher, FmsVoucherRespVO.class);
+            respVO.setEntries(BeanUtils.toBean(
+                    entryMap.getOrDefault(voucher.getId(), Collections.emptyList()),
+                    FmsVoucherRespVO.Entry.class));
+            respVO.setCreatorUserId(NumberUtils.parseLong(voucher.getCreator()));
+            respVO.setClosingGenerated(closingVoucherIds.contains(voucher.getId()));
+            MapUtils.findAndThen(voucherWordMap, voucher.getVoucherWordId(),
+                    word -> respVO.setVoucherWordName(word.getName()));
+            MapUtils.findAndThen(userMap, respVO.getCreatorUserId(),
+                    user -> respVO.setCreatorUserName(user.getNickname()));
+            MapUtils.findAndThen(userMap, respVO.getReviewerUserId(),
+                    user -> respVO.setReviewerUserName(user.getNickname()));
+            return respVO;
+        });
+    }
+
+    private List<FmsVoucherExportRespVO> buildVoucherExportRespVOList(
+            List<FmsVoucherRespVO> vouchers) {
+        return convertListByFlatMap(vouchers, voucher -> voucher.getEntries().stream().map(entry -> {
+            String subjectName = entry.getSubjectName();
+            if (CollUtil.isNotEmpty(entry.getAuxiliaries())) {
+                subjectName += " / " + String.join("、", convertList(
+                        entry.getAuxiliaries(), FmsVoucherRespVO.Entry.AuxiliaryItem::getName));
+            }
+            return new FmsVoucherExportRespVO().setVoucherTime(voucher.getVoucherTime())
+                    .setVoucherWordName(voucher.getVoucherWordName())
+                    .setVoucherNumber(voucher.getVoucherNumber()).setDigest(entry.getDigest())
+                    .setSubjectCode(entry.getSubjectCode()).setSubjectName(subjectName)
+                    .setDebitAmount(entry.getDebitAmount()).setCreditAmount(entry.getCreditAmount())
+                    .setAttachmentCount(voucher.getAttachmentCount())
+                    .setCreatorUserName(voucher.getCreatorUserName())
+                    .setReviewerUserName(voucher.getReviewerUserName());
+        }));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/FmsVoucherImportExcelHelper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/FmsVoucherImportExcelHelper.java
new file mode 100644
index 0000000..7dfe7b5
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/FmsVoucherImportExcelHelper.java
@@ -0,0 +1,328 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportTemplateVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import lombok.experimental.UtilityClass;
+import org.apache.poi.ss.usermodel.Cell;
+import org.apache.poi.ss.usermodel.CellStyle;
+import org.apache.poi.ss.usermodel.CellType;
+import org.apache.poi.ss.usermodel.DataValidation;
+import org.apache.poi.ss.usermodel.DataValidationConstraint;
+import org.apache.poi.ss.usermodel.DataValidationHelper;
+import org.apache.poi.ss.usermodel.DateUtil;
+import org.apache.poi.ss.usermodel.IndexedColors;
+import org.apache.poi.ss.usermodel.Row;
+import org.apache.poi.ss.usermodel.Sheet;
+import org.apache.poi.ss.usermodel.Workbook;
+import org.apache.poi.ss.usermodel.WorkbookFactory;
+import org.apache.poi.ss.util.CellRangeAddressList;
+import org.apache.poi.xssf.usermodel.XSSFWorkbook;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.ByteArrayOutputStream;
+import java.io.IOException;
+import java.math.BigDecimal;
+import java.time.DateTimeException;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.addComment;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.createHeaderStyle;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.getCellText;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.getDecimal;
+import static cn.iocoder.yudao.framework.excel.core.util.PoiExcelUtils.isEmptyRow;
+
+/**
+ * FMS 凭证导入 Excel 辅助类
+ *
+ * @author 芋道源码
+ */
+@UtilityClass
+public final class FmsVoucherImportExcelHelper {
+
+    private static final String DATA_SHEET_NAME = "凭证模板";
+    private static final String SUBJECT_SHEET_NAME = "科目数据";
+    private static final String AUXILIARY_SHEET_NAME = "辅助核算项目数据";
+    private static final List<String> BASE_HEADERS = Arrays.asList(
+            "日期", "凭证字", "凭证号", "附件数", "摘要", "科目编码", "科目名称", "借方金额", "贷方金额");
+
+    private static final List<String> REQUIRED_HEADERS = Arrays.asList(
+            "日期", "凭证字", "凭证号", "摘要", "科目编码", "借方金额", "贷方金额");
+
+    /**
+     * 读取凭证导入文件
+     *
+     * 按模板表头校验文件合法性，并根据动态辅助核算类别列解析数据
+     *
+     * @param file 导入文件
+     * @param auxiliaryTypes 辅助核算类别数组
+     * @return 凭证导入数据数组
+     */
+    public static List<FmsVoucherImportExcelVO> read(MultipartFile file,
+            List<FmsAuxiliaryTypeDO> auxiliaryTypes) throws IOException {
+        try (Workbook workbook = WorkbookFactory.create(file.getInputStream())) {
+            // 1. 校验模板 sheet 和表头
+            Sheet sheet = workbook.getSheet(DATA_SHEET_NAME);
+            if (sheet == null || sheet.getPhysicalNumberOfRows() == 0) {
+                throw new IllegalArgumentException("凭证模板工作表不存在");
+            }
+            Row headerRow = sheet.getRow(sheet.getFirstRowNum());
+            Map<String, Integer> headerIndexes = getHeaderIndexes(headerRow);
+            if (!headerIndexes.keySet().containsAll(REQUIRED_HEADERS)) {
+                throw new IllegalArgumentException("凭证模板表头不完整");
+            }
+            // 2. 构建动态辅助核算类别映射
+            Map<String, Long> auxiliaryTypeMap = new LinkedHashMap<>();
+            auxiliaryTypes.forEach(type -> auxiliaryTypeMap.put(type.getName(), type.getId()));
+            // 3. 逐行解析，跳过空行
+            List<FmsVoucherImportExcelVO> rows = new ArrayList<>();
+            for (int rowIndex = headerRow.getRowNum() + 1; rowIndex <= sheet.getLastRowNum(); rowIndex++) {
+                Row row = sheet.getRow(rowIndex);
+                if (isEmptyRow(row, null, headerIndexes.values())) {
+                    continue;
+                }
+                rows.add(parseRow(row, headerIndexes, auxiliaryTypeMap));
+            }
+            return rows;
+        }
+    }
+
+    /**
+     * 生成凭证导入模板
+     *
+     * 模板根据账套辅助核算类别动态增加列，并提供凭证字下拉选项和基础数据工作表
+     *
+     * @param templateData 模板基础数据
+     * @return Excel 文件字节数组
+     */
+    public static byte[] writeTemplate(FmsVoucherImportTemplateVO templateData) throws IOException {
+        try (Workbook workbook = new XSSFWorkbook(); ByteArrayOutputStream output = new ByteArrayOutputStream()) {
+            // 1. 构建动态表头和示例数据
+            List<String> headers = new ArrayList<>(BASE_HEADERS);
+            templateData.getAuxiliaryTypes().forEach(type -> headers.add(type.getName()));
+            headers.add("数量");
+            headers.add("单价");
+            Sheet dataSheet = workbook.createSheet(DATA_SHEET_NAME);
+            writeHeader(workbook, dataSheet, headers);
+            writeExampleRow(dataSheet, templateData);
+            // 2. 增加凭证字下拉选项和填写说明
+            addVoucherWordValidation(dataSheet, templateData.getVoucherWords(), headers.indexOf("凭证字"));
+            addComment(dataSheet.getRow(0).getCell(headers.indexOf("数量")),
+                    "选填，科目启用数量核算时可填写");
+            addComment(dataSheet.getRow(0).getCell(headers.indexOf("单价")),
+                    "选填，与数量同时填写时，数量乘单价应等于分录金额");
+            // 3. 写入科目和辅助核算基础数据
+            writeSubjectSheet(workbook, templateData.getSubjects(), templateData.getAuxiliaryTypes());
+            writeAuxiliarySheet(workbook, templateData.getAuxiliaryTypes(), templateData.getAuxiliaryItems());
+            workbook.write(output);
+            return output.toByteArray();
+        }
+    }
+
+    /**
+     * 生成凭证导入错误文件
+     *
+     * @param errorRows 导入错误数据数组
+     * @return Excel 文件字节数组
+     */
+    public static byte[] writeErrorFile(List<FmsVoucherImportExcelVO> errorRows) throws IOException {
+        try (Workbook workbook = new XSSFWorkbook(); ByteArrayOutputStream output = new ByteArrayOutputStream()) {
+            // 1. 收集原始文件表头
+            Sheet sheet = workbook.createSheet("错误数据");
+            Set<String> sourceHeaders = new LinkedHashSet<>();
+            errorRows.forEach(row -> sourceHeaders.addAll(row.getSourceValues().keySet()));
+            List<String> headers = new ArrayList<>();
+            headers.add("错误信息");
+            headers.addAll(sourceHeaders);
+            writeHeader(workbook, sheet, headers);
+            // 2. 写入错误信息和原始数据
+            for (int index = 0; index < errorRows.size(); index++) {
+                FmsVoucherImportExcelVO errorRow = errorRows.get(index);
+                Row row = sheet.createRow(index + 1);
+                row.createCell(0).setCellValue(String.join("；", errorRow.getErrors()));
+                int columnIndex = 1;
+                for (String header : sourceHeaders) {
+                    row.createCell(columnIndex++).setCellValue(
+                            StrUtil.nullToEmpty(errorRow.getSourceValues().get(header)));
+                }
+            }
+            setColumnWidths(sheet, headers.size());
+            workbook.write(output);
+            return output.toByteArray();
+        }
+    }
+
+    private static FmsVoucherImportExcelVO parseRow(Row row, Map<String, Integer> headerIndexes,
+            Map<String, Long> auxiliaryTypeMap) {
+        FmsVoucherImportExcelVO result = new FmsVoucherImportExcelVO().setRowNumber(row.getRowNum() + 1);
+        headerIndexes.forEach((header, index) -> result.getSourceValues().put(header, getCellText(row, index, null)));
+        result.setVoucherTime(getDateTime(row, headerIndexes.get("日期")));
+        result.setVoucherWordName(getCellText(row, headerIndexes.get("凭证字"), null));
+        result.setVoucherNumber(getInteger(row, headerIndexes.get("凭证号")));
+        result.setAttachmentCount(getInteger(row, headerIndexes.get("附件数")));
+        result.setDigest(getCellText(row, headerIndexes.get("摘要"), null));
+        result.setSubjectCode(getCellText(row, headerIndexes.get("科目编码"), null));
+        result.setSubjectName(getCellText(row, headerIndexes.get("科目名称"), null));
+        result.setDebitAmount(getDecimalOrNull(row, headerIndexes.get("借方金额")));
+        result.setCreditAmount(getDecimalOrNull(row, headerIndexes.get("贷方金额")));
+        result.setQuantity(getDecimalOrNull(row, headerIndexes.get("数量")));
+        result.setUnitPrice(getDecimalOrNull(row, headerIndexes.get("单价")));
+        auxiliaryTypeMap.forEach((name, id) -> {
+            if (headerIndexes.containsKey(name)) {
+                result.getAuxiliaryCodes().put(id, getCellText(row, headerIndexes.get(name), null));
+            }
+        });
+        return result;
+    }
+
+    private static Map<String, Integer> getHeaderIndexes(Row headerRow) {
+        if (headerRow == null) {
+            return Collections.emptyMap();
+        }
+        Map<String, Integer> indexes = new LinkedHashMap<>();
+        for (Cell cell : headerRow) {
+            String header = getCellText(headerRow, cell.getColumnIndex(), null);
+            if (StrUtil.isNotBlank(header)) {
+                indexes.put(header, cell.getColumnIndex());
+            }
+        }
+        return indexes;
+    }
+
+    private static Integer getInteger(Row row, Integer columnIndex) {
+        BigDecimal value = getDecimalOrNull(row, columnIndex);
+        if (value == null) {
+            return null;
+        }
+        try {
+            return value.intValueExact();
+        } catch (ArithmeticException ignored) {
+            return null;
+        }
+    }
+
+    private static BigDecimal getDecimalOrNull(Row row, Integer columnIndex) {
+        try {
+            return getDecimal(row, columnIndex, null);
+        } catch (NumberFormatException ignored) {
+            return null;
+        }
+    }
+
+    private static LocalDateTime getDateTime(Row row, Integer columnIndex) {
+        Cell cell = row.getCell(columnIndex);
+        if (cell != null && cell.getCellType() == CellType.NUMERIC && DateUtil.isCellDateFormatted(cell)) {
+            return cell.getLocalDateTimeCellValue().toLocalDate().atStartOfDay();
+        }
+        String value = getCellText(row, columnIndex, null);
+        if (StrUtil.isBlank(value)) {
+            return null;
+        }
+        try {
+            return LocalDateTimeUtils.parse(value).toLocalDate().atStartOfDay();
+        } catch (DateTimeException ignored) {
+            return null;
+        }
+    }
+
+    private static void writeHeader(Workbook workbook, Sheet sheet, List<String> headers) {
+        CellStyle style = createHeaderStyle(workbook, IndexedColors.LIGHT_BLUE);
+        Row row = sheet.createRow(0);
+        for (int index = 0; index < headers.size(); index++) {
+            Cell cell = row.createCell(index);
+            cell.setCellValue(headers.get(index));
+            cell.setCellStyle(style);
+        }
+        sheet.createFreezePane(0, 1);
+        setColumnWidths(sheet, headers.size());
+    }
+
+    private static void writeExampleRow(Sheet sheet, FmsVoucherImportTemplateVO templateData) {
+        Row row = sheet.createRow(1);
+        row.createCell(0).setCellValue(LocalDate.now().toString());
+        if (CollUtil.isNotEmpty(templateData.getVoucherWords())) {
+            row.createCell(1).setCellValue(templateData.getVoucherWords().get(0).getName());
+        }
+        row.createCell(2).setCellValue(1);
+        row.createCell(3).setCellValue(0);
+        row.createCell(4).setCellValue("示例摘要，导入前请删除示例行");
+    }
+
+    private static void writeSubjectSheet(Workbook workbook, List<FmsSubjectDO> subjects,
+            List<FmsAuxiliaryTypeDO> auxiliaryTypes) {
+        Sheet sheet = workbook.createSheet(SUBJECT_SHEET_NAME);
+        List<String> headers = Arrays.asList("科目编码", "科目名称", "数量核算", "计量单位", "辅助核算");
+        writeHeader(workbook, sheet, headers);
+        Map<Long, String> auxiliaryTypeNameMap = new LinkedHashMap<>();
+        auxiliaryTypes.forEach(type -> auxiliaryTypeNameMap.put(type.getId(), type.getName()));
+        for (int index = 0; index < subjects.size(); index++) {
+            FmsSubjectDO subject = subjects.get(index);
+            Row row = sheet.createRow(index + 1);
+            row.createCell(0).setCellValue(subject.getCode());
+            row.createCell(1).setCellValue(subject.getName());
+            row.createCell(2).setCellValue(Boolean.TRUE.equals(subject.getQuantityAccounting()) ? "是" : "否");
+            row.createCell(3).setCellValue(StrUtil.nullToEmpty(subject.getQuantityUnit()));
+            List<String> auxiliaryNames = new ArrayList<>();
+            if (subject.getAuxiliaryTypeIds() != null) {
+                subject.getAuxiliaryTypeIds().forEach(
+                        auxiliaryTypeId -> auxiliaryNames.add(auxiliaryTypeNameMap.get(auxiliaryTypeId)));
+            }
+            row.createCell(4).setCellValue(String.join("、", auxiliaryNames));
+        }
+        setColumnWidths(sheet, headers.size());
+    }
+
+    private static void writeAuxiliarySheet(Workbook workbook, List<FmsAuxiliaryTypeDO> auxiliaryTypes,
+            List<FmsAuxiliaryItemDO> auxiliaryItems) {
+        Sheet sheet = workbook.createSheet(AUXILIARY_SHEET_NAME);
+        List<String> headers = Arrays.asList("辅助核算类别", "编码", "名称");
+        writeHeader(workbook, sheet, headers);
+        Map<Long, String> typeNameMap = new LinkedHashMap<>();
+        auxiliaryTypes.forEach(type -> typeNameMap.put(type.getId(), type.getName()));
+        for (int index = 0; index < auxiliaryItems.size(); index++) {
+            FmsAuxiliaryItemDO item = auxiliaryItems.get(index);
+            Row row = sheet.createRow(index + 1);
+            row.createCell(0).setCellValue(StrUtil.nullToEmpty(typeNameMap.get(item.getAuxiliaryTypeId())));
+            row.createCell(1).setCellValue(item.getCode());
+            row.createCell(2).setCellValue(item.getName());
+        }
+        setColumnWidths(sheet, headers.size());
+    }
+
+    private static void addVoucherWordValidation(Sheet sheet, List<FmsVoucherWordDO> voucherWords,
+            int columnIndex) {
+        if (CollUtil.isEmpty(voucherWords)) {
+            return;
+        }
+        String[] values = voucherWords.stream().map(FmsVoucherWordDO::getName).toArray(String[]::new);
+        DataValidationHelper helper = sheet.getDataValidationHelper();
+        DataValidationConstraint constraint = helper.createExplicitListConstraint(values);
+        DataValidation validation = helper.createValidation(
+                constraint, new CellRangeAddressList(1,
+                        sheet.getWorkbook().getSpreadsheetVersion().getLastRowIndex(), columnIndex, columnIndex));
+        validation.setShowErrorBox(true);
+        sheet.addValidationData(validation);
+    }
+
+    private static void setColumnWidths(Sheet sheet, int columnCount) {
+        for (int index = 0; index < columnCount; index++) {
+            sheet.setColumnWidth(index, index == 4 ? 8_000 : 4_500);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherAttachmentUpdateReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherAttachmentUpdateReqVO.java
new file mode 100644
index 0000000..994b7ab
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherAttachmentUpdateReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证附件更新 Request VO")
+@Data
+public class FmsVoucherAttachmentUpdateReqVO {
+
+    @Schema(description = "凭证编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "凭证不能为空")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "附件地址数组")
+    @Size(max = 100, message = "凭证附件不能超过 100 个")
+    private List<String> attachmentUrls;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherEntrySaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherEntrySaveReqVO.java
new file mode 100644
index 0000000..0b11377
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherEntrySaveReqVO.java
@@ -0,0 +1,66 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证分录保存 Request VO")
+@Data
+public class FmsVoucherEntrySaveReqVO {
+
+    @Schema(description = "凭证分录编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "摘要内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "支付办公用品款")
+    @NotBlank(message = "摘要不能为空")
+    @Size(max = 500, message = "摘要长度不能超过 500 个字符")
+    private String digest;
+
+    @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "科目不能为空")
+    private Long subjectId;
+
+    @Schema(description = "数量", example = "10")
+    @DecimalMin(value = "0", message = "数量不能小于 0")
+    @Digits(integer = 14, fraction = 4, message = "数量最多保留 4 位小数")
+    private BigDecimal quantity;
+
+    @Schema(description = "单价", example = "20.50")
+    @DecimalMin(value = "0", message = "单价不能小于 0")
+    @Digits(integer = 12, fraction = 6, message = "单价最多保留 6 位小数")
+    private BigDecimal unitPrice;
+
+    @Schema(description = "借方金额", example = "205.00")
+    @Digits(integer = 16, fraction = 2, message = "借方金额最多保留 2 位小数")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额", example = "205.00")
+    @Digits(integer = 16, fraction = 2, message = "贷方金额最多保留 2 位小数")
+    private BigDecimal creditAmount;
+
+    @Schema(description = "辅助核算项目数组")
+    @Valid
+    private List<AuxiliaryItem> auxiliaries;
+
+    @Schema(description = "管理后台 - FMS 凭证分录辅助核算项目")
+    @Data
+    public static class AuxiliaryItem {
+
+        @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+        @NotNull(message = "辅助核算类别不能为空")
+        private Long typeId;
+
+        @Schema(description = "辅助核算项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        @NotNull(message = "辅助核算项目不能为空")
+        private Long itemId;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherExportRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherExportRespVO.java
new file mode 100644
index 0000000..db12e3b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherExportRespVO.java
@@ -0,0 +1,62 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.idev.excel.annotation.format.DateTimeFormat;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - FMS 凭证导出 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsVoucherExportRespVO {
+
+    @Schema(description = "凭证日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("日期")
+    @DateTimeFormat("yyyy-MM-dd")
+    private LocalDateTime voucherTime;
+
+    @Schema(description = "凭证字", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("凭证字")
+    private String voucherWordName;
+
+    @Schema(description = "凭证号", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("凭证号")
+    private Integer voucherNumber;
+
+    @Schema(description = "摘要", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("摘要")
+    private String digest;
+
+    @Schema(description = "科目代码", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("科目代码")
+    private String subjectCode;
+
+    @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("科目名称")
+    private String subjectName;
+
+    @Schema(description = "借方金额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("借方金额")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("贷方金额")
+    private BigDecimal creditAmount;
+
+    @Schema(description = "附件数", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty("附件数")
+    private Integer attachmentCount;
+
+    @Schema(description = "制单人")
+    @ExcelProperty("制单人")
+    private String creatorUserName;
+
+    @Schema(description = "审核人")
+    @ExcelProperty("审核人")
+    private String reviewerUserName;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportExcelVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportExcelVO.java
new file mode 100644
index 0000000..6ac2c1c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportExcelVO.java
@@ -0,0 +1,116 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * FMS 凭证导入 Excel VO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class FmsVoucherImportExcelVO {
+
+    /**
+     * Excel 行号
+     */
+    private Integer rowNumber;
+
+    /**
+     * 凭证日期
+     */
+    @NotNull(message = "日期不能为空或格式不正确")
+    private LocalDateTime voucherTime;
+
+    /**
+     * 凭证字
+     */
+    @NotBlank(message = "凭证字不能为空")
+    private String voucherWordName;
+
+    /**
+     * 凭证号
+     */
+    @NotNull(message = "凭证号不能为空")
+    @Min(value = 1, message = "凭证号必须为正整数")
+    private Integer voucherNumber;
+
+    /**
+     * 附件数
+     */
+    @Min(value = 0, message = "附件数不能小于 0")
+    private Integer attachmentCount;
+
+    /**
+     * 摘要内容
+     */
+    private String digest;
+
+    /**
+     * 科目编码
+     */
+    @NotBlank(message = "科目编码不能为空")
+    private String subjectCode;
+
+    /**
+     * 科目名称
+     */
+    private String subjectName;
+
+    /**
+     * 借方金额
+     */
+    @Digits(integer = 16, fraction = 2, message = "借方金额最多保留 2 位小数")
+    private BigDecimal debitAmount;
+
+    /**
+     * 贷方金额
+     */
+    @Digits(integer = 16, fraction = 2, message = "贷方金额最多保留 2 位小数")
+    private BigDecimal creditAmount;
+
+    /**
+     * 数量
+     */
+    @DecimalMin(value = "0", message = "数量不能小于 0")
+    @Digits(integer = 14, fraction = 4, message = "数量最多保留 4 位小数")
+    private BigDecimal quantity;
+
+    /**
+     * 单价
+     */
+    @DecimalMin(value = "0", message = "单价不能小于 0")
+    @Digits(integer = 12, fraction = 6, message = "单价最多保留 6 位小数")
+    private BigDecimal unitPrice;
+
+    /**
+     * 辅助核算类别编号与项目编码的映射
+     */
+    private Map<Long, String> auxiliaryCodes = new LinkedHashMap<>();
+    /**
+     * Excel 表头与原始单元格值的映射
+     */
+    private Map<String, String> sourceValues = new LinkedHashMap<>();
+    /**
+     * 校验错误数组
+     */
+    private List<String> errors = new ArrayList<>();
+
+    public void addError(String error) {
+        if (!errors.contains(error)) {
+            errors.add(error);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportRespVO.java
new file mode 100644
index 0000000..40013f9
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportRespVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证导入结果 Response VO")
+@Data
+public class FmsVoucherImportRespVO {
+
+    @Schema(description = "总分录数", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer totalRowCount;
+
+    @Schema(description = "成功分录数", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer successRowCount;
+
+    @Schema(description = "失败分录数", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer failureRowCount;
+
+    @Schema(description = "总凭证数", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer totalVoucherCount;
+
+    @Schema(description = "成功凭证数", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer successVoucherCount;
+
+    @Schema(description = "失败凭证数", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer failureVoucherCount;
+
+    @Schema(description = "错误数据文件地址")
+    private String errorFileUrl;
+
+    /**
+     * 错误数据数组
+     *
+     * 仅用于生成错误数据文件，不直接返回前端
+     */
+    @JsonIgnore
+    private List<FmsVoucherImportExcelVO> errorRows;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportTemplateVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportTemplateVO.java
new file mode 100644
index 0000000..666de41
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherImportTemplateVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * FMS 凭证导入模板 VO
+ *
+ * @author 芋道源码
+ */
+@Data
+@AllArgsConstructor
+public class FmsVoucherImportTemplateVO {
+
+    /**
+     * 凭证字数组
+     */
+    private List<FmsVoucherWordDO> voucherWords;
+    /**
+     * 科目数组
+     */
+    private List<FmsSubjectDO> subjects;
+    /**
+     * 辅助核算类别数组
+     */
+    private List<FmsAuxiliaryTypeDO> auxiliaryTypes;
+    /**
+     * 辅助核算项目数组
+     */
+    private List<FmsAuxiliaryItemDO> auxiliaryItems;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherMoveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherMoveReqVO.java
new file mode 100644
index 0000000..40dbb38
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherMoveReqVO.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 凭证移动 Request VO")
+@Data
+public class FmsVoucherMoveReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "凭证月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotBlank(message = "凭证月份不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "凭证月份格式必须为 yyyy-MM")
+    private String month;
+
+    @Schema(description = "凭证字编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+    @NotNull(message = "凭证字不能为空")
+    private Long voucherWordId;
+
+    @Schema(description = "原凭证号", requiredMode = Schema.RequiredMode.REQUIRED, example = "6")
+    @NotNull(message = "原凭证号不能为空")
+    @Min(value = 1, message = "原凭证号必须大于 0")
+    private Integer sourceNumber;
+
+    @Schema(description = "移动到的凭证号", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    @NotNull(message = "移动到的凭证号不能为空")
+    @Min(value = 1, message = "移动到的凭证号必须大于 0")
+    private Integer targetNumber;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherPageReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherPageReqVO.java
new file mode 100644
index 0000000..86d8a81
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherPageReqVO.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - FMS 凭证分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsVoucherPageReqVO extends PageParam {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "凭证编号数组")
+    @Size(max = 200, message = "凭证编号不能超过 200 个")
+    private List<Long> ids;
+
+    @Schema(description = "凭证日期范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] voucherTime;
+
+    @Schema(description = "凭证字编号", example = "11")
+    private Long voucherWordId;
+
+    @Schema(description = "凭证号", example = "1")
+    private Integer voucherNumber;
+
+    @Schema(description = "摘要关键词", example = "办公用品")
+    private String digest;
+
+    @Schema(description = "科目编号", example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "最小金额", example = "100")
+    private BigDecimal minAmount;
+
+    @Schema(description = "最大金额", example = "500")
+    private BigDecimal maxAmount;
+
+    @Schema(description = "制单人后台用户编号", example = "1")
+    private Long creatorUserId;
+
+    @Schema(description = "审核状态", example = "0")
+    @InEnum(FmsVoucherStatusEnum.class)
+    private Integer status;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherRespVO.java
new file mode 100644
index 0000000..15aa441
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherRespVO.java
@@ -0,0 +1,129 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证 Response VO")
+@Data
+public class FmsVoucherRespVO {
+
+    @Schema(description = "凭证编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long accountSetId;
+
+    @Schema(description = "凭证字编号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long voucherWordId;
+
+    @Schema(description = "凭证字", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String voucherWordName;
+
+    @Schema(description = "凭证号", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer voucherNumber;
+
+    @Schema(description = "凭证日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime voucherTime;
+
+    @Schema(description = "附件地址数组")
+    private List<String> attachmentUrls;
+
+    @Schema(description = "附件数", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer attachmentCount;
+
+    @Schema(description = "借方金额", requiredMode = Schema.RequiredMode.REQUIRED)
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额", requiredMode = Schema.RequiredMode.REQUIRED)
+    private BigDecimal creditAmount;
+
+    @Schema(description = "合计金额", requiredMode = Schema.RequiredMode.REQUIRED)
+    private BigDecimal total;
+
+    @Schema(description = "审核状态", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Integer status;
+
+    @Schema(description = "是否为结账生成凭证", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Boolean closingGenerated;
+
+    @Schema(description = "制单人后台用户编号")
+    private Long creatorUserId;
+
+    @Schema(description = "制单人名称")
+    private String creatorUserName;
+
+    @Schema(description = "审核人后台用户编号")
+    private Long reviewerUserId;
+
+    @Schema(description = "审核人名称")
+    private String reviewerUserName;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+    @Schema(description = "凭证分录数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<Entry> entries;
+
+    @Schema(description = "管理后台 - FMS 凭证分录 Response VO")
+    @Data
+    public static class Entry {
+
+        @Schema(description = "分录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long id;
+
+        @Schema(description = "摘要内容", requiredMode = Schema.RequiredMode.REQUIRED)
+        private String digest;
+
+        @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+        private Long subjectId;
+
+        @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED)
+        private String subjectCode;
+
+        @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED)
+        private String subjectName;
+
+        @Schema(description = "数量")
+        private BigDecimal quantity;
+
+        @Schema(description = "单价")
+        private BigDecimal unitPrice;
+
+        @Schema(description = "借方金额", requiredMode = Schema.RequiredMode.REQUIRED)
+        private BigDecimal debitAmount;
+
+        @Schema(description = "贷方金额", requiredMode = Schema.RequiredMode.REQUIRED)
+        private BigDecimal creditAmount;
+
+        @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED)
+        private Integer sort;
+
+        @Schema(description = "辅助核算组合编号")
+        private Long assistCombinationId;
+
+        @Schema(description = "辅助核算项目数组")
+        private List<AuxiliaryItem> auxiliaries;
+
+        @Schema(description = "管理后台 - FMS 凭证分录辅助核算项目")
+        @Data
+        public static class AuxiliaryItem {
+
+            @Schema(description = "辅助核算类型", requiredMode = Schema.RequiredMode.REQUIRED)
+            private Integer type;
+
+            @Schema(description = "辅助核算类别编号", requiredMode = Schema.RequiredMode.REQUIRED)
+            private Long typeId;
+
+            @Schema(description = "辅助核算项目编号", requiredMode = Schema.RequiredMode.REQUIRED)
+            private Long itemId;
+
+            @Schema(description = "辅助核算项目名称", requiredMode = Schema.RequiredMode.REQUIRED)
+            private String name;
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherReviewReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherReviewReqVO.java
new file mode 100644
index 0000000..1db5dd3
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherReviewReqVO.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证审核 Request VO")
+@Data
+public class FmsVoucherReviewReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "凭证编号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "凭证编号不能为空")
+    private List<Long> ids;
+
+    @Schema(description = "审核状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "审核状态不能为空")
+    @InEnum(FmsVoucherStatusEnum.class)
+    private Integer status;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSaveReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSaveReqVO.java
new file mode 100644
index 0000000..d9ab2a2
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSaveReqVO.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import jakarta.validation.constraints.Min;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - FMS 凭证保存 Request VO")
+@Data
+public class FmsVoucherSaveReqVO {
+
+    @Schema(description = "凭证编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "凭证字编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+    @NotNull(message = "凭证字不能为空")
+    private Long voucherWordId;
+
+    @Schema(description = "凭证号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "凭证号不能为空")
+    @Min(value = 1, message = "凭证号必须大于 0")
+    private Integer voucherNumber;
+
+    @Schema(description = "凭证日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "凭证日期不能为空")
+    private LocalDateTime voucherTime;
+
+    @Schema(description = "附单据张数", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "附单据张数不能为空")
+    @Min(value = 0, message = "附单据张数不能小于 0")
+    private Integer attachmentCount;
+
+    @Schema(description = "凭证分录数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @Size(min = 2, message = "凭证至少需要两条分录")
+    private List<FmsVoucherEntrySaveReqVO> entries;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherStatisticsReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherStatisticsReqVO.java
new file mode 100644
index 0000000..13beb85
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherStatisticsReqVO.java
@@ -0,0 +1,49 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 凭证汇总查询 Request VO")
+@Data
+public class FmsVoucherStatisticsReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套编号不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "开始会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotNull(message = "开始会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "开始会计期间格式不正确")
+    private String startMonth;
+
+    @Schema(description = "结束会计期间", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-12")
+    @NotNull(message = "结束会计期间不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "结束会计期间格式不正确")
+    private String endMonth;
+
+    @Schema(description = "凭证字编号", example = "1024")
+    private Long voucherWordId;
+
+    @Schema(description = "最小凭证号", example = "1")
+    @Min(value = 1, message = "最小凭证号不能小于 1")
+    private Integer minVoucherNumber;
+
+    @Schema(description = "最大凭证号", example = "100")
+    @Min(value = 1, message = "最大凭证号不能小于 1")
+    private Integer maxVoucherNumber;
+
+    @Schema(description = "最小科目级次", example = "1")
+    @Min(value = 1, message = "最小科目级次不能小于 1")
+    @Max(value = 10, message = "最小科目级次不能大于 10")
+    private Integer minLevel;
+
+    @Schema(description = "最大科目级次", example = "1")
+    @Min(value = 1, message = "最大科目级次不能小于 1")
+    @Max(value = 10, message = "最大科目级次不能大于 10")
+    private Integer maxLevel;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherStatisticsRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherStatisticsRespVO.java
new file mode 100644
index 0000000..9bdf07b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherStatisticsRespVO.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 凭证汇总 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class FmsVoucherStatisticsRespVO {
+
+    @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "科目编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    @ExcelProperty("科目编码")
+    private String subjectCode;
+
+    @Schema(description = "科目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "库存现金")
+    @ExcelProperty("科目名称")
+    private String subjectName;
+
+    @Schema(description = "科目级次", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer level;
+
+    @Schema(description = "借方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    @ExcelProperty("借方金额")
+    private BigDecimal debitAmount;
+
+    @Schema(description = "贷方金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    @ExcelProperty("贷方金额")
+    private BigDecimal creditAmount;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSubjectAmountVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSubjectAmountVO.java
new file mode 100644
index 0000000..c173a8a
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSubjectAmountVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 凭证科目发生额 VO
+ *
+ * @author 芋道源码
+ */
+@Data
+public class FmsVoucherSubjectAmountVO {
+
+    /**
+     * 科目编号
+     */
+    private Long subjectId;
+    /**
+     * 借方发生额
+     */
+    private BigDecimal debitAmount;
+    /**
+     * 贷方发生额
+     */
+    private BigDecimal creditAmount;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSubjectBalanceRespVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSubjectBalanceRespVO.java
new file mode 100644
index 0000000..fb29d97
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherSubjectBalanceRespVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - FMS 凭证科目余额 Response VO")
+@Data
+@Accessors(chain = true)
+public class FmsVoucherSubjectBalanceRespVO {
+
+    @Schema(description = "科目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long subjectId;
+
+    @Schema(description = "余额方向", example = "借")
+    private String balanceDirection;
+
+    @Schema(description = "余额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+    private BigDecimal balance;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherTidyReqVO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherTidyReqVO.java
new file mode 100644
index 0000000..aad2bc7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/controller/admin/voucher/vo/FmsVoucherTidyReqVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.fms.controller.admin.voucher.vo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherTidyTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+
+@Schema(description = "管理后台 - FMS 凭证整理 Request VO")
+@Data
+public class FmsVoucherTidyReqVO {
+
+    @Schema(description = "账套编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "账套不能为空")
+    private Long accountSetId;
+
+    @Schema(description = "整理月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026-08")
+    @NotBlank(message = "整理月份不能为空")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "整理月份格式必须为 yyyy-MM")
+    private String month;
+
+    @Schema(description = "凭证字编号，为空时整理全部凭证字", example = "11")
+    private Long voucherWordId;
+
+    @Schema(description = "起始编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "起始编号不能为空")
+    @Min(value = 1, message = "起始编号必须大于 0")
+    private Integer startNumber;
+
+    @Schema(description = "整理方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "整理方式不能为空")
+    @InEnum(FmsVoucherTidyTypeEnum.class)
+    private Integer type;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingPeriodDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingPeriodDO.java
new file mode 100644
index 0000000..abeb7d8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingPeriodDO.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * FMS 结账期间 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_closing_period")
+@KeySequence("fms_closing_period_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsClosingPeriodDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 结账时间
+     */
+    private LocalDateTime closingTime;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingSchemeDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingSchemeDO.java
new file mode 100644
index 0000000..741081d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingSchemeDO.java
@@ -0,0 +1,163 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * FMS 结账方案 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_closing", autoResultMap = true)
+@KeySequence("fms_closing_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsClosingSchemeDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 结账名称
+     */
+    private String name;
+    /**
+     * 是否期末结转
+     */
+    private Boolean periodEnd;
+    /**
+     * 科目编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long subjectId;
+    /**
+     * 取数规则
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum}
+     */
+    private Integer formulaRule;
+    /**
+     * 取数时间类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum}
+     */
+    private Integer timeType;
+    /**
+     * 凭证字编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO#getId()}
+     */
+    private Long voucherWordId;
+    /**
+     * 凭证摘要
+     */
+    private String digest;
+    /**
+     * 结转凭证类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.closing.FmsClosingVoucherTypeEnum}
+     */
+    private Integer voucherType;
+    /**
+     * “以前年度损益调整”科目
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long priorYearAdjustmentSubjectId;
+    /**
+     * “以前年度损益调整”科目的结转科目
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long adjustmentClosingSubjectId;
+    /**
+     * 其他损益科目的结转科目
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long otherClosingSubjectId;
+    /**
+     * 是否按余额反向结转
+     */
+    private Boolean reverseBalance;
+    /**
+     * 类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 结转损益日期，最大31，超过31默认最后一天
+     */
+    private Integer closingDay;
+    /**
+     * 结转科目规则数组
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<SubjectRule> subjectRules;
+
+    /**
+     * 结转科目规则
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class SubjectRule {
+
+        /**
+         * 科目编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+         */
+        private Long subjectId;
+        /**
+         * 科目编码快照
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getCode()}
+         */
+        private String subjectCode;
+        /**
+         * 摘要
+         */
+        private String digest;
+        /**
+         * 借贷方向
+         *
+         * 枚举 {@link FmsDebitCreditDirectionEnum}
+         */
+        private Integer direction;
+        /**
+         * 金额比例，取值范围 0 至 100
+         */
+        private BigDecimal amountRatio;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingTemplateDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingTemplateDO.java
new file mode 100644
index 0000000..84f8fb5
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingTemplateDO.java
@@ -0,0 +1,126 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * FMS 结账模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_closing_template", autoResultMap = true)
+@KeySequence("fms_closing_template_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsClosingTemplateDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 系统预置编码
+     */
+    private String presetCode;
+    /**
+     * 模板名称
+     */
+    private String name;
+    /**
+     * 模板分类
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTemplateCategoryEnum}
+     */
+    private Integer category;
+    /**
+     * 是否期末结转
+     */
+    private Boolean periodEnd;
+    /**
+     * 来源科目编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long subjectId;
+    /**
+     * 取数规则
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum}
+     */
+    private Integer formulaRule;
+    /**
+     * 取数时间类型
+     *
+     * 枚举 {@link FmsClosingTimeTypeEnum}
+     */
+    private Integer timeType;
+    /**
+     * 结转科目规则数组
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<SubjectRule> subjectRules;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+
+    /**
+     * 结转科目规则
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class SubjectRule {
+
+        /**
+         * 科目编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+         */
+        private Long subjectId;
+        /**
+         * 科目编码快照
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getCode()}
+         */
+        private String subjectCode;
+        /**
+         * 摘要
+         */
+        private String digest;
+        /**
+         * 借贷方向
+         *
+         * 枚举 {@link FmsDebitCreditDirectionEnum}
+         */
+        private Integer direction;
+        /**
+         * 金额比例，取值范围 0 至 100
+         */
+        private BigDecimal amountRatio;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingVoucherDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingVoucherDO.java
new file mode 100644
index 0000000..af4926e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/closing/FmsClosingVoucherDO.java
@@ -0,0 +1,68 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * FMS 结账凭证 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_closing_voucher")
+@KeySequence("fms_closing_voucher_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsClosingVoucherDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 结账方案编号
+     *
+     * 关联 {@link FmsClosingSchemeDO#getId()}
+     */
+    private Long closingId;
+    /**
+     * 凭证编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO#getId()}
+     */
+    private Long voucherId;
+    /**
+     * 凭证日期
+     */
+    private LocalDateTime voucherTime;
+    /**
+     * 结转金额
+     */
+    private BigDecimal amount;
+    /**
+     * 是否已结账
+     */
+    private Boolean closed;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAccountSetDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAccountSetDO.java
new file mode 100644
index 0000000..3148935
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAccountSetDO.java
@@ -0,0 +1,128 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * FMS 账套 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_account_set")
+@KeySequence("fms_account_set_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsAccountSetDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 公司编码
+     */
+    private String companyCode;
+    /**
+     * 公司名称
+     */
+    private String companyName;
+    /**
+     * 公司简介
+     */
+    private String companyProfile;
+    /**
+     * 所在行业
+     */
+    private String industry;
+    /**
+     * 所在地
+     */
+    private String location;
+    /**
+     * 法人代表
+     */
+    private String legalRepresentative;
+    /**
+     * 身份证号
+     */
+    private String legalRepresentativeIdNumber;
+    /**
+     * 营业执照号
+     */
+    private String businessLicenseNumber;
+    /**
+     * 组织机构代码
+     */
+    private String organizationCode;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 联系人
+     */
+    private String contactName;
+    /**
+     * 办公电话
+     */
+    private String officeTelephone;
+    /**
+     * 手机号码
+     */
+    private String mobile;
+    /**
+     * 传真号码
+     */
+    private String faxNumber;
+    /**
+     * QQ 号码
+     */
+    private String qqNumber;
+    /**
+     * 邮箱
+     */
+    private String email;
+    /**
+     * 其他
+     */
+    private String otherContact;
+    /**
+     * 详细地址
+     */
+    private String address;
+    /**
+     * 币种编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO#getId()}
+     */
+    private Long currencyId;
+    /**
+     * 启用期间
+     */
+    private LocalDateTime startTime;
+    /**
+     * 会计制度
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsAccountingStandardEnum}
+     */
+    private Integer standard;
+    /**
+     * 是否已初始化
+     */
+    private Boolean initialized;
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAccountUserDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAccountUserDO.java
new file mode 100644
index 0000000..03458b5
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAccountUserDO.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 账套用户 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_account_user")
+@KeySequence("fms_account_user_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsAccountUserDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 后台用户编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.system.dal.dataobject.user.AdminUserDO#getId()}
+     */
+    private Long userId;
+    /**
+     * 是否默认账套
+     */
+    private Boolean defaultStatus;
+    /**
+     * 是否账套创建人
+     */
+    private Boolean founder;
+    /**
+     * 成员权限级别
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsAccountUserLevelEnum}
+     */
+    private Integer level;
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryCombinationDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryCombinationDO.java
new file mode 100644
index 0000000..57a452e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryCombinationDO.java
@@ -0,0 +1,91 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.util.List;
+
+/**
+ * FMS 辅助核算组合 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_assist_combination", autoResultMap = true)
+@KeySequence("fms_assist_combination_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsAuxiliaryCombinationDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 科目编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long subjectId;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 辅助核算项目数组
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<AuxiliaryItem> items;
+
+    /**
+     * 辅助核算项目
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class AuxiliaryItem {
+
+        /**
+         * 辅助核算类别
+         *
+         * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 辅助核算类别编号
+         *
+         * 关联 {@link FmsAuxiliaryTypeDO#getId()}
+         */
+        private Long typeId;
+        /**
+         * 辅助核算项目编号
+         *
+         * 关联 {@link FmsAuxiliaryItemDO#getId()}
+         */
+        private Long itemId;
+        /**
+         * 辅助核算项目名称快照
+         *
+         * 关联 {@link FmsAuxiliaryItemDO#getName()}
+         */
+        private String name;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryItemDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryItemDO.java
new file mode 100644
index 0000000..f211c8c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryItemDO.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 辅助核算项目 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_auxiliary_item")
+@KeySequence("fms_auxiliary_item_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsAuxiliaryItemDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 编码
+     */
+    private String code;
+    /**
+     * 名称
+     */
+    private String name;
+    /**
+     * 辅助核算类别编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO#getId()}
+     */
+    private Long auxiliaryTypeId;
+    /**
+     * 状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 规格（存货）
+     */
+    private String specification;
+    /**
+     * 单位（存货）
+     */
+    private String unit;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryTypeDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryTypeDO.java
new file mode 100644
index 0000000..c490177
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsAuxiliaryTypeDO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 辅助核算类别 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_auxiliary_type")
+@KeySequence("fms_auxiliary_type_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsAuxiliaryTypeDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 辅助核算名称
+     */
+    private String name;
+    /**
+     * 是否系统预置
+     */
+    private Boolean systemPreset;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum}
+     */
+    private Integer type;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsCurrencyDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsCurrencyDO.java
new file mode 100644
index 0000000..c3484a3
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsCurrencyDO.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 币别 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_currency")
+@KeySequence("fms_currency_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsCurrencyDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 编码
+     */
+    private String code;
+    /**
+     * 币种名称
+     */
+    private String name;
+    /**
+     * 汇率
+     */
+    private BigDecimal exchangeRate;
+    /**
+     * 是否本位币
+     */
+    private Boolean standard;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsDigestDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsDigestDO.java
new file mode 100644
index 0000000..22c3abd
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsDigestDO.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+/**
+ * FMS 常用摘要 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_digest")
+@KeySequence("fms_digest_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsDigestDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 摘要内容
+     */
+    private String content;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsFinanceIndicatorDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsFinanceIndicatorDO.java
new file mode 100644
index 0000000..8f516cf
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsFinanceIndicatorDO.java
@@ -0,0 +1,64 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+// TODO DONE @AI：DO 字段注释、枚举引用和状态字段已对齐 FMS 现有 DO 风格。
+/**
+ * FMS 首页财务指标 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_finance_indicator")
+@KeySequence("fms_finance_indicator_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsFinanceIndicatorDO extends BaseDO {
+
+    // TODO DONE @AI：报表类型常量已迁移到 FmsFinanceIndicatorTypeEnum。
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 指标名称
+     */
+    private String name;
+    /**
+     * 指标编码
+     */
+    private String code;
+    /**
+     * 取数报表类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsFinanceIndicatorTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 指标公式，支持报表行次公式或科目公式 JSON
+     */
+    private String formula;
+    /**
+     * 展示顺序
+     */
+    private Integer sort;
+    /**
+     * 状态
+     *
+     * 枚举 {@link cn.iocoder.yudao.framework.common.enums.CommonStatusEnum}
+     */
+    private Integer status;
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsFinanceParameterDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsFinanceParameterDO.java
new file mode 100644
index 0000000..87737c8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsFinanceParameterDO.java
@@ -0,0 +1,83 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.fms.enums.ledger.FmsLedgerBalanceModeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 财务参数 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_finance_parameter")
+@KeySequence("fms_finance_parameter_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsFinanceParameterDO extends BaseDO {
+
+    public static final Integer DEFAULT_LEVEL = 4;
+
+    public static final String DEFAULT_SUBJECT_CODE_RULE = "4-2-2-2";
+
+    public static final Integer DEFAULT_LEDGER_BALANCE_MODE = FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode();
+    public static final Boolean DEFAULT_VOUCHER_REVIEW_REQUIRED = false;
+    public static final Boolean DEFAULT_DEFICIT_CHECK = false;
+    public static final Boolean DEFAULT_ASSET_PERIOD_LOCKED = false;
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 科目层级
+     */
+    private Integer level;
+    /**
+     * 科目编码规则
+     */
+    private String subjectCodeRule;
+    /**
+     * 账簿余额方向模式
+     */
+    private Integer ledgerBalanceMode;
+    /**
+     * 是否检查现金及银行存款科目赤字
+     */
+    private Boolean deficitCheck;
+    /**
+     * 结账前是否要求凭证审核
+     */
+    private Boolean voucherReviewRequired;
+    /**
+     * 生成折旧凭证后是否锁定以前期间资产卡片
+     */
+    private Boolean assetPeriodLocked;
+    /**
+     * 纳税人名称
+     */
+    private String taxpayerName;
+    /**
+     * 纳税人识别号
+     */
+    private String taxpayerNumber;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsInitialBalanceDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsInitialBalanceDO.java
new file mode 100644
index 0000000..fef8c60
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsInitialBalanceDO.java
@@ -0,0 +1,197 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * FMS 科目期初余额 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_initial_balance", autoResultMap = true)
+@KeySequence("fms_initial_balance_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsInitialBalanceDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 科目编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long subjectId;
+    /**
+     * 是否启用辅助核算
+     */
+    private Boolean auxiliaryAccounting;
+    /**
+     * 期初金额
+     */
+    private BigDecimal openingAmount;
+    /**
+     * 期初数量
+     */
+    private BigDecimal openingQuantity;
+    /**
+     * 本年累计借方金额
+     */
+    private BigDecimal yearDebitAmount;
+    /**
+     * 本年累计借方数量
+     */
+    private BigDecimal yearDebitQuantity;
+    /**
+     * 本年累计贷方金额
+     */
+    private BigDecimal yearCreditAmount;
+    /**
+     * 本年累计贷方数量
+     */
+    private BigDecimal yearCreditQuantity;
+    /**
+     * 年初金额
+     */
+    private BigDecimal yearOpeningAmount;
+    /**
+     * 年初数量
+     */
+    private BigDecimal yearOpeningQuantity;
+    /**
+     * 实际损益发生额
+     */
+    private BigDecimal profitLossAmount;
+    /**
+     * 实际损益发生数量
+     */
+    private BigDecimal profitLossQuantity;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 辅助核算余额数组
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<AssistBalance> assistBalances;
+
+    /**
+     * 辅助核算余额
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class AssistBalance {
+
+        /**
+         * 辅助核算组合编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO#getId()}
+         */
+        private Long assistCombinationId;
+        /**
+         * 辅助核算项目数组
+         */
+        private List<AuxiliaryItem> auxiliaries;
+        /**
+         * 期初金额
+         */
+        private BigDecimal openingAmount;
+        /**
+         * 期初数量
+         */
+        private BigDecimal openingQuantity;
+        /**
+         * 本年累计借方金额
+         */
+        private BigDecimal yearDebitAmount;
+        /**
+         * 本年累计借方数量
+         */
+        private BigDecimal yearDebitQuantity;
+        /**
+         * 本年累计贷方金额
+         */
+        private BigDecimal yearCreditAmount;
+        /**
+         * 本年累计贷方数量
+         */
+        private BigDecimal yearCreditQuantity;
+        /**
+         * 年初金额
+         */
+        private BigDecimal yearOpeningAmount;
+        /**
+         * 年初数量
+         */
+        private BigDecimal yearOpeningQuantity;
+        /**
+         * 实际损益发生额
+         */
+        private BigDecimal profitLossAmount;
+        /**
+         * 实际损益发生数量
+         */
+        private BigDecimal profitLossQuantity;
+    }
+
+    /**
+     * 辅助核算项目
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class AuxiliaryItem {
+
+        /**
+         * 辅助核算类别
+         *
+         * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 辅助核算类别编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO#getId()}
+         */
+        private Long typeId;
+        /**
+         * 辅助核算项目编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO#getId()}
+         */
+        private Long itemId;
+        /**
+         * 辅助核算项目名称快照
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO#getName()}
+         */
+        private String name;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsSubjectDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsSubjectDO.java
new file mode 100644
index 0000000..cff165d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsSubjectDO.java
@@ -0,0 +1,117 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.util.List;
+
+/**
+ * FMS 会计科目 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_subject", autoResultMap = true)
+@KeySequence("fms_subject_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsSubjectDO extends BaseDO {
+
+    /**
+     * 根科目编号
+     */
+    public static final Long PARENT_ID_ROOT = 0L;
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 科目编码
+     */
+    private String code;
+    /**
+     * 科目名称
+     */
+    private String name;
+    /**
+     * 上级科目编号
+     *
+     * 关联 {@link FmsSubjectDO#getId()}
+     */
+    private Long parentId;
+    /**
+     * 科目类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 科目类别
+     */
+    private Integer category;
+    /**
+     * 余额方向
+     *
+     * 枚举 {@link FmsDebitCreditDirectionEnum}
+     */
+    private Integer balanceDirection;
+    /**
+     * 数量核算 计量单位
+     */
+    private String quantityUnit;
+    /**
+     * 是否现金科目
+     */
+    private Boolean cash;
+    /**
+     * 状态
+     *
+     * 枚举 {@link cn.iocoder.yudao.framework.common.enums.CommonStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 科目层级
+     */
+    private Integer level;
+    /**
+     * 是否启用数量核算
+     */
+    private Boolean quantityAccounting;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 辅助核算类别编号数组
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO#getId()}
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Long> auxiliaryTypeIds;
+    /**
+     * 核算币种编号数组
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO#getId()}
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Long> currencyIds;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsSubjectTemplateDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsSubjectTemplateDO.java
new file mode 100644
index 0000000..7c9fcf1
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsSubjectTemplateDO.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.tenant.core.aop.TenantIgnore;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 科目模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_subject_template")
+@KeySequence("fms_subject_template_seq")
+@TenantIgnore
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsSubjectTemplateDO extends BaseDO {
+
+    /**
+     * 根科目编号
+     */
+    public static final Long PARENT_ID_ROOT = 0L;
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 科目编码
+     */
+    private String code;
+    /**
+     * 科目名称
+     */
+    private String name;
+    /**
+     * 上级科目编号
+     *
+     * 关联 {@link FmsSubjectTemplateDO#getId()}
+     */
+    private Long parentId;
+    /**
+     * 科目类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 科目类别
+     */
+    private Integer category;
+    /**
+     * 余额方向
+     *
+     * 枚举 {@link FmsDebitCreditDirectionEnum}
+     */
+    private Integer balanceDirection;
+    /**
+     * 数量核算 计量单位
+     */
+    private String quantityUnit;
+    /**
+     * 是否现金科目
+     */
+    private Boolean cash;
+    /**
+     * 状态
+     *
+     * 枚举 {@link cn.iocoder.yudao.framework.common.enums.CommonStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 科目层级
+     */
+    private Integer level;
+    /**
+     * 是否启用数量核算
+     */
+    private Boolean quantityAccounting;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherTemplateCategoryDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherTemplateCategoryDO.java
new file mode 100644
index 0000000..c9959cb
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherTemplateCategoryDO.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+/**
+ * FMS 凭证模板分类 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_voucher_template_category")
+@KeySequence("fms_voucher_template_category_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsVoucherTemplateCategoryDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 凭证模板分类名称
+     */
+    private String name;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherTemplateDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherTemplateDO.java
new file mode 100644
index 0000000..09793a1
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherTemplateDO.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * FMS 凭证模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_voucher_template", autoResultMap = true)
+@KeySequence("fms_voucher_template_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsVoucherTemplateDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 凭证模板名称
+     */
+    private String name;
+    /**
+     * 凭证模板分类编号
+     *
+     * 关联 {@link FmsVoucherTemplateCategoryDO#getId()}
+     */
+    private Long categoryId;
+    /**
+     * 凭证模板分录数组
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Entry> entries;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+    /**
+     * 凭证模板分录
+     */
+    @Data
+    public static class Entry {
+
+        /**
+         * 摘要内容
+         */
+        private String digest;
+        /**
+         * 科目编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+         */
+        private Long subjectId;
+        /**
+         * 数量
+         */
+        private BigDecimal quantity;
+        /**
+         * 单价
+         */
+        private BigDecimal unitPrice;
+        /**
+         * 借方金额
+         */
+        private BigDecimal debitAmount;
+        /**
+         * 贷方金额
+         */
+        private BigDecimal creditAmount;
+        /**
+         * 辅助核算项目数组
+         */
+        private List<FmsVoucherEntryDO.AuxiliaryItem> auxiliaries;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherWordDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherWordDO.java
new file mode 100644
index 0000000..4387175
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/config/FmsVoucherWordDO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+/**
+ * FMS 凭证字 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_voucher_word")
+@KeySequence("fms_voucher_word_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class FmsVoucherWordDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 凭证字
+     */
+    private String name;
+    /**
+     * 打印标题
+     */
+    private String printTitle;
+    /**
+     * 是否默认凭证字
+     */
+    private Boolean defaultStatus;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/FmsReportTemplateDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/FmsReportTemplateDO.java
new file mode 100644
index 0000000..31cb820
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/FmsReportTemplateDO.java
@@ -0,0 +1,79 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.tenant.core.aop.TenantIgnore;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 报表模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_report_template")
+@KeySequence("fms_report_template_seq")
+@TenantIgnore
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsReportTemplateDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 配置名称
+     */
+    private String name;
+    /**
+     * 行次
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     */
+    private String formula;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否可编辑
+     */
+    private Boolean editable;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 行编号
+     */
+    private Integer rowId;
+    /**
+     * 类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsReportTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 现金流量表分类
+     */
+    private Integer category;
+    /**
+     * 层级
+     */
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/balance/FmsBalanceSheetConfigDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/balance/FmsBalanceSheetConfigDO.java
new file mode 100644
index 0000000..5405a37
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/balance/FmsBalanceSheetConfigDO.java
@@ -0,0 +1,73 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.balance;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 资产负债表配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_balance_sheet_config")
+@KeySequence("fms_balance_sheet_config_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsBalanceSheetConfigDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 配置名称
+     */
+    private String name;
+    /**
+     * 行次
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     */
+    private String formula;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否可编辑
+     */
+    private Boolean editable;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 层级
+     */
+    private Integer level;
+    /**
+     * 行编号
+     */
+    private Integer rowId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/balance/FmsBalanceSheetReportDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/balance/FmsBalanceSheetReportDO.java
new file mode 100644
index 0000000..806048e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/balance/FmsBalanceSheetReportDO.java
@@ -0,0 +1,117 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.balance;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 资产负债表数据 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_balance_sheet_report")
+@KeySequence("fms_balance_sheet_report_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsBalanceSheetReportDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 开始会计期间，格式为 yyyyMM
+     */
+    private Integer fromPeriod;
+    /**
+     * 结束会计期间，格式为 yyyyMM
+     */
+    private Integer toPeriod;
+    /**
+     * 报表期间类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsReportPeriodTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 层级快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getLevel()}，用于保留历史期间的展示层级
+     */
+    private Integer level;
+    /**
+     * 配置名称快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getName()}，用于保留历史期间的项目名称
+     */
+    private String name;
+    /**
+     * 行次快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getRowNo()}，用于保留历史期间的报表行次
+     */
+    private Integer rowNo;
+    /**
+     * 公式快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getFormula()}，保证历史期间报表不受后续公式调整影响
+     */
+    private String formula;
+    /**
+     * 备注快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getRemark()}，用于保留历史期间的备注
+     */
+    private String remark;
+    /**
+     * 是否可编辑快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getEditable()}，用于保留历史期间的可编辑标识
+     */
+    private Boolean editable;
+    /**
+     * 显示顺序快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getSort()}，用于保留历史期间的显示顺序
+     */
+    private Integer sort;
+    /**
+     * 期初金额
+     */
+    private BigDecimal openingAmount;
+    /**
+     * 期末金额
+     */
+    private BigDecimal closingAmount;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 是否已结账
+     */
+    private Boolean settled;
+    /**
+     * 行编号快照
+     *
+     * 冗余 {@link FmsBalanceSheetConfigDO#getRowId()}，用于保留历史期间资产与负债项目的行配对关系
+     */
+    private Integer rowId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowExtendConfigDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowExtendConfigDO.java
new file mode 100644
index 0000000..0a0a6fd
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowExtendConfigDO.java
@@ -0,0 +1,89 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 现金流量表扩展配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_cash_flow_extend_config")
+@KeySequence("fms_cash_flow_extend_config_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsCashFlowExtendConfigDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 配置名称
+     */
+    private String name;
+    /**
+     * 行次
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     */
+    private String formula;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 表格标识
+     */
+    private Integer category;
+    /**
+     * 公式类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsCashFlowExtendTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 本期金额
+     */
+    private BigDecimal currentAmount;
+    /**
+     * 本年累计金额
+     */
+    private BigDecimal yearAmount;
+    /**
+     * 是否可编辑
+     */
+    private Boolean editable;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 层级
+     */
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowExtendDataDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowExtendDataDO.java
new file mode 100644
index 0000000..78a9a2b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowExtendDataDO.java
@@ -0,0 +1,97 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 现金流量表扩展数据 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_cash_flow_extend_data")
+@KeySequence("fms_cash_flow_extend_data_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsCashFlowExtendDataDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 配置名称
+     */
+    private String name;
+    /**
+     * 行次
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     */
+    private String formula;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 现金流量表分类
+     */
+    private Integer category;
+    /**
+     * 本期金额
+     */
+    private BigDecimal currentAmount;
+    /**
+     * 本年累计金额
+     */
+    private BigDecimal yearAmount;
+    /**
+     * 开始会计期间，格式为 yyyyMM
+     */
+    private Integer fromPeriod;
+    /**
+     * 是否可编辑
+     */
+    private Boolean editable;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 结束会计期间，格式为 yyyyMM
+     */
+    private Integer toPeriod;
+    /**
+     * 报表期间类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsReportPeriodTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 层级
+     */
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowStatementConfigDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowStatementConfigDO.java
new file mode 100644
index 0000000..a9d87bc
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowStatementConfigDO.java
@@ -0,0 +1,73 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 现金流量表配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_cash_flow_statement_config")
+@KeySequence("fms_cash_flow_statement_config_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsCashFlowStatementConfigDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 配置名称
+     */
+    private String name;
+    /**
+     * 行次
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     */
+    private String formula;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否可编辑
+     */
+    private Boolean editable;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 现金流量表分类
+     */
+    private Integer category;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 层级
+     */
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowStatementReportDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowStatementReportDO.java
new file mode 100644
index 0000000..464529f
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/cashflow/FmsCashFlowStatementReportDO.java
@@ -0,0 +1,111 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 现金流量表数据 DO
+ *
+ * 按会计期间保存报表配置的快照：名称、行次、公式、是否可编辑、显示顺序和层级冗余自 {@link FmsCashFlowStatementConfigDO}，保证历史期间报表保留当时的公式，不受后续公式调整影响
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_cash_flow_statement_report")
+@KeySequence("fms_cash_flow_statement_report_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsCashFlowStatementReportDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 开始会计期间，格式为 yyyyMM
+     */
+    private Integer fromPeriod;
+    /**
+     * 配置名称
+     *
+     * 冗余 {@link FmsCashFlowStatementConfigDO#getName()}
+     */
+    private String name;
+    /**
+     * 行次
+     *
+     * 冗余 {@link FmsCashFlowStatementConfigDO#getRowNo()}
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     *
+     * 冗余 {@link FmsCashFlowStatementConfigDO#getFormula()}
+     */
+    private String formula;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否可编辑
+     *
+     * 冗余 {@link FmsCashFlowStatementConfigDO#getEditable()}
+     */
+    private Boolean editable;
+    /**
+     * 本期金额
+     */
+    private BigDecimal currentAmount;
+    /**
+     * 本年累计金额
+     */
+    private BigDecimal yearAmount;
+    /**
+     * 显示顺序
+     *
+     * 冗余 {@link FmsCashFlowStatementConfigDO#getSort()}
+     */
+    private Integer sort;
+    /**
+     * 现金流量表分类
+     */
+    private Integer category;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 结束会计期间，格式为 yyyyMM
+     */
+    private Integer toPeriod;
+    /**
+     * 报表期间类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsReportPeriodTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 层级
+     *
+     * 冗余 {@link FmsCashFlowStatementConfigDO#getLevel()}
+     */
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/income/FmsIncomeStatementConfigDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/income/FmsIncomeStatementConfigDO.java
new file mode 100644
index 0000000..c1f3103
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/income/FmsIncomeStatementConfigDO.java
@@ -0,0 +1,65 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.income;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * FMS 利润表配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_income_statement_config")
+@KeySequence("fms_income_statement_config_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsIncomeStatementConfigDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 配置名称
+     */
+    private String name;
+    /**
+     * 行次
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     */
+    private String formula;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 是否可编辑
+     */
+    private Boolean editable;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 层级
+     */
+    private Integer level;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/income/FmsIncomeStatementReportDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/income/FmsIncomeStatementReportDO.java
new file mode 100644
index 0000000..be60112
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/report/income/FmsIncomeStatementReportDO.java
@@ -0,0 +1,107 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.report.income;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 利润表数据 DO
+ *
+ * 按会计期间保存报表配置的快照：名称、行次、公式、显示顺序、是否可编辑和层级冗余自 {@link FmsIncomeStatementConfigDO}，保证历史期间报表保留当时的公式，不受后续公式调整影响
+ *
+ * @author 芋道源码
+ */
+@TableName("fms_income_statement_report")
+@KeySequence("fms_income_statement_report_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsIncomeStatementReportDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 报表期间类型
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.report.FmsReportPeriodTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 开始会计期间，格式为 yyyyMM
+     */
+    private Integer fromPeriod;
+    /**
+     * 结束会计期间，格式为 yyyyMM
+     */
+    private Integer toPeriod;
+    /**
+     * 配置名称
+     *
+     * 冗余 {@link FmsIncomeStatementConfigDO#getName()}
+     */
+    private String name;
+    /**
+     * 行次
+     *
+     * 冗余 {@link FmsIncomeStatementConfigDO#getRowNo()}
+     */
+    private Integer rowNo;
+    /**
+     * 公式
+     *
+     * 冗余 {@link FmsIncomeStatementConfigDO#getFormula()}
+     */
+    private String formula;
+    /**
+     * 显示顺序
+     *
+     * 冗余 {@link FmsIncomeStatementConfigDO#getSort()}
+     */
+    private Integer sort;
+    /**
+     * 是否可编辑
+     *
+     * 冗余 {@link FmsIncomeStatementConfigDO#getEditable()}
+     */
+    private Boolean editable;
+    /**
+     * 本期金额
+     */
+    private BigDecimal currentAmount;
+    /**
+     * 本年累计金额
+     */
+    private BigDecimal yearAmount;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 层级
+     *
+     * 冗余 {@link FmsIncomeStatementConfigDO#getLevel()}
+     */
+    private Integer level;
+    /**
+     * 是否已结账
+     */
+    private Boolean settled;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/voucher/FmsVoucherDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/voucher/FmsVoucherDO.java
new file mode 100644
index 0000000..e540166
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/voucher/FmsVoucherDO.java
@@ -0,0 +1,94 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.voucher;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * FMS 凭证 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_voucher", autoResultMap = true)
+@KeySequence("fms_voucher_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsVoucherDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 凭证字编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO#getId()}
+     */
+    private Long voucherWordId;
+    /**
+     * 凭证号
+     */
+    private Integer voucherNumber;
+    /**
+     * 凭证日期
+     */
+    private LocalDateTime voucherTime;
+    /**
+     * 附件地址
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<String> attachmentUrls;
+    /**
+     * 附单据张数
+     */
+    private Integer attachmentCount;
+    /**
+     * 借方金额
+     */
+    private BigDecimal debitAmount;
+    /**
+     * 贷方金额
+     */
+    private BigDecimal creditAmount;
+    /**
+     * 合计金额
+     */
+    private BigDecimal total;
+    /**
+     * 状态
+     *
+     * 枚举 {@link cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 审核人后台用户编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.system.dal.dataobject.user.AdminUserDO#getId()}
+     */
+    private Long reviewerUserId;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/voucher/FmsVoucherEntryDO.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/voucher/FmsVoucherEntryDO.java
new file mode 100644
index 0000000..9ae812b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/dataobject/voucher/FmsVoucherEntryDO.java
@@ -0,0 +1,141 @@
+package cn.iocoder.yudao.module.fms.dal.dataobject.voucher;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * FMS 凭证分录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "fms_voucher_entry", autoResultMap = true)
+@KeySequence("fms_voucher_entry_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class FmsVoucherEntryDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 摘要内容
+     */
+    private String digest;
+    /**
+     * 科目名称快照
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getName()}
+     */
+    private String subjectName;
+    /**
+     * 数量
+     */
+    private BigDecimal quantity;
+    /**
+     * 借方金额
+     */
+    private BigDecimal debitAmount;
+    /**
+     * 贷方金额
+     */
+    private BigDecimal creditAmount;
+    /**
+     * 凭证编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO#getId()}
+     */
+    private Long voucherId;
+    /**
+     * 科目编码快照
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getCode()}
+     */
+    private String subjectCode;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 科目编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO#getId()}
+     */
+    private Long subjectId;
+    /**
+     * 账套编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO#getId()}
+     */
+    private Long accountSetId;
+    /**
+     * 单价
+     */
+    private BigDecimal unitPrice;
+    /**
+     * 辅助核算组合编号
+     *
+     * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO#getId()}
+     */
+    private Long assistCombinationId;
+    /**
+     * 辅助核算项目数组
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<AuxiliaryItem> auxiliaries;
+
+    /**
+     * 辅助核算项目
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class AuxiliaryItem {
+
+        /**
+         * 辅助核算类别
+         *
+         * 枚举 {@link cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 辅助核算类别编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO#getId()}
+         */
+        private Long typeId;
+        /**
+         * 辅助核算项目编号
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO#getId()}
+         */
+        private Long itemId;
+        /**
+         * 辅助核算项目名称快照
+         *
+         * 关联 {@link cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO#getName()}
+         */
+        private String name;
+
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingPeriodMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingPeriodMapper.java
new file mode 100644
index 0000000..a6675c2
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingPeriodMapper.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingPeriodDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+
+/**
+ * FMS 结账期间 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsClosingPeriodMapper extends BaseMapperX<FmsClosingPeriodDO> {
+
+    default FmsClosingPeriodDO selectByPeriod(Long accountSetId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return selectOne(new LambdaQueryWrapperX<FmsClosingPeriodDO>()
+                .eq(FmsClosingPeriodDO::getAccountSetId, accountSetId)
+                .between(FmsClosingPeriodDO::getClosingTime, beginTime, endTime));
+    }
+
+    default FmsClosingPeriodDO selectLatestByAccountSetId(Long accountSetId) {
+        return selectLastOne(new LambdaQueryWrapperX<FmsClosingPeriodDO>()
+                .eq(FmsClosingPeriodDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsClosingPeriodDO::getClosingTime)
+                .orderByAsc(FmsClosingPeriodDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingSchemeMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingSchemeMapper.java
new file mode 100644
index 0000000..7066f35
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingSchemeMapper.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 结账方案 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsClosingSchemeMapper extends BaseMapperX<FmsClosingSchemeDO> {
+
+    default FmsClosingSchemeDO selectByAccountSetIdAndType(Long accountSetId, Integer type) {
+        return selectOne(new LambdaQueryWrapperX<FmsClosingSchemeDO>()
+                .eq(FmsClosingSchemeDO::getAccountSetId, accountSetId)
+                .eq(FmsClosingSchemeDO::getType, type));
+    }
+
+    default FmsClosingSchemeDO selectByIdAndAccountSetId(Long id, Long accountSetId) {
+        return selectOne(new LambdaQueryWrapperX<FmsClosingSchemeDO>()
+                .eq(FmsClosingSchemeDO::getId, id)
+                .eq(FmsClosingSchemeDO::getAccountSetId, accountSetId));
+    }
+
+    default List<FmsClosingSchemeDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsClosingSchemeDO>()
+                .eq(FmsClosingSchemeDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsClosingSchemeDO::getType)
+                .orderByAsc(FmsClosingSchemeDO::getId));
+    }
+
+    default List<FmsClosingSchemeDO> selectPeriodEndListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsClosingSchemeDO>()
+                .eq(FmsClosingSchemeDO::getAccountSetId, accountSetId)
+                .and(wrapper -> wrapper.ne(FmsClosingSchemeDO::getType,
+                                FmsClosingTypeEnum.REGULAR.getType())
+                        .or().eq(FmsClosingSchemeDO::getPeriodEnd, true))
+                .orderByAsc(FmsClosingSchemeDO::getType)
+                .orderByAsc(FmsClosingSchemeDO::getId));
+    }
+
+    default Long selectCountByAccountSetIdAndVoucherWordId(
+            Long accountSetId, Long voucherWordId) {
+        return selectCount(new LambdaQueryWrapperX<FmsClosingSchemeDO>()
+                .eq(FmsClosingSchemeDO::getAccountSetId, accountSetId)
+                .eq(FmsClosingSchemeDO::getVoucherWordId, voucherWordId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingTemplateMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingTemplateMapper.java
new file mode 100644
index 0000000..5f13b90
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingTemplateMapper.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 结账模板 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsClosingTemplateMapper extends BaseMapperX<FmsClosingTemplateDO> {
+
+    default FmsClosingTemplateDO selectByIdAndAccountSetId(Long id, Long accountSetId) {
+        return selectOne(new LambdaQueryWrapperX<FmsClosingTemplateDO>()
+                .eq(FmsClosingTemplateDO::getId, id)
+                .eq(FmsClosingTemplateDO::getAccountSetId, accountSetId));
+    }
+
+    default List<FmsClosingTemplateDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsClosingTemplateDO>()
+                .eq(FmsClosingTemplateDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsClosingTemplateDO::getCategory)
+                .orderByAsc(FmsClosingTemplateDO::getSort)
+                .orderByAsc(FmsClosingTemplateDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingVoucherMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingVoucherMapper.java
new file mode 100644
index 0000000..5677a92
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/closing/FmsClosingVoucherMapper.java
@@ -0,0 +1,61 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.closing;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 结账凭证 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsClosingVoucherMapper extends BaseMapperX<FmsClosingVoucherDO> {
+
+    default List<FmsClosingVoucherDO> selectListByPeriod(Long accountSetId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return selectList(new LambdaQueryWrapperX<FmsClosingVoucherDO>()
+                .eq(FmsClosingVoucherDO::getAccountSetId, accountSetId)
+                .between(FmsClosingVoucherDO::getVoucherTime, beginTime, endTime)
+                .orderByDesc(FmsClosingVoucherDO::getId));
+    }
+
+    default List<FmsClosingVoucherDO> selectListByClosingId(Long closingId) {
+        return selectList(FmsClosingVoucherDO::getClosingId, closingId);
+    }
+
+    default Long selectCountByClosingId(Long closingId) {
+        return selectCount(FmsClosingVoucherDO::getClosingId, closingId);
+    }
+
+    default List<FmsClosingVoucherDO> selectListByClosingIdAndPeriod(Long closingId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return selectList(new LambdaQueryWrapperX<FmsClosingVoucherDO>()
+                .eq(FmsClosingVoucherDO::getClosingId, closingId)
+                .between(FmsClosingVoucherDO::getVoucherTime, beginTime, endTime)
+                .orderByDesc(FmsClosingVoucherDO::getId));
+    }
+
+    default List<FmsClosingVoucherDO> selectListByClosingIdAndVoucherTimeBetween(Long closingId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return selectList(new LambdaQueryWrapperX<FmsClosingVoucherDO>()
+                .eq(FmsClosingVoucherDO::getClosingId, closingId)
+                .geIfPresent(FmsClosingVoucherDO::getVoucherTime, beginTime)
+                .ltIfPresent(FmsClosingVoucherDO::getVoucherTime, endTime)
+                .orderByAsc(FmsClosingVoucherDO::getVoucherTime)
+                .orderByAsc(FmsClosingVoucherDO::getId));
+    }
+
+    default List<FmsClosingVoucherDO> selectListByAccountSetIdAndVoucherIds(
+            Long accountSetId, Collection<Long> voucherIds) {
+        return selectList(new LambdaQueryWrapperX<FmsClosingVoucherDO>()
+                .eq(FmsClosingVoucherDO::getAccountSetId, accountSetId)
+                .in(FmsClosingVoucherDO::getVoucherId, voucherIds));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAccountSetMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAccountSetMapper.java
new file mode 100644
index 0000000..38fa6d9
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAccountSetMapper.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * FMS 账套 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsAccountSetMapper extends BaseMapperX<FmsAccountSetDO> {
+
+    default FmsAccountSetDO selectByCompanyCode(String companyCode) {
+        return selectOne(FmsAccountSetDO::getCompanyCode, companyCode);
+    }
+
+    default FmsAccountSetDO selectByIdForUpdate(Long id) {
+        return selectOneForUpdate(FmsAccountSetDO::getId, id);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAccountUserMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAccountUserMapper.java
new file mode 100644
index 0000000..e6005a4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAccountUserMapper.java
@@ -0,0 +1,58 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 账套用户 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsAccountUserMapper extends BaseMapperX<FmsAccountUserDO> {
+
+    default FmsAccountUserDO selectByAccountSetIdAndUserId(Long accountSetId, Long userId) {
+        return selectOne(FmsAccountUserDO::getAccountSetId, accountSetId,
+                FmsAccountUserDO::getUserId, userId);
+    }
+
+    default List<FmsAccountUserDO> selectListByUserId(Long userId) {
+        return selectList(new LambdaQueryWrapperX<FmsAccountUserDO>()
+                .eq(FmsAccountUserDO::getUserId, userId)
+                .orderByDesc(FmsAccountUserDO::getDefaultStatus)
+                .orderByDesc(FmsAccountUserDO::getId));
+    }
+
+    default List<FmsAccountUserDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsAccountUserDO>()
+                .eq(FmsAccountUserDO::getAccountSetId, accountSetId)
+                .orderByDesc(FmsAccountUserDO::getFounder)
+                .orderByAsc(FmsAccountUserDO::getId));
+    }
+
+    default void deleteByAccountSetIdAndUserIds(Long accountSetId, Collection<Long> userIds) {
+        delete(new LambdaQueryWrapperX<FmsAccountUserDO>()
+                .eq(FmsAccountUserDO::getAccountSetId, accountSetId)
+                .in(FmsAccountUserDO::getUserId, userIds));
+    }
+
+    default Long selectCountByUserId(Long userId) {
+        return selectCount(FmsAccountUserDO::getUserId, userId);
+    }
+
+    default void updateDefaultStatusByUserId(Long userId) {
+        update(new FmsAccountUserDO().setDefaultStatus(false),
+                new LambdaQueryWrapperX<FmsAccountUserDO>().eq(FmsAccountUserDO::getUserId, userId));
+    }
+
+    default void updateDefaultStatusByAccountSetIdAndUserId(Long accountSetId, Long userId) {
+        update(new FmsAccountUserDO().setDefaultStatus(true), new LambdaQueryWrapperX<FmsAccountUserDO>()
+                .eq(FmsAccountUserDO::getAccountSetId, accountSetId).eq(FmsAccountUserDO::getUserId, userId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryCombinationMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryCombinationMapper.java
new file mode 100644
index 0000000..c1935a9
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryCombinationMapper.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 辅助核算组合 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsAuxiliaryCombinationMapper extends BaseMapperX<FmsAuxiliaryCombinationDO> {
+
+    default List<FmsAuxiliaryCombinationDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsAuxiliaryCombinationDO>()
+                .eq(FmsAuxiliaryCombinationDO::getAccountSetId, accountSetId));
+    }
+
+    default Long selectCountByAccountSetIdAndSubjectIds(
+            Long accountSetId, Collection<Long> subjectIds) {
+        return selectCount(new LambdaQueryWrapperX<FmsAuxiliaryCombinationDO>()
+                .eq(FmsAuxiliaryCombinationDO::getAccountSetId, accountSetId)
+                .in(FmsAuxiliaryCombinationDO::getSubjectId, subjectIds));
+    }
+
+    default void updateSubject(Long accountSetId, Long subjectId, FmsAuxiliaryCombinationDO updateObj) {
+        update(updateObj, new LambdaUpdateWrapper<FmsAuxiliaryCombinationDO>()
+                .eq(FmsAuxiliaryCombinationDO::getAccountSetId, accountSetId)
+                .eq(FmsAuxiliaryCombinationDO::getSubjectId, subjectId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryItemMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryItemMapper.java
new file mode 100644
index 0000000..8f8bad8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryItemMapper.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemPageReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 辅助核算项目 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsAuxiliaryItemMapper extends BaseMapperX<FmsAuxiliaryItemDO> {
+
+    default PageResult<FmsAuxiliaryItemDO> selectPage(FmsAuxiliaryItemPageReqVO reqVO) {
+        LambdaQueryWrapperX<FmsAuxiliaryItemDO> query = new LambdaQueryWrapperX<FmsAuxiliaryItemDO>()
+                .eq(FmsAuxiliaryItemDO::getAccountSetId, reqVO.getAccountSetId())
+                .eq(FmsAuxiliaryItemDO::getAuxiliaryTypeId, reqVO.getAuxiliaryTypeId());
+        if (StrUtil.isNotBlank(reqVO.getSearch())) {
+            query.and(wrapper -> wrapper.like(FmsAuxiliaryItemDO::getCode, reqVO.getSearch())
+                    .or().like(FmsAuxiliaryItemDO::getName, reqVO.getSearch()));
+        }
+        return selectPage(reqVO, query.orderByDesc(FmsAuxiliaryItemDO::getCode)
+                .orderByDesc(FmsAuxiliaryItemDO::getId));
+    }
+
+    default FmsAuxiliaryItemDO selectByTypeIdAndCode(Long accountSetId, Long auxiliaryTypeId, String code) {
+        return selectOne(new LambdaQueryWrapperX<FmsAuxiliaryItemDO>()
+                .eq(FmsAuxiliaryItemDO::getAccountSetId, accountSetId)
+                .eq(FmsAuxiliaryItemDO::getAuxiliaryTypeId, auxiliaryTypeId)
+                .eq(FmsAuxiliaryItemDO::getCode, code));
+    }
+
+    default Long selectCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId) {
+        return selectCount(new LambdaQueryWrapperX<FmsAuxiliaryItemDO>()
+                .eq(FmsAuxiliaryItemDO::getAccountSetId, accountSetId)
+                .eq(FmsAuxiliaryItemDO::getAuxiliaryTypeId, auxiliaryTypeId));
+    }
+
+    default List<FmsAuxiliaryItemDO> selectListByIdsAndAccountSetId(Collection<Long> ids, Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsAuxiliaryItemDO>()
+                .in(FmsAuxiliaryItemDO::getId, ids)
+                .eq(FmsAuxiliaryItemDO::getAccountSetId, accountSetId));
+    }
+
+    default List<FmsAuxiliaryItemDO> selectListByAccountSetIdAndAuxiliaryTypeId(
+            Long accountSetId, Long auxiliaryTypeId) {
+        return selectList(new LambdaQueryWrapperX<FmsAuxiliaryItemDO>()
+                .eq(FmsAuxiliaryItemDO::getAccountSetId, accountSetId)
+                .eq(FmsAuxiliaryItemDO::getAuxiliaryTypeId, auxiliaryTypeId)
+                .orderByDesc(FmsAuxiliaryItemDO::getCode)
+                .orderByDesc(FmsAuxiliaryItemDO::getId));
+    }
+
+    default List<FmsAuxiliaryItemDO> selectListByAccountSetIdAndAuxiliaryTypeIdAndStatus(
+            Long accountSetId, Long auxiliaryTypeId, Integer status) {
+        return selectList(new LambdaQueryWrapperX<FmsAuxiliaryItemDO>()
+                .eq(FmsAuxiliaryItemDO::getAccountSetId, accountSetId)
+                .eq(FmsAuxiliaryItemDO::getAuxiliaryTypeId, auxiliaryTypeId)
+                .eq(FmsAuxiliaryItemDO::getStatus, status)
+                .orderByDesc(FmsAuxiliaryItemDO::getCode)
+                .orderByDesc(FmsAuxiliaryItemDO::getId));
+    }
+
+    default List<FmsAuxiliaryItemDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsAuxiliaryItemDO>()
+                .eq(FmsAuxiliaryItemDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsAuxiliaryItemDO::getAuxiliaryTypeId)
+                .orderByDesc(FmsAuxiliaryItemDO::getCode)
+                .orderByDesc(FmsAuxiliaryItemDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryTypeMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryTypeMapper.java
new file mode 100644
index 0000000..f1aaa45
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsAuxiliaryTypeMapper.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 辅助核算类别 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsAuxiliaryTypeMapper extends BaseMapperX<FmsAuxiliaryTypeDO> {
+
+    default List<FmsAuxiliaryTypeDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsAuxiliaryTypeDO>()
+                .eq(FmsAuxiliaryTypeDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsAuxiliaryTypeDO::getType)
+                .orderByAsc(FmsAuxiliaryTypeDO::getId));
+    }
+
+    default List<FmsAuxiliaryTypeDO> selectListByIdsAndAccountSetId(
+            Collection<Long> ids, Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsAuxiliaryTypeDO>()
+                .in(FmsAuxiliaryTypeDO::getId, ids)
+                .eq(FmsAuxiliaryTypeDO::getAccountSetId, accountSetId));
+    }
+
+    default FmsAuxiliaryTypeDO selectByAccountSetIdAndName(Long accountSetId, String name) {
+        return selectOne(new LambdaQueryWrapperX<FmsAuxiliaryTypeDO>()
+                .eq(FmsAuxiliaryTypeDO::getAccountSetId, accountSetId)
+                .eq(FmsAuxiliaryTypeDO::getName, name));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsCurrencyMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsCurrencyMapper.java
new file mode 100644
index 0000000..23c5b33
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsCurrencyMapper.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 币种 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsCurrencyMapper extends BaseMapperX<FmsCurrencyDO> {
+
+    default FmsCurrencyDO selectByAccountSetIdAndCode(Long accountSetId, String code) {
+        return selectOne(FmsCurrencyDO::getAccountSetId, accountSetId,
+                FmsCurrencyDO::getCode, code);
+    }
+
+    default FmsCurrencyDO selectByIdAndAccountSetId(Long id, Long accountSetId) {
+        return selectOne(FmsCurrencyDO::getId, id,
+                FmsCurrencyDO::getAccountSetId, accountSetId);
+    }
+
+    default List<FmsCurrencyDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsCurrencyDO>()
+                .eq(FmsCurrencyDO::getAccountSetId, accountSetId)
+                .orderByDesc(FmsCurrencyDO::getStandard)
+                .orderByAsc(FmsCurrencyDO::getId));
+    }
+
+    default List<FmsCurrencyDO> selectListByIdsAndAccountSetId(
+            Collection<Long> ids, Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsCurrencyDO>()
+                .in(FmsCurrencyDO::getId, ids)
+                .eq(FmsCurrencyDO::getAccountSetId, accountSetId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsDigestMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsDigestMapper.java
new file mode 100644
index 0000000..c63e7cc
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsDigestMapper.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsDigestDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 常用摘要 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsDigestMapper extends BaseMapperX<FmsDigestDO> {
+
+    default List<FmsDigestDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsDigestDO>()
+                .eq(FmsDigestDO::getAccountSetId, accountSetId)
+                .orderByDesc(FmsDigestDO::getUpdateTime)
+                .orderByDesc(FmsDigestDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsFinanceIndicatorMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsFinanceIndicatorMapper.java
new file mode 100644
index 0000000..e6eab75
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsFinanceIndicatorMapper.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceIndicatorDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 首页财务指标 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsFinanceIndicatorMapper extends BaseMapperX<FmsFinanceIndicatorDO> {
+
+    default FmsFinanceIndicatorDO selectByIdAndAccountSetId(Long id, Long accountSetId) {
+        return selectOne(FmsFinanceIndicatorDO::getId, id,
+                FmsFinanceIndicatorDO::getAccountSetId, accountSetId);
+    }
+
+    default List<FmsFinanceIndicatorDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsFinanceIndicatorDO>()
+                .eq(FmsFinanceIndicatorDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsFinanceIndicatorDO::getSort)
+                .orderByAsc(FmsFinanceIndicatorDO::getId));
+    }
+
+    // TODO DONE @AI：启用指标查询改为按 status 查询，方法名完整表达过滤条件。
+    default List<FmsFinanceIndicatorDO> selectListByAccountSetIdAndStatus(Long accountSetId, Integer status) {
+        return selectList(new LambdaQueryWrapperX<FmsFinanceIndicatorDO>()
+                .eq(FmsFinanceIndicatorDO::getAccountSetId, accountSetId)
+                .eq(FmsFinanceIndicatorDO::getStatus, status)
+                .orderByAsc(FmsFinanceIndicatorDO::getSort)
+                .orderByAsc(FmsFinanceIndicatorDO::getId));
+    }
+
+    default FmsFinanceIndicatorDO selectByAccountSetIdAndCode(Long accountSetId, String code) {
+        return selectOne(new LambdaQueryWrapperX<FmsFinanceIndicatorDO>()
+                .eq(FmsFinanceIndicatorDO::getAccountSetId, accountSetId)
+                .eq(FmsFinanceIndicatorDO::getCode, code));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsFinanceParameterMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsFinanceParameterMapper.java
new file mode 100644
index 0000000..036c613
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsFinanceParameterMapper.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * FMS 财务参数 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsFinanceParameterMapper extends BaseMapperX<FmsFinanceParameterDO> {
+
+    default FmsFinanceParameterDO selectByAccountSetId(Long accountSetId) {
+        return selectOne(FmsFinanceParameterDO::getAccountSetId, accountSetId);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsInitialBalanceMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsInitialBalanceMapper.java
new file mode 100644
index 0000000..2f4f8b8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsInitialBalanceMapper.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsInitialBalanceDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 科目期初余额 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsInitialBalanceMapper extends BaseMapperX<FmsInitialBalanceDO> {
+
+    default List<FmsInitialBalanceDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsInitialBalanceDO>()
+                .eq(FmsInitialBalanceDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsInitialBalanceDO::getSubjectId)
+                .orderByAsc(FmsInitialBalanceDO::getId));
+    }
+
+    default FmsInitialBalanceDO selectByAccountSetIdAndSubjectId(Long accountSetId, Long subjectId) {
+        return selectOne(FmsInitialBalanceDO::getAccountSetId, accountSetId,
+                FmsInitialBalanceDO::getSubjectId, subjectId);
+    }
+
+    default List<FmsInitialBalanceDO> selectListByAccountSetIdAndSubjectIds(
+            Long accountSetId, Collection<Long> subjectIds) {
+        return selectList(new LambdaQueryWrapperX<FmsInitialBalanceDO>()
+                .eq(FmsInitialBalanceDO::getAccountSetId, accountSetId)
+                .in(FmsInitialBalanceDO::getSubjectId, subjectIds));
+    }
+
+    default Long selectCountByAccountSetIdAndSubjectIds(
+            Long accountSetId, Collection<Long> subjectIds) {
+        return selectCount(new LambdaQueryWrapperX<FmsInitialBalanceDO>()
+                .eq(FmsInitialBalanceDO::getAccountSetId, accountSetId)
+                .in(FmsInitialBalanceDO::getSubjectId, subjectIds));
+    }
+
+    default void updateSubject(Long accountSetId, Long subjectId, FmsInitialBalanceDO updateObj) {
+        update(updateObj, new LambdaUpdateWrapper<FmsInitialBalanceDO>()
+                .eq(FmsInitialBalanceDO::getAccountSetId, accountSetId)
+                .eq(FmsInitialBalanceDO::getSubjectId, subjectId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsSubjectMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsSubjectMapper.java
new file mode 100644
index 0000000..e89e613
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsSubjectMapper.java
@@ -0,0 +1,68 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 会计科目 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsSubjectMapper extends BaseMapperX<FmsSubjectDO> {
+
+    default List<FmsSubjectDO> selectListByAccountSetIdAndType(Long accountSetId, Integer type) {
+        return selectList(new LambdaQueryWrapperX<FmsSubjectDO>()
+                .eq(FmsSubjectDO::getAccountSetId, accountSetId)
+                .eqIfPresent(FmsSubjectDO::getType, type)
+                .orderByAsc(FmsSubjectDO::getCode)
+                .orderByAsc(FmsSubjectDO::getId));
+    }
+
+    default FmsSubjectDO selectByAccountSetIdAndCode(Long accountSetId, String code) {
+        return selectOne(new LambdaQueryWrapperX<FmsSubjectDO>()
+                .eq(FmsSubjectDO::getAccountSetId, accountSetId)
+                .eq(FmsSubjectDO::getCode, code));
+    }
+
+    default Long selectCountByParentId(Long parentId) {
+        return selectCount(FmsSubjectDO::getParentId, parentId);
+    }
+
+    default Long selectCountByParentIds(Collection<Long> parentIds) {
+        return selectCount(new LambdaQueryWrapperX<FmsSubjectDO>()
+                .in(FmsSubjectDO::getParentId, parentIds));
+    }
+
+    default List<FmsSubjectDO> selectListByParentIds(Long accountSetId, Collection<Long> parentIds) {
+        return selectList(new LambdaQueryWrapperX<FmsSubjectDO>()
+                .eq(FmsSubjectDO::getAccountSetId, accountSetId)
+                .in(FmsSubjectDO::getParentId, parentIds)
+                .orderByAsc(FmsSubjectDO::getCode)
+                .orderByAsc(FmsSubjectDO::getId));
+    }
+
+    default FmsSubjectDO selectByIdAndAccountSetId(Long id, Long accountSetId) {
+        return selectOne(FmsSubjectDO::getId, id,
+                FmsSubjectDO::getAccountSetId, accountSetId);
+    }
+
+    default List<FmsSubjectDO> selectListByIdsAndAccountSetId(Collection<Long> ids, Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsSubjectDO>()
+                .in(FmsSubjectDO::getId, ids)
+                .eq(FmsSubjectDO::getAccountSetId, accountSetId));
+    }
+
+    default void updateStatusByIdsAndAccountSetId(Collection<Long> ids, Long accountSetId, FmsSubjectDO updateObj) {
+        update(updateObj, new LambdaUpdateWrapper<FmsSubjectDO>()
+                .in(FmsSubjectDO::getId, ids)
+                .eq(FmsSubjectDO::getAccountSetId, accountSetId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsSubjectTemplateMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsSubjectTemplateMapper.java
new file mode 100644
index 0000000..d486078
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsSubjectTemplateMapper.java
@@ -0,0 +1,15 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+/**
+ * FMS 科目模板 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsSubjectTemplateMapper extends BaseMapperX<FmsSubjectTemplateDO> {
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherTemplateCategoryMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherTemplateCategoryMapper.java
new file mode 100644
index 0000000..fd5488b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherTemplateCategoryMapper.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateCategoryDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 凭证模板分类 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsVoucherTemplateCategoryMapper extends BaseMapperX<FmsVoucherTemplateCategoryDO> {
+
+    default List<FmsVoucherTemplateCategoryDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherTemplateCategoryDO>()
+                .eq(FmsVoucherTemplateCategoryDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsVoucherTemplateCategoryDO::getId));
+    }
+
+    default FmsVoucherTemplateCategoryDO selectByAccountSetIdAndName(Long accountSetId, String name) {
+        return selectOne(FmsVoucherTemplateCategoryDO::getAccountSetId, accountSetId,
+                FmsVoucherTemplateCategoryDO::getName, name);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherTemplateMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherTemplateMapper.java
new file mode 100644
index 0000000..f9a5a05
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherTemplateMapper.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 凭证模板 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsVoucherTemplateMapper extends BaseMapperX<FmsVoucherTemplateDO> {
+
+    default List<FmsVoucherTemplateDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherTemplateDO>()
+                .eq(FmsVoucherTemplateDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsVoucherTemplateDO::getCategoryId)
+                .orderByAsc(FmsVoucherTemplateDO::getId));
+    }
+
+    default Long selectCountByCategoryId(Long categoryId) {
+        return selectCount(FmsVoucherTemplateDO::getCategoryId, categoryId);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherWordMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherWordMapper.java
new file mode 100644
index 0000000..63c0292
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/config/FmsVoucherWordMapper.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 凭证字 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsVoucherWordMapper extends BaseMapperX<FmsVoucherWordDO> {
+
+    default List<FmsVoucherWordDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherWordDO>()
+                .eq(FmsVoucherWordDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsVoucherWordDO::getSort)
+                .orderByAsc(FmsVoucherWordDO::getId));
+    }
+
+    default FmsVoucherWordDO selectByAccountSetIdAndName(Long accountSetId, String name) {
+        return selectOne(FmsVoucherWordDO::getAccountSetId, accountSetId,
+                FmsVoucherWordDO::getName, name);
+    }
+
+    default FmsVoucherWordDO selectDefaultByAccountSetId(Long accountSetId) {
+        return selectFirstOne(FmsVoucherWordDO::getAccountSetId, accountSetId,
+                FmsVoucherWordDO::getDefaultStatus, true);
+    }
+
+    default FmsVoucherWordDO selectLastByAccountSetId(Long accountSetId) {
+        return selectLastOne(new LambdaQueryWrapperX<FmsVoucherWordDO>()
+                .eq(FmsVoucherWordDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsVoucherWordDO::getSort)
+                .orderByAsc(FmsVoucherWordDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/ledger/FmsLedgerQueryMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/ledger/FmsLedgerQueryMapper.java
new file mode 100644
index 0000000..3319837
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/ledger/FmsLedgerQueryMapper.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.ledger;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerEntryVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * FMS 账簿查询 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsLedgerQueryMapper extends BaseMapperX<FmsVoucherEntryDO> {
+
+    default List<FmsLedgerEntryVO> selectEntryListBeforeTime(Long accountSetId, LocalDateTime endTime) {
+        return selectJoinList(FmsLedgerEntryVO.class,
+                new MPJLambdaWrapperX<FmsVoucherEntryDO>()
+                        .selectAs(FmsVoucherEntryDO::getId, FmsLedgerEntryVO::getEntryId)
+                        .selectAs(FmsVoucherEntryDO::getVoucherId, FmsLedgerEntryVO::getVoucherId)
+                        .selectAs(FmsVoucherEntryDO::getSubjectId, FmsLedgerEntryVO::getSubjectId)
+                        .selectAs(FmsVoucherDO::getVoucherTime, FmsLedgerEntryVO::getVoucherTime)
+                        .selectAs(FmsVoucherDO::getVoucherNumber, FmsLedgerEntryVO::getVoucherNumber)
+                        .selectAs(FmsVoucherWordDO::getName, FmsLedgerEntryVO::getVoucherWordName)
+                        .selectAs(FmsVoucherEntryDO::getDigest, FmsLedgerEntryVO::getDigest)
+                        .selectAs(FmsVoucherEntryDO::getDebitAmount, FmsLedgerEntryVO::getDebitAmount)
+                        .selectAs(FmsVoucherEntryDO::getCreditAmount, FmsLedgerEntryVO::getCreditAmount)
+                        .selectAs(FmsVoucherEntryDO::getQuantity, FmsLedgerEntryVO::getQuantity)
+                        .selectAs(FmsVoucherEntryDO::getUnitPrice, FmsLedgerEntryVO::getUnitPrice)
+                        .selectAs(FmsVoucherEntryDO::getSort, FmsLedgerEntryVO::getSort)
+                        .selectAs(FmsVoucherEntryDO::getAssistCombinationId,
+                                FmsLedgerEntryVO::getAssistCombinationId)
+                        .selectAs(FmsVoucherEntryDO::getAuxiliaries, FmsLedgerEntryVO::getAuxiliaries)
+                        .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                        .lt(FmsVoucherDO::getVoucherTime, endTime)
+                        .innerJoin(FmsVoucherDO.class, FmsVoucherDO::getId,
+                                FmsVoucherEntryDO::getVoucherId)
+                        .leftJoin(FmsVoucherWordDO.class, FmsVoucherWordDO::getId,
+                                FmsVoucherDO::getVoucherWordId)
+                        .orderByAsc(FmsVoucherDO::getVoucherTime)
+                        .orderByAsc(FmsVoucherDO::getVoucherNumber)
+                        .orderByAsc(FmsVoucherDO::getId)
+                        .orderByAsc(FmsVoucherEntryDO::getSort)
+                        .orderByAsc(FmsVoucherEntryDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/FmsReportTemplateMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/FmsReportTemplateMapper.java
new file mode 100644
index 0000000..08ce250
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/FmsReportTemplateMapper.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.FmsReportTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 报表模板 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsReportTemplateMapper extends BaseMapperX<FmsReportTemplateDO> {
+
+    default List<FmsReportTemplateDO> selectListByType(Integer type) {
+        return selectList(new LambdaQueryWrapperX<FmsReportTemplateDO>()
+                .eq(FmsReportTemplateDO::getType, type)
+                .orderByAsc(FmsReportTemplateDO::getSort)
+                .orderByAsc(FmsReportTemplateDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/balance/FmsBalanceSheetConfigMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/balance/FmsBalanceSheetConfigMapper.java
new file mode 100644
index 0000000..d229f0e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/balance/FmsBalanceSheetConfigMapper.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.balance;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.balance.FmsBalanceSheetConfigDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 资产负债表配置 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsBalanceSheetConfigMapper extends BaseMapperX<FmsBalanceSheetConfigDO> {
+
+    default List<FmsBalanceSheetConfigDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsBalanceSheetConfigDO>()
+                .eq(FmsBalanceSheetConfigDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsBalanceSheetConfigDO::getSort)
+                .orderByAsc(FmsBalanceSheetConfigDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/balance/FmsBalanceSheetReportMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/balance/FmsBalanceSheetReportMapper.java
new file mode 100644
index 0000000..dccbe20
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/balance/FmsBalanceSheetReportMapper.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.balance;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.balance.FmsBalanceSheetReportDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 资产负债表数据 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsBalanceSheetReportMapper extends BaseMapperX<FmsBalanceSheetReportDO> {
+
+    default List<FmsBalanceSheetReportDO> selectListByPeriod(
+            Long accountSetId, Integer fromPeriod, Integer toPeriod, Integer type) {
+        return selectList(new LambdaQueryWrapperX<FmsBalanceSheetReportDO>()
+                .eq(FmsBalanceSheetReportDO::getAccountSetId, accountSetId)
+                .eq(FmsBalanceSheetReportDO::getFromPeriod, fromPeriod)
+                .eq(FmsBalanceSheetReportDO::getToPeriod, toPeriod)
+                .eq(FmsBalanceSheetReportDO::getType, type)
+                .orderByAsc(FmsBalanceSheetReportDO::getSort)
+                .orderByAsc(FmsBalanceSheetReportDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowExtendConfigMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowExtendConfigMapper.java
new file mode 100644
index 0000000..b34247e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowExtendConfigMapper.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowExtendConfigDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 现金流量表扩展配置 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsCashFlowExtendConfigMapper extends BaseMapperX<FmsCashFlowExtendConfigDO> {
+
+    default List<FmsCashFlowExtendConfigDO> selectListByAccountSetIdAndCategory(Long accountSetId, Integer category) {
+        return selectList(new LambdaQueryWrapperX<FmsCashFlowExtendConfigDO>()
+                .eq(FmsCashFlowExtendConfigDO::getAccountSetId, accountSetId)
+                .eqIfPresent(FmsCashFlowExtendConfigDO::getCategory, category)
+                .orderByAsc(FmsCashFlowExtendConfigDO::getSort)
+                .orderByAsc(FmsCashFlowExtendConfigDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowExtendDataMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowExtendDataMapper.java
new file mode 100644
index 0000000..22ee2f1
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowExtendDataMapper.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowExtendDataDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 现金流量表扩展数据 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsCashFlowExtendDataMapper extends BaseMapperX<FmsCashFlowExtendDataDO> {
+
+    default List<FmsCashFlowExtendDataDO> selectListByPeriod(Long accountSetId, Integer fromPeriod,
+                                                             Integer toPeriod, Integer type, Integer category) {
+        return selectList(new LambdaQueryWrapperX<FmsCashFlowExtendDataDO>()
+                .eq(FmsCashFlowExtendDataDO::getAccountSetId, accountSetId)
+                .eq(FmsCashFlowExtendDataDO::getFromPeriod, fromPeriod)
+                .eq(FmsCashFlowExtendDataDO::getToPeriod, toPeriod)
+                .eq(FmsCashFlowExtendDataDO::getType, type)
+                .eqIfPresent(FmsCashFlowExtendDataDO::getCategory, category)
+                .orderByAsc(FmsCashFlowExtendDataDO::getSort)
+                .orderByAsc(FmsCashFlowExtendDataDO::getId));
+    }
+
+    default List<FmsCashFlowExtendDataDO> selectListByIdsAndAccountSetId(Collection<Long> ids, Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsCashFlowExtendDataDO>()
+                .in(FmsCashFlowExtendDataDO::getId, ids)
+                .eq(FmsCashFlowExtendDataDO::getAccountSetId, accountSetId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowStatementConfigMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowStatementConfigMapper.java
new file mode 100644
index 0000000..2815dde
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowStatementConfigMapper.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowStatementConfigDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 现金流量表配置 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsCashFlowStatementConfigMapper extends BaseMapperX<FmsCashFlowStatementConfigDO> {
+
+    default List<FmsCashFlowStatementConfigDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsCashFlowStatementConfigDO>()
+                .eq(FmsCashFlowStatementConfigDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsCashFlowStatementConfigDO::getSort)
+                .orderByAsc(FmsCashFlowStatementConfigDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowStatementReportMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowStatementReportMapper.java
new file mode 100644
index 0000000..60d62df
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/cashflow/FmsCashFlowStatementReportMapper.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowStatementReportDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * FMS 现金流量表数据 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsCashFlowStatementReportMapper extends BaseMapperX<FmsCashFlowStatementReportDO> {
+
+    default List<FmsCashFlowStatementReportDO> selectListByPeriod(Long accountSetId,
+                                                                  Integer fromPeriod, Integer toPeriod, Integer type) {
+        return selectList(new LambdaQueryWrapperX<FmsCashFlowStatementReportDO>()
+                .eq(FmsCashFlowStatementReportDO::getAccountSetId, accountSetId)
+                .eq(FmsCashFlowStatementReportDO::getFromPeriod, fromPeriod)
+                .eq(FmsCashFlowStatementReportDO::getToPeriod, toPeriod)
+                .eq(FmsCashFlowStatementReportDO::getType, type)
+                .orderByAsc(FmsCashFlowStatementReportDO::getSort)
+                .orderByAsc(FmsCashFlowStatementReportDO::getId));
+    }
+
+    default List<FmsCashFlowStatementReportDO> selectListByIdsAndPeriod(List<Long> ids,
+            Long accountSetId, Integer fromPeriod, Integer toPeriod, Integer type) {
+        return selectList(new LambdaQueryWrapperX<FmsCashFlowStatementReportDO>()
+                .in(FmsCashFlowStatementReportDO::getId, ids)
+                .eq(FmsCashFlowStatementReportDO::getAccountSetId, accountSetId)
+                .eq(FmsCashFlowStatementReportDO::getFromPeriod, fromPeriod)
+                .eq(FmsCashFlowStatementReportDO::getToPeriod, toPeriod)
+                .eq(FmsCashFlowStatementReportDO::getType, type));
+    }
+
+    default void clearAdjustedAmounts(Long accountSetId, Integer fromPeriod, Integer toPeriod, Integer type) {
+        update(new FmsCashFlowStatementReportDO(),
+                new LambdaUpdateWrapper<FmsCashFlowStatementReportDO>()
+                        .eq(FmsCashFlowStatementReportDO::getAccountSetId, accountSetId)
+                        .eq(FmsCashFlowStatementReportDO::getFromPeriod, fromPeriod)
+                        .eq(FmsCashFlowStatementReportDO::getToPeriod, toPeriod)
+                        .eq(FmsCashFlowStatementReportDO::getType, type)
+                        .set(FmsCashFlowStatementReportDO::getCurrentAmount, BigDecimal.ZERO)
+                        .set(FmsCashFlowStatementReportDO::getYearAmount, BigDecimal.ZERO));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/income/FmsIncomeStatementConfigMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/income/FmsIncomeStatementConfigMapper.java
new file mode 100644
index 0000000..c7ef633
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/income/FmsIncomeStatementConfigMapper.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.income;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.income.FmsIncomeStatementConfigDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 利润表配置 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsIncomeStatementConfigMapper extends BaseMapperX<FmsIncomeStatementConfigDO> {
+
+    default List<FmsIncomeStatementConfigDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsIncomeStatementConfigDO>()
+                .eq(FmsIncomeStatementConfigDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsIncomeStatementConfigDO::getSort)
+                .orderByAsc(FmsIncomeStatementConfigDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/income/FmsIncomeStatementReportMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/income/FmsIncomeStatementReportMapper.java
new file mode 100644
index 0000000..f19b046
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/report/income/FmsIncomeStatementReportMapper.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.report.income;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.income.FmsIncomeStatementReportDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+/**
+ * FMS 利润表数据 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsIncomeStatementReportMapper extends BaseMapperX<FmsIncomeStatementReportDO> {
+
+    default List<FmsIncomeStatementReportDO> selectListByPeriod(Long accountSetId,
+                                                                Integer fromPeriod, Integer toPeriod, Integer type) {
+        return selectList(new LambdaQueryWrapperX<FmsIncomeStatementReportDO>()
+                .eq(FmsIncomeStatementReportDO::getAccountSetId, accountSetId)
+                .eq(FmsIncomeStatementReportDO::getFromPeriod, fromPeriod)
+                .eq(FmsIncomeStatementReportDO::getToPeriod, toPeriod)
+                .eq(FmsIncomeStatementReportDO::getType, type)
+                .orderByAsc(FmsIncomeStatementReportDO::getSort)
+                .orderByAsc(FmsIncomeStatementReportDO::getId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/voucher/FmsVoucherEntryMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/voucher/FmsVoucherEntryMapper.java
new file mode 100644
index 0000000..83af3e8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/voucher/FmsVoucherEntryMapper.java
@@ -0,0 +1,127 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.voucher;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSubjectAmountVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 凭证分录 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsVoucherEntryMapper extends BaseMapperX<FmsVoucherEntryDO> {
+
+    default List<FmsVoucherEntryDO> selectListByVoucherId(Long voucherId) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .eq(FmsVoucherEntryDO::getVoucherId, voucherId)
+                .orderByAsc(FmsVoucherEntryDO::getSort)
+                .orderByAsc(FmsVoucherEntryDO::getId));
+    }
+
+    default List<FmsVoucherEntryDO> selectListByVoucherIds(Collection<Long> voucherIds) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .in(FmsVoucherEntryDO::getVoucherId, voucherIds)
+                .orderByAsc(FmsVoucherEntryDO::getVoucherId)
+                .orderByAsc(FmsVoucherEntryDO::getSort)
+                .orderByAsc(FmsVoucherEntryDO::getId));
+    }
+
+    default List<FmsVoucherEntryDO> selectListByAccountSetId(Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                .orderByAsc(FmsVoucherEntryDO::getId));
+    }
+
+    default List<FmsVoucherEntryDO> selectListByAccountSetIdAndSubjectId(Long accountSetId, Long subjectId) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                .eq(FmsVoucherEntryDO::getSubjectId, subjectId)
+                .orderByAsc(FmsVoucherEntryDO::getId));
+    }
+
+    default List<FmsVoucherEntryDO> selectVoucherIdsByCondition(Long accountSetId, Collection<Long> subjectIds, String digest,
+                                                                BigDecimal minAmount, BigDecimal maxAmount) {
+        LambdaQueryWrapperX<FmsVoucherEntryDO> query = new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                .inIfPresent(FmsVoucherEntryDO::getSubjectId, subjectIds)
+                .likeIfPresent(FmsVoucherEntryDO::getDigest, digest);
+        query.apply(minAmount != null, "(debit_amount + credit_amount) >= {0}", minAmount)
+                .apply(maxAmount != null, "(debit_amount + credit_amount) <= {0}", maxAmount);
+        query.select(FmsVoucherEntryDO::getVoucherId);
+        return selectList(query);
+    }
+
+    default void deleteByVoucherIds(Collection<Long> voucherIds) {
+        delete(new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .in(FmsVoucherEntryDO::getVoucherId, voucherIds));
+    }
+
+    default Long selectCountByAccountSetIdAndSubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        return selectCount(new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                .in(FmsVoucherEntryDO::getSubjectId, subjectIds));
+    }
+
+    default Long selectQuantityCountByAccountSetIdAndSubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        return selectCount(new LambdaQueryWrapperX<FmsVoucherEntryDO>()
+                .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                .in(FmsVoucherEntryDO::getSubjectId, subjectIds)
+                .isNotNull(FmsVoucherEntryDO::getQuantity)
+                .ne(FmsVoucherEntryDO::getQuantity, BigDecimal.ZERO));
+    }
+
+    default void updateSubject(Long accountSetId, Long subjectId, FmsVoucherEntryDO updateObj) {
+        update(updateObj, new LambdaUpdateWrapper<FmsVoucherEntryDO>()
+                .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                .eq(FmsVoucherEntryDO::getSubjectId, subjectId));
+    }
+
+    default List<FmsVoucherSubjectAmountVO> selectSubjectAmountList(Long accountSetId,
+                                                                    LocalDateTime beginTime, LocalDateTime endTime,
+                                                                    Long voucherWordId, Integer minVoucherNumber, Integer maxVoucherNumber) {
+        return selectJoinList(FmsVoucherSubjectAmountVO.class,
+                new MPJLambdaWrapperX<FmsVoucherEntryDO>()
+                        .selectAs(FmsVoucherEntryDO::getSubjectId,
+                                FmsVoucherSubjectAmountVO::getSubjectId)
+                        .selectSum(FmsVoucherEntryDO::getDebitAmount,
+                                FmsVoucherSubjectAmountVO::getDebitAmount)
+                        .selectSum(FmsVoucherEntryDO::getCreditAmount,
+                                FmsVoucherSubjectAmountVO::getCreditAmount)
+                        .eq(FmsVoucherEntryDO::getAccountSetId, accountSetId)
+                        .eqIfPresent(FmsVoucherDO::getVoucherWordId, voucherWordId)
+                        .geIfPresent(FmsVoucherDO::getVoucherNumber, minVoucherNumber)
+                        .leIfPresent(FmsVoucherDO::getVoucherNumber, maxVoucherNumber)
+                        .ge(FmsVoucherDO::getVoucherTime, beginTime)
+                        .lt(FmsVoucherDO::getVoucherTime, endTime)
+                        .innerJoin(FmsVoucherDO.class, FmsVoucherDO::getId,
+                                FmsVoucherEntryDO::getVoucherId)
+                        .groupBy(FmsVoucherEntryDO::getSubjectId)
+                        .orderByAsc(FmsVoucherEntryDO::getSubjectId));
+    }
+
+    default List<FmsVoucherSubjectAmountVO> selectSubjectAmountListByVoucherIds(Collection<Long> voucherIds) {
+        return selectJoinList(FmsVoucherSubjectAmountVO.class,
+                new MPJLambdaWrapperX<FmsVoucherEntryDO>()
+                        .selectAs(FmsVoucherEntryDO::getSubjectId,
+                                FmsVoucherSubjectAmountVO::getSubjectId)
+                        .selectSum(FmsVoucherEntryDO::getDebitAmount,
+                                FmsVoucherSubjectAmountVO::getDebitAmount)
+                        .selectSum(FmsVoucherEntryDO::getCreditAmount,
+                                FmsVoucherSubjectAmountVO::getCreditAmount)
+                        .in(FmsVoucherEntryDO::getVoucherId, voucherIds)
+                        .groupBy(FmsVoucherEntryDO::getSubjectId)
+                        .orderByAsc(FmsVoucherEntryDO::getSubjectId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/voucher/FmsVoucherMapper.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/voucher/FmsVoucherMapper.java
new file mode 100644
index 0000000..ea43d9b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/dal/mysql/voucher/FmsVoucherMapper.java
@@ -0,0 +1,132 @@
+package cn.iocoder.yudao.module.fms.dal.mysql.voucher;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherPageReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherTidyTypeEnum;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 凭证 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface FmsVoucherMapper extends BaseMapperX<FmsVoucherDO> {
+
+    default void updateReviewStatusById(Long id, Integer status, Long reviewerUserId) {
+        update(new LambdaUpdateWrapper<FmsVoucherDO>()
+                .eq(FmsVoucherDO::getId, id)
+                .set(FmsVoucherDO::getStatus, status)
+                .set(FmsVoucherDO::getReviewerUserId, reviewerUserId));
+    }
+
+    default PageResult<FmsVoucherDO> selectPage(FmsVoucherPageReqVO reqVO, Collection<Long> voucherIds) {
+        LambdaQueryWrapperX<FmsVoucherDO> query = new LambdaQueryWrapperX<FmsVoucherDO>()
+                .eq(FmsVoucherDO::getAccountSetId, reqVO.getAccountSetId())
+                .inIfPresent(FmsVoucherDO::getId, reqVO.getIds())
+                .betweenIfPresent(FmsVoucherDO::getVoucherTime, reqVO.getVoucherTime())
+                .eqIfPresent(FmsVoucherDO::getVoucherWordId, reqVO.getVoucherWordId())
+                .eqIfPresent(FmsVoucherDO::getVoucherNumber, reqVO.getVoucherNumber())
+                .eqIfPresent(FmsVoucherDO::getStatus, reqVO.getStatus())
+                .eqIfPresent(FmsVoucherDO::getCreator, reqVO.getCreatorUserId() == null ? null : reqVO.getCreatorUserId().toString())
+                .inIfPresent(FmsVoucherDO::getId, voucherIds);
+        return selectPage(reqVO, query.orderByAsc(FmsVoucherDO::getVoucherTime)
+                .orderByAsc(FmsVoucherDO::getVoucherWordId)
+                .orderByAsc(FmsVoucherDO::getVoucherNumber)
+                .orderByAsc(FmsVoucherDO::getId));
+    }
+
+    default FmsVoucherDO selectByAccountSetIdAndVoucherWordIdAndVoucherNumberAndVoucherTimeBetween(
+            Long accountSetId, Long voucherWordId, Integer voucherNumber,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return selectOne(new LambdaQueryWrapperX<FmsVoucherDO>()
+                .eq(FmsVoucherDO::getAccountSetId, accountSetId)
+                .eq(FmsVoucherDO::getVoucherWordId, voucherWordId)
+                .eq(FmsVoucherDO::getVoucherNumber, voucherNumber)
+                .ge(FmsVoucherDO::getVoucherTime, beginTime)
+                .lt(FmsVoucherDO::getVoucherTime, endTime));
+    }
+
+    default FmsVoucherDO selectLastByPeriod(Long accountSetId, Long voucherWordId, LocalDateTime monthBeginTime,
+            LocalDateTime nextMonthBeginTime) {
+        return selectLastOne(new LambdaQueryWrapperX<FmsVoucherDO>()
+                .eq(FmsVoucherDO::getAccountSetId, accountSetId)
+                .eq(FmsVoucherDO::getVoucherWordId, voucherWordId)
+                .ge(FmsVoucherDO::getVoucherTime, monthBeginTime)
+                .lt(FmsVoucherDO::getVoucherTime, nextMonthBeginTime)
+                .orderByAsc(FmsVoucherDO::getVoucherNumber)
+                .orderByAsc(FmsVoucherDO::getId));
+    }
+
+    default List<FmsVoucherDO> selectListByIdsAndAccountSetId(Collection<Long> ids, Long accountSetId) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherDO>()
+                .in(FmsVoucherDO::getId, ids)
+                .eq(FmsVoucherDO::getAccountSetId, accountSetId));
+    }
+
+    default List<FmsVoucherDO> selectListByAccountSetIdAndVoucherTimeBetween(Long accountSetId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return selectList(new LambdaQueryWrapperX<FmsVoucherDO>()
+                .eq(FmsVoucherDO::getAccountSetId, accountSetId)
+                .ge(FmsVoucherDO::getVoucherTime, beginTime)
+                .lt(FmsVoucherDO::getVoucherTime, endTime)
+                .orderByAsc(FmsVoucherDO::getVoucherWordId)
+                .orderByAsc(FmsVoucherDO::getVoucherNumber)
+                .orderByAsc(FmsVoucherDO::getId));
+    }
+
+    /**
+     * 查询指定会计期间和起始号码后的待整理凭证：按凭证字分组，并根据整理方式按日期或凭证号优先排序
+     */
+    default List<FmsVoucherDO> selectListForTidy(Long accountSetId, LocalDateTime monthBeginTime,
+            LocalDateTime nextMonthBeginTime, Long voucherWordId, Integer startNumber, Integer type) {
+        LambdaQueryWrapperX<FmsVoucherDO> query = new LambdaQueryWrapperX<>();
+        query.eq(FmsVoucherDO::getAccountSetId, accountSetId);
+        query.eqIfPresent(FmsVoucherDO::getVoucherWordId, voucherWordId);
+        query.ge(FmsVoucherDO::getVoucherTime, monthBeginTime)
+                .lt(FmsVoucherDO::getVoucherTime, nextMonthBeginTime)
+                .ge(FmsVoucherDO::getVoucherNumber, startNumber)
+                .orderByAsc(FmsVoucherDO::getVoucherWordId);
+        if (FmsVoucherTidyTypeEnum.REORDER_BY_TIME.getType().equals(type)) {
+            query.orderByAsc(FmsVoucherDO::getVoucherTime)
+                    .orderByAsc(FmsVoucherDO::getVoucherNumber);
+        } else {
+            query.orderByAsc(FmsVoucherDO::getVoucherNumber)
+                    .orderByAsc(FmsVoucherDO::getVoucherTime);
+        }
+        return selectList(query.orderByAsc(FmsVoucherDO::getId));
+    }
+
+    /**
+     * 查询指定会计期间内目标号码到原凭证号码之间的凭证：按凭证号、日期和编号升序，供移动时稳定顺延中间凭证
+     */
+    default List<FmsVoucherDO> selectListForMove(Long accountSetId, Long voucherWordId,
+            LocalDateTime monthBeginTime, LocalDateTime nextMonthBeginTime,
+            Integer targetNumber, Integer sourceNumber) {
+        LambdaQueryWrapperX<FmsVoucherDO> query = new LambdaQueryWrapperX<>();
+        query.eq(FmsVoucherDO::getAccountSetId, accountSetId);
+        query.eq(FmsVoucherDO::getVoucherWordId, voucherWordId);
+        query.ge(FmsVoucherDO::getVoucherTime, monthBeginTime)
+                .lt(FmsVoucherDO::getVoucherTime, nextMonthBeginTime)
+                .between(FmsVoucherDO::getVoucherNumber, targetNumber, sourceNumber)
+                .orderByAsc(FmsVoucherDO::getVoucherNumber)
+                .orderByAsc(FmsVoucherDO::getVoucherTime)
+                .orderByAsc(FmsVoucherDO::getId);
+        return selectList(query);
+    }
+
+    default Long selectCountByAccountSetIdAndVoucherWordId(Long accountSetId, Long voucherWordId) {
+        return selectCount(new LambdaQueryWrapperX<FmsVoucherDO>()
+                .eq(FmsVoucherDO::getAccountSetId, accountSetId)
+                .eq(FmsVoucherDO::getVoucherWordId, voucherWordId));
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/DictTypeConstants.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/DictTypeConstants.java
new file mode 100644
index 0000000..7001b42
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/DictTypeConstants.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.fms.enums;
+
+/**
+ * FMS 字典类型的枚举类
+ *
+ * @author 芋道源码
+ */
+public interface DictTypeConstants {
+
+    String ACCOUNT_USER_LEVEL = "fms_account_user_level"; // 账套用户权限级别
+    String SUBJECT_CATEGORY = "fms_subject_category"; // 科目类别
+    String SUBJECT_TYPE = "fms_subject_type"; // 科目类型
+    String AUXILIARY_TYPE = "fms_auxiliary_type"; // 辅助核算类别
+    String DEBIT_CREDIT_DIRECTION = "fms_debit_credit_direction"; // 借贷方向
+    String VOUCHER_STATUS = "fms_voucher_status"; // 凭证状态
+    String VOUCHER_TIDY_TYPE = "fms_voucher_tidy_type"; // 凭证整理方式
+    String FINANCE_INDICATOR_TYPE = "fms_finance_indicator_type"; // 财务指标取数报表类型
+    String FORMULA_RULE = "fms_formula_rule"; // 报表公式取数规则
+    String REPORT_TYPE = "fms_report_type"; // 财务报表类型
+    String REPORT_PERIOD_TYPE = "fms_report_period_type"; // 财务报表期间类型
+    String LEDGER_BALANCE_MODE = "fms_ledger_balance_mode"; // 账簿余额方向模式
+    String ACCOUNTING_STANDARD = "fms_accounting_standard"; // 会计制度
+    String CLOSING_TYPE = "fms_closing_type"; // 结账方案类型
+    String CLOSING_TIME_TYPE = "fms_closing_time_type"; // 结账取数期间
+    String CLOSING_VOUCHER_TYPE = "fms_closing_voucher_type"; // 结账凭证类型
+    String CLOSING_TEMPLATE_CATEGORY = "fms_closing_template_category"; // 结账模板分类
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/ErrorCodeConstants.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/ErrorCodeConstants.java
new file mode 100644
index 0000000..27d1ae6
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/ErrorCodeConstants.java
@@ -0,0 +1,189 @@
+package cn.iocoder.yudao.module.fms.enums;
+
+import cn.iocoder.yudao.framework.common.exception.ErrorCode;
+
+/**
+ * FMS 错误码常量
+ *
+ * @author 芋道源码
+ */
+public interface ErrorCodeConstants {
+
+    // ========== 账套 1-052-100-000 ==========
+    ErrorCode ACCOUNT_SET_NOT_EXISTS = new ErrorCode(1_052_100_000, "账套不存在");
+    ErrorCode ACCOUNT_SET_CODE_DUPLICATE = new ErrorCode(1_052_100_001, "账套编码已存在");
+    ErrorCode ACCOUNT_SET_ACCESS_DENIED = new ErrorCode(1_052_100_002, "无权访问该账套");
+    ErrorCode ACCOUNT_SET_ALREADY_INITIALIZED = new ErrorCode(1_052_100_003, "账套已完成初始化");
+    ErrorCode ACCOUNT_SET_NOT_INITIALIZED = new ErrorCode(1_052_100_005, "账套尚未完成初始化");
+    ErrorCode ACCOUNT_SET_SETTINGS_RULE_INVALID = new ErrorCode(1_052_100_006, "科目编码规则不正确");
+    ErrorCode ACCOUNT_SET_SETTINGS_RULE_SHRINK = new ErrorCode(1_052_100_007, "科目级次和编码长度不能调小");
+    ErrorCode FINANCE_PARAMETER_NOT_EXISTS = new ErrorCode(1_052_100_008, "财务参数不存在");
+
+    // ========== 科目 1-052-101-000 ==========
+    ErrorCode SUBJECT_NOT_EXISTS = new ErrorCode(1_052_101_000, "科目不存在");
+    ErrorCode SUBJECT_CODE_DUPLICATE = new ErrorCode(1_052_101_001, "科目编码已存在");
+    ErrorCode SUBJECT_CATEGORY_INVALID = new ErrorCode(1_052_101_002, "科目类别与科目类型不匹配");
+    ErrorCode SUBJECT_PARENT_INVALID = new ErrorCode(1_052_101_003,
+            "上级科目不属于当前账套，或科目类型、类别不一致");
+    ErrorCode SUBJECT_CODE_RULE_INVALID = new ErrorCode(1_052_101_004, "科目编码不符合科目级次规则");
+    ErrorCode SUBJECT_HAS_CHILDREN = new ErrorCode(1_052_101_005, "科目下有子级科目，不能删除或修改编码");
+    ErrorCode SUBJECT_QUANTITY_UNIT_REQUIRED = new ErrorCode(1_052_101_006, "启用数量核算时数量单位不能为空");
+    ErrorCode SUBJECT_CURRENCY_INVALID = new ErrorCode(1_052_101_007, "外币核算不能选择本位币");
+    ErrorCode SUBJECT_VOUCHER_ENTRY_IN_USE = new ErrorCode(1_052_101_008,
+            "科目已被 {} 条凭证分录使用，不能删除");
+    ErrorCode SUBJECT_VOUCHER_TEMPLATE_IN_USE = new ErrorCode(1_052_101_009,
+            "科目已被 {} 个凭证模板使用，不能删除");
+    ErrorCode SUBJECT_INITIAL_BALANCE_IN_USE = new ErrorCode(1_052_101_010,
+            "科目已被 {} 条初始余额使用，不能删除");
+    ErrorCode SUBJECT_AUXILIARY_COMBINATION_IN_USE = new ErrorCode(1_052_101_011,
+            "科目已被 {} 个辅助核算组合使用，不能删除");
+    ErrorCode SUBJECT_CLOSING_SCHEME_IN_USE = new ErrorCode(1_052_101_012,
+            "科目已被 {} 个结账方案使用，不能删除");
+    ErrorCode SUBJECT_IMPORT_LIST_IS_EMPTY = new ErrorCode(1_052_101_013, "导入科目数据不能为空");
+    ErrorCode SUBJECT_USED_BALANCE_DIRECTION_IMMUTABLE = new ErrorCode(1_052_101_014,
+            "科目已有业务数据，不能修改余额方向");
+    ErrorCode SUBJECT_USED_AUXILIARY_IMMUTABLE = new ErrorCode(1_052_101_015,
+            "科目已有业务数据，不能直接修改辅助核算");
+    ErrorCode SUBJECT_NON_LEAF_CONFIG_IMMUTABLE = new ErrorCode(1_052_101_016,
+            "非末级科目不能修改科目类型、类别或辅助核算");
+    ErrorCode SUBJECT_QUANTITY_ACCOUNTING_IN_USE = new ErrorCode(1_052_101_017,
+            "科目已有数量数据，不能关闭数量核算");
+    ErrorCode SUBJECT_PARENT_IN_USE = new ErrorCode(1_052_101_018,
+            "上级科目已有业务数据，新增下级前需要迁移历史数据");
+    ErrorCode SUBJECT_PARENT_CONFIG_INCOMPATIBLE = new ErrorCode(1_052_101_019,
+            "迁移历史数据时，下级科目的余额方向和核算配置必须与上级科目一致");
+    ErrorCode SUBJECT_AUXILIARY_MIGRATION_INVALID = new ErrorCode(1_052_101_020,
+            "科目已有业务数据，新增辅助核算时必须为每个类别选择有效的迁移项目");
+    ErrorCode SUBJECT_CLOSING_TEMPLATE_IN_USE = new ErrorCode(1_052_101_021,
+            "科目已被 {} 个结账模板使用，不能删除");
+
+    // ========== 辅助核算 1-052-102-000 ==========
+    ErrorCode AUXILIARY_TYPE_NOT_EXISTS = new ErrorCode(1_052_102_000, "辅助核算类别不存在");
+    ErrorCode AUXILIARY_TYPE_NAME_DUPLICATE = new ErrorCode(1_052_102_001, "辅助核算类别名称已存在");
+    ErrorCode AUXILIARY_TYPE_SYSTEM_NOT_EDITABLE = new ErrorCode(1_052_102_002, "系统预置辅助核算类别不能编辑或删除");
+    ErrorCode AUXILIARY_TYPE_HAS_ITEM = new ErrorCode(1_052_102_003,
+            "辅助核算类别下有 {} 个项目，不能删除");
+    ErrorCode AUXILIARY_ITEM_NOT_EXISTS = new ErrorCode(1_052_102_004, "辅助核算项目不存在");
+    ErrorCode AUXILIARY_ITEM_CODE_DUPLICATE = new ErrorCode(1_052_102_005, "辅助核算项目编码已存在");
+    ErrorCode AUXILIARY_TYPE_SUBJECT_IN_USE = new ErrorCode(1_052_102_006,
+            "辅助核算类别已被 {} 个科目使用，不能删除");
+    ErrorCode AUXILIARY_ITEM_VOUCHER_IN_USE = new ErrorCode(1_052_102_007,
+            "辅助核算项目已被 {} 条凭证分录使用，不能删除");
+    ErrorCode AUXILIARY_ITEM_IMPORT_LIST_IS_EMPTY = new ErrorCode(1_052_102_008,
+            "导入辅助核算项目数据不能为空");
+    ErrorCode AUXILIARY_ITEM_VOUCHER_TEMPLATE_IN_USE = new ErrorCode(1_052_102_009,
+            "辅助核算项目已被 {} 个凭证模板使用，不能删除");
+    ErrorCode AUXILIARY_ITEM_INITIAL_BALANCE_IN_USE = new ErrorCode(1_052_102_010,
+            "辅助核算项目已被 {} 条初始余额使用，不能删除");
+    ErrorCode AUXILIARY_TYPE_VOUCHER_IN_USE = new ErrorCode(1_052_102_012,
+            "辅助核算类别已被 {} 条凭证分录使用，不能删除");
+    ErrorCode AUXILIARY_TYPE_VOUCHER_TEMPLATE_IN_USE = new ErrorCode(1_052_102_013,
+            "辅助核算类别已被 {} 个凭证模板使用，不能删除");
+    ErrorCode AUXILIARY_TYPE_INITIAL_BALANCE_IN_USE = new ErrorCode(1_052_102_014,
+            "辅助核算类别已被 {} 条初始余额使用，不能删除");
+
+    // ========== 凭证 1-052-103-000 ==========
+    ErrorCode VOUCHER_NOT_EXISTS = new ErrorCode(1_052_103_000, "凭证不存在");
+    ErrorCode VOUCHER_WORD_NOT_EXISTS = new ErrorCode(1_052_103_001, "凭证字不存在");
+    ErrorCode VOUCHER_NUMBER_DUPLICATE = new ErrorCode(1_052_103_002, "该期间的凭证号已存在");
+    ErrorCode VOUCHER_ENTRY_REQUIRED = new ErrorCode(1_052_103_003, "凭证至少需要两条有效分录");
+    ErrorCode VOUCHER_ENTRY_AMOUNT_INVALID = new ErrorCode(1_052_103_004, "凭证分录只能填写借方或贷方金额");
+    ErrorCode VOUCHER_AMOUNT_UNBALANCED = new ErrorCode(1_052_103_005, "凭证借贷金额不平衡");
+    ErrorCode VOUCHER_APPROVED_NOT_EDITABLE = new ErrorCode(1_052_103_006, "已审核凭证不能编辑或删除");
+    ErrorCode VOUCHER_STATUS_INVALID = new ErrorCode(1_052_103_007, "凭证状态流转不正确");
+    ErrorCode VOUCHER_SUBJECT_DISABLED = new ErrorCode(1_052_103_008, "凭证分录使用了已停用科目");
+    ErrorCode VOUCHER_SUBJECT_HAS_CHILDREN = new ErrorCode(1_052_103_009, "凭证分录不能使用非末级科目");
+    ErrorCode VOUCHER_AUXILIARY_REQUIRED = new ErrorCode(1_052_103_010, "凭证分录的辅助核算项目不完整");
+    ErrorCode VOUCHER_QUANTITY_INVALID = new ErrorCode(1_052_103_011, "凭证分录的数量核算信息不正确");
+    ErrorCode VOUCHER_WORD_NAME_DUPLICATE = new ErrorCode(1_052_103_012, "凭证字已存在");
+    ErrorCode VOUCHER_WORD_DEFAULT_REQUIRED = new ErrorCode(1_052_103_013, "请确保至少有一个默认凭证字");
+    ErrorCode VOUCHER_WORD_DEFAULT_NOT_DELETABLE = new ErrorCode(1_052_103_014, "默认凭证字不允许删除");
+    ErrorCode VOUCHER_WORD_IN_USE_NOT_EDITABLE = new ErrorCode(1_052_103_015, "使用中的凭证字不能编辑");
+    ErrorCode VOUCHER_WORD_IN_USE_NOT_DELETABLE = new ErrorCode(1_052_103_016,
+            "该凭证字已被 {} 张凭证使用，不能删除");
+    ErrorCode VOUCHER_TEMPLATE_CATEGORY_NOT_EXISTS = new ErrorCode(1_052_103_017, "凭证模板分类不存在");
+    ErrorCode VOUCHER_TEMPLATE_CATEGORY_NAME_DUPLICATE = new ErrorCode(1_052_103_018, "凭证模板分类已存在");
+    ErrorCode VOUCHER_TEMPLATE_CATEGORY_IN_USE = new ErrorCode(1_052_103_019, "分类下存在凭证模板，不能删除");
+    ErrorCode VOUCHER_TEMPLATE_NOT_EXISTS = new ErrorCode(1_052_103_020, "凭证模板不存在");
+    ErrorCode DIGEST_NOT_EXISTS = new ErrorCode(1_052_103_021, "常用摘要不存在");
+    ErrorCode VOUCHER_STATISTICS_RANGE_INVALID = new ErrorCode(1_052_103_022, "凭证汇总查询范围不正确");
+    ErrorCode VOUCHER_MOVE_RANGE_INVALID = new ErrorCode(1_052_103_023, "移动到的凭证号必须小于原凭证号");
+    ErrorCode VOUCHER_MOVE_SOURCE_NOT_EXISTS = new ErrorCode(1_052_103_024, "要移动的凭证不存在");
+    ErrorCode VOUCHER_IMPORT_FILE_EMPTY = new ErrorCode(1_052_103_025, "请选择要导入的凭证文件");
+    ErrorCode VOUCHER_IMPORT_FILE_TOO_LARGE = new ErrorCode(1_052_103_026, "导入文件不能超过 2MB");
+    ErrorCode VOUCHER_IMPORT_TEMPLATE_INVALID = new ErrorCode(1_052_103_027, "凭证导入模板格式不正确");
+    ErrorCode VOUCHER_CLOSING_GENERATED_NOT_EDITABLE = new ErrorCode(1_052_103_029, "结账生成凭证不能编辑、审核或删除");
+    ErrorCode VOUCHER_WORD_IN_USE_BY_CLOSING_SCHEME_NOT_DELETABLE = new ErrorCode(1_052_103_030,
+            "该凭证字已被 {} 个结账方案使用，不能删除");
+
+    // ========== 账簿 1-052-104-000 ==========
+    ErrorCode LEDGER_PERIOD_INVALID = new ErrorCode(1_052_104_000, "开始会计期间不能晚于结束会计期间");
+    ErrorCode INITIAL_BALANCE_SUBJECT_NOT_LEAF = new ErrorCode(1_052_104_001, "初始余额只能录入末级科目");
+    ErrorCode INITIAL_BALANCE_AUXILIARY_INVALID = new ErrorCode(1_052_104_002, "辅助核算项目与科目配置不一致");
+    ErrorCode INITIAL_BALANCE_PROFIT_LOSS_YEAR_OPENING_INVALID = new ErrorCode(1_052_104_003,
+            "损益类科目的年初余额必须为 0");
+    ErrorCode INITIAL_BALANCE_IMPORT_TEMPLATE_INVALID = new ErrorCode(1_052_104_006,
+            "初始余额导入模板格式不正确");
+    ErrorCode INITIAL_BALANCE_IMPORT_ROW_INVALID = new ErrorCode(1_052_104_008,
+            "第 {} 行导入失败：{}");
+    ErrorCode INITIAL_BALANCE_PERIOD_CLOSED = new ErrorCode(1_052_104_009,
+            "账套已结账，不能修改初始余额");
+    ErrorCode LEDGER_PERIOD_BEFORE_ACCOUNT_START = new ErrorCode(1_052_104_010,
+            "开始会计期间不能早于账套启用期间");
+
+    // ========== 结账 1-052-105-000 ==========
+    ErrorCode CLOSING_PERIOD_CLOSED = new ErrorCode(1_052_105_000, "该会计期间已结账");
+    ErrorCode CLOSING_PERIOD_NOT_CLOSED = new ErrorCode(1_052_105_001, "该会计期间尚未结账");
+    ErrorCode CLOSING_NOT_LATEST_PERIOD = new ErrorCode(1_052_105_002, "只能反结账最近的已结账期间");
+    ErrorCode CLOSING_VOUCHER_PENDING_REVIEW = new ErrorCode(1_052_105_003, "存在未审核凭证，不能结账");
+    ErrorCode CLOSING_PROFIT_LOSS_NOT_TRANSFERRED = new ErrorCode(1_052_105_004, "损益类科目尚有余额，请先结转损益");
+    ErrorCode CLOSING_BALANCE_SHEET_UNBALANCED = new ErrorCode(1_052_105_005, "资产负债表不平衡，不能结账");
+    ErrorCode CLOSING_PROFIT_SUBJECT_INVALID = new ErrorCode(1_052_105_006, "本年利润科目不正确");
+    ErrorCode CLOSING_NO_PROFIT_LOSS_BALANCE = new ErrorCode(1_052_105_007, "当前期间无需结转损益");
+    ErrorCode CLOSING_SCHEME_NOT_EXISTS = new ErrorCode(1_052_105_008, "结账方案不存在");
+    ErrorCode CLOSING_SCHEME_SUBJECT_INVALID = new ErrorCode(1_052_105_009, "结账方案科目不正确");
+    ErrorCode CLOSING_SCHEME_RATIO_INVALID = new ErrorCode(1_052_105_010, "结账方案借贷金额比例必须分别等于 100%");
+    ErrorCode CLOSING_SCHEME_NO_BALANCE = new ErrorCode(1_052_105_011, "当前期间无需生成该结转凭证");
+    ErrorCode CLOSING_SCHEME_IN_USE = new ErrorCode(1_052_105_012, "结账方案已生成凭证，不能删除");
+    ErrorCode CLOSING_NOT_CURRENT_PERIOD = new ErrorCode(1_052_105_013, "只能操作当前会计期间");
+    ErrorCode CLOSING_PROFIT_LOSS_SETTINGS_INVALID = new ErrorCode(1_052_105_014, "结转损益科目设置不正确");
+    ErrorCode CLOSING_PROFIT_LOSS_SETTINGS_NOT_EXISTS = new ErrorCode(1_052_105_015, "请先完成结转损益参数设置");
+    ErrorCode CLOSING_SPECIAL_SETTINGS_INVALID = new ErrorCode(1_052_105_016, "专用结转设置不正确");
+    ErrorCode CLOSING_SPECIAL_SUBJECT_NOT_EXISTS = new ErrorCode(1_052_105_017, "专用结转所需的预置科目不存在");
+    ErrorCode CLOSING_INITIAL_BALANCE_UNBALANCED = new ErrorCode(1_052_105_018, "初始余额试算不平衡，不能结账");
+    ErrorCode CLOSING_VOUCHER_NUMBER_DISCONTINUOUS = new ErrorCode(1_052_105_019,
+            "当前期间存在断号凭证，请先整理凭证号");
+    ErrorCode CLOSING_PROFIT_LOSS_VOUCHER_MISSING = new ErrorCode(1_052_105_020,
+            "当前期间存在损益发生额，请先生成结转损益凭证");
+    ErrorCode CLOSING_INCOME_STATEMENT_UNBALANCED = new ErrorCode(1_052_105_021,
+            "利润表勾稽不平衡，不能结账");
+    ErrorCode CLOSING_REPORT_SUBJECT_UNMAPPED = new ErrorCode(1_052_105_022,
+            "存在未纳入报表公式的科目，不能结账");
+    ErrorCode CLOSING_TEMPLATE_NOT_EXISTS = new ErrorCode(1_052_105_023, "结账模板不存在");
+    ErrorCode CLOSING_TEMPLATE_PRESET_INVALID = new ErrorCode(1_052_105_024, "结账模板预置数据不正确");
+    ErrorCode CLOSING_TEMPLATE_PRESET_SUBJECT_NOT_EXISTS = new ErrorCode(1_052_105_025,
+            "结账模板【{}】所需科目【{}】不存在");
+    ErrorCode CLOSING_SCHEME_PRESET_SUBJECT_NOT_EXISTS = new ErrorCode(1_052_105_026,
+            "结账方案【{}】所需科目【{}】不存在");
+    ErrorCode CLOSING_SCHEME_NOT_PERIOD_END = new ErrorCode(1_052_105_027,
+            "该结账方案未启用期末结转");
+
+    // ========== 报表 1-052-106-000 ==========
+    ErrorCode REPORT_CONFIG_NOT_EXISTS = new ErrorCode(1_052_106_000, "报表项目不存在");
+    ErrorCode REPORT_CONFIG_NOT_EDITABLE = new ErrorCode(1_052_106_001, "该报表项目不允许编辑公式");
+    ErrorCode REPORT_FORMULA_SUBJECT_DUPLICATE = new ErrorCode(1_052_106_002, "报表公式科目不能重复");
+    ErrorCode REPORT_FORMULA_RULE_INVALID = new ErrorCode(1_052_106_003, "报表公式取数规则不正确");
+    ErrorCode REPORT_FORMULA_OPERATOR_INVALID = new ErrorCode(1_052_106_004, "报表公式运算符不正确");
+    ErrorCode REPORT_ADJUSTMENT_NOT_EXISTS = new ErrorCode(1_052_106_005, "现金流量辅助数据不存在");
+    ErrorCode REPORT_AMOUNT_NOT_ADJUSTABLE = new ErrorCode(1_052_106_006, "该现金流量表项目不允许调整金额");
+
+    // ========== 币种 1-052-107-000 ==========
+    ErrorCode CURRENCY_NOT_EXISTS = new ErrorCode(1_052_107_000, "币别不存在");
+    ErrorCode CURRENCY_CODE_DUPLICATE = new ErrorCode(1_052_107_001, "币别编码已存在");
+    ErrorCode CURRENCY_STANDARD_NOT_DELETABLE = new ErrorCode(1_052_107_002, "本位币不允许删除");
+    ErrorCode CURRENCY_IN_USE = new ErrorCode(1_052_107_003, "币别已被科目使用，不能删除");
+
+    // ========== 首页 1-052-108-000 ==========
+    ErrorCode HOME_METRIC_INVALID = new ErrorCode(1_052_108_001, "首页财务指标不正确");
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/LogRecordConstants.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/LogRecordConstants.java
new file mode 100644
index 0000000..6c67bd0
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/LogRecordConstants.java
@@ -0,0 +1,185 @@
+package cn.iocoder.yudao.module.fms.enums;
+
+/**
+ * FMS 操作日志常量
+ *
+ * @author 芋道源码
+ */
+public interface LogRecordConstants {
+
+    // ======================= FMS_ACCOUNT_SET 账套 =======================
+
+    String FMS_ACCOUNT_SET_TYPE = "FMS 账套";
+    String FMS_ACCOUNT_SET_CREATE_SUB_TYPE = "创建账套";
+    String FMS_ACCOUNT_SET_CREATE_SUCCESS = "创建了账套【{{#createReqVO.companyName}}】";
+    String FMS_ACCOUNT_SET_UPDATE_SUB_TYPE = "更新账套";
+    String FMS_ACCOUNT_SET_UPDATE_SUCCESS =
+            "更新了账套【{{#updateReqVO.companyName}}】: {_DIFF{#updateReqVO}}";
+    String FMS_ACCOUNT_SET_INITIALIZE_SUB_TYPE = "初始化账套";
+    String FMS_ACCOUNT_SET_INITIALIZE_SUCCESS = "初始化了账套【{{#accountSet.companyName}}】";
+    String FMS_ACCOUNT_SET_MEMBER_UPDATE_SUB_TYPE = "更新账套成员";
+    String FMS_ACCOUNT_SET_MEMBER_UPDATE_SUCCESS =
+            "更新了账套【{{#accountSet.companyName}}】的成员授权";
+
+    // ======================= FMS_FINANCE_PARAMETER 财务参数 =======================
+
+    String FMS_FINANCE_PARAMETER_TYPE = "FMS 财务参数";
+    String FMS_FINANCE_PARAMETER_UPDATE_SUB_TYPE = "更新财务参数";
+    String FMS_FINANCE_PARAMETER_UPDATE_SUCCESS =
+            "更新了账套【{{#accountSet.companyName}}】的财务参数: {_DIFF{#updateReqVO}}";
+
+    // ======================= FMS_SUBJECT 科目 =======================
+
+    String FMS_SUBJECT_TYPE = "FMS 科目";
+    String FMS_SUBJECT_CREATE_SUB_TYPE = "创建科目";
+    String FMS_SUBJECT_CREATE_SUCCESS = "创建了科目【{{#createReqVO.code}} {{#createReqVO.name}}】";
+    String FMS_SUBJECT_UPDATE_SUB_TYPE = "更新科目";
+    String FMS_SUBJECT_UPDATE_SUCCESS = "更新了科目【{{#updateReqVO.code}} {{#updateReqVO.name}}】";
+    String FMS_SUBJECT_DELETE_SUB_TYPE = "删除科目";
+    String FMS_SUBJECT_DELETE_SUCCESS = "删除了【{{#subjects.size()}}】个科目";
+    String FMS_SUBJECT_STATUS_SUB_TYPE = "更新科目状态";
+    String FMS_SUBJECT_STATUS_SUCCESS = "更新了科目状态";
+
+    // ======================= FMS_AUXILIARY 辅助核算 =======================
+
+    String FMS_AUXILIARY_TYPE = "FMS 辅助核算";
+    String FMS_AUXILIARY_TYPE_CREATE_SUB_TYPE = "创建辅助核算分类";
+    String FMS_AUXILIARY_TYPE_CREATE_SUCCESS = "创建了辅助核算分类【{{#createReqVO.name}}】";
+    String FMS_AUXILIARY_TYPE_UPDATE_SUB_TYPE = "更新辅助核算分类";
+    String FMS_AUXILIARY_TYPE_UPDATE_SUCCESS = "更新了辅助核算分类【{{#updateReqVO.name}}】";
+    String FMS_AUXILIARY_TYPE_DELETE_SUB_TYPE = "删除辅助核算分类";
+    String FMS_AUXILIARY_TYPE_DELETE_SUCCESS = "删除了辅助核算分类【{{#auxiliaryType.name}}】";
+
+    String FMS_AUXILIARY_ITEM_TYPE = "FMS 辅助核算项目";
+    String FMS_AUXILIARY_ITEM_CREATE_SUB_TYPE = "创建辅助核算项目";
+    String FMS_AUXILIARY_ITEM_CREATE_SUCCESS = "创建了辅助核算项目【{{#createReqVO.code}} {{#createReqVO.name}}】";
+    String FMS_AUXILIARY_ITEM_UPDATE_SUB_TYPE = "更新辅助核算项目";
+    String FMS_AUXILIARY_ITEM_UPDATE_SUCCESS = "更新了辅助核算项目【{{#updateReqVO.code}} {{#updateReqVO.name}}】";
+    String FMS_AUXILIARY_ITEM_DELETE_SUB_TYPE = "删除辅助核算项目";
+    String FMS_AUXILIARY_ITEM_DELETE_SUCCESS = "删除了辅助核算项目【{{#auxiliaryItem.code}} {{#auxiliaryItem.name}}】";
+    String FMS_AUXILIARY_ITEM_STATUS_SUB_TYPE = "更新辅助核算项目状态";
+    String FMS_AUXILIARY_ITEM_STATUS_SUCCESS = "更新了辅助核算项目状态";
+
+    // ======================= FMS_VOUCHER 凭证 =======================
+
+    String FMS_VOUCHER_TYPE = "FMS 凭证";
+    String FMS_VOUCHER_CREATE_SUB_TYPE = "创建凭证";
+    String FMS_VOUCHER_CREATE_SUCCESS = "创建了凭证【{{#voucherId}}】";
+    String FMS_VOUCHER_UPDATE_SUB_TYPE = "更新凭证";
+    String FMS_VOUCHER_UPDATE_SUCCESS = "更新了凭证【{{#updateReqVO.id}}】";
+    String FMS_VOUCHER_ATTACHMENT_UPDATE_SUB_TYPE = "更新凭证附件";
+    String FMS_VOUCHER_ATTACHMENT_UPDATE_SUCCESS = "更新了凭证【{{#updateReqVO.id}}】的附件";
+    String FMS_VOUCHER_DELETE_SUB_TYPE = "删除凭证";
+    String FMS_VOUCHER_DELETE_SUCCESS = "删除了凭证【{{#voucher.id}}】";
+    String FMS_VOUCHER_REVIEW_SUB_TYPE = "审核凭证";
+    String FMS_VOUCHER_REVIEW_SUCCESS = "更新了凭证审核状态";
+    String FMS_VOUCHER_TIDY_SUB_TYPE = "整理凭证";
+    String FMS_VOUCHER_TIDY_SUCCESS = "整理了【{{#tidyReqVO.month}}】期间的凭证";
+    String FMS_VOUCHER_MOVE_SUB_TYPE = "移动凭证";
+    String FMS_VOUCHER_MOVE_SUCCESS = "将【{{#moveReqVO.month}}】期间的【{{#moveReqVO.sourceNumber}}】号凭证移动到【{{#moveReqVO.targetNumber}}】号之前";
+
+    // ======================= FMS_VOUCHER_WORD 凭证字 =======================
+
+    String FMS_VOUCHER_WORD_TYPE = "FMS 凭证字";
+    String FMS_VOUCHER_WORD_CREATE_SUB_TYPE = "创建凭证字";
+    String FMS_VOUCHER_WORD_CREATE_SUCCESS = "创建了凭证字【{{#createReqVO.name}}】";
+    String FMS_VOUCHER_WORD_UPDATE_SUB_TYPE = "更新凭证字";
+    String FMS_VOUCHER_WORD_UPDATE_SUCCESS = "更新了凭证字【{{#updateReqVO.name}}】";
+    String FMS_VOUCHER_WORD_DELETE_SUB_TYPE = "删除凭证字";
+    String FMS_VOUCHER_WORD_DELETE_SUCCESS = "删除了凭证字【{{#voucherWord.name}}】";
+
+    // ======================= FMS_VOUCHER_TEMPLATE 凭证模板 =======================
+
+    String FMS_VOUCHER_TEMPLATE_CATEGORY_TYPE = "FMS 凭证模板分类";
+    String FMS_VOUCHER_TEMPLATE_CATEGORY_CREATE_SUB_TYPE = "创建凭证模板分类";
+    String FMS_VOUCHER_TEMPLATE_CATEGORY_CREATE_SUCCESS = "创建了凭证模板分类【{{#createReqVO.name}}】";
+    String FMS_VOUCHER_TEMPLATE_CATEGORY_UPDATE_SUB_TYPE = "更新凭证模板分类";
+    String FMS_VOUCHER_TEMPLATE_CATEGORY_UPDATE_SUCCESS = "更新了凭证模板分类【{{#updateReqVO.name}}】";
+    String FMS_VOUCHER_TEMPLATE_CATEGORY_DELETE_SUB_TYPE = "删除凭证模板分类";
+    String FMS_VOUCHER_TEMPLATE_CATEGORY_DELETE_SUCCESS = "删除了凭证模板分类【{{#category.name}}】";
+
+    String FMS_VOUCHER_TEMPLATE_TYPE = "FMS 凭证模板";
+    String FMS_VOUCHER_TEMPLATE_CREATE_SUB_TYPE = "创建凭证模板";
+    String FMS_VOUCHER_TEMPLATE_CREATE_SUCCESS = "创建了凭证模板【{{#createReqVO.name}}】";
+    String FMS_VOUCHER_TEMPLATE_UPDATE_SUB_TYPE = "更新凭证模板";
+    String FMS_VOUCHER_TEMPLATE_UPDATE_SUCCESS = "更新了凭证模板【{{#updateReqVO.name}}】";
+    String FMS_VOUCHER_TEMPLATE_DELETE_SUB_TYPE = "删除凭证模板";
+    String FMS_VOUCHER_TEMPLATE_DELETE_SUCCESS = "删除了凭证模板【{{#template.name}}】";
+
+    // ======================= FMS_DIGEST 常用摘要 =======================
+
+    String FMS_DIGEST_TYPE = "FMS 常用摘要";
+    String FMS_DIGEST_CREATE_SUB_TYPE = "创建常用摘要";
+    String FMS_DIGEST_CREATE_SUCCESS = "创建了常用摘要【{{#createReqVO.content}}】";
+    String FMS_DIGEST_UPDATE_SUB_TYPE = "更新常用摘要";
+    String FMS_DIGEST_UPDATE_SUCCESS = "更新了常用摘要【{{#updateReqVO.content}}】";
+    String FMS_DIGEST_DELETE_SUB_TYPE = "删除常用摘要";
+    String FMS_DIGEST_DELETE_SUCCESS = "删除了常用摘要【{{#digest.content}}】";
+
+    // ======================= FMS_CURRENCY 币别 =======================
+
+    String FMS_CURRENCY_TYPE = "FMS 币别";
+    String FMS_CURRENCY_CREATE_SUB_TYPE = "创建币别";
+    String FMS_CURRENCY_CREATE_SUCCESS = "创建了币别【{{#createReqVO.name}}】";
+    String FMS_CURRENCY_UPDATE_SUB_TYPE = "更新币别";
+    String FMS_CURRENCY_UPDATE_SUCCESS = "更新了币别【{{#updateReqVO.name}}】";
+    String FMS_CURRENCY_DELETE_SUB_TYPE = "删除币别";
+    String FMS_CURRENCY_DELETE_SUCCESS = "删除了币别【{{#currency.name}}】";
+
+    // ======================= FMS_INITIAL_BALANCE 财务初始余额 =======================
+
+    String FMS_INITIAL_BALANCE_TYPE = "FMS 财务初始余额";
+    String FMS_INITIAL_BALANCE_SAVE_SUB_TYPE = "保存财务初始余额";
+    String FMS_INITIAL_BALANCE_SAVE_SUCCESS =
+            "保存了账套【{{#saveReqVO.accountSetId}}】的【{{#saveReqVO.balances.size()}}】项财务初始余额";
+    String FMS_INITIAL_BALANCE_IMPORT_SUB_TYPE = "导入财务初始余额";
+    String FMS_INITIAL_BALANCE_IMPORT_SUCCESS =
+            "向账套【{{#accountSetId}}】导入了【{{#_ret}}】项财务初始余额";
+
+    // ======================= FMS_CLOSING 结账 =======================
+
+    String FMS_CLOSING_TYPE = "FMS 结账";
+    String FMS_CLOSING_SCHEME_CREATE_SUB_TYPE = "创建结账方案";
+    String FMS_CLOSING_SCHEME_CREATE_SUCCESS = "创建了结账方案【{{#createReqVO.name}}】";
+    String FMS_CLOSING_SCHEME_UPDATE_SUB_TYPE = "更新结账方案";
+    String FMS_CLOSING_SCHEME_UPDATE_SUCCESS = "更新了结账方案【{{#updateReqVO.name}}】";
+    String FMS_CLOSING_SCHEME_DELETE_SUB_TYPE = "删除结账方案";
+    String FMS_CLOSING_SCHEME_DELETE_SUCCESS = "删除了结账方案【{{#id}}】";
+    String FMS_CLOSING_TEMPLATE_CREATE_SUB_TYPE = "创建结账模板";
+    String FMS_CLOSING_TEMPLATE_CREATE_SUCCESS = "创建了结账模板【{{#createReqVO.name}}】";
+    String FMS_CLOSING_TEMPLATE_UPDATE_SUB_TYPE = "更新结账模板";
+    String FMS_CLOSING_TEMPLATE_UPDATE_SUCCESS = "更新了结账模板【{{#updateReqVO.name}}】";
+    String FMS_CLOSING_TEMPLATE_DELETE_SUB_TYPE = "删除结账模板";
+    String FMS_CLOSING_TEMPLATE_DELETE_SUCCESS = "删除了结账模板【{{#id}}】";
+    String FMS_CLOSING_SETTINGS_UPDATE_SUB_TYPE = "更新结账设置";
+    String FMS_CLOSING_SETTINGS_UPDATE_SUCCESS = "更新了账套【{{#saveReqVO.accountSetId}}】的结账设置";
+    String FMS_CLOSING_SPECIAL_SETTINGS_UPDATE_SUCCESS =
+            "更新了账套【{{#updateReqVO.accountSetId}}】的结账方案【{{#updateReqVO.id}}】设置";
+    String FMS_CLOSING_VOUCHER_GENERATE_SUB_TYPE = "生成结转凭证";
+    String FMS_CLOSING_PROFIT_LOSS_VOUCHER_GENERATE_SUCCESS =
+            "生成了账套【{{#generateReqVO.accountSetId}}】{{#generateReqVO.month}}期间的结转损益凭证【{{#_ret}}】";
+    String FMS_CLOSING_SCHEME_VOUCHER_GENERATE_SUCCESS =
+            "生成了账套【{{#generateReqVO.accountSetId}}】{{#generateReqVO.month}}期间方案【{{#generateReqVO.id}}】的结转凭证【{{#_ret}}】";
+    String FMS_CLOSING_VOUCHER_BATCH_GENERATE_SUCCESS =
+            "为账套【{{#generateReqVO.accountSetId}}】{{#generateReqVO.month}}期间批量生成了【{{#_ret.size()}}】张结转凭证";
+    String FMS_CLOSING_PERIOD_CLOSE_SUB_TYPE = "结账";
+    String FMS_CLOSING_PERIOD_CLOSE_SUCCESS =
+            "完成了账套【{{#queryReqVO.accountSetId}}】{{#queryReqVO.month}}期间结账";
+    String FMS_CLOSING_PERIOD_CANCEL_SUB_TYPE = "反结账";
+    String FMS_CLOSING_PERIOD_CANCEL_SUCCESS =
+            "完成了账套【{{#queryReqVO.accountSetId}}】{{#queryReqVO.month}}期间反结账";
+
+    // ======================= FMS_CASH_FLOW_STATEMENT 现金流量表 =======================
+
+    String FMS_CASH_FLOW_STATEMENT_TYPE = "FMS 现金流量表";
+    String FMS_CASH_FLOW_STATEMENT_UPDATE_SUB_TYPE = "调整现金流量表";
+    String FMS_CASH_FLOW_STATEMENT_UPDATE_SUCCESS =
+            "调整了账套【{{#updateReqVO.accountSetId}}】{{#updateReqVO.startMonth}} 至 {{#updateReqVO.endMonth}}的现金流量表";
+    String FMS_CASH_FLOW_ADJUSTMENT_UPDATE_SUB_TYPE = "调整现金流量辅助数据";
+    String FMS_CASH_FLOW_ADJUSTMENT_UPDATE_SUCCESS =
+            "调整了账套【{{#updateReqVO.accountSetId}}】的【{{#updateReqVO.items.size()}}】项现金流量辅助数据";
+    String FMS_CASH_FLOW_ADJUSTMENT_FORMULA_UPDATE_SUB_TYPE = "更新现金流量辅助公式";
+    String FMS_CASH_FLOW_ADJUSTMENT_FORMULA_UPDATE_SUCCESS =
+            "更新了账套【{{#updateReqVO.accountSetId}}】的现金流量辅助公式【{{#updateReqVO.id}}】";
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingPresetSubjectEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingPresetSubjectEnum.java
new file mode 100644
index 0000000..bb3a28e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingPresetSubjectEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.fms.enums.closing;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * FMS 预置结转科目编码枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsClosingPresetSubjectEnum {
+
+    PRIOR_YEAR_ADJUSTMENT("6000", "以前年度损益调整"),
+    PRIOR_YEAR_ADJUSTMENT_CLOSING("310415", "未分配利润"),
+    CURRENT_YEAR_PROFIT("3103", "本年利润"),
+
+    UNPAID_VAT("22210104", "转出未交增值税"),
+    OUTPUT_VAT("222102", "销项税额"),
+    VAT_PAYABLE("222101", "应交增值税"),
+    CONSUMPTION_TAX("222121", "应交消费税"),
+
+    EDUCATION_SURCHARGE("540310", "教育费附加"),
+    EDUCATION_SURCHARGE_PAYABLE("222113", "应交教育费附加"),
+    CITY_MAINTENANCE_TAX("540303", "城市维护建设税"),
+    CITY_MAINTENANCE_TAX_PAYABLE("222117", "应交城市维护建设税"),
+    LOCAL_EDUCATION_SURCHARGE("540313", "地方教育费附加"),
+    LOCAL_EDUCATION_SURCHARGE_PAYABLE("222114", "应交地方教育费附加"),
+
+    INCOME_TAX_EXPENSE("5801", "所得税费用"),
+    INCOME_TAX_PAYABLE("222111", "应交所得税");
+
+    /**
+     * 科目编码
+     */
+    private final String code;
+    /**
+     * 科目名称
+     */
+    private final String name;
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTemplateCategoryEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTemplateCategoryEnum.java
new file mode 100644
index 0000000..a55afd7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTemplateCategoryEnum.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.fms.enums.closing;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 结账模板分类枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsClosingTemplateCategoryEnum implements ArrayValuable<Integer> {
+
+    DAILY_EXPENSE(1, "日常开支"),
+    PURCHASE_SALE(2, "采购销售"),
+    CURRENT_ACCOUNT(3, "往来款"),
+    TRANSFER_BUSINESS(4, "转账业务");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsClosingTemplateCategoryEnum::getCategory).toArray(Integer[]::new);
+
+    /**
+     * 分类
+     */
+    private final Integer category;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTimeTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTimeTypeEnum.java
new file mode 100644
index 0000000..c87a73e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTimeTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.fms.enums.closing;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 结转取数时间枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsClosingTimeTypeEnum implements ArrayValuable<Integer> {
+
+    PERIOD_END(1, "期末"),
+    PERIOD_BEGIN(2, "期初"),
+    YEAR_BEGIN(3, "年初");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsClosingTimeTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsClosingTimeTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTypeEnum.java
new file mode 100644
index 0000000..66cb9c3
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingTypeEnum.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.fms.enums.closing;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 结账业务类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsClosingTypeEnum implements ArrayValuable<Integer> {
+
+    REGULAR(1, "常规结账", null),
+    PROFIT_LOSS(2, "结转损益", "结转本期损益"),
+    UNPAID_VAT(3, "转出未交增值税", "转出未交增值税"),
+    LOCAL_TAX(4, "计提地税", "计提地税"),
+    INCOME_TAX(5, "计提所得税", "计提所得税");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsClosingTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+    /**
+     * 默认凭证摘要
+     */
+    private final String digest;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsClosingTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingVoucherTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingVoucherTypeEnum.java
new file mode 100644
index 0000000..aefddd5
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/closing/FmsClosingVoucherTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.enums.closing;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 结转凭证类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsClosingVoucherTypeEnum implements ArrayValuable<Integer> {
+
+    SEPARATE_GAIN_AND_LOSS(1, "收益和损失分开结转"),
+    COMBINED_GAIN_AND_LOSS(2, "收益和损失同时结转");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsClosingVoucherTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsClosingVoucherTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/common/FmsBalanceDirectionEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/common/FmsBalanceDirectionEnum.java
new file mode 100644
index 0000000..5ed9662
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/common/FmsBalanceDirectionEnum.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.fms.enums.common;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.math.BigDecimal;
+
+/**
+ * FMS 余额方向枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsBalanceDirectionEnum {
+
+    DEBIT("借"),
+    CREDIT("贷"),
+    FLAT("平");
+
+    /**
+     * 名字
+     */
+    private final String name;
+
+    public static FmsBalanceDirectionEnum valueOf(BigDecimal balance) {
+        return balance.signum() > 0 ? DEBIT : balance.signum() < 0 ? CREDIT : FLAT;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/common/FmsDebitCreditDirectionEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/common/FmsDebitCreditDirectionEnum.java
new file mode 100644
index 0000000..66cb764
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/common/FmsDebitCreditDirectionEnum.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.fms.enums.common;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 方向枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsDebitCreditDirectionEnum implements ArrayValuable<Integer> {
+
+    DEBIT(1, "借"),
+    CREDIT(2, "贷");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsDebitCreditDirectionEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsDebitCreditDirectionEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+    public static FmsDebitCreditDirectionEnum valueOfName(String name) {
+        return ArrayUtil.firstMatch(item -> item.getName().equals(name), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAccountUserLevelEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAccountUserLevelEnum.java
new file mode 100644
index 0000000..ff93ac4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAccountUserLevelEnum.java
@@ -0,0 +1,85 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 账套用户权限级别枚举
+ *
+ * OWNER > WRITE > READ
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsAccountUserLevelEnum implements ArrayValuable<Integer> {
+
+    OWNER(1, "主管"),
+    READ(2, "查看者"),
+    WRITE(3, "会计");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsAccountUserLevelEnum::getLevel).toArray(Integer[]::new);
+
+    /**
+     * 级别
+     */
+    private final Integer level;
+    /**
+     * 级别名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static boolean isOwner(Integer level) {
+        return ObjUtil.equal(OWNER.level, level);
+    }
+
+    public static boolean isRead(Integer level) {
+        return ObjUtil.equal(READ.level, level);
+    }
+
+    public static boolean isWrite(Integer level) {
+        return ObjUtil.equal(WRITE.level, level);
+    }
+
+    /**
+     * 判断是否可读
+     *
+     * @param level 权限级别
+     * @return 是否可读
+     */
+    public static boolean isReadable(Integer level) {
+        return valueOf(level) != null;
+    }
+
+    /**
+     * 判断是否可写
+     *
+     * @param level 权限级别
+     * @return 是否可写
+     */
+    public static boolean isWritable(Integer level) {
+        return isOwner(level) || isWrite(level);
+    }
+
+    public static FmsAccountUserLevelEnum valueOf(Integer level) {
+        return CollUtil.findOne(CollUtil.newArrayList(values()),
+                item -> ObjUtil.equal(item.level, level));
+    }
+
+    public static String getNameByLevel(Integer level) {
+        FmsAccountUserLevelEnum levelEnum = valueOf(level);
+        return levelEnum == null ? null : levelEnum.getName();
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAccountingStandardEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAccountingStandardEnum.java
new file mode 100644
index 0000000..d80fbeb
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAccountingStandardEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 会计制度枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsAccountingStandardEnum implements ArrayValuable<Integer> {
+
+    SMALL_BUSINESS_2013(1, "小企业会计准则（2013 年颁）");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsAccountingStandardEnum::getStandard).toArray(Integer[]::new);
+
+    /**
+     * 会计制度
+     */
+    private final Integer standard;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsAccountingStandardEnum valueOf(Integer standard) {
+        return ArrayUtil.firstMatch(item -> item.getStandard().equals(standard), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAuxiliaryTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAuxiliaryTypeEnum.java
new file mode 100644
index 0000000..8e6032f
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsAuxiliaryTypeEnum.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 辅助核算类别枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsAuxiliaryTypeEnum implements ArrayValuable<Integer> {
+
+    CUSTOMER(1, "客户"),
+    SUPPLIER(2, "供应商"),
+    EMPLOYEE(3, "职员"),
+    PROJECT(4, "项目"),
+    DEPARTMENT(5, "部门"),
+    INVENTORY(6, "存货"),
+    CUSTOM(7, "自定义");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsAuxiliaryTypeEnum::getType).toArray(Integer[]::new);
+
+    public static final FmsAuxiliaryTypeEnum[] SYSTEM_PRESET_TYPES = Arrays.stream(values())
+            .filter(type -> type != CUSTOM).toArray(FmsAuxiliaryTypeEnum[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsAuxiliaryTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsCurrencyPresetEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsCurrencyPresetEnum.java
new file mode 100644
index 0000000..e3c56f2
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsCurrencyPresetEnum.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+
+/**
+ * FMS 预置币别枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsCurrencyPresetEnum implements ArrayValuable<String> {
+
+    RMB("RMB", "人民币", BigDecimal.ONE);
+
+    public static final String[] ARRAYS = Arrays.stream(values())
+            .map(FmsCurrencyPresetEnum::getCode).toArray(String[]::new);
+
+    /**
+     * 币别编码
+     */
+    private final String code;
+    /**
+     * 币别名称
+     */
+    private final String name;
+    /**
+     * 汇率
+     */
+    private final BigDecimal exchangeRate;
+
+    @Override
+    public String[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsCurrencyPresetEnum valueOfCode(String code) {
+        return ArrayUtil.firstMatch(currency -> currency.getCode().equals(code), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsFinanceIndicatorTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsFinanceIndicatorTypeEnum.java
new file mode 100644
index 0000000..4b99eac
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsFinanceIndicatorTypeEnum.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+// TODO DONE @AI：JSON 预置文件已格式化，枚举已归入 config 包。
+/**
+ * FMS 首页财务指标取数报表类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsFinanceIndicatorTypeEnum implements ArrayValuable<Integer> {
+
+    BALANCE_SHEET(1, "资产负债表"),
+    INCOME_STATEMENT(2, "利润表");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsFinanceIndicatorTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsFinanceIndicatorTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.type.equals(type), values());
+    }
+
+    public static boolean isBalanceSheet(Integer type) {
+        return BALANCE_SHEET.getType().equals(type);
+    }
+
+    public static boolean isIncomeStatement(Integer type) {
+        return INCOME_STATEMENT.getType().equals(type);
+    }
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsSubjectCategoryEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsSubjectCategoryEnum.java
new file mode 100644
index 0000000..81ce7e7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsSubjectCategoryEnum.java
@@ -0,0 +1,57 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 科目类别枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsSubjectCategoryEnum {
+
+    CURRENT_ASSET(1, 1, "流动资产"),
+    NON_CURRENT_ASSET(1, 2, "非流动资产"),
+    CURRENT_LIABILITY(2, 1, "流动负债"),
+    NON_CURRENT_LIABILITY(2, 2, "非流动负债"),
+    EQUITY(3, 1, "所有者权益"),
+    COST(4, 1, "成本"),
+    OPERATING_INCOME(5, 1, "营业收入"),
+    OTHER_INCOME(5, 2, "其他收益"),
+    PERIOD_EXPENSE(5, 3, "期间费用"),
+    OTHER_LOSS(5, 4, "其他损失"),
+    OPERATING_COST_AND_TAX(5, 5, "营业成本及税金"),
+    PRIOR_YEAR_ADJUSTMENT(5, 6, "以前年度损益调整"),
+    INCOME_TAX(5, 7, "所得税"),
+    COMMON(6, 1, "共同");
+
+    /**
+     * 科目类型
+     */
+    private final Integer type;
+    /**
+     * 类别
+     */
+    private final Integer category;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    public static FmsSubjectCategoryEnum valueOf(Integer type, Integer category) {
+        return Arrays.stream(values())
+                .filter(item -> item.getType().equals(type) && item.getCategory().equals(category))
+                .findFirst().orElse(null);
+    }
+
+    public static FmsSubjectCategoryEnum valueOfName(String name) {
+        return Arrays.stream(values())
+                .filter(item -> item.getName().equals(name))
+                .findFirst().orElse(null);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsSubjectTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsSubjectTypeEnum.java
new file mode 100644
index 0000000..e7996f7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsSubjectTypeEnum.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 科目类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsSubjectTypeEnum implements ArrayValuable<Integer> {
+
+    ASSET(1, "资产"),
+    LIABILITY(2, "负债"),
+    EQUITY(3, "所有者权益"),
+    COST(4, "成本"),
+    PROFIT_LOSS(5, "损益"),
+    COMMON(6, "共同");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsSubjectTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsSubjectTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsVoucherWordPresetEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsVoucherWordPresetEnum.java
new file mode 100644
index 0000000..102257b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/config/FmsVoucherWordPresetEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.fms.enums.config;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * FMS 预置凭证字枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsVoucherWordPresetEnum {
+
+    RECORD("记", "记账凭证", true, 1),
+    RECEIPT("收", "收款凭证", false, 2),
+    TRANSFER("转", "转账凭证", false, 3),
+    PAYMENT("付", "付款凭证", false, 4);
+
+    /**
+     * 凭证字
+     */
+    private final String name;
+    /**
+     * 打印标题
+     */
+    private final String printTitle;
+    /**
+     * 是否默认凭证字
+     */
+    private final Boolean defaultStatus;
+    /**
+     * 显示顺序
+     */
+    private final Integer sort;
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/home/FmsHomeMetricEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/home/FmsHomeMetricEnum.java
new file mode 100644
index 0000000..3ea004a
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/home/FmsHomeMetricEnum.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.fms.enums.home;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 首页财务指标枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsHomeMetricEnum {
+
+    INCOME("income", "收入", new Integer[]{1}, "L1"),
+    OPERATING_COST("operatingCost", "成本", new Integer[]{2, 3}, "L2+L3"),
+    PROFIT("profit", "利润", new Integer[]{30}, "L30"),
+    EXPENSE("expense", "费用", new Integer[]{11, 14, 18}, "L11+L14+L18"),
+    OTHER("other", "其他", new Integer[]{}, "L30+L11+L14+L18+L2+L3-L1");
+
+    /**
+     * 指标标识
+     */
+    private final String key;
+    /**
+     * 指标名称
+     */
+    private final String name;
+    /**
+     * 利润表行次数组
+     */
+    private final Integer[] rowNumbers;
+    /**
+     * 科目构成行次公式
+     */
+    private final String structureFormula;
+
+    public static FmsHomeMetricEnum valueOfKey(String key) {
+        return Arrays.stream(values()).filter(item -> item.getKey().equals(key))
+                .findFirst().orElse(null);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/ledger/FmsLedgerBalanceModeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/ledger/FmsLedgerBalanceModeEnum.java
new file mode 100644
index 0000000..4ea0e8b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/ledger/FmsLedgerBalanceModeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.enums.ledger;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 账簿余额方向模式枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsLedgerBalanceModeEnum implements ArrayValuable<Integer> {
+
+    SAME_AS_SUBJECT(1, "与科目方向相同"),
+    OPPOSITE_TO_SUBJECT(2, "与科目方向相反");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsLedgerBalanceModeEnum::getMode).toArray(Integer[]::new);
+
+    /**
+     * 模式
+     */
+    private final Integer mode;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsLedgerBalanceModeEnum valueOf(Integer mode) {
+        return ArrayUtil.firstMatch(item -> item.getMode().equals(mode), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsCashFlowExtendTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsCashFlowExtendTypeEnum.java
new file mode 100644
index 0000000..8aac640
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsCashFlowExtendTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.enums.report;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 现金流量扩展公式类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsCashFlowExtendTypeEnum implements ArrayValuable<Integer> {
+
+    CUSTOM(0, "用户配置"),
+    FIXED(1, "固定公式");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsCashFlowExtendTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsCashFlowExtendTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsCashFlowParamTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsCashFlowParamTypeEnum.java
new file mode 100644
index 0000000..1ac3a5a
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsCashFlowParamTypeEnum.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.fms.enums.report;
+
+import cn.hutool.core.util.StrUtil;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * FMS 现金流量表跨报表取数参数类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsCashFlowParamTypeEnum {
+
+    BALANCE("BA", "资产负债取数"),
+    INCOME("IN", "利润表取数"),
+    EXTEND("EX", "辅助数据取数"),
+    LINE("L", "行次取数");
+
+    /**
+     * 参数前缀
+     */
+    private final String prefix;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    /**
+     * 解析参数前缀对应的取数类型
+     *
+     * @param param 参数，例如 BA[1,2]、IN32、EX4、L7
+     * @return 取数类型，无法识别时返回 null
+     */
+    public static FmsCashFlowParamTypeEnum of(String param) {
+        for (FmsCashFlowParamTypeEnum type : values()) {
+            if (StrUtil.startWith(param, type.getPrefix())) {
+                return type;
+            }
+        }
+        return null;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsFormulaRuleEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsFormulaRuleEnum.java
new file mode 100644
index 0000000..e142ff0
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsFormulaRuleEnum.java
@@ -0,0 +1,49 @@
+package cn.iocoder.yudao.module.fms.enums.report;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 报表取数规则枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsFormulaRuleEnum implements ArrayValuable<Integer> {
+
+    BALANCE(0, "余额"),
+    DEBIT_BALANCE(1, "借方余额"),
+    CREDIT_BALANCE(2, "贷方余额"),
+    SUBJECT_DEBIT_BALANCE(3, "科目借方余额"),
+    SUBJECT_CREDIT_BALANCE(4, "科目贷方余额"),
+    DEBIT_AMOUNT(5, "借方发生额"),
+    CREDIT_AMOUNT(6, "贷方发生额"),
+    PROFIT_LOSS_AMOUNT(7, "损益发生额");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsFormulaRuleEnum::getRule).toArray(Integer[]::new);
+
+    /**
+     * 规则
+     */
+    private final Integer rule;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsFormulaRuleEnum valueOf(Integer rule) {
+        return ArrayUtil.firstMatch(item -> item.getRule().equals(rule), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsReportPeriodTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsReportPeriodTypeEnum.java
new file mode 100644
index 0000000..e4ed247
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsReportPeriodTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.enums.report;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 报表期间类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsReportPeriodTypeEnum implements ArrayValuable<Integer> {
+
+    MONTH(1, "月度"),
+    QUARTER(2, "季度");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsReportPeriodTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsReportPeriodTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsReportTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsReportTypeEnum.java
new file mode 100644
index 0000000..4cdd419
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/report/FmsReportTypeEnum.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.fms.enums.report;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 财务报表类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsReportTypeEnum implements ArrayValuable<Integer> {
+
+    BALANCE_SHEET(1, "资产负债表"),
+    INCOME_STATEMENT(2, "利润表"),
+    CASH_FLOW_STATEMENT(3, "现金流量表"),
+    CASH_FLOW_ADJUSTMENT(4, "现金流量辅助数据");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsReportTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsReportTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/voucher/FmsVoucherStatusEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/voucher/FmsVoucherStatusEnum.java
new file mode 100644
index 0000000..d1353f1
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/voucher/FmsVoucherStatusEnum.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.fms.enums.voucher;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 凭证状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsVoucherStatusEnum implements ArrayValuable<Integer> {
+
+    PENDING_REVIEW(0, "待审核"),
+    APPROVED(1, "已审核"),
+    REJECTED(2, "已驳回"),
+    REVIEWING(3, "审核中"),
+    WITHDRAWN(4, "已撤回"),
+    UNSUBMITTED(5, "未提交"),
+    CREATED(6, "已创建"),
+    DELETED(7, "已删除"),
+    VOIDED(8, "已作废");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsVoucherStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsVoucherStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/voucher/FmsVoucherTidyTypeEnum.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/voucher/FmsVoucherTidyTypeEnum.java
new file mode 100644
index 0000000..9afa176
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/enums/voucher/FmsVoucherTidyTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.enums.voucher;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * FMS 凭证整理方式枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum FmsVoucherTidyTypeEnum implements ArrayValuable<Integer> {
+
+    FILL_GAPS(1, "按凭证号顺次前移补齐断号"),
+    REORDER_BY_TIME(2, "按凭证日期重新顺次编号");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(FmsVoucherTidyTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static FmsVoucherTidyTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/package-info.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/package-info.java
new file mode 100644
index 0000000..f534bcb
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/package-info.java
@@ -0,0 +1,6 @@
+/**
+ * 属于 fms 模块的 framework 封装
+ *
+ * @author 芋道源码
+ */
+package cn.iocoder.yudao.module.fms.framework;
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/web/config/FmsWebConfiguration.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/web/config/FmsWebConfiguration.java
new file mode 100644
index 0000000..130fe47
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/web/config/FmsWebConfiguration.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.fms.framework.web.config;
+
+import cn.iocoder.yudao.framework.swagger.config.YudaoSwaggerAutoConfiguration;
+import org.springdoc.core.models.GroupedOpenApi;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * fms 模块的 web 组件的 Configuration
+ *
+ * @author 芋道源码
+ */
+@Configuration(proxyBeanMethods = false)
+public class FmsWebConfiguration {
+
+    /**
+     * fms 模块的 API 分组
+     *
+     * @return fms 模块的 OpenAPI 分组
+     */
+    @Bean
+    public GroupedOpenApi fmsGroupedOpenApi() {
+        return YudaoSwaggerAutoConfiguration.buildGroupedOpenApi("fms");
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/web/package-info.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/web/package-info.java
new file mode 100644
index 0000000..b2eab0b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/framework/web/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * fms 模块的 web 拓展封装
+ */
+package cn.iocoder.yudao.module.fms.framework.web;
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/package-info.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/package-info.java
new file mode 100644
index 0000000..52a71fc
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * FMS 财务管理模块，包含凭证、账簿、报表和结账等业务能力
+ */
+package cn.iocoder.yudao.module.fms;
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodService.java
new file mode 100644
index 0000000..b6bb20d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodService.java
@@ -0,0 +1,85 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingOverviewRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+
+/**
+ * FMS 结账期间 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsClosingPeriodService {
+
+    /**
+     * 校验业务时间所属期间未结账
+     *
+     * @param accountSetId 账套编号
+     * @param businessTime 业务时间
+     */
+    void validatePeriodOpen(Long accountSetId, LocalDateTime businessTime);
+
+    /**
+     * 判断业务时间所属期间是否已结账
+     *
+     * @param accountSetId 账套编号
+     * @param businessTime 业务时间
+     * @return 是否已结账
+     */
+    boolean isPeriodClosed(Long accountSetId, LocalDateTime businessTime);
+
+    /**
+     * 获得当前会计期间
+     *
+     * @param accountSetId 账套编号
+     * @param startTime 账套启用时间
+     * @return 当前会计期间
+     */
+    YearMonth getCurrentMonth(Long accountSetId, LocalDateTime startTime);
+
+    /**
+     * 获得当前会计期间
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 当前会计期间
+     */
+    String getCurrentMonth(Long accountSetId, Long userId);
+
+    /**
+     * 获得结账概况
+     *
+     * @param queryReqVO 查询参数
+     * @param userId 用户编号
+     * @return 结账概况
+     */
+    FmsClosingOverviewRespVO getClosingOverview(FmsClosingQueryReqVO queryReqVO, Long userId);
+
+    /**
+     * 结账
+     *
+     * @param queryReqVO 结账期间
+     * @param userId 用户编号
+     */
+    void closePeriod(FmsClosingQueryReqVO queryReqVO, Long userId);
+
+    /**
+     * 反结账
+     *
+     * @param queryReqVO 结账期间
+     * @param userId 用户编号
+     */
+    void cancelClosePeriod(FmsClosingQueryReqVO queryReqVO, Long userId);
+
+    /**
+     * 判断指定会计期间是否已结账
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @return 是否已结账
+     */
+    boolean isPeriodClosed(Long accountSetId, String month);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodServiceImpl.java
new file mode 100644
index 0000000..207c930
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodServiceImpl.java
@@ -0,0 +1,510 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingOverviewRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsTrialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetRowRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.income.FmsIncomeStatementCheckRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingPeriodDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingPeriodMapper;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherStatusEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.report.FmsBalanceSheetService;
+import cn.iocoder.yudao.module.fms.service.report.FmsBalanceSheetServiceImpl;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.stream.Collectors;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.count;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+
+/**
+ * FMS 结账期间 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsClosingPeriodServiceImpl implements FmsClosingPeriodService {
+
+    @Resource
+    private FmsClosingPeriodMapper closingPeriodMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsClosingSchemeService closingSchemeService;
+    @Resource
+    private FmsClosingVoucherService closingVoucherService;
+    @Resource
+    private FmsFinanceParameterService financeParameterService;
+    @Resource
+    private FmsInitialBalanceService initialBalanceService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsLedgerService ledgerService;
+    @Resource
+    private FmsVoucherService voucherService;
+    @Resource
+    private FmsBalanceSheetService balanceSheetService;
+    @Resource
+    private FmsIncomeStatementService incomeStatementService;
+
+    @Override
+    public void validatePeriodOpen(Long accountSetId, LocalDateTime businessTime) {
+        if (isPeriodClosed(accountSetId, businessTime)) {
+            throw exception(CLOSING_PERIOD_CLOSED);
+        }
+    }
+
+    @Override
+    public boolean isPeriodClosed(Long accountSetId, LocalDateTime businessTime) {
+        YearMonth month = YearMonth.from(businessTime);
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        return closingPeriodMapper.selectByPeriod(accountSetId, monthBeginTime,
+                LocalDateTimeUtils.endOfMonth(monthBeginTime)) != null;
+    }
+
+    @Override
+    public YearMonth getCurrentMonth(Long accountSetId, LocalDateTime startTime) {
+        FmsClosingPeriodDO latestPeriod = closingPeriodMapper.selectLatestByAccountSetId(accountSetId);
+        return latestPeriod != null ? YearMonth.from(latestPeriod.getClosingTime()).plusMonths(1)
+                : YearMonth.from(startTime);
+    }
+
+    @Override
+    public String getCurrentMonth(Long accountSetId, Long userId) {
+        // 1.1 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 校验账套初始化状态
+        if (ObjUtil.notEqual(accountSet.getInitialized(), true) || accountSet.getStartTime() == null) {
+            throw exception(ACCOUNT_SET_NOT_INITIALIZED);
+        }
+
+        // 2. 获得当前会计期间
+        return getCurrentMonth(accountSetId, accountSet.getStartTime()).toString();
+    }
+
+    @Override
+    public FmsClosingOverviewRespVO getClosingOverview(
+            FmsClosingQueryReqVO queryReqVO, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(queryReqVO.getAccountSetId(), userId);
+        // 1.2 解析会计期间
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(queryReqVO.getMonth());
+        LocalDateTime beginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        LocalDateTime endTime = LocalDateTimeUtils.endOfMonth(beginTime);
+
+        // 2. 查询结账前检查项
+        List<FmsVoucherDO> vouchers = voucherService.getVoucherListByPeriod(
+                queryReqVO.getAccountSetId(), beginTime, endTime);
+        List<FmsClosingVoucherDO> closingVouchers = closingVoucherService.getClosingVoucherListByPeriod(
+                queryReqVO.getAccountSetId(), beginTime, endTime);
+        long pendingVoucherCount = getPendingVoucherCount(vouchers, closingVouchers);
+        long voucherCount = vouchers.size();
+        BigDecimal profitLossBalance = calculateProfitLossBalance(queryReqVO.getAccountSetId(), month, userId);
+        BigDecimal balanceSheetDifference = calculateBalanceSheetDifference(
+                queryReqVO.getAccountSetId(), month, userId);
+        FmsClosingSchemeDO profitLossClosing = closingSchemeService.getClosingSchemeByAccountSetIdAndType(
+                queryReqVO.getAccountSetId(), FmsClosingTypeEnum.PROFIT_LOSS.getType());
+        FmsClosingVoucherDO profitLossVoucher = profitLossClosing == null ? null
+                : CollUtil.findOne(closingVouchers, item ->
+                        ObjUtil.equal(item.getClosingId(), profitLossClosing.getId()));
+
+        // 3. 查询其余结账前检查项
+        FmsTrialBalanceRespVO trialBalance = initialBalanceService.getTrialBalance(
+                queryReqVO.getAccountSetId(), userId);
+        boolean voucherNumberContinuous = isVoucherNumberContinuous(vouchers);
+        boolean profitLossVoucherGenerated = !hasProfitLossActivity(
+                queryReqVO.getAccountSetId(), month, userId) || profitLossVoucher != null;
+        FmsReportListReqVO reportReqVO = new FmsReportListReqVO().setAccountSetId(queryReqVO.getAccountSetId())
+                .setStartMonth(queryReqVO.getMonth()).setEndMonth(queryReqVO.getMonth());
+        FmsIncomeStatementCheckRespVO incomeCheck = incomeStatementService.checkIncomeStatement(reportReqVO, userId);
+        FmsBalanceSheetCheckRespVO balanceCheck = balanceSheetService.checkBalanceSheet(reportReqVO, userId);
+
+        // 4. 组装结账概况
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(
+                queryReqVO.getAccountSetId(), userId);
+        boolean voucherReviewRequired = Boolean.TRUE.equals(financeParameter.getVoucherReviewRequired());
+        boolean initialBalanceBalanced = trialBalance != null && Boolean.TRUE.equals(trialBalance.getBalanced());
+        boolean incomeStatementBalanced = incomeCheck != null && Boolean.TRUE.equals(incomeCheck.getBalanced());
+        int incomeUnmappedCount = incomeCheck == null || incomeCheck.getUnmappedSubjects() == null
+                ? 0 : incomeCheck.getUnmappedSubjects().size();
+        boolean balanceSheetProfitLossTransferred = balanceCheck != null
+                && Boolean.TRUE.equals(balanceCheck.getProfitLossTransferred());
+        boolean balanceSheetBalanced = balanceCheck != null && Boolean.TRUE.equals(balanceCheck.getBalanced());
+        int balanceUnmappedCount = balanceCheck == null || balanceCheck.getUnmappedSubjects() == null
+                ? 0 : balanceCheck.getUnmappedSubjects().size();
+        boolean closed = closingPeriodMapper.selectByPeriod(
+                queryReqVO.getAccountSetId(), beginTime, endTime) != null;
+        boolean canClose = !closed
+                && (!voucherReviewRequired || pendingVoucherCount == 0)
+                && initialBalanceBalanced && voucherNumberContinuous && profitLossVoucherGenerated
+                && profitLossBalance.compareTo(BigDecimal.ZERO) == 0
+                && incomeStatementBalanced && incomeUnmappedCount == 0
+                && balanceSheetProfitLossTransferred && balanceSheetBalanced && balanceUnmappedCount == 0;
+        return new FmsClosingOverviewRespVO().setMonth(queryReqVO.getMonth())
+                .setClosed(closed)
+                .setVoucherReviewRequired(voucherReviewRequired)
+                .setPendingVoucherCount(pendingVoucherCount)
+                .setVoucherCount(voucherCount)
+                .setProfitLossBalance(profitLossBalance)
+                .setBalanceSheetDifference(balanceSheetDifference)
+                .setProfitLossVoucherId(profitLossVoucher == null ? null : profitLossVoucher.getVoucherId())
+                .setInitialBalanceBalanced(initialBalanceBalanced)
+                .setVoucherNumberContinuous(voucherNumberContinuous)
+                .setProfitLossVoucherGenerated(profitLossVoucherGenerated)
+                .setIncomeStatementBalanced(incomeStatementBalanced)
+                .setIncomeStatementUnmappedSubjectCount(incomeUnmappedCount)
+                .setBalanceSheetProfitLossTransferred(balanceSheetProfitLossTransferred)
+                .setBalanceSheetBalanced(balanceSheetBalanced)
+                .setBalanceSheetUnmappedSubjectCount(balanceUnmappedCount)
+                .setCanClose(canClose);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_PERIOD_CLOSE_SUB_TYPE,
+            bizNo = "{{#queryReqVO.accountSetId}}", success = FMS_CLOSING_PERIOD_CLOSE_SUCCESS)
+    public void closePeriod(FmsClosingQueryReqVO queryReqVO, Long userId) {
+        // 1. 校验账套权限、初始化状态和结账目标期间
+        YearMonth currentMonth = validateCloseTargetPeriod(queryReqVO.getAccountSetId(), queryReqVO.getMonth(), userId);
+        YearMonth targetMonth = LocalDateTimeUtils.parseYearMonth(queryReqVO.getMonth());
+
+        // 2. 逐月执行结账，保证目标期间之前的每个期间都已完成完整检查
+        for (YearMonth month = currentMonth; !month.isAfter(targetMonth); month = month.plusMonths(1)) {
+            closeSinglePeriod(queryReqVO.getAccountSetId(), month, userId);
+        }
+    }
+
+    /**
+     * 执行单个会计期间的结账检查和状态登记
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     */
+    private void closeSinglePeriod(Long accountSetId, YearMonth month, Long userId) {
+        // 1. 查询结账前概况
+        FmsClosingQueryReqVO queryReqVO = new FmsClosingQueryReqVO()
+                .setAccountSetId(accountSetId).setMonth(month.toString());
+        // 1.2 校验结账概况
+        FmsClosingOverviewRespVO overview = getClosingOverview(queryReqVO, userId);
+        if (overview.getClosed()) {
+            throw exception(CLOSING_PERIOD_CLOSED);
+        }
+        if (overview.getVoucherReviewRequired() && overview.getPendingVoucherCount() > 0) {
+            throw exception(CLOSING_VOUCHER_PENDING_REVIEW);
+        }
+
+        // 2.1 校验初始余额试算平衡
+        if (!Boolean.TRUE.equals(overview.getInitialBalanceBalanced())) {
+            throw exception(CLOSING_INITIAL_BALANCE_UNBALANCED);
+        }
+        // 2.2 校验凭证号连续
+        if (!Boolean.TRUE.equals(overview.getVoucherNumberContinuous())) {
+            throw exception(CLOSING_VOUCHER_NUMBER_DISCONTINUOUS);
+        }
+
+        // 3.1 校验损益结转凭证
+        if (!Boolean.TRUE.equals(overview.getProfitLossVoucherGenerated())) {
+            throw exception(CLOSING_PROFIT_LOSS_VOUCHER_MISSING);
+        }
+        if (overview.getProfitLossBalance().compareTo(BigDecimal.ZERO) != 0) {
+            throw exception(CLOSING_PROFIT_LOSS_NOT_TRANSFERRED);
+        }
+        // 3.2 校验利润表勾稽和公式覆盖
+        if (!Boolean.TRUE.equals(overview.getIncomeStatementBalanced())) {
+            throw exception(CLOSING_INCOME_STATEMENT_UNBALANCED);
+        }
+        if (overview.getIncomeStatementUnmappedSubjectCount() > 0) {
+            throw exception(CLOSING_REPORT_SUBJECT_UNMAPPED);
+        }
+        // 3.3 校验资产负债表平衡和公式覆盖
+        if (!Boolean.TRUE.equals(overview.getBalanceSheetProfitLossTransferred())) {
+            throw exception(CLOSING_PROFIT_LOSS_NOT_TRANSFERRED);
+        }
+        if (!Boolean.TRUE.equals(overview.getBalanceSheetBalanced())) {
+            throw exception(CLOSING_BALANCE_SHEET_UNBALANCED);
+        }
+        if (overview.getBalanceSheetUnmappedSubjectCount() > 0) {
+            throw exception(CLOSING_REPORT_SUBJECT_UNMAPPED);
+        }
+
+        // 4. 登记结账期间
+        LocalDateTime beginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        LocalDateTime endTime = LocalDateTimeUtils.endOfMonth(beginTime);
+        closingPeriodMapper.insert(new FmsClosingPeriodDO().setClosingTime(month.atEndOfMonth().atStartOfDay())
+                .setAccountSetId(accountSetId));
+
+        // 5. 更新当期结转凭证为已结账
+        closingVoucherService.updateClosingVoucherClosedByPeriod(
+                accountSetId, beginTime, endTime, true);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_PERIOD_CANCEL_SUB_TYPE,
+            bizNo = "{{#queryReqVO.accountSetId}}", success = FMS_CLOSING_PERIOD_CANCEL_SUCCESS)
+    public void cancelClosePeriod(FmsClosingQueryReqVO queryReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetWritePermission(
+                queryReqVO.getAccountSetId(), userId);
+        // 1.2 串行化同一账套的结账状态变更
+        accountSetService.lockAccountSet(queryReqVO.getAccountSetId());
+
+        // 2. 从最近期间逐月反结账到目标期间
+        FmsClosingPeriodDO latest = closingPeriodMapper.selectLatestByAccountSetId(queryReqVO.getAccountSetId());
+        YearMonth targetMonth = LocalDateTimeUtils.parseYearMonth(queryReqVO.getMonth());
+        YearMonth startMonth = accountSet.getStartTime() == null ? null : YearMonth.from(accountSet.getStartTime());
+        if (latest == null || targetMonth.isAfter(YearMonth.from(latest.getClosingTime()))
+                || (startMonth != null && targetMonth.isBefore(startMonth))) {
+            throw exception(CLOSING_PERIOD_NOT_CLOSED);
+        }
+        for (YearMonth month = YearMonth.from(latest.getClosingTime()); !month.isBefore(targetMonth);
+             month = month.minusMonths(1)) {
+            cancelSinglePeriod(queryReqVO.getAccountSetId(), month);
+        }
+    }
+
+    /**
+     * 撤销单个会计期间的结账状态
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     */
+    private void cancelSinglePeriod(Long accountSetId, YearMonth month) {
+        LocalDateTime beginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        LocalDateTime endTime = LocalDateTimeUtils.endOfMonth(beginTime);
+        FmsClosingPeriodDO period = closingPeriodMapper.selectByPeriod(accountSetId, beginTime, endTime);
+        if (period == null) {
+            throw exception(CLOSING_PERIOD_NOT_CLOSED);
+        }
+        closingPeriodMapper.deleteById(period.getId());
+        closingVoucherService.updateClosingVoucherClosedByPeriod(accountSetId, beginTime, endTime, false);
+    }
+
+    @Override
+    public boolean isPeriodClosed(Long accountSetId, String monthValue) {
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(monthValue);
+        LocalDateTime beginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        FmsClosingPeriodDO period = closingPeriodMapper.selectByPeriod(accountSetId, beginTime, LocalDateTimeUtils.endOfMonth(beginTime));
+        return period != null;
+    }
+
+    /**
+     * 获得待审核凭证数量
+     *
+     * 结转凭证由结账流程生成且不提供人工审核入口，不计入结账前的待审核凭证数量
+     *
+     * @param vouchers 会计期间凭证列表
+     * @param closingVouchers 会计期间结转凭证列表
+     * @return 待审核凭证数量
+     */
+    private long getPendingVoucherCount(List<FmsVoucherDO> vouchers,
+            List<FmsClosingVoucherDO> closingVouchers) {
+        Set<Long> closingVoucherIds = convertSet(closingVouchers, FmsClosingVoucherDO::getVoucherId);
+        return count(vouchers, voucher ->
+                ObjUtil.equal(voucher.getStatus(), FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                        && !closingVoucherIds.contains(voucher.getId()));
+    }
+
+    /**
+     * 计算末级损益科目的本期借贷差额绝对值合计
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     * @return 损益余额
+     */
+    private BigDecimal calculateProfitLossBalance(Long accountSetId, YearMonth month, Long userId) {
+        // 1. 查询科目和当期科目余额
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId, Objects::nonNull);
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = getSubjectBalanceMap(accountSetId, month, userId);
+
+        // 2. 汇总末级损益科目的本期借贷差额
+        BigDecimal result = BigDecimal.ZERO;
+        for (FmsSubjectDO subject : subjects) {
+            if (ObjUtil.notEqual(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                    || parentIds.contains(subject.getId())) {
+                continue;
+            }
+            FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(subject.getId());
+            if (balance != null) {
+                result = result.add(NumberUtils.zeroIfNull(balance.getPeriodDebitAmount())
+                        .subtract(NumberUtils.zeroIfNull(balance.getPeriodCreditAmount())).abs());
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 判断当期损益类末级科目是否存在发生额
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     * @return 是否存在发生额
+     */
+    private boolean hasProfitLossActivity(Long accountSetId, YearMonth month, Long userId) {
+        // 1. 查询末级损益科目和当期余额
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId, Objects::nonNull);
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = getSubjectBalanceMap(accountSetId, month, userId);
+
+        // 2. 任一末级损益科目存在借方或贷方发生额即视为当期有损益业务
+        for (FmsSubjectDO subject : subjects) {
+            if (ObjUtil.notEqual(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                    || parentIds.contains(subject.getId())) {
+                continue;
+            }
+            FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(subject.getId());
+            if (balance != null && (NumberUtils.zeroIfNull(balance.getPeriodDebitAmount()).signum() != 0
+                    || NumberUtils.zeroIfNull(balance.getPeriodCreditAmount()).signum() != 0)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * 校验每个凭证字的当期凭证号从 1 开始连续编号
+     *
+     * @param vouchers 当期凭证列表
+     * @return 是否连续编号
+     */
+    private boolean isVoucherNumberContinuous(List<FmsVoucherDO> vouchers) {
+        // 1. 按凭证字分组
+        Map<Long, List<FmsVoucherDO>> voucherMap = vouchers.stream()
+                .collect(Collectors.groupingBy(FmsVoucherDO::getVoucherWordId, LinkedHashMap::new,
+                        Collectors.toList()));
+
+        // 2. 校验各凭证字的号码从 1 开始连续递增
+        for (List<FmsVoucherDO> wordVouchers : voucherMap.values()) {
+            for (int index = 0; index < wordVouchers.size(); index++) {
+                if (ObjUtil.notEqual(wordVouchers.get(index).getVoucherNumber(), index + 1)) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+
+    private BigDecimal calculateBalanceSheetDifference(Long accountSetId, YearMonth month, Long userId) {
+        FmsReportListReqVO listReqVO = new FmsReportListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(month.toString()).setEndMonth(month.toString());
+        BigDecimal assetAmount = BigDecimal.ZERO;
+        BigDecimal liabilityAmount = BigDecimal.ZERO;
+        for (FmsBalanceSheetRowRespVO row : balanceSheetService.getBalanceSheet(listReqVO, userId)) {
+            if (ObjUtil.equal(row.getAssetRowNo(), FmsBalanceSheetServiceImpl.ASSET_TOTAL_ROW_NO)) {
+                assetAmount = NumberUtils.zeroIfNull(row.getAssetClosingAmount());
+            }
+            if (ObjUtil.equal(row.getLiabilityRowNo(), FmsBalanceSheetServiceImpl.LIABILITY_TOTAL_ROW_NO)) {
+                liabilityAmount = NumberUtils.zeroIfNull(row.getLiabilityClosingAmount());
+            }
+        }
+        return assetAmount.subtract(liabilityAmount).abs();
+    }
+
+    /**
+     * 获得单个会计期间的科目余额 Map
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     * @return 科目编号到余额的 Map
+     */
+    private Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(Long accountSetId, YearMonth month, Long userId) {
+        return getSubjectBalanceMap(accountSetId, month, month, userId);
+    }
+
+    /**
+     * 获得月份区间的科目余额 Map，树形余额扁平化后按科目编号存放
+     *
+     * @param accountSetId 账套编号
+     * @param startMonth 开始月份
+     * @param endMonth 结束月份
+     * @param userId 用户编号
+     * @return 科目编号到余额的 Map
+     */
+    private Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(Long accountSetId, YearMonth startMonth, YearMonth endMonth, Long userId) {
+        FmsLedgerListReqVO listReqVO = new FmsLedgerListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(startMonth.toString()).setEndMonth(endMonth.toString());
+        Map<Long, FmsLedgerSubjectBalanceRespVO> result = new LinkedHashMap<>();
+        flattenBalances(ledgerService.getSubjectBalanceList(listReqVO, userId), result);
+        return result;
+    }
+
+    /**
+     * 递归扁平化树形科目余额到 Map
+     *
+     * @param balances 树形科目余额
+     * @param result 科目编号到余额的 Map
+     */
+    private void flattenBalances(List<FmsLedgerSubjectBalanceRespVO> balances,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> result) {
+        for (FmsLedgerSubjectBalanceRespVO balance : balances) {
+            result.put(balance.getSubjectId(), balance);
+            flattenBalances(balance.getChildren(), result);
+        }
+    }
+
+    /**
+     * 校验账套写权限、初始化状态和结账目标期间
+     *
+     * @param accountSetId 账套编号
+     * @param month 结账目标期间
+     * @param userId 用户编号
+     * @return 当前会计期间
+     */
+    private YearMonth validateCloseTargetPeriod(Long accountSetId, String month, Long userId) {
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        accountSetService.lockAccountSet(accountSetId);
+        if (ObjUtil.notEqual(accountSet.getInitialized(), true) || accountSet.getStartTime() == null) {
+            throw exception(ACCOUNT_SET_NOT_INITIALIZED);
+        }
+        YearMonth currentMonth = getCurrentMonth(accountSetId, accountSet.getStartTime());
+        if (LocalDateTimeUtils.parseYearMonth(month).isBefore(currentMonth)) {
+            throw exception(CLOSING_NOT_CURRENT_PERIOD);
+        }
+        return currentMonth;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeService.java
new file mode 100644
index 0000000..ed66e0c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeService.java
@@ -0,0 +1,116 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossSettingsSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsSpecialClosingSettingsSaveReqVO;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 结账方案 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsClosingSchemeService {
+
+    /**
+     * 初始化账套默认结账方案
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     */
+    void initializeDefaultClosingSchemes(Long accountSetId, Long userId);
+
+    /**
+     * 获得账套下指定类型的结账方案
+     *
+     * @param accountSetId 账套编号
+     * @param type 结账业务类型
+     * @return 结账方案
+     */
+    FmsClosingSchemeDO getClosingSchemeByAccountSetIdAndType(Long accountSetId, Integer type);
+
+    /**
+     * 校验账套下的结账方案存在
+     *
+     * @param accountSetId 账套编号
+     * @param id 方案编号
+     * @return 结账方案
+     */
+    FmsClosingSchemeDO validateClosingSchemeExists(Long accountSetId, Long id);
+
+    /**
+     * 获得引用指定科目的结账方案数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号数组
+     * @return 结账方案数量
+     */
+    Long getClosingSchemeCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 获得引用指定凭证字的结账方案数量
+     *
+     * @param accountSetId 账套编号
+     * @param voucherWordId 凭证字编号
+     * @return 结账方案数量
+     */
+    Long getClosingSchemeCountByVoucherWordId(Long accountSetId, Long voucherWordId);
+
+    /**
+     * 保存结转损益设置
+     *
+     * @param saveReqVO 保存参数
+     * @param userId 用户编号
+     * @return 方案编号
+     */
+    Long saveProfitLossSettings(FmsProfitLossSettingsSaveReqVO saveReqVO, Long userId);
+
+    /**
+     * 获得结账方案列表
+     *
+     * @param queryReqVO 查询参数
+     * @param userId 用户编号
+     * @return 结账方案列表
+     */
+    List<FmsClosingSchemeRespVO> getClosingSchemeList(FmsClosingQueryReqVO queryReqVO, Long userId);
+
+    /**
+     * 创建结账方案
+     *
+     * @param createReqVO 创建参数
+     * @param userId 用户编号
+     * @return 方案编号
+     */
+    Long createClosingScheme(FmsClosingSchemeSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新结账方案
+     *
+     * @param updateReqVO 更新参数
+     * @param userId 用户编号
+     */
+    void updateClosingScheme(FmsClosingSchemeSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 更新专用结转设置
+     *
+     * @param updateReqVO 更新参数
+     * @param userId 用户编号
+     */
+    void updateSpecialClosingSettings(FmsSpecialClosingSettingsSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除结账方案
+     *
+     * @param accountSetId 账套编号
+     * @param id 方案编号
+     * @param userId 用户编号
+     */
+    void deleteClosingScheme(Long accountSetId, Long id, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeServiceImpl.java
new file mode 100644
index 0000000..96bc110
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeServiceImpl.java
@@ -0,0 +1,934 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.io.IoUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossSettingsSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsSpecialClosingSettingsSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingSchemeMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingVoucherMapper;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingPresetSubjectEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingVoucherTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import cn.iocoder.yudao.module.fms.util.FmsPeriodUtils;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import lombok.Data;
+import org.springframework.core.io.ClassPathResource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+import java.io.InputStream;
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sumBigDecimal;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+
+/**
+ * FMS 结账方案 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsClosingSchemeServiceImpl implements FmsClosingSchemeService {
+
+    private static final String PRESET_RESOURCE = "fms/closing/closing-scheme-presets.json";
+
+    @Resource
+    private FmsClosingSchemeMapper closingSchemeMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsClosingVoucherService closingVoucherService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsFinanceParameterService financeParameterService;
+    @Resource
+    private FmsLedgerService ledgerService;
+    @Resource
+    private FmsVoucherWordService voucherWordService;
+    @Resource
+    private FmsIncomeStatementService incomeStatementService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void initializeDefaultClosingSchemes(Long accountSetId, Long userId) {
+        // 1.1 加载并校验预置方案
+        List<SchemePreset> presets = loadSchemePresets();
+        validateSchemePresets(presets);
+        // 1.2 查询尚未初始化的预置结账类型
+        Set<Integer> existingTypes = convertSet(
+                closingSchemeMapper.selectListByAccountSetId(accountSetId), FmsClosingSchemeDO::getType);
+        List<SchemePreset> pendingPresets = filterList(presets, preset -> !existingTypes.contains(
+                FmsClosingTypeEnum.valueOf(preset.getClosingType()).getType()));
+        if (CollUtil.isEmpty(pendingPresets)) {
+            return;
+        }
+
+        // 2. 查询默认凭证字和预置科目
+        List<FmsVoucherWordDO> voucherWords = voucherWordService.getVoucherWordList(accountSetId);
+        FmsVoucherWordDO voucherWord = CollUtil.findOne(voucherWords,
+                item -> Boolean.TRUE.equals(item.getDefaultStatus()));
+        if (voucherWord == null) {
+            voucherWord = CollUtil.getFirst(voucherWords);
+        }
+        if (voucherWord == null) {
+            throw exception(CLOSING_SPECIAL_SETTINGS_INVALID);
+        }
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Map<String, FmsSubjectDO> subjectMap = buildPresetSubjectMap(accountSetId, subjects);
+
+        // 3. 创建预置结账方案
+        Long voucherWordId = voucherWord.getId();
+        closingSchemeMapper.insertBatch(convertList(pendingPresets,
+                preset -> buildPresetClosingScheme(accountSetId, voucherWordId, preset, subjectMap)));
+    }
+
+    @Override
+    public FmsClosingSchemeDO getClosingSchemeByAccountSetIdAndType(Long accountSetId, Integer type) {
+        return closingSchemeMapper.selectByAccountSetIdAndType(accountSetId, type);
+    }
+
+    @Override
+    public FmsClosingSchemeDO validateClosingSchemeExists(Long accountSetId, Long id) {
+        FmsClosingSchemeDO closing = closingSchemeMapper.selectByIdAndAccountSetId(id, accountSetId);
+        if (closing == null) {
+            throw exception(CLOSING_SCHEME_NOT_EXISTS);
+        }
+        return closing;
+    }
+
+    @Override
+    public Long getClosingSchemeCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        Set<Long> subjectIdSet = new HashSet<>(subjectIds);
+        List<FmsClosingSchemeDO> closings = closingSchemeMapper.selectListByAccountSetId(accountSetId);
+        // 来源科目、结转科目或科目规则中任一引用命中即计入
+        return (long) CollUtil.count(closings, closing -> subjectIdSet.contains(closing.getSubjectId())
+                || subjectIdSet.contains(closing.getPriorYearAdjustmentSubjectId())
+                || subjectIdSet.contains(closing.getAdjustmentClosingSubjectId())
+                || subjectIdSet.contains(closing.getOtherClosingSubjectId())
+                || CollUtil.isNotEmpty(closing.getSubjectRules()) && closing.getSubjectRules().stream()
+                        .map(FmsClosingSchemeDO.SubjectRule::getSubjectId)
+                        .anyMatch(subjectIdSet::contains));
+    }
+
+    @Override
+    public Long getClosingSchemeCountByVoucherWordId(Long accountSetId, Long voucherWordId) {
+        return closingSchemeMapper.selectCountByAccountSetIdAndVoucherWordId(accountSetId, voucherWordId);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_SETTINGS_UPDATE_SUB_TYPE,
+            bizNo = "{{#saveReqVO.accountSetId}}", success = FMS_CLOSING_SETTINGS_UPDATE_SUCCESS)
+    public Long saveProfitLossSettings(FmsProfitLossSettingsSaveReqVO saveReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(saveReqVO.getAccountSetId(), userId);
+        // 1.2 校验凭证字和科目
+        voucherWordService.validateVoucherWordExists(saveReqVO.getAccountSetId(), saveReqVO.getVoucherWordId());
+        validateProfitLossSettings(saveReqVO, userId);
+
+        // 2. 创建或更新结转损益设置
+        FmsClosingSchemeDO closing = closingSchemeMapper.selectByAccountSetIdAndType(
+                saveReqVO.getAccountSetId(), FmsClosingTypeEnum.PROFIT_LOSS.getType());
+        FmsClosingSchemeDO updateObj = BeanUtils.toBean(saveReqVO, FmsClosingSchemeDO.class)
+                .setName(FmsClosingTypeEnum.PROFIT_LOSS.getName()).setPeriodEnd(true)
+                .setType(FmsClosingTypeEnum.PROFIT_LOSS.getType());
+        if (closing == null) {
+            closingSchemeMapper.insert(updateObj);
+            return updateObj.getId();
+        }
+        closingSchemeMapper.updateById(updateObj.setId(closing.getId()));
+        return closing.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<FmsClosingSchemeRespVO> getClosingSchemeList(
+            FmsClosingQueryReqVO queryReqVO, Long userId) {
+        // 1. 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(
+                queryReqVO.getAccountSetId(), userId);
+
+        // 2. 查询方案、余额和已生成凭证
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(queryReqVO.getMonth());
+        List<FmsClosingSchemeDO> closings = closingSchemeMapper.selectPeriodEndListByAccountSetId(
+                queryReqVO.getAccountSetId());
+        if (CollUtil.isEmpty(closings)) {
+            return Collections.emptyList();
+        }
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = getSubjectBalanceMap(
+                queryReqVO.getAccountSetId(), month, userId);
+        Map<Long, FmsLedgerSubjectBalanceRespVO> yearBalanceMap = closings.stream()
+                .anyMatch(item -> ObjUtil.equal(item.getTimeType(),
+                        FmsClosingTimeTypeEnum.YEAR_BEGIN.getType()))
+                ? getSubjectBalanceMap(queryReqVO.getAccountSetId(),
+                        FmsPeriodUtils.getYearStartMonth(accountSet, month), month, userId) : balanceMap;
+        Map<Long, List<FmsClosingVoucherDO>> closingVoucherMap = new HashMap<>();
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        closingVoucherService.getClosingVoucherListByPeriod(queryReqVO.getAccountSetId(),
+                        monthBeginTime, LocalDateTimeUtils.endOfMonth(monthBeginTime))
+                .forEach(item -> closingVoucherMap.computeIfAbsent(
+                        item.getClosingId(), key -> new ArrayList<>()).add(item));
+
+        // 查询账套科目，供专用结转方案按预置科目编码取数
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(
+                queryReqVO.getAccountSetId(), null, userId);
+
+        // 3. 组装方案结转金额和凭证编号
+        List<FmsClosingSchemeRespVO> results = new ArrayList<>();
+        for (FmsClosingSchemeDO closing : closings) {
+            BigDecimal balance;
+            if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.PROFIT_LOSS.getType())) {
+                balance = calculateProfitLossBalance(queryReqVO.getAccountSetId(), month, userId);
+            } else if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.REGULAR.getType())) {
+                balance = calculateClosingSchemeBalance(closing,
+                        ObjUtil.equal(closing.getTimeType(), FmsClosingTimeTypeEnum.YEAR_BEGIN.getType())
+                                ? yearBalanceMap : balanceMap);
+            } else {
+                balance = calculateSpecialClosingBalance(closing, queryReqVO.getAccountSetId(),
+                        month, subjects, balanceMap, userId);
+            }
+            List<FmsClosingVoucherDO> closingVouchers = closingVoucherMap.getOrDefault(
+                    closing.getId(), Collections.emptyList());
+            BigDecimal displayBalance = CollUtil.isNotEmpty(closingVouchers)
+                    ? sumBigDecimal(closingVouchers,
+                            item -> NumberUtils.zeroIfNull(item.getAmount())) : balance;
+            List<FmsClosingSchemeRespVO.SubjectRule> subjectRules = CollUtil.isEmpty(closing.getSubjectRules())
+                    ? Collections.emptyList() : BeanUtils.toBean(
+                            closing.getSubjectRules(), FmsClosingSchemeRespVO.SubjectRule.class);
+            FmsClosingSchemeRespVO respVO = BeanUtils.toBean(closing, FmsClosingSchemeRespVO.class)
+                    .setSubjects(subjectRules)
+                    .setBalance(displayBalance)
+                    .setVoucherIds(closingVouchers.stream().map(FmsClosingVoucherDO::getVoucherId)
+                            .collect(Collectors.toList()));
+            results.add(respVO);
+        }
+        return results;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_SCHEME_CREATE_SUB_TYPE,
+            bizNo = "{{#createReqVO.accountSetId}}", success = FMS_CLOSING_SCHEME_CREATE_SUCCESS)
+    public Long createClosingScheme(FmsClosingSchemeSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验凭证字和科目规则
+        voucherWordService.validateVoucherWordExists(createReqVO.getAccountSetId(), createReqVO.getVoucherWordId());
+        List<FmsSubjectDO> subjects = validateClosingScheme(createReqVO, userId);
+
+        // 2. 创建结账方案
+        FmsClosingSchemeDO closing = BeanUtils.toBean(createReqVO, FmsClosingSchemeDO.class)
+                .setId(null).setType(FmsClosingTypeEnum.REGULAR.getType())
+                .setDigest(createReqVO.getName())
+                .setSubjectRules(buildSubjectRules(createReqVO.getSubjects(), subjects));
+        closingSchemeMapper.insert(closing);
+        return closing.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_SCHEME_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.accountSetId}}", success = FMS_CLOSING_SCHEME_UPDATE_SUCCESS)
+    public void updateClosingScheme(FmsClosingSchemeSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验结账方案
+        FmsClosingSchemeDO closing = validateClosingSchemeExists(
+                updateReqVO.getAccountSetId(), updateReqVO.getId());
+        if (!ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.REGULAR.getType())) {
+            throw exception(CLOSING_SCHEME_NOT_EXISTS);
+        }
+        // 1.3 校验凭证字和科目规则
+        voucherWordService.validateVoucherWordExists(updateReqVO.getAccountSetId(), updateReqVO.getVoucherWordId());
+        List<FmsSubjectDO> subjects = validateClosingScheme(updateReqVO, userId);
+
+        // 2. 更新结账方案
+        closingSchemeMapper.updateById(BeanUtils.toBean(updateReqVO, FmsClosingSchemeDO.class)
+                .setType(FmsClosingTypeEnum.REGULAR.getType()).setDigest(updateReqVO.getName())
+                .setSubjectRules(buildSubjectRules(updateReqVO.getSubjects(), subjects)));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_SETTINGS_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.accountSetId}}", success = FMS_CLOSING_SPECIAL_SETTINGS_UPDATE_SUCCESS)
+    public void updateSpecialClosingSettings(
+            FmsSpecialClosingSettingsSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验专用结转方案
+        FmsClosingSchemeDO closing = validateClosingSchemeExists(
+                updateReqVO.getAccountSetId(), updateReqVO.getId());
+        if (!isSpecialClosing(closing)) {
+            throw exception(CLOSING_SCHEME_NOT_EXISTS);
+        }
+        // 1.3 校验凭证字和科目规则
+        voucherWordService.validateVoucherWordExists(
+                updateReqVO.getAccountSetId(), updateReqVO.getVoucherWordId());
+        List<FmsSubjectDO> subjects = validateSpecialClosingSettings(
+                closing.getType(), updateReqVO, userId);
+
+        // 2. 更新专用结转设置
+        closingSchemeMapper.updateById(new FmsClosingSchemeDO().setId(closing.getId())
+                .setVoucherWordId(updateReqVO.getVoucherWordId())
+                .setSubjectRules(buildSpecialSubjectRules(updateReqVO.getSubjects(), subjects)));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_SCHEME_DELETE_SUB_TYPE,
+            bizNo = "{{#accountSetId}}", success = FMS_CLOSING_SCHEME_DELETE_SUCCESS)
+    public void deleteClosingScheme(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验结账方案
+        FmsClosingSchemeDO closing = validateClosingSchemeExists(accountSetId, id);
+        if (!ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.REGULAR.getType())) {
+            throw exception(CLOSING_SCHEME_NOT_EXISTS);
+        }
+        if (closingVoucherService.getClosingVoucherCountByClosingId(id) > 0) {
+            throw exception(CLOSING_SCHEME_IN_USE);
+        }
+
+        // 2. 删除结账方案
+        closingSchemeMapper.deleteById(id);
+    }
+
+    /**
+     * 计算结转损益余额：末级损益科目本期借贷差额绝对值之和
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     * @return 结转损益余额
+     */
+    private BigDecimal calculateProfitLossBalance(Long accountSetId, YearMonth month, Long userId) {
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId, Objects::nonNull);
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = getSubjectBalanceMap(accountSetId, month, userId);
+        BigDecimal result = BigDecimal.ZERO;
+        for (FmsSubjectDO subject : subjects) {
+            if (ObjUtil.notEqual(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                    || parentIds.contains(subject.getId())) {
+                continue;
+            }
+            FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(subject.getId());
+            if (balance != null) {
+                result = result.add(NumberUtils.zeroIfNull(balance.getPeriodDebitAmount())
+                        .subtract(NumberUtils.zeroIfNull(balance.getPeriodCreditAmount())).abs());
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 构造预置结账方案
+     *
+     * @param accountSetId 账套编号
+     * @param voucherWordId 默认凭证字编号
+     * @param preset 预置方案
+     * @param subjectMap 标准科目编码到实际科目的 Map
+     * @return 结账方案
+     */
+    private FmsClosingSchemeDO buildPresetClosingScheme(Long accountSetId, Long voucherWordId,
+            SchemePreset preset, Map<String, FmsSubjectDO> subjectMap) {
+        // 1. 构造结账方案公共字段
+        FmsClosingTypeEnum closingType = FmsClosingTypeEnum.valueOf(preset.getClosingType());
+        FmsClosingSchemeDO scheme = new FmsClosingSchemeDO().setName(preset.getName())
+                .setPeriodEnd(preset.getPeriodEnd()).setVoucherWordId(voucherWordId)
+                .setDigest(preset.getDigest()).setType(closingType.getType())
+                .setAccountSetId(accountSetId).setClosingDay(preset.getClosingDay());
+        if (closingType == FmsClosingTypeEnum.PROFIT_LOSS) {
+            // 2. 构造结转损益专用字段
+            return scheme.setVoucherType(FmsClosingVoucherTypeEnum.valueOf(preset.getVoucherType()).getType())
+                    .setReverseBalance(preset.getReverseBalance())
+                    .setPriorYearAdjustmentSubjectId(getPresetSubject(subjectMap, preset, preset.getPriorYearAdjustmentSubject()).getId())
+                    .setAdjustmentClosingSubjectId(getPresetSubject(subjectMap, preset, preset.getAdjustmentClosingSubject()).getId())
+                    .setOtherClosingSubjectId(getPresetSubject(subjectMap, preset, preset.getOtherClosingSubject()).getId());
+        }
+        // 3. 构造其他专用结转方案的科目规则
+        preset.getCalculationSubjects().forEach(subject -> getPresetSubject(subjectMap, preset, subject));
+        return scheme.setSubjectRules(convertList(preset.getEntries(), entry -> {
+            FmsSubjectDO subject = getPresetSubject(subjectMap, preset, entry.getSubject());
+            return FmsClosingSchemeDO.SubjectRule.builder().subjectId(subject.getId())
+                    .subjectCode(subject.getCode()).digest(entry.getDigest())
+                    .direction(FmsDebitCreditDirectionEnum.valueOf(entry.getDirection()).getType())
+                    .amountRatio(entry.getAmountRatio()).build();
+        }));
+    }
+
+    /**
+     * 获得预置方案使用的账套科目
+     *
+     * @param subjectMap 标准科目编码到实际科目的 Map
+     * @param preset 预置方案
+     * @param subjectName 预置科目枚举名
+     * @return 账套科目
+     */
+    private FmsSubjectDO getPresetSubject(Map<String, FmsSubjectDO> subjectMap,
+                                          SchemePreset preset, String subjectName) {
+        FmsClosingPresetSubjectEnum presetSubject = FmsClosingPresetSubjectEnum.valueOf(subjectName);
+        FmsSubjectDO subject = subjectMap.get(presetSubject.getCode());
+        if (subject == null) {
+            throw exception(CLOSING_SCHEME_PRESET_SUBJECT_NOT_EXISTS,
+                    preset.getCode(), presetSubject.getCode());
+        }
+        return subject;
+    }
+
+    /**
+     * 加载结账方案预置文件
+     *
+     * @return 预置文件
+     */
+    private List<SchemePreset> loadSchemePresets() {
+        try (InputStream inputStream = new ClassPathResource(PRESET_RESOURCE).getInputStream()) {
+            return JsonUtils.parseArray(IoUtil.readUtf8(inputStream), SchemePreset.class);
+        } catch (Exception ex) {
+            throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+        }
+    }
+
+    /**
+     * 校验结账方案预置文件
+     *
+     * @param presets 预置方案数组
+     */
+    private void validateSchemePresets(List<SchemePreset> presets) {
+        // 1. 校验预置编码和结账类型唯一
+        if (CollUtil.isEmpty(presets)
+                || convertSet(presets, SchemePreset::getCode).size() != presets.size()
+                || convertSet(presets, SchemePreset::getClosingType).size() != presets.size()) {
+            throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+        }
+        // 2. 校验各类型必需的枚举字段和科目规则
+        try {
+            for (SchemePreset preset : presets) {
+                FmsClosingTypeEnum closingType = FmsClosingTypeEnum.valueOf(preset.getClosingType());
+                if (closingType == FmsClosingTypeEnum.PROFIT_LOSS) {
+                    FmsClosingVoucherTypeEnum.valueOf(preset.getVoucherType());
+                    FmsClosingPresetSubjectEnum.valueOf(preset.getPriorYearAdjustmentSubject());
+                    FmsClosingPresetSubjectEnum.valueOf(preset.getAdjustmentClosingSubject());
+                    FmsClosingPresetSubjectEnum.valueOf(preset.getOtherClosingSubject());
+                    continue;
+                }
+                if (CollUtil.size(preset.getEntries()) < 2) {
+                    throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+                }
+                for (String subject : preset.getCalculationSubjects()) {
+                    FmsClosingPresetSubjectEnum.valueOf(subject);
+                }
+                for (SchemePreset.Entry entry : preset.getEntries()) {
+                    FmsClosingPresetSubjectEnum.valueOf(entry.getSubject());
+                    FmsDebitCreditDirectionEnum.valueOf(entry.getDirection());
+                }
+                BigDecimal debitRatio = sumBigDecimal(filterList(preset.getEntries(), entry -> Objects.equals(
+                        entry.getDirection(), FmsDebitCreditDirectionEnum.DEBIT.name())),
+                        SchemePreset.Entry::getAmountRatio);
+                BigDecimal creditRatio = sumBigDecimal(filterList(preset.getEntries(), entry -> Objects.equals(
+                        entry.getDirection(), FmsDebitCreditDirectionEnum.CREDIT.name())),
+                        SchemePreset.Entry::getAmountRatio);
+                if (debitRatio.compareTo(creditRatio) != 0) {
+                    throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+                }
+            }
+        } catch (IllegalArgumentException | NullPointerException ex) {
+            throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+        }
+    }
+
+    /**
+     * 计算专用结转方案的结转金额
+     *
+     * 转出未交增值税取应交增值税期末贷方净额；计提地税按应交增值税和消费税合计乘以比例；
+     * 计提所得税按利润总额减已计提所得税后乘以比例
+     *
+     * @param closing 结账方案
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param subjects 账套下的科目列表
+     * @param balanceMap 科目编号到余额的 Map
+     * @param userId 用户编号
+     * @return 结转金额
+     */
+    private BigDecimal calculateSpecialClosingBalance(FmsClosingSchemeDO closing, Long accountSetId,
+            YearMonth month, List<FmsSubjectDO> subjects,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap, Long userId) {
+        Map<String, FmsSubjectDO> subjectMap = buildPresetSubjectMap(accountSetId, subjects);
+        if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.UNPAID_VAT.getType())) {
+            return getPositiveCreditEndingBalance(subjectMap.get(FmsClosingPresetSubjectEnum.VAT_PAYABLE.getCode()), balanceMap);
+        }
+        BigDecimal rate = getDirectionRatio(
+                closing.getSubjectRules(), FmsDebitCreditDirectionEnum.DEBIT.getType());
+        if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.LOCAL_TAX.getType())) {
+            BigDecimal taxBase = getPositiveCreditEndingBalance(
+                    subjectMap.get(FmsClosingPresetSubjectEnum.VAT_PAYABLE.getCode()), balanceMap)
+                    .add(getPositiveCreditEndingBalance(
+                            subjectMap.get(FmsClosingPresetSubjectEnum.CONSUMPTION_TAX.getCode()), balanceMap));
+            return taxBase.multiply(rate).divide(NumberUtils.ONE_HUNDRED, 2, RoundingMode.HALF_UP);
+        }
+        if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.INCOME_TAX.getType())) {
+            FmsReportListReqVO listReqVO = new FmsReportListReqVO();
+            listReqVO.setAccountSetId(accountSetId);
+            listReqVO.setStartMonth(month.toString());
+            listReqVO.setEndMonth(month.toString());
+            List<FmsReportItemRespVO> reportItems = incomeStatementService.getIncomeStatement(listReqVO, userId);
+            Map<Integer, FmsReportItemRespVO> reportItemMap = convertMap(
+                    filterList(reportItems, item -> item.getRowNo() != null),
+                    FmsReportItemRespVO::getRowNo, Function.identity(), (first, second) -> first);
+            BigDecimal totalProfit = reportItemMap.containsKey(30)
+                    ? NumberUtils.zeroIfNull(reportItemMap.get(30).getYearAmount()) : BigDecimal.ZERO;
+            BigDecimal accruedIncomeTax = reportItemMap.containsKey(31)
+                    ? NumberUtils.zeroIfNull(reportItemMap.get(31).getYearAmount()) : BigDecimal.ZERO;
+            return totalProfit.max(BigDecimal.ZERO).multiply(rate)
+                    .divide(NumberUtils.ONE_HUNDRED, 2, RoundingMode.HALF_UP)
+                    .subtract(accruedIncomeTax.max(BigDecimal.ZERO)).max(BigDecimal.ZERO);
+        }
+        return BigDecimal.ZERO;
+    }
+
+    /**
+     * 获得科目期末贷方净额，借方大于贷方时按零处理
+     *
+     * @param subject 科目
+     * @param balanceMap 科目编号到余额的 Map
+     * @return 期末贷方净额
+     */
+    private BigDecimal getPositiveCreditEndingBalance(FmsSubjectDO subject,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap) {
+        // 预置科目不存在时直接抛错，避免按错误科目结转
+        if (subject == null) {
+            throw exception(CLOSING_SPECIAL_SUBJECT_NOT_EXISTS);
+        }
+        FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(subject.getId());
+        return balance == null ? BigDecimal.ZERO : NumberUtils.zeroIfNull(balance.getEndingCreditAmount())
+                .subtract(NumberUtils.zeroIfNull(balance.getEndingDebitAmount())).max(BigDecimal.ZERO);
+    }
+
+    /**
+     * 按标准科目编码构建预置科目 Map
+     *
+     * @param accountSetId 账套编号
+     * @param subjects 账套科目列表
+     * @return 标准科目编码到实际科目的 Map
+     */
+    private Map<String, FmsSubjectDO> buildPresetSubjectMap(Long accountSetId, List<FmsSubjectDO> subjects) {
+        // 1. 按账套实际科目编码建立索引
+        Map<String, FmsSubjectDO> actualSubjectMap = convertMap(subjects, FmsSubjectDO::getCode,
+                Function.identity(), (first, second) -> first);
+
+        // 2. 将各预置标准编码转换为账套实际编码
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(accountSetId);
+        Map<String, FmsSubjectDO> result = new LinkedHashMap<>();
+        for (FmsClosingPresetSubjectEnum presetSubject : FmsClosingPresetSubjectEnum.values()) {
+            String actualCode = financeParameterService.convertStandardSubjectCode(
+                    presetSubject.getCode(), financeParameter.getSubjectCodeRule());
+            FmsSubjectDO subject = actualSubjectMap.get(actualCode);
+            if (subject != null) {
+                result.put(presetSubject.getCode(), subject);
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 校验常规结账方案的来源科目、科目规则和金额比例，返回账套科目列表
+     *
+     * @param saveReqVO 方案信息
+     * @param userId 用户编号
+     * @return 账套下的科目列表
+     */
+    private List<FmsSubjectDO> validateClosingScheme(
+            FmsClosingSchemeSaveReqVO saveReqVO, Long userId) {
+        // 1. 校验来源科目和规则科目存在且为末级科目
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(
+                saveReqVO.getAccountSetId(), null, userId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId, Objects::nonNull);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        if (!subjectMap.containsKey(saveReqVO.getSubjectId())
+                || parentIds.contains(saveReqVO.getSubjectId())) {
+            throw exception(CLOSING_SCHEME_SUBJECT_INVALID);
+        }
+        for (FmsClosingSchemeSaveReqVO.SubjectRule subjectRule : saveReqVO.getSubjects()) {
+            if (!subjectMap.containsKey(subjectRule.getSubjectId())
+                    || parentIds.contains(subjectRule.getSubjectId())) {
+                throw exception(CLOSING_SCHEME_SUBJECT_INVALID);
+            }
+        }
+        // 2. 校验借方和贷方金额比例分别等于 100%
+        BigDecimal debitRatio = sumBigDecimal(filterList(saveReqVO.getSubjects(),
+                item -> ObjUtil.equal(item.getDirection(), FmsDebitCreditDirectionEnum.DEBIT.getType())),
+                FmsClosingSchemeSaveReqVO.SubjectRule::getAmountRatio);
+        BigDecimal creditRatio = sumBigDecimal(filterList(saveReqVO.getSubjects(),
+                item -> ObjUtil.equal(item.getDirection(), FmsDebitCreditDirectionEnum.CREDIT.getType())),
+                FmsClosingSchemeSaveReqVO.SubjectRule::getAmountRatio);
+        if (debitRatio.compareTo(NumberUtils.ONE_HUNDRED) != 0
+                || creditRatio.compareTo(NumberUtils.ONE_HUNDRED) != 0) {
+            throw exception(CLOSING_SCHEME_RATIO_INVALID);
+        }
+        return subjects;
+    }
+
+    /**
+     * 构造常规结账方案的科目规则，按科目编号补充科目编码快照
+     *
+     * @param saveRules 保存的科目规则
+     * @param subjects 账套下的科目列表
+     * @return 科目规则
+     */
+    private List<FmsClosingSchemeDO.SubjectRule> buildSubjectRules(
+            List<FmsClosingSchemeSaveReqVO.SubjectRule> saveRules, List<FmsSubjectDO> subjects) {
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        List<FmsClosingSchemeDO.SubjectRule> rules = BeanUtils.toBean(saveRules, FmsClosingSchemeDO.SubjectRule.class);
+        rules.forEach(rule -> rule.setSubjectCode(subjectMap.get(rule.getSubjectId()).getCode()));
+        return rules;
+    }
+
+    /**
+     * 校验专用结转的科目规则和金额比例，返回账套科目列表
+     *
+     * 借方比例必须等于贷方比例且不超过 100%；转出未交增值税的借方比例必须等于 100%
+     *
+     * @param closingType 结转类型
+     * @param saveReqVO 设置信息
+     * @param userId 用户编号
+     * @return 账套下的科目列表
+     */
+    private List<FmsSubjectDO> validateSpecialClosingSettings(Integer closingType,
+            FmsSpecialClosingSettingsSaveReqVO saveReqVO, Long userId) {
+        // 1. 校验规则科目存在且为末级科目
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(
+                saveReqVO.getAccountSetId(), null, userId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId, Objects::nonNull);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        if (saveReqVO.getSubjects().stream().anyMatch(subjectRule ->
+                !subjectMap.containsKey(subjectRule.getSubjectId())
+                        || parentIds.contains(subjectRule.getSubjectId()))) {
+            throw exception(CLOSING_SPECIAL_SETTINGS_INVALID);
+        }
+        // 2. 校验借贷比例相等且不超过 100%
+        BigDecimal debitRatio = sumBigDecimal(filterList(saveReqVO.getSubjects(),
+                item -> ObjUtil.equal(item.getDirection(), FmsDebitCreditDirectionEnum.DEBIT.getType())),
+                FmsSpecialClosingSettingsSaveReqVO.SubjectRule::getAmountRatio);
+        BigDecimal creditRatio = sumBigDecimal(filterList(saveReqVO.getSubjects(),
+                item -> ObjUtil.equal(item.getDirection(), FmsDebitCreditDirectionEnum.CREDIT.getType())),
+                FmsSpecialClosingSettingsSaveReqVO.SubjectRule::getAmountRatio);
+        boolean unpaidVatRatioInvalid = ObjUtil.equal(
+                closingType, FmsClosingTypeEnum.UNPAID_VAT.getType())
+                && debitRatio.compareTo(NumberUtils.ONE_HUNDRED) != 0;
+        if (debitRatio.signum() <= 0 || debitRatio.compareTo(creditRatio) != 0
+                || debitRatio.compareTo(NumberUtils.ONE_HUNDRED) > 0 || unpaidVatRatioInvalid) {
+            throw exception(CLOSING_SPECIAL_SETTINGS_INVALID);
+        }
+        return subjects;
+    }
+
+    /**
+     * 构造专用结转的科目规则，按科目编号补充科目编码快照
+     *
+     * @param saveRules 保存的科目规则
+     * @param subjects 账套下的科目列表
+     * @return 科目规则
+     */
+    private List<FmsClosingSchemeDO.SubjectRule> buildSpecialSubjectRules(
+            List<FmsSpecialClosingSettingsSaveReqVO.SubjectRule> saveRules,
+            List<FmsSubjectDO> subjects) {
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        List<FmsClosingSchemeDO.SubjectRule> rules = BeanUtils.toBean(
+                saveRules, FmsClosingSchemeDO.SubjectRule.class);
+        rules.forEach(rule -> rule.setSubjectCode(
+                subjectMap.get(rule.getSubjectId()).getCode()));
+        return rules;
+    }
+
+    /**
+     * 校验结转损益设置的科目合法性
+     *
+     * @param saveReqVO 设置信息
+     * @param userId 用户编号
+     */
+    private void validateProfitLossSettings(FmsProfitLossSettingsSaveReqVO saveReqVO, Long userId) {
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(saveReqVO.getAccountSetId(), null, userId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId, Objects::nonNull);
+        validateProfitLossSubjects(BeanUtils.toBean(saveReqVO, FmsClosingSchemeDO.class),
+                subjects, parentIds);
+    }
+
+    /**
+     * 校验结转损益的三个科目：调整科目必须为末级损益科目，结转科目必须为末级非损益科目
+     *
+     * @param closing 结账方案
+     * @param subjects 账套下的科目列表
+     * @param parentIds 父级科目编号集合
+     */
+    private void validateProfitLossSubjects(FmsClosingSchemeDO closing,
+            List<FmsSubjectDO> subjects, Set<Long> parentIds) {
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        FmsSubjectDO adjustmentSubject = subjectMap.get(closing.getPriorYearAdjustmentSubjectId());
+        FmsSubjectDO adjustmentClosingSubject = subjectMap.get(closing.getAdjustmentClosingSubjectId());
+        FmsSubjectDO otherClosingSubject = subjectMap.get(closing.getOtherClosingSubjectId());
+        if (adjustmentSubject == null
+                || !ObjUtil.equal(adjustmentSubject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                || parentIds.contains(adjustmentSubject.getId())
+                || adjustmentClosingSubject == null
+                || parentIds.contains(adjustmentClosingSubject.getId())
+                || ObjUtil.equal(adjustmentClosingSubject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                || otherClosingSubject == null
+                || parentIds.contains(otherClosingSubject.getId())
+                || ObjUtil.equal(otherClosingSubject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())) {
+            throw exception(CLOSING_PROFIT_LOSS_SETTINGS_INVALID);
+        }
+    }
+
+    /**
+     * 计算常规结账方案的来源科目结转金额
+     *
+     * 按取数时间类型选择期初、期末、本期或本年累计口径，再按取数规则返回余额或发生额
+     *
+     * @param closing 结账方案
+     * @param balanceMap 科目编号到余额的 Map
+     * @return 结转金额
+     */
+    private BigDecimal calculateClosingSchemeBalance(FmsClosingSchemeDO closing,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap) {
+        FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(closing.getSubjectId());
+        if (balance == null) {
+            return BigDecimal.ZERO;
+        }
+        // 期初、年初或期末余额口径
+        boolean openingBalance = ObjectUtils.equalsAny(closing.getTimeType(),
+                FmsClosingTimeTypeEnum.PERIOD_BEGIN.getType(), FmsClosingTimeTypeEnum.YEAR_BEGIN.getType());
+        BigDecimal debitBalance = openingBalance
+                ? NumberUtils.zeroIfNull(balance.getOpeningDebitAmount())
+                : NumberUtils.zeroIfNull(balance.getEndingDebitAmount());
+        BigDecimal creditBalance = openingBalance
+                ? NumberUtils.zeroIfNull(balance.getOpeningCreditAmount())
+                : NumberUtils.zeroIfNull(balance.getEndingCreditAmount());
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.BALANCE.getRule())) {
+            return debitBalance.subtract(creditBalance).abs();
+        }
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                || ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.SUBJECT_DEBIT_BALANCE.getRule())) {
+            return debitBalance;
+        }
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.CREDIT_BALANCE.getRule())
+                || ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.SUBJECT_CREDIT_BALANCE.getRule())) {
+            return creditBalance;
+        }
+        // 本期或本年累计发生额口径
+        BigDecimal debitAmount = ObjUtil.equal(closing.getTimeType(), FmsClosingTimeTypeEnum.YEAR_BEGIN.getType())
+                ? NumberUtils.zeroIfNull(balance.getYearDebitAmount())
+                : NumberUtils.zeroIfNull(balance.getPeriodDebitAmount());
+        BigDecimal creditAmount = ObjUtil.equal(closing.getTimeType(), FmsClosingTimeTypeEnum.YEAR_BEGIN.getType())
+                ? NumberUtils.zeroIfNull(balance.getYearCreditAmount())
+                : NumberUtils.zeroIfNull(balance.getPeriodCreditAmount());
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.DEBIT_AMOUNT.getRule())) {
+            return debitAmount;
+        }
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.CREDIT_AMOUNT.getRule())) {
+            return creditAmount;
+        }
+        return debitAmount.subtract(creditAmount).abs();
+    }
+
+    /**
+     * 汇总科目规则中指定借贷方向的金额比例
+     *
+     * @param subjectRules 科目规则
+     * @param direction 借贷方向
+     * @return 金额比例合计
+     */
+    private BigDecimal getDirectionRatio(List<FmsClosingSchemeDO.SubjectRule> subjectRules, Integer direction) {
+        return sumBigDecimal(filterList(subjectRules,
+                        item -> ObjUtil.equal(item.getDirection(), direction)), FmsClosingSchemeDO.SubjectRule::getAmountRatio);
+    }
+
+    /**
+     * 判断是否为专用结转方案（转出未交增值税、计提地税、计提所得税）
+     *
+     * @param closing 结账方案
+     * @return 是否专用结转方案
+     */
+    private boolean isSpecialClosing(FmsClosingSchemeDO closing) {
+        return ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.UNPAID_VAT.getType())
+                || ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.LOCAL_TAX.getType())
+                || ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.INCOME_TAX.getType());
+    }
+
+    /**
+     * 获得单个会计期间的科目余额 Map
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     * @return 科目编号到余额的 Map
+     */
+    private Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(
+            Long accountSetId, YearMonth month, Long userId) {
+        return getSubjectBalanceMap(accountSetId, month, month, userId);
+    }
+
+    /**
+     * 获得月份区间的科目余额 Map，树形余额扁平化后按科目编号存放
+     *
+     * @param accountSetId 账套编号
+     * @param startMonth 开始月份
+     * @param endMonth 结束月份
+     * @param userId 用户编号
+     * @return 科目编号到余额的 Map
+     */
+    private Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(
+            Long accountSetId, YearMonth startMonth, YearMonth endMonth, Long userId) {
+        FmsLedgerListReqVO listReqVO = new FmsLedgerListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(startMonth.toString()).setEndMonth(endMonth.toString());
+        Map<Long, FmsLedgerSubjectBalanceRespVO> result = new LinkedHashMap<>();
+        flattenBalances(ledgerService.getSubjectBalanceList(listReqVO, userId), result);
+        return result;
+    }
+
+    /**
+     * 递归扁平化树形科目余额到 Map
+     *
+     * @param balances 树形科目余额
+     * @param result 科目编号到余额的 Map
+     */
+    private void flattenBalances(List<FmsLedgerSubjectBalanceRespVO> balances,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> result) {
+        for (FmsLedgerSubjectBalanceRespVO balance : balances) {
+            result.put(balance.getSubjectId(), balance);
+            flattenBalances(balance.getChildren(), result);
+        }
+    }
+
+    @Data
+    private static class SchemePreset {
+
+        /**
+         * 预置编码
+         */
+        private String code;
+        /**
+         * 方案名称
+         */
+        private String name;
+        /**
+         * 结账类型
+         */
+        private String closingType;
+        /**
+         * 凭证摘要
+         */
+        private String digest;
+        /**
+         * 是否期末结转
+         */
+        private Boolean periodEnd;
+        /**
+         * 结转日期
+         */
+        private Integer closingDay;
+        /**
+         * 结转凭证类型
+         */
+        private String voucherType;
+        /**
+         * 是否按余额反向结转
+         */
+        private Boolean reverseBalance;
+        /**
+         * 以前年度损益调整科目
+         */
+        private String priorYearAdjustmentSubject;
+        /**
+         * 以前年度损益调整结转科目
+         */
+        private String adjustmentClosingSubject;
+        /**
+         * 其他损益结转科目
+         */
+        private String otherClosingSubject;
+        /**
+         * 计算科目数组
+         */
+        private List<String> calculationSubjects;
+        /**
+         * 分录数组
+         */
+        private List<Entry> entries;
+
+        @Data
+        private static class Entry {
+
+            /**
+             * 预置科目
+             */
+            private String subject;
+            /**
+             * 摘要
+             */
+            private String digest;
+            /**
+             * 借贷方向
+             */
+            private String direction;
+            /**
+             * 金额比例
+             */
+            private BigDecimal amountRatio;
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateService.java
new file mode 100644
index 0000000..27aa22b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateService.java
@@ -0,0 +1,68 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingTemplateRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingTemplateSaveReqVO;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 结账模板 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsClosingTemplateService {
+
+    /**
+     * 初始化账套结账模板
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     */
+    void initializeClosingTemplates(Long accountSetId, Long userId);
+
+    /**
+     * 获得结账模板列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 结账模板列表
+     */
+    List<FmsClosingTemplateRespVO> getClosingTemplateList(Long accountSetId, Long userId);
+
+    /**
+     * 获得引用指定科目的结账模板数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号集合
+     * @return 结账模板数量
+     */
+    Long getClosingTemplateCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 创建结账模板
+     *
+     * @param createReqVO 创建信息
+     * @param userId 用户编号
+     * @return 模板编号
+     */
+    Long createClosingTemplate(FmsClosingTemplateSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新结账模板
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 用户编号
+     */
+    void updateClosingTemplate(FmsClosingTemplateSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除结账模板
+     *
+     * @param accountSetId 账套编号
+     * @param id 模板编号
+     * @param userId 用户编号
+     */
+    void deleteClosingTemplate(Long accountSetId, Long id, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateServiceImpl.java
new file mode 100644
index 0000000..3ae9dc4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateServiceImpl.java
@@ -0,0 +1,372 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.io.IoUtil;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingTemplateRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingTemplateSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingTemplateMapper;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTemplateCategoryEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import lombok.Data;
+import org.springframework.core.io.ClassPathResource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.io.InputStream;
+import java.math.BigDecimal;
+import java.util.Collection;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.function.Function;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sumBigDecimal;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_SCHEME_RATIO_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_SCHEME_SUBJECT_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_TEMPLATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_TEMPLATE_PRESET_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_TEMPLATE_PRESET_SUBJECT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CLOSING_TEMPLATE_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CLOSING_TEMPLATE_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CLOSING_TEMPLATE_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CLOSING_TEMPLATE_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CLOSING_TEMPLATE_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CLOSING_TEMPLATE_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CLOSING_TYPE;
+
+/**
+ * FMS 结账模板 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsClosingTemplateServiceImpl implements FmsClosingTemplateService {
+
+    private static final String PRESET_RESOURCE = "fms/closing/closing-template-presets.json";
+
+    @Resource
+    private FmsClosingTemplateMapper closingTemplateMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsFinanceParameterService financeParameterService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void initializeClosingTemplates(Long accountSetId, Long userId) {
+        // 1.1 加载并校验预置模板
+        List<Preset> presets = loadPresets();
+        validatePresets(presets);
+        // 1.2 查询尚未初始化的预置编码
+        Set<String> existingCodes = convertSet(closingTemplateMapper.selectListByAccountSetId(accountSetId),
+                FmsClosingTemplateDO::getPresetCode, Objects::nonNull);
+        List<Preset> pendingPresets = filterList(presets,
+                preset -> !existingCodes.contains(preset.getCode()));
+        if (CollUtil.isEmpty(pendingPresets)) {
+            return;
+        }
+
+        // 2. 查询账套科目并建立实际科目编码索引
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode,
+                Function.identity(), (first, second) -> first);
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(accountSetId);
+
+        // 3. 转换预置模板并批量创建
+        List<FmsClosingTemplateDO> templates = convertList(pendingPresets,
+                preset -> buildPresetTemplate(accountSetId, preset, subjectMap,
+                        financeParameter.getSubjectCodeRule()));
+        closingTemplateMapper.insertBatch(templates);
+    }
+
+    @Override
+    public List<FmsClosingTemplateRespVO> getClosingTemplateList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询结账模板
+        return convertList(closingTemplateMapper.selectListByAccountSetId(accountSetId), this::buildTemplateRespVO);
+    }
+
+    @Override
+    public Long getClosingTemplateCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        // 1. 查询账套结账模板
+        List<FmsClosingTemplateDO> templates = closingTemplateMapper.selectListByAccountSetId(accountSetId);
+
+        // 2. 统计来源科目或分录科目被引用的模板数量
+        Set<Long> subjectIdSet = new HashSet<>(subjectIds);
+        return (long) filterList(templates, template -> subjectIdSet.contains(template.getSubjectId())
+                || CollUtil.emptyIfNull(template.getSubjectRules()).stream()
+                .anyMatch(rule -> subjectIdSet.contains(rule.getSubjectId()))).size();
+    }
+
+    @Override
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_TEMPLATE_CREATE_SUB_TYPE,
+            bizNo = "{{#templateId}}", success = FMS_CLOSING_TEMPLATE_CREATE_SUCCESS)
+    public Long createClosingTemplate(FmsClosingTemplateSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验模板科目和金额比例
+        Map<Long, FmsSubjectDO> subjectMap = validateClosingTemplate(createReqVO, userId);
+
+        // 2. 创建结账模板
+        FmsClosingTemplateDO template = buildClosingTemplate(createReqVO, subjectMap).setId(null);
+        closingTemplateMapper.insert(template);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("templateId", template.getId());
+        return template.getId();
+    }
+
+    @Override
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_TEMPLATE_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_CLOSING_TEMPLATE_UPDATE_SUCCESS)
+    public void updateClosingTemplate(FmsClosingTemplateSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验结账模板存在
+        validateClosingTemplateExists(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        // 1.3 校验模板科目和金额比例
+        Map<Long, FmsSubjectDO> subjectMap = validateClosingTemplate(updateReqVO, userId);
+
+        // 2. 更新结账模板
+        closingTemplateMapper.updateById(buildClosingTemplate(updateReqVO, subjectMap));
+    }
+
+    @Override
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_TEMPLATE_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_CLOSING_TEMPLATE_DELETE_SUCCESS)
+    public void deleteClosingTemplate(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验结账模板存在
+        validateClosingTemplateExists(accountSetId, id);
+
+        // 2. 删除结账模板
+        closingTemplateMapper.deleteById(id);
+    }
+
+    /**
+     * 校验结账模板存在
+     *
+     * @param accountSetId 账套编号
+     * @param id 模板编号
+     * @return 结账模板
+     */
+    private FmsClosingTemplateDO validateClosingTemplateExists(Long accountSetId, Long id) {
+        FmsClosingTemplateDO template = closingTemplateMapper.selectByIdAndAccountSetId(id, accountSetId);
+        if (template == null) {
+            throw exception(CLOSING_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    /**
+     * 校验模板科目和金额比例
+     *
+     * @param saveReqVO 模板信息
+     * @param userId 用户编号
+     * @return 科目编号到科目的 Map
+     */
+    private Map<Long, FmsSubjectDO> validateClosingTemplate(
+            FmsClosingTemplateSaveReqVO saveReqVO, Long userId) {
+        // 1. 校验来源科目和规则科目存在且为末级科目
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(saveReqVO.getAccountSetId(), null, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId, Objects::nonNull);
+        if (saveReqVO.getSubjectId() != null
+                && (!subjectMap.containsKey(saveReqVO.getSubjectId()) || parentIds.contains(saveReqVO.getSubjectId()))) {
+            throw exception(CLOSING_SCHEME_SUBJECT_INVALID);
+        }
+        for (FmsClosingTemplateSaveReqVO.SubjectRule rule : saveReqVO.getSubjects()) {
+            if (!subjectMap.containsKey(rule.getSubjectId()) || parentIds.contains(rule.getSubjectId())) {
+                throw exception(CLOSING_SCHEME_SUBJECT_INVALID);
+            }
+        }
+
+        // 2. 校验借贷金额比例分别等于 100%
+        BigDecimal debitRatio = sumBigDecimal(filterList(saveReqVO.getSubjects(), rule -> Objects.equals(
+                rule.getDirection(), FmsDebitCreditDirectionEnum.DEBIT.getType())),
+                FmsClosingTemplateSaveReqVO.SubjectRule::getAmountRatio);
+        BigDecimal creditRatio = sumBigDecimal(filterList(saveReqVO.getSubjects(), rule -> Objects.equals(
+                rule.getDirection(), FmsDebitCreditDirectionEnum.CREDIT.getType())),
+                FmsClosingTemplateSaveReqVO.SubjectRule::getAmountRatio);
+        if (debitRatio.compareTo(BigDecimal.valueOf(100)) != 0
+                || creditRatio.compareTo(BigDecimal.valueOf(100)) != 0) {
+            throw exception(CLOSING_SCHEME_RATIO_INVALID);
+        }
+        return subjectMap;
+    }
+
+    /**
+     * 构造结账模板
+     *
+     * @param saveReqVO 模板信息
+     * @param subjectMap 科目编号到科目的 Map
+     * @return 结账模板
+     */
+    private FmsClosingTemplateDO buildClosingTemplate(FmsClosingTemplateSaveReqVO saveReqVO,
+            Map<Long, FmsSubjectDO> subjectMap) {
+        List<FmsClosingTemplateDO.SubjectRule> rules = BeanUtils.toBean(
+                saveReqVO.getSubjects(), FmsClosingTemplateDO.SubjectRule.class);
+        rules.forEach(rule -> rule.setSubjectCode(subjectMap.get(rule.getSubjectId()).getCode()));
+        return BeanUtils.toBean(saveReqVO, FmsClosingTemplateDO.class).setSubjectRules(rules);
+    }
+
+    /**
+     * 构造结账模板响应
+     *
+     * @param template 结账模板
+     * @return 结账模板响应
+     */
+    private FmsClosingTemplateRespVO buildTemplateRespVO(FmsClosingTemplateDO template) {
+        return BeanUtils.toBean(template, FmsClosingTemplateRespVO.class)
+                .setSubjects(BeanUtils.toBean(template.getSubjectRules(), FmsClosingTemplateRespVO.SubjectRule.class));
+    }
+
+    /**
+     * 构造预置结账模板
+     *
+     * @param accountSetId 账套编号
+     * @param preset 预置模板
+     * @param subjectMap 实际科目编码到科目的 Map
+     * @param subjectCodeRule 科目编码规则
+     * @return 结账模板
+     */
+    private FmsClosingTemplateDO buildPresetTemplate(Long accountSetId, Preset preset,
+            Map<String, FmsSubjectDO> subjectMap, String subjectCodeRule) {
+        List<FmsClosingTemplateDO.SubjectRule> rules = convertList(preset.getEntries(), entry -> {
+            String actualCode = financeParameterService.convertStandardSubjectCode(
+                    entry.getSubjectCode(), subjectCodeRule);
+            FmsSubjectDO subject = subjectMap.get(actualCode);
+            if (subject == null) {
+                throw exception(CLOSING_TEMPLATE_PRESET_SUBJECT_NOT_EXISTS, preset.getCode(), entry.getSubjectCode());
+            }
+            return FmsClosingTemplateDO.SubjectRule.builder().subjectId(subject.getId())
+                    .subjectCode(subject.getCode()).digest(entry.getDigest())
+                    .direction(FmsDebitCreditDirectionEnum.valueOf(entry.getDirection()).getType())
+                    .amountRatio(entry.getAmountRatio()).build();
+        });
+        return new FmsClosingTemplateDO().setAccountSetId(accountSetId).setPresetCode(preset.getCode())
+                .setName(preset.getName()).setCategory(FmsClosingTemplateCategoryEnum.valueOf(preset.getCategory()).getCategory())
+                .setPeriodEnd(true).setSubjectRules(rules).setSort(preset.getSort());
+    }
+
+    /**
+     * 加载结账模板预置文件
+     *
+     * @return 预置文件
+     */
+    private List<Preset> loadPresets() {
+        try (InputStream inputStream = new ClassPathResource(PRESET_RESOURCE).getInputStream()) {
+            return JsonUtils.parseArray(IoUtil.readUtf8(inputStream), Preset.class);
+        } catch (Exception ex) {
+            throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+        }
+    }
+
+    /**
+     * 校验结账模板预置文件
+     *
+     * @param presets 预置模板数组
+     */
+    private void validatePresets(List<Preset> presets) {
+        // 1. 校验预置编码唯一
+        if (CollUtil.isEmpty(presets) || convertSet(presets, Preset::getCode).size() != presets.size()) {
+            throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+        }
+        for (Preset preset : presets) {
+            // 2. 校验模板分类、分录数量和枚举字段
+            try {
+                FmsClosingTemplateCategoryEnum.valueOf(preset.getCategory());
+                if (CollUtil.size(preset.getEntries()) < 2) {
+                    throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+                }
+                for (Preset.Entry entry : preset.getEntries()) {
+                    FmsDebitCreditDirectionEnum.valueOf(entry.getDirection());
+                }
+            } catch (IllegalArgumentException | NullPointerException ex) {
+                throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+            }
+            // 3. 校验借贷金额比例分别等于 100%
+            BigDecimal debitRatio = sumBigDecimal(filterList(preset.getEntries(), entry -> Objects.equals(
+                    entry.getDirection(), FmsDebitCreditDirectionEnum.DEBIT.name())), Preset.Entry::getAmountRatio);
+            BigDecimal creditRatio = sumBigDecimal(filterList(preset.getEntries(), entry -> Objects.equals(
+                    entry.getDirection(), FmsDebitCreditDirectionEnum.CREDIT.name())), Preset.Entry::getAmountRatio);
+            if (debitRatio.compareTo(BigDecimal.valueOf(100)) != 0
+                    || creditRatio.compareTo(BigDecimal.valueOf(100)) != 0) {
+                throw exception(CLOSING_TEMPLATE_PRESET_INVALID);
+            }
+        }
+    }
+
+    @Data
+    private static class Preset {
+
+        /**
+         * 预置编码
+         */
+        private String code;
+        /**
+         * 模板名称
+         */
+        private String name;
+        /**
+         * 模板分类
+         */
+        private String category;
+        /**
+         * 显示顺序
+         */
+        private Integer sort;
+        /**
+         * 分录数组
+         */
+        private List<Entry> entries;
+
+        @Data
+        private static class Entry {
+
+            /**
+             * 标准科目编码
+             */
+            private String subjectCode;
+            /**
+             * 摘要
+             */
+            private String digest;
+            /**
+             * 借贷方向
+             */
+            private String direction;
+            /**
+             * 金额比例
+             */
+            private BigDecimal amountRatio;
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherService.java
new file mode 100644
index 0000000..7935955
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherService.java
@@ -0,0 +1,98 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingVoucherGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossGenerateReqVO;
+
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Set;
+
+/**
+ * FMS 结转凭证 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsClosingVoucherService {
+
+    /**
+     * 获得指定期间的结转凭证关联列表
+     *
+     * @param accountSetId 账套编号
+     * @param beginTime 期间开始时间
+     * @param endTime 期间结束时间
+     * @return 结转凭证关联列表
+     */
+    List<FmsClosingVoucherDO> getClosingVoucherListByPeriod(Long accountSetId,
+            LocalDateTime beginTime, LocalDateTime endTime);
+
+    /**
+     * 获得指定方案和期间的结转凭证关联列表
+     *
+     * @param closingId 结账方案编号
+     * @param beginTime 开始时间，为空时不限制
+     * @param endTime 结束时间，为空时不限制
+     * @return 结转凭证关联列表
+     */
+    List<FmsClosingVoucherDO> getClosingVoucherListByClosingIdAndPeriod(Long closingId,
+            LocalDateTime beginTime, LocalDateTime endTime);
+
+    /**
+     * 更新指定期间的结转凭证结账状态
+     *
+     * @param accountSetId 账套编号
+     * @param beginTime 期间开始时间
+     * @param endTime 期间结束时间
+     * @param closed 是否已结账
+     */
+    void updateClosingVoucherClosedByPeriod(Long accountSetId, LocalDateTime beginTime,
+            LocalDateTime endTime, Boolean closed);
+
+    /**
+     * 获得方案已生成的结转凭证数量
+     *
+     * @param closingId 方案编号
+     * @return 结转凭证数量
+     */
+    Long getClosingVoucherCountByClosingId(Long closingId);
+
+    /**
+     * 获得结转凭证编号集合
+     *
+     * @param accountSetId 账套编号
+     * @param voucherIds 凭证编号数组
+     * @return 结转凭证编号集合
+     */
+    Set<Long> getClosingVoucherIdSet(Long accountSetId, Collection<Long> voucherIds);
+
+    /**
+     * 生成结转损益凭证
+     *
+     * @param generateReqVO 生成参数
+     * @param userId 用户编号
+     * @return 凭证编号
+     */
+    Long generateProfitLossVoucher(FmsProfitLossGenerateReqVO generateReqVO, Long userId);
+
+    /**
+     * 生成结账方案凭证
+     *
+     * @param generateReqVO 生成参数
+     * @param userId 用户编号
+     * @return 凭证编号
+     */
+    Long generateClosingSchemeVoucher(FmsClosingSchemeGenerateReqVO generateReqVO, Long userId);
+
+    /**
+     * 批量生成结转凭证
+     *
+     * @param generateReqVO 生成参数
+     * @param userId 用户编号
+     * @return 凭证编号数组
+     */
+    List<Long> generateClosingVoucherList(FmsClosingVoucherGenerateReqVO generateReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherServiceImpl.java
new file mode 100644
index 0000000..874c646
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherServiceImpl.java
@@ -0,0 +1,804 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.exception.ServiceException;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingVoucherGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerEntryVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherEntrySaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingSchemeMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingVoucherMapper;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingPresetSubjectEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingVoucherTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import cn.iocoder.yudao.module.fms.util.FmsPeriodUtils;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sumBigDecimal;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+
+/**
+ * FMS 结转凭证 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsClosingVoucherServiceImpl implements FmsClosingVoucherService {
+
+    @Resource
+    private FmsClosingVoucherMapper closingVoucherMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    @Lazy // 延迟加载，避免与结账期间 Service 循环依赖
+    private FmsClosingPeriodService closingPeriodService;
+    @Resource
+    @Lazy // 延迟加载，避免与结账方案 Service 循环依赖
+    private FmsClosingSchemeService closingSchemeService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsLedgerService ledgerService;
+    @Resource
+    @Lazy // 延迟加载，避免与凭证 Service 循环依赖
+    private FmsVoucherService voucherService;
+    @Resource
+    private FmsVoucherWordService voucherWordService;
+    @Resource
+    private FmsIncomeStatementService incomeStatementService;
+
+    @Override
+    public List<FmsClosingVoucherDO> getClosingVoucherListByPeriod(Long accountSetId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return closingVoucherMapper.selectListByPeriod(accountSetId, beginTime, endTime);
+    }
+
+    @Override
+    public List<FmsClosingVoucherDO> getClosingVoucherListByClosingIdAndPeriod(Long closingId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return closingVoucherMapper.selectListByClosingIdAndVoucherTimeBetween(closingId, beginTime, endTime);
+    }
+
+    @Override
+    public void updateClosingVoucherClosedByPeriod(Long accountSetId, LocalDateTime beginTime,
+            LocalDateTime endTime, Boolean closed) {
+        List<FmsClosingVoucherDO> closingVouchers = getClosingVoucherListByPeriod(
+                accountSetId, beginTime, endTime);
+        closingVouchers.forEach(item -> closingVoucherMapper.updateById(new FmsClosingVoucherDO()
+                .setId(item.getId()).setClosed(closed)));
+    }
+
+    @Override
+    public Long getClosingVoucherCountByClosingId(Long closingId) {
+        return closingVoucherMapper.selectCountByClosingId(closingId);
+    }
+
+    @Override
+    public Set<Long> getClosingVoucherIdSet(Long accountSetId, Collection<Long> voucherIds) {
+        if (CollUtil.isEmpty(voucherIds)) {
+            return Collections.emptySet();
+        }
+        List<FmsClosingVoucherDO> closingVouchers = closingVoucherMapper.selectListByAccountSetIdAndVoucherIds(
+                accountSetId, voucherIds);
+        return convertSet(closingVouchers, FmsClosingVoucherDO::getVoucherId);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_VOUCHER_GENERATE_SUB_TYPE,
+            bizNo = "{{#generateReqVO.accountSetId}}", success = FMS_CLOSING_PROFIT_LOSS_VOUCHER_GENERATE_SUCCESS)
+    public Long generateProfitLossVoucher(FmsProfitLossGenerateReqVO generateReqVO, Long userId) {
+        // 1.1 校验当前会计期间
+        validateCurrentPeriod(generateReqVO.getAccountSetId(), generateReqVO.getMonth(), userId);
+        // 1.2 校验期间未结账
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(generateReqVO.getMonth());
+        if (closingPeriodService.isPeriodClosed(generateReqVO.getAccountSetId(), generateReqVO.getMonth())) {
+            throw exception(CLOSING_PERIOD_CLOSED);
+        }
+        // 1.3 校验结转损益设置
+        FmsClosingSchemeDO closing = closingSchemeService.getClosingSchemeByAccountSetIdAndType(
+                generateReqVO.getAccountSetId(), FmsClosingTypeEnum.PROFIT_LOSS.getType());
+        if (closing == null) {
+            throw exception(CLOSING_PROFIT_LOSS_SETTINGS_NOT_EXISTS);
+        }
+        voucherWordService.validateVoucherWordExists(generateReqVO.getAccountSetId(), closing.getVoucherWordId());
+        List<FmsClosingVoucherDO> existingVouchers = closingVoucherMapper.selectListByClosingIdAndPeriod(
+                closing.getId(), LocalDateTimeUtils.getMonthBeginTime(month),
+                LocalDateTimeUtils.endOfMonth(LocalDateTimeUtils.getMonthBeginTime(month)));
+        deleteExistingClosingVouchers(
+                generateReqVO.getAccountSetId(), existingVouchers, userId);
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(
+                generateReqVO.getAccountSetId(), null, userId);
+        Set<Long> parentIds = subjects.stream().map(FmsSubjectDO::getParentId)
+                .filter(id -> id != null).collect(Collectors.toSet());
+        validateProfitLossSubjects(closing, subjects, parentIds);
+
+        // 2. 计算末级损益科目余额并按凭证分类构造分录
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = getSubjectBalanceMap(
+                generateReqVO.getAccountSetId(), month, userId);
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        List<FmsLedgerEntryVO> ledgerEntries = ledgerService.getEntryList(
+                generateReqVO.getAccountSetId(), monthBeginTime, monthBeginTime.plusMonths(1), userId);
+        List<List<FmsVoucherEntrySaveReqVO>> voucherEntriesList = new ArrayList<>();
+        if (ObjUtil.equal(closing.getVoucherType(),
+                FmsClosingVoucherTypeEnum.SEPARATE_GAIN_AND_LOSS.getType())) {
+            List<FmsVoucherEntrySaveReqVO> gainEntries = buildProfitLossEntries(
+                    closing, subjects, parentIds, balanceMap, ledgerEntries, true);
+            List<FmsVoucherEntrySaveReqVO> lossEntries = buildProfitLossEntries(
+                    closing, subjects, parentIds, balanceMap, ledgerEntries, false);
+            if (CollUtil.isNotEmpty(gainEntries)) {
+                voucherEntriesList.add(gainEntries);
+            }
+            if (CollUtil.isNotEmpty(lossEntries)) {
+                voucherEntriesList.add(lossEntries);
+            }
+        } else {
+            List<FmsVoucherEntrySaveReqVO> entries = buildProfitLossEntries(
+                    closing, subjects, parentIds, balanceMap, ledgerEntries, null);
+            if (CollUtil.isNotEmpty(entries)) {
+                voucherEntriesList.add(entries);
+            }
+        }
+        if (CollUtil.isEmpty(voucherEntriesList)) {
+            throw exception(CLOSING_NO_PROFIT_LOSS_BALANCE);
+        }
+
+        // 3. 创建结转凭证并登记关联
+        LocalDateTime voucherTime = month.atDay(Math.min(closing.getClosingDay(), month.lengthOfMonth()))
+                .atStartOfDay();
+        Long firstVoucherId = null;
+        for (List<FmsVoucherEntrySaveReqVO> entries : voucherEntriesList) {
+            FmsVoucherSaveReqVO voucherReqVO = new FmsVoucherSaveReqVO();
+            voucherReqVO.setAccountSetId(generateReqVO.getAccountSetId());
+            voucherReqVO.setVoucherWordId(closing.getVoucherWordId());
+            voucherReqVO.setVoucherTime(voucherTime);
+            voucherReqVO.setVoucherNumber(voucherService.getNextVoucherNumber(
+                    generateReqVO.getAccountSetId(), closing.getVoucherWordId(), voucherTime, userId));
+            voucherReqVO.setEntries(entries);
+            Long voucherId = voucherService.createVoucher(voucherReqVO, userId);
+            if (firstVoucherId == null) {
+                firstVoucherId = voucherId;
+            }
+            closingVoucherMapper.insert(new FmsClosingVoucherDO().setClosingId(closing.getId())
+                    .setVoucherId(voucherId).setVoucherTime(voucherTime)
+                    .setAmount(entries.stream().map(FmsVoucherEntrySaveReqVO::getDebitAmount)
+                            .map(NumberUtils::zeroIfNull).reduce(BigDecimal.ZERO, BigDecimal::add))
+                    .setClosed(false)
+                    .setAccountSetId(generateReqVO.getAccountSetId()));
+        }
+        return firstVoucherId;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_VOUCHER_GENERATE_SUB_TYPE,
+            bizNo = "{{#generateReqVO.accountSetId}}", success = FMS_CLOSING_SCHEME_VOUCHER_GENERATE_SUCCESS)
+    public Long generateClosingSchemeVoucher(
+            FmsClosingSchemeGenerateReqVO generateReqVO, Long userId) {
+        // 1.1 校验当前会计期间
+        FmsAccountSetDO accountSet = validateCurrentPeriod(
+                generateReqVO.getAccountSetId(), generateReqVO.getMonth(), userId);
+        // 1.2 校验期间未结账
+        if (closingPeriodService.isPeriodClosed(generateReqVO.getAccountSetId(), generateReqVO.getMonth())) {
+            throw exception(CLOSING_PERIOD_CLOSED);
+        }
+        // 1.3 校验结账方案
+        FmsClosingSchemeDO closing = closingSchemeService.validateClosingSchemeExists(
+                generateReqVO.getAccountSetId(), generateReqVO.getId());
+        if (!ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.REGULAR.getType())
+                && !isSpecialClosing(closing)) {
+            throw exception(CLOSING_SCHEME_NOT_EXISTS);
+        }
+        validatePeriodEndClosing(closing);
+        voucherWordService.validateVoucherWordExists(
+                generateReqVO.getAccountSetId(), closing.getVoucherWordId());
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(generateReqVO.getMonth());
+
+        // 2. 重新生成时先删除当前期间的旧凭证和关联
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        List<FmsClosingVoucherDO> existingVouchers = closingVoucherMapper.selectListByClosingIdAndPeriod(
+                closing.getId(), monthBeginTime, LocalDateTimeUtils.endOfMonth(monthBeginTime));
+        deleteExistingClosingVouchers(generateReqVO.getAccountSetId(), existingVouchers, userId);
+
+        // 3. 计算结转金额并校验非零
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = ObjUtil.equal(closing.getTimeType(), FmsClosingTimeTypeEnum.YEAR_BEGIN.getType())
+                ? getSubjectBalanceMap(generateReqVO.getAccountSetId(),
+                        FmsPeriodUtils.getYearStartMonth(accountSet, month), month, userId)
+                : getSubjectBalanceMap(generateReqVO.getAccountSetId(), month, userId);
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(generateReqVO.getAccountSetId(), null, userId);
+        BigDecimal balance = isSpecialClosing(closing)
+                ? calculateSpecialClosingBalance(closing, generateReqVO.getAccountSetId(), month, subjects, balanceMap, userId)
+                : calculateClosingSchemeBalance(closing, balanceMap);
+        if (balance.signum() == 0) {
+            throw exception(CLOSING_SCHEME_NO_BALANCE);
+        }
+
+        // 4. 按 JSON 科目规则构造凭证分录
+        List<FmsVoucherEntrySaveReqVO> entries = isSpecialClosing(closing)
+                ? buildSpecialClosingEntries(closing, balance)
+                : buildRegularClosingEntries(closing, balance);
+
+        // 5. 创建凭证并登记方案关联
+        LocalDateTime voucherTime = month.atEndOfMonth().atStartOfDay();
+        Long voucherId = voucherService.createVoucher(new FmsVoucherSaveReqVO()
+                .setAccountSetId(generateReqVO.getAccountSetId())
+                .setVoucherWordId(closing.getVoucherWordId())
+                .setVoucherTime(voucherTime)
+                .setVoucherNumber(voucherService.getNextVoucherNumber(generateReqVO.getAccountSetId(),
+                        closing.getVoucherWordId(), voucherTime, userId))
+                .setEntries(entries), userId);
+        closingVoucherMapper.insert(new FmsClosingVoucherDO().setClosingId(closing.getId())
+                .setVoucherId(voucherId).setVoucherTime(voucherTime)
+                .setAmount(balance).setClosed(false).setAccountSetId(generateReqVO.getAccountSetId()));
+        return voucherId;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CLOSING_TYPE, subType = FMS_CLOSING_VOUCHER_GENERATE_SUB_TYPE,
+            bizNo = "{{#generateReqVO.accountSetId}}", success = FMS_CLOSING_VOUCHER_BATCH_GENERATE_SUCCESS)
+    public List<Long> generateClosingVoucherList(
+            FmsClosingVoucherGenerateReqVO generateReqVO, Long userId) {
+        // 1.1 校验当前会计期间
+        validateCurrentPeriod(generateReqVO.getAccountSetId(), generateReqVO.getMonth(), userId);
+        // 1.2 校验期间未结账
+        if (closingPeriodService.isPeriodClosed(generateReqVO.getAccountSetId(), generateReqVO.getMonth())) {
+            throw exception(CLOSING_PERIOD_CLOSED);
+        }
+        // 1.3 校验结账方案
+        List<FmsClosingSchemeDO> closings = new ArrayList<>();
+        for (Long id : new LinkedHashSet<>(generateReqVO.getIds())) {
+            FmsClosingSchemeDO closing = closingSchemeService.validateClosingSchemeExists(
+                    generateReqVO.getAccountSetId(), id);
+            if (ObjUtil.notEqual(closing.getType(), FmsClosingTypeEnum.PROFIT_LOSS.getType())
+                    && ObjUtil.notEqual(closing.getType(), FmsClosingTypeEnum.REGULAR.getType())
+                    && !isSpecialClosing(closing)) {
+                throw exception(CLOSING_SCHEME_NOT_EXISTS);
+            }
+            validatePeriodEndClosing(closing);
+            closings.add(closing);
+        }
+
+        // 2. 统一删除本批方案的旧结转凭证，避免逐个重生成后删除旧凭证造成凭证号断号
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(generateReqVO.getMonth());
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        List<FmsClosingVoucherDO> existingVouchers = new ArrayList<>();
+        for (FmsClosingSchemeDO closing : closings) {
+            existingVouchers.addAll(closingVoucherMapper.selectListByClosingIdAndPeriod(
+                    closing.getId(), monthBeginTime, LocalDateTimeUtils.endOfMonth(monthBeginTime)));
+        }
+        deleteExistingClosingVouchers(generateReqVO.getAccountSetId(), existingVouchers, userId);
+
+        // 3. 在同一事务中生成全部结转凭证
+        List<Long> voucherIds = new ArrayList<>();
+        for (FmsClosingSchemeDO closing : closings) {
+            boolean profitLoss = ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.PROFIT_LOSS.getType());
+            Integer noBalanceErrorCode = profitLoss ? CLOSING_NO_PROFIT_LOSS_BALANCE.getCode() : CLOSING_SCHEME_NO_BALANCE.getCode();
+            try {
+                if (profitLoss) {
+                    FmsProfitLossGenerateReqVO profitLossReqVO = BeanUtils.toBean(generateReqVO, FmsProfitLossGenerateReqVO.class);
+                    voucherIds.add(generateProfitLossVoucher(profitLossReqVO, userId));
+                } else {
+                    FmsClosingSchemeGenerateReqVO schemeReqVO = BeanUtils.toBean(generateReqVO, FmsClosingSchemeGenerateReqVO.class);
+                    schemeReqVO.setId(closing.getId());
+                    voucherIds.add(generateClosingSchemeVoucher(schemeReqVO, userId));
+                }
+            } catch (ServiceException ex) {
+                // 批量生成时，余额为零的方案无需生成凭证，继续处理其他方案
+                if (ObjUtil.notEqual(ex.getCode(), noBalanceErrorCode)) {
+                    throw ex;
+                }
+            }
+        }
+        return voucherIds;
+    }
+
+    /**
+     * 删除方案当前期间的已生成结转凭证及其关联
+     *
+     * @param accountSetId 账套编号
+     * @param closingVouchers 结账凭证关联列表
+     * @param userId 用户编号
+     */
+    private void deleteExistingClosingVouchers(Long accountSetId, List<FmsClosingVoucherDO> closingVouchers, Long userId) {
+        if (CollUtil.isEmpty(closingVouchers)) {
+            return;
+        }
+        List<Long> voucherIds = convertList(closingVouchers, FmsClosingVoucherDO::getVoucherId);
+        closingVoucherMapper.deleteByIds(convertList(closingVouchers, FmsClosingVoucherDO::getId));
+        voucherService.deleteVoucherList(accountSetId, voucherIds, userId);
+    }
+
+    /**
+     * 计算专用结转方案的结转金额
+     *
+     * 转出未交增值税取应交增值税期末贷方净额；计提地税按应交增值税和消费税合计乘以比例；
+     * 计提所得税按利润总额减已计提所得税后乘以比例
+     *
+     * @param closing 结账方案
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param subjects 账套下的科目列表
+     * @param balanceMap 科目编号到余额的 Map
+     * @param userId 用户编号
+     * @return 结转金额
+     */
+    private BigDecimal calculateSpecialClosingBalance(FmsClosingSchemeDO closing, Long accountSetId,
+            YearMonth month, List<FmsSubjectDO> subjects,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap, Long userId) {
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode,
+                Function.identity(), (first, second) -> first);
+        if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.UNPAID_VAT.getType())) {
+            return getPositiveCreditEndingBalance(subjectMap.get(FmsClosingPresetSubjectEnum.VAT_PAYABLE.getCode()), balanceMap);
+        }
+        BigDecimal rate = getDirectionRatio(
+                closing.getSubjectRules(), FmsDebitCreditDirectionEnum.DEBIT.getType());
+        if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.LOCAL_TAX.getType())) {
+            BigDecimal taxBase = getPositiveCreditEndingBalance(
+                    subjectMap.get(FmsClosingPresetSubjectEnum.VAT_PAYABLE.getCode()), balanceMap)
+                    .add(getPositiveCreditEndingBalance(
+                            subjectMap.get(FmsClosingPresetSubjectEnum.CONSUMPTION_TAX.getCode()), balanceMap));
+            return taxBase.multiply(rate).divide(NumberUtils.ONE_HUNDRED, 2, RoundingMode.HALF_UP);
+        }
+        if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.INCOME_TAX.getType())) {
+            FmsReportListReqVO listReqVO = new FmsReportListReqVO();
+            listReqVO.setAccountSetId(accountSetId);
+            listReqVO.setStartMonth(month.toString());
+            listReqVO.setEndMonth(month.toString());
+            List<FmsReportItemRespVO> reportItems = incomeStatementService.getIncomeStatement(listReqVO, userId);
+            Map<Integer, FmsReportItemRespVO> reportItemMap = convertMap(
+                    filterList(reportItems, item -> item.getRowNo() != null),
+                    FmsReportItemRespVO::getRowNo, Function.identity(), (first, second) -> first);
+            BigDecimal totalProfit = reportItemMap.containsKey(30)
+                    ? NumberUtils.zeroIfNull(reportItemMap.get(30).getYearAmount()) : BigDecimal.ZERO;
+            BigDecimal accruedIncomeTax = reportItemMap.containsKey(31)
+                    ? NumberUtils.zeroIfNull(reportItemMap.get(31).getYearAmount()) : BigDecimal.ZERO;
+            return totalProfit.max(BigDecimal.ZERO).multiply(rate)
+                    .divide(NumberUtils.ONE_HUNDRED, 2, RoundingMode.HALF_UP)
+                    .subtract(accruedIncomeTax.max(BigDecimal.ZERO)).max(BigDecimal.ZERO);
+        }
+        return BigDecimal.ZERO;
+    }
+
+    /**
+     * 获得科目期末贷方净额，借方大于贷方时按零处理
+     *
+     * @param subject 科目
+     * @param balanceMap 科目编号到余额的 Map
+     * @return 期末贷方净额
+     */
+    private BigDecimal getPositiveCreditEndingBalance(FmsSubjectDO subject,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap) {
+        // 预置科目不存在时直接抛错，避免按错误科目结转
+        if (subject == null) {
+            throw exception(CLOSING_SPECIAL_SUBJECT_NOT_EXISTS);
+        }
+        FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(subject.getId());
+        return balance == null ? BigDecimal.ZERO : NumberUtils.zeroIfNull(balance.getEndingCreditAmount())
+                .subtract(NumberUtils.zeroIfNull(balance.getEndingDebitAmount())).max(BigDecimal.ZERO);
+    }
+
+    /**
+     * 校验结转损益的三个科目：调整科目必须为末级损益科目，结转科目必须为末级非损益科目
+     *
+     * @param closing 结账方案
+     * @param subjects 账套下的科目列表
+     * @param parentIds 父级科目编号集合
+     */
+    private void validateProfitLossSubjects(FmsClosingSchemeDO closing,
+            List<FmsSubjectDO> subjects, Set<Long> parentIds) {
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        FmsSubjectDO adjustmentSubject = subjectMap.get(closing.getPriorYearAdjustmentSubjectId());
+        FmsSubjectDO adjustmentClosingSubject = subjectMap.get(closing.getAdjustmentClosingSubjectId());
+        FmsSubjectDO otherClosingSubject = subjectMap.get(closing.getOtherClosingSubjectId());
+        if (adjustmentSubject == null
+                || !ObjUtil.equal(adjustmentSubject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                || parentIds.contains(adjustmentSubject.getId())
+                || adjustmentClosingSubject == null
+                || parentIds.contains(adjustmentClosingSubject.getId())
+                || ObjUtil.equal(adjustmentClosingSubject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                || otherClosingSubject == null
+                || parentIds.contains(otherClosingSubject.getId())
+                || ObjUtil.equal(otherClosingSubject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())) {
+            throw exception(CLOSING_PROFIT_LOSS_SETTINGS_INVALID);
+        }
+    }
+
+    /**
+     * 构造结转损益凭证分录
+     *
+     * 逐个末级损益科目按余额方向生成结转分录，并汇总生成目标结转科目分录；
+     * gain 为 true 时只生成收益科目，false 时只生成损失科目，null 时合并生成
+     *
+     * @param closing 结账方案
+     * @param subjects 账套下的科目列表
+     * @param parentIds 父级科目编号集合
+     * @param balanceMap 科目编号到余额的 Map
+     * @param ledgerEntries 当前期间凭证分录列表
+     * @param gain 是否收益科目，null 表示全部
+     * @return 凭证分录列表
+     */
+    private List<FmsVoucherEntrySaveReqVO> buildProfitLossEntries(FmsClosingSchemeDO closing,
+            List<FmsSubjectDO> subjects, Set<Long> parentIds,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap,
+            List<FmsLedgerEntryVO> ledgerEntries, Boolean gain) {
+        List<FmsVoucherEntrySaveReqVO> entries = new ArrayList<>();
+        Map<Long, BigDecimal> targetAmountMap = new LinkedHashMap<>();
+        String digest = closing.getDigest();
+        boolean reverseBalance = closing.getReverseBalance() == null || closing.getReverseBalance();
+        // 1. 逐个末级损益科目生成结转分录，跳过无余额和不属于当前收益损失分类的科目
+        for (FmsSubjectDO subject : subjects) {
+            if (ObjUtil.notEqual(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                    || parentIds.contains(subject.getId())) {
+                continue;
+            }
+            FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(subject.getId());
+            BigDecimal amount = balance == null ? BigDecimal.ZERO
+                    : NumberUtils.zeroIfNull(balance.getPeriodDebitAmount())
+                    .subtract(NumberUtils.zeroIfNull(balance.getPeriodCreditAmount()));
+            if (amount.signum() == 0
+                    || gain != null && gain != (amount.signum() < 0)) {
+                continue;
+            }
+            Long targetSubjectId = ObjUtil.equal(subject.getId(),
+                    closing.getPriorYearAdjustmentSubjectId())
+                    ? closing.getAdjustmentClosingSubjectId() : closing.getOtherClosingSubjectId();
+            Map<List<FmsVoucherEntryDO.AuxiliaryItem>, BigDecimal> auxiliaryAmountMap =
+                    buildProfitLossAuxiliaryAmountMap(subject, amount, ledgerEntries);
+            auxiliaryAmountMap.forEach((auxiliaries, auxiliaryAmount) -> {
+                if (auxiliaryAmount.signum() == 0) {
+                    return;
+                }
+                boolean normalCredit = ObjUtil.equal(subject.getBalanceDirection(),
+                        FmsDebitCreditDirectionEnum.CREDIT.getType());
+                boolean abnormalBalance = normalCredit && auxiliaryAmount.signum() > 0
+                        || !normalCredit && auxiliaryAmount.signum() < 0;
+                boolean sourceDebit = reverseBalance || abnormalBalance
+                        ? auxiliaryAmount.signum() < 0 : normalCredit;
+                BigDecimal transferAmount = auxiliaryAmount.abs();
+                FmsVoucherEntrySaveReqVO entry = buildEntry(digest, subject.getId(),
+                        sourceDebit ? transferAmount : BigDecimal.ZERO,
+                        sourceDebit ? BigDecimal.ZERO : transferAmount);
+                entry.setAuxiliaries(convertList(auxiliaries, auxiliary ->
+                        new FmsVoucherEntrySaveReqVO.AuxiliaryItem()
+                                .setTypeId(auxiliary.getTypeId()).setItemId(auxiliary.getItemId())));
+                entries.add(entry);
+                targetAmountMap.merge(targetSubjectId,
+                        sourceDebit ? transferAmount.negate() : transferAmount, BigDecimal::add);
+            });
+        }
+        // 2. 按目标结转科目汇总生成分录
+        targetAmountMap.forEach((subjectId, amount) -> {
+            if (amount.signum() != 0) {
+                entries.add(buildEntry(digest, subjectId,
+                        amount.signum() > 0 ? amount : BigDecimal.ZERO,
+                        amount.signum() < 0 ? amount.abs() : BigDecimal.ZERO));
+            }
+        });
+        return entries;
+    }
+
+    /**
+     * 按辅助核算组合汇总损益科目发生额
+     *
+     * 未启用辅助核算时直接返回科目汇总发生额；启用辅助核算时保留原分录的辅助核算组合，保证生成的结转分录满足科目辅助核算校验，并将每个辅助核算项目一并结平
+     *
+     * @param subject 损益科目
+     * @param amount 科目发生额
+     * @param ledgerEntries 当前期间凭证分录列表
+     * @return 辅助核算组合和发生额 Map
+     */
+    private Map<List<FmsVoucherEntryDO.AuxiliaryItem>, BigDecimal> buildProfitLossAuxiliaryAmountMap(
+            FmsSubjectDO subject, BigDecimal amount, List<FmsLedgerEntryVO> ledgerEntries) {
+        if (CollUtil.isEmpty(subject.getAuxiliaryTypeIds())) {
+            return Collections.singletonMap(Collections.emptyList(), amount);
+        }
+        Map<List<FmsVoucherEntryDO.AuxiliaryItem>, BigDecimal> amountMap = new LinkedHashMap<>();
+        for (FmsLedgerEntryVO entry : ledgerEntries) {
+            if (ObjUtil.notEqual(entry.getSubjectId(), subject.getId())) {
+                continue;
+            }
+            amountMap.merge(entry.getAuxiliaries(), NumberUtils.zeroIfNull(entry.getDebitAmount())
+                            .subtract(NumberUtils.zeroIfNull(entry.getCreditAmount())), BigDecimal::add);
+        }
+        return amountMap;
+    }
+
+    /**
+     * 计算常规结账方案的来源科目结转金额
+     *
+     * 按取数时间类型选择期初、期末、本期或本年累计口径，再按取数规则返回余额或发生额
+     *
+     * @param closing 结账方案
+     * @param balanceMap 科目编号到余额的 Map
+     * @return 结转金额
+     */
+    private BigDecimal calculateClosingSchemeBalance(FmsClosingSchemeDO closing,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap) {
+        FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(closing.getSubjectId());
+        if (balance == null) {
+            return BigDecimal.ZERO;
+        }
+        // 期初、年初或期末余额口径
+        boolean openingBalance = ObjectUtils.equalsAny(closing.getTimeType(),
+                FmsClosingTimeTypeEnum.PERIOD_BEGIN.getType(), FmsClosingTimeTypeEnum.YEAR_BEGIN.getType());
+        BigDecimal debitBalance = openingBalance
+                ? NumberUtils.zeroIfNull(balance.getOpeningDebitAmount())
+                : NumberUtils.zeroIfNull(balance.getEndingDebitAmount());
+        BigDecimal creditBalance = openingBalance
+                ? NumberUtils.zeroIfNull(balance.getOpeningCreditAmount())
+                : NumberUtils.zeroIfNull(balance.getEndingCreditAmount());
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.BALANCE.getRule())) {
+            return debitBalance.subtract(creditBalance).abs();
+        }
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                || ObjUtil.equal(closing.getFormulaRule(),
+                        FmsFormulaRuleEnum.SUBJECT_DEBIT_BALANCE.getRule())) {
+            return debitBalance;
+        }
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.CREDIT_BALANCE.getRule())
+                || ObjUtil.equal(closing.getFormulaRule(),
+                        FmsFormulaRuleEnum.SUBJECT_CREDIT_BALANCE.getRule())) {
+            return creditBalance;
+        }
+        // 本期或本年累计发生额口径
+        BigDecimal debitAmount = ObjUtil.equal(closing.getTimeType(),
+                FmsClosingTimeTypeEnum.YEAR_BEGIN.getType())
+                ? NumberUtils.zeroIfNull(balance.getYearDebitAmount())
+                : NumberUtils.zeroIfNull(balance.getPeriodDebitAmount());
+        BigDecimal creditAmount = ObjUtil.equal(closing.getTimeType(),
+                FmsClosingTimeTypeEnum.YEAR_BEGIN.getType())
+                ? NumberUtils.zeroIfNull(balance.getYearCreditAmount())
+                : NumberUtils.zeroIfNull(balance.getPeriodCreditAmount());
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.DEBIT_AMOUNT.getRule())) {
+            return debitAmount;
+        }
+        if (ObjUtil.equal(closing.getFormulaRule(), FmsFormulaRuleEnum.CREDIT_AMOUNT.getRule())) {
+            return creditAmount;
+        }
+        return debitAmount.subtract(creditAmount).abs();
+    }
+
+    /**
+     * 按科目规则的金额比例构造常规结账凭证分录
+     *
+     * @param closing 结账方案
+     * @param balance 结转金额
+     * @return 凭证分录列表
+     */
+    private List<FmsVoucherEntrySaveReqVO> buildRegularClosingEntries(
+            FmsClosingSchemeDO closing, BigDecimal balance) {
+        // 逐条科目规则按比例分摊结转金额
+        List<FmsVoucherEntrySaveReqVO> entries = new ArrayList<>();
+        for (FmsClosingSchemeDO.SubjectRule subjectRule : closing.getSubjectRules()) {
+            BigDecimal amount = balance.multiply(subjectRule.getAmountRatio())
+                    .divide(NumberUtils.ONE_HUNDRED, 2, RoundingMode.HALF_UP);
+            entries.add(buildEntry(subjectRule.getDigest(), subjectRule.getSubjectId(),
+                    ObjUtil.equal(subjectRule.getDirection(), FmsDebitCreditDirectionEnum.DEBIT.getType())
+                            ? amount : BigDecimal.ZERO,
+                    ObjUtil.equal(subjectRule.getDirection(), FmsDebitCreditDirectionEnum.CREDIT.getType())
+                            ? amount : BigDecimal.ZERO));
+        }
+        return entries;
+    }
+
+    /**
+     * 按科目规则的金额比例构造专用结转凭证分录
+     *
+     * 借贷两侧分别按比例分摊，每侧最后一条分录倒挤剩余金额，保证合计等于结转金额
+     *
+     * @param closing 结账方案
+     * @param balance 结转金额
+     * @return 凭证分录列表
+     */
+    private List<FmsVoucherEntrySaveReqVO> buildSpecialClosingEntries(
+            FmsClosingSchemeDO closing, BigDecimal balance) {
+        BigDecimal debitRatio = getDirectionRatio(
+                closing.getSubjectRules(), FmsDebitCreditDirectionEnum.DEBIT.getType());
+        BigDecimal creditRatio = getDirectionRatio(
+                closing.getSubjectRules(), FmsDebitCreditDirectionEnum.CREDIT.getType());
+        int debitRemainingCount = (int) closing.getSubjectRules().stream()
+                .filter(item -> ObjUtil.equal(item.getDirection(),
+                        FmsDebitCreditDirectionEnum.DEBIT.getType())).count();
+        int creditRemainingCount = closing.getSubjectRules().size() - debitRemainingCount;
+        BigDecimal allocatedDebitAmount = BigDecimal.ZERO;
+        BigDecimal allocatedCreditAmount = BigDecimal.ZERO;
+        List<FmsVoucherEntrySaveReqVO> entries = new ArrayList<>();
+        for (FmsClosingSchemeDO.SubjectRule subjectRule : closing.getSubjectRules()) {
+            boolean debit = ObjUtil.equal(subjectRule.getDirection(),
+                    FmsDebitCreditDirectionEnum.DEBIT.getType());
+            BigDecimal amount;
+            if (debit) {
+                debitRemainingCount--;
+                amount = debitRemainingCount == 0 ? balance.subtract(allocatedDebitAmount)
+                        : balance.multiply(subjectRule.getAmountRatio())
+                                .divide(debitRatio, 2, RoundingMode.HALF_UP);
+                allocatedDebitAmount = allocatedDebitAmount.add(amount);
+            } else {
+                creditRemainingCount--;
+                amount = creditRemainingCount == 0 ? balance.subtract(allocatedCreditAmount)
+                        : balance.multiply(subjectRule.getAmountRatio())
+                                .divide(creditRatio, 2, RoundingMode.HALF_UP);
+                allocatedCreditAmount = allocatedCreditAmount.add(amount);
+            }
+            entries.add(buildEntry(subjectRule.getDigest(), subjectRule.getSubjectId(),
+                    debit ? amount : BigDecimal.ZERO, debit ? BigDecimal.ZERO : amount));
+        }
+        return entries;
+    }
+
+    /**
+     * 汇总科目规则中指定借贷方向的金额比例
+     *
+     * @param subjectRules 科目规则
+     * @param direction 借贷方向
+     * @return 金额比例合计
+     */
+    private BigDecimal getDirectionRatio(List<FmsClosingSchemeDO.SubjectRule> subjectRules, Integer direction) {
+        return sumBigDecimal(filterList(subjectRules,
+                        item -> ObjUtil.equal(item.getDirection(), direction)),
+                FmsClosingSchemeDO.SubjectRule::getAmountRatio);
+    }
+
+    /**
+     * 判断是否为专用结转方案（转出未交增值税、计提地税、计提所得税）
+     *
+     * @param closing 结账方案
+     * @return 是否专用结转方案
+     */
+    private boolean isSpecialClosing(FmsClosingSchemeDO closing) {
+        return ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.UNPAID_VAT.getType())
+                || ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.LOCAL_TAX.getType())
+                || ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.INCOME_TAX.getType());
+    }
+
+    /**
+     * 获得单个会计期间的科目余额 Map
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     * @return 科目编号到余额的 Map
+     */
+    private Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(
+            Long accountSetId, YearMonth month, Long userId) {
+        return getSubjectBalanceMap(accountSetId, month, month, userId);
+    }
+
+    /**
+     * 获得月份区间的科目余额 Map，树形余额扁平化后按科目编号存放
+     *
+     * @param accountSetId 账套编号
+     * @param startMonth 开始月份
+     * @param endMonth 结束月份
+     * @param userId 用户编号
+     * @return 科目编号到余额的 Map
+     */
+    private Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(
+            Long accountSetId, YearMonth startMonth, YearMonth endMonth, Long userId) {
+        FmsLedgerListReqVO listReqVO = new FmsLedgerListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(startMonth.toString()).setEndMonth(endMonth.toString());
+        Map<Long, FmsLedgerSubjectBalanceRespVO> result = new LinkedHashMap<>();
+        flattenBalances(ledgerService.getSubjectBalanceList(listReqVO, userId), result);
+        return result;
+    }
+
+    /**
+     * 递归扁平化树形科目余额到 Map
+     *
+     * @param balances 树形科目余额
+     * @param result 科目编号到余额的 Map
+     */
+    private void flattenBalances(List<FmsLedgerSubjectBalanceRespVO> balances,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> result) {
+        for (FmsLedgerSubjectBalanceRespVO balance : balances) {
+            result.put(balance.getSubjectId(), balance);
+            flattenBalances(balance.getChildren(), result);
+        }
+    }
+
+    /**
+     * 构造凭证分录
+     *
+     * @param digest 摘要
+     * @param subjectId 科目编号
+     * @param debitAmount 借方金额
+     * @param creditAmount 贷方金额
+     * @return 凭证分录
+     */
+    private FmsVoucherEntrySaveReqVO buildEntry(String digest, Long subjectId, BigDecimal debitAmount, BigDecimal creditAmount) {
+        return new FmsVoucherEntrySaveReqVO().setDigest(digest).setSubjectId(subjectId)
+                .setDebitAmount(debitAmount).setCreditAmount(creditAmount);
+    }
+
+    /**
+     * 校验常规方案已启用期末结转
+     *
+     * @param closing 结账方案
+     */
+    private void validatePeriodEndClosing(FmsClosingSchemeDO closing) {
+        if (ObjUtil.equal(closing.getType(), FmsClosingTypeEnum.REGULAR.getType())
+                && !Boolean.TRUE.equals(closing.getPeriodEnd())) {
+            throw exception(CLOSING_SCHEME_NOT_PERIOD_END);
+        }
+    }
+
+    /**
+     * 校验账套写权限、初始化状态，且指定期间为当前会计期间
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 用户编号
+     * @return 已校验的账套
+     */
+    private FmsAccountSetDO validateCurrentPeriod(Long accountSetId, String month, Long userId) {
+        // 1. 校验账套写权限并锁定账套，避免同一账套并发生成结转凭证
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        accountSetService.lockAccountSet(accountSetId);
+
+        // 2. 校验账套已完成初始化
+        if (ObjUtil.notEqual(accountSet.getInitialized(), true) || accountSet.getStartTime() == null) {
+            throw exception(ACCOUNT_SET_NOT_INITIALIZED);
+        }
+
+        // 3. 校验指定期间为账套当前会计期间
+        String currentMonth = closingPeriodService.getCurrentMonth(accountSetId, accountSet.getStartTime()).toString();
+        if (!ObjUtil.equal(currentMonth, month)) {
+            throw exception(CLOSING_NOT_CURRENT_PERIOD);
+        }
+        return accountSet;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetService.java
new file mode 100644
index 0000000..4e7721b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetService.java
@@ -0,0 +1,122 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetInitializeReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * FMS 账套 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsAccountSetService {
+
+    /**
+     * 创建账套
+     *
+     * @param createReqVO 创建信息
+     * @param userId 当前用户编号
+     * @return 账套编号
+     */
+    Long createAccountSet(FmsAccountSetSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新账套
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 当前用户编号
+     */
+    void updateAccountSet(FmsAccountSetSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 更新账套会计制度
+     *
+     * @param accountSetId 账套编号
+     * @param standard 会计制度
+     * @param userId 用户编号
+     */
+    void updateAccountSetStandard(Long accountSetId, Integer standard, Long userId);
+
+    /**
+     * 初始化账套
+     *
+     * @param initializeReqVO 初始化信息
+     * @param userId 当前用户编号
+     */
+    void initializeAccountSet(FmsAccountSetInitializeReqVO initializeReqVO, Long userId);
+
+    /**
+     * 获得账套
+     *
+     * @param id 账套编号
+     * @return 账套
+     */
+    FmsAccountSetDO getAccountSet(Long id);
+
+    /**
+     * 校验账套存在并返回账套
+     *
+     * @param id 账套编号
+     * @return 账套
+     */
+    FmsAccountSetDO validateAccountSetExists(Long id);
+
+    /**
+     * 校验账套读取权限
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 账套
+     */
+    FmsAccountSetDO validateAccountSetReadPermission(Long accountSetId, Long userId);
+
+    /**
+     * 校验账套写入权限
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 账套
+     */
+    FmsAccountSetDO validateAccountSetWritePermission(Long accountSetId, Long userId);
+
+    /**
+     * 校验账套主管权限
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 账套
+     */
+    FmsAccountSetDO validateAccountSetOwnerPermission(Long accountSetId, Long userId);
+
+    /**
+     * 锁定账套，使同一账套的关键写操作串行执行
+     *
+     * @param accountSetId 账套编号
+     */
+    void lockAccountSet(Long accountSetId);
+
+    /**
+     * 获得指定账套列表
+     *
+     * @param ids 账套编号数组
+     * @return 账套列表
+     */
+    List<FmsAccountSetDO> getAccountSetList(Collection<Long> ids);
+
+    /**
+     * 获得指定账套 Map
+     *
+     * @param ids 账套编号数组
+     * @return 账套 Map
+     */
+    default Map<Long, FmsAccountSetDO> getAccountSetMap(Collection<Long> ids) {
+        return convertMap(getAccountSetList(ids), FmsAccountSetDO::getId);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetServiceImpl.java
new file mode 100644
index 0000000..388c664
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetServiceImpl.java
@@ -0,0 +1,230 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetInitializeReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAccountSetMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountUserLevelEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsCurrencyPresetEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingTemplateService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_ALREADY_INITIALIZED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_ACCESS_DENIED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_CODE_DUPLICATE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_INITIALIZE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_INITIALIZE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_UPDATE_SUCCESS;
+
+/**
+ * FMS 账套 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsAccountSetServiceImpl implements FmsAccountSetService {
+
+    @Resource
+    private FmsAccountSetMapper accountSetMapper;
+
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsAccountUserService accountUserService;
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsCurrencyService currencyService;
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsFinanceParameterService financeParameterService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private FmsVoucherWordService voucherWordService;
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsSubjectService subjectService;
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsClosingSchemeService closingSchemeService;
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsFinanceIndicatorService financeIndicatorService;
+    @Resource
+    @Lazy // 延迟加载，避免循环引用报错
+    private FmsClosingTemplateService closingTemplateService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_ACCOUNT_SET_TYPE, subType = FMS_ACCOUNT_SET_CREATE_SUB_TYPE,
+            bizNo = "{{#accountSetId}}", success = FMS_ACCOUNT_SET_CREATE_SUCCESS)
+    public Long createAccountSet(FmsAccountSetSaveReqVO createReqVO, Long userId) {
+        // 1. 校验公司编码唯一
+        validateAccountSetCompanyCodeUnique(null, createReqVO.getCompanyCode());
+
+        // 2. 创建未初始化账套
+        FmsAccountSetDO accountSet = BeanUtils.toBean(createReqVO, FmsAccountSetDO.class)
+                .setId(null).setInitialized(false);
+        accountSetMapper.insert(accountSet);
+
+        // 3. 将创建人加入账套
+        accountUserService.createAccountOwner(accountSet.getId(), userId);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("accountSetId", accountSet.getId());
+        return accountSet.getId();
+    }
+
+    @Override
+    @LogRecord(type = FMS_ACCOUNT_SET_TYPE, subType = FMS_ACCOUNT_SET_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_ACCOUNT_SET_UPDATE_SUCCESS)
+    public void updateAccountSet(FmsAccountSetSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套主管权限
+        FmsAccountSetDO accountSet = validateAccountSetOwnerPermission(updateReqVO.getId(), userId);
+        // 1.2 校验公司编码唯一
+        validateAccountSetCompanyCodeUnique(updateReqVO.getId(), updateReqVO.getCompanyCode());
+
+        // 2. 更新账套基本信息
+        accountSetMapper.updateById(BeanUtils.toBean(updateReqVO, FmsAccountSetDO.class));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(accountSet, FmsAccountSetSaveReqVO.class));
+    }
+
+    @Override
+    public void updateAccountSetStandard(Long accountSetId, Integer standard, Long userId) {
+        // 1. 校验账套写权限
+        validateAccountSetWritePermission(accountSetId, userId);
+
+        // 2. 更新账套会计制度
+        accountSetMapper.updateById(new FmsAccountSetDO().setId(accountSetId).setStandard(standard));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_ACCOUNT_SET_TYPE, subType = FMS_ACCOUNT_SET_INITIALIZE_SUB_TYPE,
+            bizNo = "{{#initializeReqVO.accountSetId}}", success = FMS_ACCOUNT_SET_INITIALIZE_SUCCESS)
+    public void initializeAccountSet(FmsAccountSetInitializeReqVO initializeReqVO, Long userId) {
+        // 1.1 校验账套成员写权限；未初始化账套由可维护成员完成初始化
+        FmsAccountSetDO accountSet = validateAccountSetWritePermission(initializeReqVO.getAccountSetId(), userId);
+        // 1.2 校验账套初始化状态
+        FmsCurrencyPresetEnum presetCurrency = FmsCurrencyPresetEnum.valueOfCode(initializeReqVO.getCurrencyCode());
+        if (Boolean.TRUE.equals(accountSet.getInitialized())) {
+            throw exception(ACCOUNT_SET_ALREADY_INITIALIZED);
+        }
+
+        // 2. 初始化账套基础数据
+        FmsCurrencyDO currency = currencyService.initializeStandardCurrency(accountSet.getId(), presetCurrency);
+        financeParameterService.initializeFinanceParameter(accountSet.getId(), initializeReqVO);
+        voucherWordService.initializeDefaultVoucherWords(accountSet.getId());
+        auxiliaryTypeService.initializeDefaultTypes(accountSet.getId());
+        subjectService.initializeDefaultSubjects(accountSet.getId());
+        closingTemplateService.initializeClosingTemplates(accountSet.getId(), userId);
+        closingSchemeService.initializeDefaultClosingSchemes(accountSet.getId(), userId);
+        financeIndicatorService.initializeDefaultFinanceIndicators(accountSet.getId(), userId);
+
+        // 3. 回写账套初始化信息和本位币
+        accountSetMapper.updateById(new FmsAccountSetDO().setId(accountSet.getId())
+                .setInitialized(true).setStandard(initializeReqVO.getStandard())
+                .setStartTime(LocalDateTimeUtils.beginOfMonth(initializeReqVO.getStartTime()))
+                .setCurrencyId(currency.getId()));
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("accountSet", accountSet);
+    }
+
+    @Override
+    public FmsAccountSetDO getAccountSet(Long id) {
+        return accountSetMapper.selectById(id);
+    }
+
+    @Override
+    public FmsAccountSetDO validateAccountSetExists(Long id) {
+        FmsAccountSetDO accountSet = getAccountSet(id);
+        if (accountSet == null) {
+            throw exception(ACCOUNT_SET_NOT_EXISTS);
+        }
+        return accountSet;
+    }
+
+    @Override
+    public FmsAccountSetDO validateAccountSetReadPermission(Long accountSetId, Long userId) {
+        FmsAccountSetDO accountSet = validateAccountSetExists(accountSetId);
+        FmsAccountUserDO accountUser = accountUserService.getAccountUser(accountSetId, userId);
+        if (accountUser == null || !FmsAccountUserLevelEnum.isReadable(accountUser.getLevel())) {
+            throw exception(ACCOUNT_SET_ACCESS_DENIED);
+        }
+        return accountSet;
+    }
+
+    @Override
+    public FmsAccountSetDO validateAccountSetWritePermission(Long accountSetId, Long userId) {
+        FmsAccountSetDO accountSet = validateAccountSetExists(accountSetId);
+        FmsAccountUserDO accountUser = accountUserService.getAccountUser(accountSetId, userId);
+        if (accountUser == null || !FmsAccountUserLevelEnum.isWritable(accountUser.getLevel())) {
+            throw exception(ACCOUNT_SET_ACCESS_DENIED);
+        }
+        return accountSet;
+    }
+
+    @Override
+    public void lockAccountSet(Long accountSetId) {
+        FmsAccountSetDO accountSet = accountSetMapper.selectByIdForUpdate(accountSetId);
+        if (accountSet == null) {
+            throw exception(ACCOUNT_SET_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public FmsAccountSetDO validateAccountSetOwnerPermission(Long accountSetId, Long userId) {
+        FmsAccountSetDO accountSet = validateAccountSetExists(accountSetId);
+        FmsAccountUserDO accountUser = accountUserService.getAccountUser(accountSetId, userId);
+        if (accountUser == null || !FmsAccountUserLevelEnum.isOwner(accountUser.getLevel())) {
+            throw exception(ACCOUNT_SET_ACCESS_DENIED);
+        }
+        return accountSet;
+    }
+
+    @Override
+    public List<FmsAccountSetDO> getAccountSetList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return accountSetMapper.selectByIds(ids);
+    }
+
+    private void validateAccountSetCompanyCodeUnique(Long id, String companyCode) {
+        FmsAccountSetDO accountSet = accountSetMapper.selectByCompanyCode(companyCode);
+        if (accountSet != null && ObjUtil.notEqual(id, accountSet.getId())) {
+            throw exception(ACCOUNT_SET_CODE_DUPLICATE);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserService.java
new file mode 100644
index 0000000..aee1dca
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserService.java
@@ -0,0 +1,65 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountuser.FmsAccountUserUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+
+import java.util.List;
+
+/**
+ * FMS 账套用户 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsAccountUserService {
+
+    /**
+     * 创建账套主管关系
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     */
+    void createAccountOwner(Long accountSetId, Long userId);
+
+    /**
+     * 获得当前用户的账套关系列表
+     *
+     * @param userId 用户编号
+     * @return 账套关系列表
+     */
+    List<FmsAccountUserDO> getAccountUserList(Long userId);
+
+    /**
+     * 获得账套用户关系
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 账套用户关系
+     */
+    FmsAccountUserDO getAccountUser(Long accountSetId, Long userId);
+
+    /**
+     * 设置当前用户的默认账套
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     */
+    void updateAccountSetDefaultStatus(Long accountSetId, Long userId);
+
+    /**
+     * 获得账套成员列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 账套成员列表
+     */
+    List<FmsAccountUserDO> getAccountUserList(Long accountSetId, Long userId);
+
+    /**
+     * 更新账套成员列表
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 当前用户编号
+     */
+    void updateAccountUserList(FmsAccountUserUpdateReqVO updateReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserServiceImpl.java
new file mode 100644
index 0000000..ff242fc
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserServiceImpl.java
@@ -0,0 +1,140 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountuser.FmsAccountUserUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAccountUserMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountUserLevelEnum;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_MEMBER_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_MEMBER_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_ACCOUNT_SET_TYPE;
+
+/**
+ * FMS 账套用户 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsAccountUserServiceImpl implements FmsAccountUserService {
+
+    @Resource
+    private FmsAccountUserMapper accountUserMapper;
+
+    @Resource
+    @Lazy // 延迟加载，避免与账套 Service 循环依赖
+    private FmsAccountSetService accountSetService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @Override
+    public void createAccountOwner(Long accountSetId, Long userId) {
+        boolean defaultStatus = accountUserMapper.selectCountByUserId(userId) == 0;
+        FmsAccountUserDO accountUser = new FmsAccountUserDO().setAccountSetId(accountSetId).setUserId(userId)
+                .setDefaultStatus(defaultStatus).setFounder(true)
+                .setLevel(FmsAccountUserLevelEnum.OWNER.getLevel());
+        accountUserMapper.insert(accountUser);
+    }
+
+    @Override
+    public List<FmsAccountUserDO> getAccountUserList(Long userId) {
+        return accountUserMapper.selectListByUserId(userId);
+    }
+
+    @Override
+    public FmsAccountUserDO getAccountUser(Long accountSetId, Long userId) {
+        return accountUserMapper.selectByAccountSetIdAndUserId(accountSetId, userId);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updateAccountSetDefaultStatus(Long accountSetId, Long userId) {
+        // 1. 校验用户属于目标账套
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 清除用户原默认账套，再设置目标账套
+        accountUserMapper.updateDefaultStatusByUserId(userId);
+        accountUserMapper.updateDefaultStatusByAccountSetIdAndUserId(accountSetId, userId);
+    }
+
+    @Override
+    public List<FmsAccountUserDO> getAccountUserList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询账套成员
+        return accountUserMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_ACCOUNT_SET_TYPE, subType = FMS_ACCOUNT_SET_MEMBER_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.accountSetId}}", success = FMS_ACCOUNT_SET_MEMBER_UPDATE_SUCCESS)
+    public void updateAccountUserList(FmsAccountUserUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套主管权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetOwnerPermission(
+                updateReqVO.getAccountSetId(), userId);
+        // 1.2 查询现有成员并校验授权成员
+        List<FmsAccountUserDO> accountUsers = accountUserMapper.selectListByAccountSetId(accountSet.getId());
+        Set<Long> founderUserIds = convertSet(accountUsers, FmsAccountUserDO::getUserId,
+                accountUser -> Boolean.TRUE.equals(accountUser.getFounder()));
+        Map<Long, Integer> memberLevelMap = convertMap(updateReqVO.getMembers(),
+                FmsAccountUserUpdateReqVO.Member::getUserId, FmsAccountUserUpdateReqVO.Member::getLevel);
+        Set<Long> memberUserIds = new HashSet<>(memberLevelMap.keySet());
+        memberUserIds.removeAll(founderUserIds);
+        adminUserApi.validateUserList(memberUserIds);
+
+        // 2.1 移出取消授权的成员
+        Set<Long> currentMemberUserIds = convertSet(accountUsers, FmsAccountUserDO::getUserId,
+                accountUser -> Boolean.FALSE.equals(accountUser.getFounder()));
+        Set<Long> deleteUserIds = new HashSet<>(currentMemberUserIds);
+        deleteUserIds.removeAll(memberUserIds);
+        if (CollUtil.isNotEmpty(deleteUserIds)) {
+            accountUserMapper.deleteByAccountSetIdAndUserIds(accountSet.getId(), deleteUserIds);
+        }
+
+        // 2.2 更新已有成员的权限级别
+        List<FmsAccountUserDO> updateAccountUsers = convertList(accountUsers,
+                accountUser -> new FmsAccountUserDO().setId(accountUser.getId())
+                        .setLevel(memberLevelMap.get(accountUser.getUserId())),
+                accountUser -> Boolean.FALSE.equals(accountUser.getFounder())
+                        && memberLevelMap.containsKey(accountUser.getUserId())
+                        && ObjUtil.notEqual(accountUser.getLevel(), memberLevelMap.get(accountUser.getUserId())));
+        if (CollUtil.isNotEmpty(updateAccountUsers)) {
+            accountUserMapper.updateBatch(updateAccountUsers);
+        }
+
+        // 2.3 加入新增授权的成员
+        Set<Long> createUserIds = new HashSet<>(memberUserIds);
+        createUserIds.removeAll(currentMemberUserIds);
+        if (CollUtil.isNotEmpty(createUserIds)) {
+            accountUserMapper.insertBatch(convertList(createUserIds,
+                    memberUserId -> new FmsAccountUserDO().setAccountSetId(accountSet.getId())
+                            .setUserId(memberUserId).setDefaultStatus(false).setFounder(false)
+                            .setLevel(memberLevelMap.get(memberUserId))));
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("accountSet", accountSet);
+    }
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationService.java
new file mode 100644
index 0000000..041e0f8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationService.java
@@ -0,0 +1,61 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 辅助核算组合 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsAuxiliaryCombinationService {
+
+    /**
+     * 为凭证分录获得或创建辅助核算组合
+     *
+     * @param accountSetId 账套编号
+     * @param entries 凭证分录数组
+     */
+    void setAuxiliaryCombinationIds(Long accountSetId, List<FmsVoucherEntryDO> entries);
+
+    /**
+     * 保存辅助核算组合
+     *
+     * @param accountSetId 账套编号
+     * @param subjectId 科目编号
+     * @param items 辅助核算项目数组
+     * @return 辅助核算组合
+     */
+    FmsAuxiliaryCombinationDO saveAuxiliaryCombination(Long accountSetId, Long subjectId,
+                                                       List<FmsAuxiliaryCombinationDO.AuxiliaryItem> items);
+
+    /**
+     * 获得指定科目的辅助核算组合数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号数组
+     * @return 辅助核算组合数量
+     */
+    Long getAuxiliaryCombinationCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 迁移科目的辅助核算组合
+     *
+     * @param accountSetId 账套编号
+     * @param subjectId 科目编号
+     * @param targetSubjectId 目标科目编号
+     */
+    void updateAuxiliaryCombinationSubject(Long accountSetId, Long subjectId, Long targetSubjectId);
+
+    /**
+     * 删除包含指定辅助核算项目的组合
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryItemIds 辅助核算项目编号数组
+     */
+    void deleteAuxiliaryCombinationByAuxiliaryItemIds(Long accountSetId, Collection<Long> auxiliaryItemIds);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationServiceImpl.java
new file mode 100644
index 0000000..2b54cf9
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationServiceImpl.java
@@ -0,0 +1,141 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAuxiliaryCombinationMapper;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.anyMatch;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+/**
+ * FMS 辅助核算组合 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsAuxiliaryCombinationServiceImpl implements FmsAuxiliaryCombinationService {
+
+    @Resource
+    private FmsAuxiliaryCombinationMapper auxiliaryCombinationMapper;
+
+    @Override
+    public void setAuxiliaryCombinationIds(Long accountSetId, List<FmsVoucherEntryDO> entries) {
+        // 1. 一次加载账套已有的辅助核算组合
+        List<FmsAuxiliaryCombinationDO> combinations = auxiliaryCombinationMapper.selectListByAccountSetId(accountSetId);
+
+        // 2. 逐条复用或创建组合并回填分录
+        for (FmsVoucherEntryDO entry : entries) {
+            // 2.1 无辅助核算项目时，清空分录的组合编号
+            if (CollUtil.isEmpty(entry.getAuxiliaries())) {
+                entry.setAssistCombinationId(null);
+                continue;
+            }
+            // 2.2 转换辅助核算组合明细
+            List<FmsAuxiliaryCombinationDO.AuxiliaryItem> items = convertList(entry.getAuxiliaries(),
+                    auxiliary -> FmsAuxiliaryCombinationDO.AuxiliaryItem.builder()
+                            .type(auxiliary.getType()).typeId(auxiliary.getTypeId())
+                            .itemId(auxiliary.getItemId()).name(auxiliary.getName()).build());
+            // 2.3 复用或创建辅助核算组合
+            FmsAuxiliaryCombinationDO combination = CollUtil.findOne(combinations, item ->
+                    ObjUtil.equal(item.getSubjectId(), entry.getSubjectId()) && isSameCombination(item.getItems(), items));
+            if (combination == null) {
+                combination = new FmsAuxiliaryCombinationDO().setAccountSetId(accountSetId)
+                        .setSubjectId(entry.getSubjectId()).setItems(items);
+                auxiliaryCombinationMapper.insert(combination);
+                combinations.add(combination);
+            }
+            // 2.4 回填分录的辅助核算组合编号
+            entry.setAssistCombinationId(combination.getId());
+        }
+    }
+
+    @Override
+    public FmsAuxiliaryCombinationDO saveAuxiliaryCombination(Long accountSetId, Long subjectId,
+                                                              List<FmsAuxiliaryCombinationDO.AuxiliaryItem> items) {
+        // 1. 查询已有组合
+        FmsAuxiliaryCombinationDO combination = CollUtil.findOne(
+                auxiliaryCombinationMapper.selectListByAccountSetId(accountSetId),
+                item -> ObjUtil.equal(item.getSubjectId(), subjectId)
+                        && isSameCombination(item.getItems(), items));
+        if (combination != null) {
+            return combination;
+        }
+
+        // 2. 创建组合
+        combination = new FmsAuxiliaryCombinationDO().setAccountSetId(accountSetId)
+                .setSubjectId(subjectId).setItems(items);
+        auxiliaryCombinationMapper.insert(combination);
+        return combination;
+    }
+
+    @Override
+    public Long getAuxiliaryCombinationCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        return auxiliaryCombinationMapper.selectCountByAccountSetIdAndSubjectIds(accountSetId, subjectIds);
+    }
+
+    @Override
+    public void updateAuxiliaryCombinationSubject(Long accountSetId, Long subjectId, Long targetSubjectId) {
+        auxiliaryCombinationMapper.updateSubject(accountSetId, subjectId,
+                new FmsAuxiliaryCombinationDO().setSubjectId(targetSubjectId));
+    }
+
+    @Override
+    public void deleteAuxiliaryCombinationByAuxiliaryItemIds(
+            Long accountSetId, Collection<Long> auxiliaryItemIds) {
+        // 1. 校验辅助核算项目编号数组非空
+        if (CollUtil.isEmpty(auxiliaryItemIds)) {
+            return;
+        }
+
+        // 2. 查询包含指定辅助核算项目的组合
+        Set<Long> auxiliaryItemIdSet = new HashSet<>(auxiliaryItemIds);
+        List<FmsAuxiliaryCombinationDO> combinations = auxiliaryCombinationMapper
+                .selectListByAccountSetId(accountSetId);
+        List<Long> combinationIds = convertList(combinations, FmsAuxiliaryCombinationDO::getId,
+                combination -> CollUtil.isNotEmpty(combination.getItems())
+                        && anyMatch(combination.getItems(),
+                        item -> auxiliaryItemIdSet.contains(item.getItemId())));
+
+        // 3. 删除辅助核算组合
+        if (CollUtil.isNotEmpty(combinationIds)) {
+            auxiliaryCombinationMapper.deleteByIds(combinationIds);
+        }
+    }
+
+    /**
+     * 判断两个辅助核算组合是否相同
+     *
+     * @param left 左侧辅助核算项目数组
+     * @param right 右侧辅助核算项目数组
+     * @return 是否相同
+     */
+    private boolean isSameCombination(List<FmsAuxiliaryCombinationDO.AuxiliaryItem> left,
+                                      List<FmsAuxiliaryCombinationDO.AuxiliaryItem> right) {
+        // 项目数量不同，不是同一组合
+        if (CollUtil.size(left) != CollUtil.size(right)) {
+            return false;
+        }
+        // 按辅助核算类别和项目的固定顺序逐项比较
+        for (int index = 0; index < CollUtil.size(left); index++) {
+            FmsAuxiliaryCombinationDO.AuxiliaryItem leftItem = left.get(index);
+            FmsAuxiliaryCombinationDO.AuxiliaryItem rightItem = right.get(index);
+            if (ObjUtil.notEqual(leftItem.getTypeId(), rightItem.getTypeId())
+                    || ObjUtil.notEqual(leftItem.getItemId(), rightItem.getItemId())) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemService.java
new file mode 100644
index 0000000..150dfd3
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemService.java
@@ -0,0 +1,154 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+
+import java.util.List;
+import java.util.Collection;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * FMS 辅助核算项目 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsAuxiliaryItemService {
+
+    /**
+     * 创建辅助核算项目
+     *
+     * @param createReqVO 创建信息
+     * @param userId 当前用户编号
+     * @return 编号
+     */
+    Long createAuxiliaryItem(FmsAuxiliaryItemSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新辅助核算项目
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 当前用户编号
+     */
+    void updateAuxiliaryItem(FmsAuxiliaryItemSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除辅助核算项目
+     *
+     * @param accountSetId 账套编号
+     * @param ids 编号数组
+     * @param userId 当前用户编号
+     */
+    void deleteAuxiliaryItemList(Long accountSetId, List<Long> ids, Long userId);
+
+    /**
+     * 更新辅助核算项目状态
+     *
+     * @param accountSetId 账套编号
+     * @param id 编号
+     * @param status 状态
+     * @param userId 当前用户编号
+     */
+    void updateAuxiliaryItemStatus(Long accountSetId, Long id, Integer status, Long userId);
+
+    /**
+     * 导入辅助核算项目
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @param importItems 导入项目数组
+     * @param userId 当前用户编号
+     * @return 导入结果
+     */
+    FmsAuxiliaryItemImportRespVO importAuxiliaryItemList(Long accountSetId, Long auxiliaryTypeId,
+            List<FmsAuxiliaryItemImportExcelVO> importItems, Long userId);
+
+    /**
+     * 获得辅助核算项目分页
+     *
+     * @param pageReqVO 分页条件
+     * @param userId 当前用户编号
+     * @return 辅助核算项目分页
+     */
+    PageResult<FmsAuxiliaryItemDO> getAuxiliaryItemPage(
+            FmsAuxiliaryItemPageReqVO pageReqVO, Long userId);
+
+    /**
+     * 获得辅助核算项目
+     *
+     * @param accountSetId 账套编号
+     * @param id 辅助核算项目编号
+     * @param userId 当前用户编号
+     * @return 辅助核算项目
+     */
+    FmsAuxiliaryItemDO getAuxiliaryItem(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得辅助核算项目列表
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @param userId 当前用户编号
+     * @return 辅助核算项目列表
+     */
+    List<FmsAuxiliaryItemDO> getAuxiliaryItemList(
+            Long accountSetId, Long auxiliaryTypeId, Long userId);
+
+    /**
+     * 获得指定状态的辅助核算项目列表
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @param status 状态
+     * @param userId 当前用户编号
+     * @return 辅助核算项目列表
+     */
+    List<FmsAuxiliaryItemDO> getAuxiliaryItemListByAccountSetIdAndAuxiliaryTypeIdAndStatus(
+            Long accountSetId, Long auxiliaryTypeId, Integer status, Long userId);
+
+    /**
+     * 获得账套的全部辅助核算项目
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 辅助核算项目列表
+     */
+    List<FmsAuxiliaryItemDO> getAuxiliaryItemListByAccountSetId(Long accountSetId, Long userId);
+
+    /**
+     * 获得账套的辅助核算项目 Map
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 辅助核算项目 Map，键为“类别编号|项目编码”
+     */
+    default Map<String, FmsAuxiliaryItemDO> getAuxiliaryItemMapByTypeIdAndCode(
+            Long accountSetId, Long userId) {
+        return convertMap(getAuxiliaryItemListByAccountSetId(accountSetId, userId),
+                item -> item.getAuxiliaryTypeId() + "|" + item.getCode());
+    }
+
+    /**
+     * 获得指定辅助核算类别的项目数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @return 辅助核算项目数量
+     */
+    Long getAuxiliaryItemCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId);
+
+    /**
+     * 校验并获得辅助核算项目列表
+     *
+     * @param accountSetId 账套编号
+     * @param ids 辅助核算项目编号数组
+     * @return 辅助核算项目列表
+     */
+    List<FmsAuxiliaryItemDO> validateAuxiliaryItemList(Long accountSetId, Collection<Long> ids);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemServiceImpl.java
new file mode 100644
index 0000000..61419f7
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemServiceImpl.java
@@ -0,0 +1,329 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.validation.ValidationUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAuxiliaryItemMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherTemplateService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import jakarta.validation.ConstraintViolationException;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+
+/**
+ * FMS 辅助核算项目 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsAuxiliaryItemServiceImpl implements FmsAuxiliaryItemService {
+
+    @Resource
+    private FmsAuxiliaryItemMapper auxiliaryItemMapper;
+
+    @Resource
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private FmsVoucherService voucherService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private FmsVoucherTemplateService voucherTemplateService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private FmsInitialBalanceService initialBalanceService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_AUXILIARY_ITEM_TYPE, subType = FMS_AUXILIARY_ITEM_CREATE_SUB_TYPE,
+            bizNo = "{{#auxiliaryItemId}}", success = FMS_AUXILIARY_ITEM_CREATE_SUCCESS)
+    public Long createAuxiliaryItem(FmsAuxiliaryItemSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验辅助核算类别和编码唯一
+        validateAuxiliaryType(createReqVO.getAccountSetId(), createReqVO.getAuxiliaryTypeId());
+        validateAuxiliaryItemCodeUnique(null, createReqVO.getAccountSetId(),
+                createReqVO.getAuxiliaryTypeId(), createReqVO.getCode());
+
+        // 2. 创建辅助核算项目
+        FmsAuxiliaryItemDO auxiliaryItem = BeanUtils.toBean(createReqVO, FmsAuxiliaryItemDO.class)
+                .setId(null).setStatus(CommonStatusEnum.ENABLE.getStatus());
+        auxiliaryItemMapper.insert(auxiliaryItem);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("auxiliaryItemId", auxiliaryItem.getId());
+        return auxiliaryItem.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_AUXILIARY_ITEM_TYPE, subType = FMS_AUXILIARY_ITEM_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_AUXILIARY_ITEM_UPDATE_SUCCESS)
+    public void updateAuxiliaryItem(FmsAuxiliaryItemSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验辅助核算项目和所属类别
+        FmsAuxiliaryItemDO auxiliaryItem = validateAuxiliaryItemExists(
+                updateReqVO.getAccountSetId(), updateReqVO.getId());
+        if (ObjUtil.notEqual(auxiliaryItem.getAuxiliaryTypeId(), updateReqVO.getAuxiliaryTypeId())) {
+            throw exception(AUXILIARY_TYPE_NOT_EXISTS);
+        }
+        validateAuxiliaryType(updateReqVO.getAccountSetId(), updateReqVO.getAuxiliaryTypeId());
+        // 1.3 校验编码唯一
+        validateAuxiliaryItemCodeUnique(auxiliaryItem.getId(), updateReqVO.getAccountSetId(),
+                updateReqVO.getAuxiliaryTypeId(), updateReqVO.getCode());
+
+        // 2. 更新辅助核算项目
+        auxiliaryItemMapper.updateById(BeanUtils.toBean(updateReqVO, FmsAuxiliaryItemDO.class)
+                .setStatus(auxiliaryItem.getStatus()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_AUXILIARY_ITEM_TYPE, subType = FMS_AUXILIARY_ITEM_DELETE_SUB_TYPE,
+            bizNo = "{{#accountSetId}}", success = FMS_AUXILIARY_ITEM_DELETE_SUCCESS)
+    public void deleteAuxiliaryItemList(Long accountSetId, List<Long> ids, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验辅助核算项目
+        List<FmsAuxiliaryItemDO> auxiliaryItems = auxiliaryItemMapper
+                .selectListByIdsAndAccountSetId(ids, accountSetId);
+        if (auxiliaryItems.size() != new LinkedHashSet<>(ids).size()) {
+            throw exception(AUXILIARY_ITEM_NOT_EXISTS);
+        }
+        Set<Long> idSet = new LinkedHashSet<>(ids);
+        // 1.3 校验辅助核算项目未被业务引用
+        // 1.3.1 校验辅助核算项目未被凭证使用
+        Long voucherEntryCount = voucherService.getVoucherEntryCountByAuxiliaryItemIds(accountSetId, idSet);
+        if (voucherEntryCount > 0) {
+            throw exception(AUXILIARY_ITEM_VOUCHER_IN_USE, voucherEntryCount);
+        }
+        // 1.3.2 校验辅助核算项目未被凭证模板使用
+        Long voucherTemplateCount = voucherTemplateService
+                .getVoucherTemplateCountByAuxiliaryItemIds(accountSetId, idSet);
+        if (voucherTemplateCount > 0) {
+            throw exception(AUXILIARY_ITEM_VOUCHER_TEMPLATE_IN_USE, voucherTemplateCount);
+        }
+        // 1.3.3 校验辅助核算项目未被初始余额使用
+        Long initialBalanceCount = initialBalanceService
+                .getInitialBalanceCountByAuxiliaryItemIds(accountSetId, idSet);
+        if (initialBalanceCount > 0) {
+            throw exception(AUXILIARY_ITEM_INITIAL_BALANCE_IN_USE, initialBalanceCount);
+        }
+        // 2. 删除派生的辅助核算组合和辅助核算项目
+        auxiliaryCombinationService.deleteAuxiliaryCombinationByAuxiliaryItemIds(accountSetId, idSet);
+        auxiliaryItemMapper.deleteByIds(ids);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("auxiliaryItem", CollUtil.getFirst(auxiliaryItems));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_AUXILIARY_ITEM_TYPE, subType = FMS_AUXILIARY_ITEM_STATUS_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_AUXILIARY_ITEM_STATUS_SUCCESS)
+    public void updateAuxiliaryItemStatus(Long accountSetId, Long id, Integer status, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验辅助核算项目
+        FmsAuxiliaryItemDO auxiliaryItem = validateAuxiliaryItemExists(accountSetId, id);
+
+        // 2. 更新状态
+        auxiliaryItemMapper.updateById(new FmsAuxiliaryItemDO()
+                .setId(auxiliaryItem.getId()).setStatus(status));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public FmsAuxiliaryItemImportRespVO importAuxiliaryItemList(Long accountSetId, Long auxiliaryTypeId,
+            List<FmsAuxiliaryItemImportExcelVO> importItems, Long userId) {
+        // 1.1 校验导入数据非空
+        if (CollUtil.isEmpty(importItems)) {
+            throw exception(AUXILIARY_ITEM_IMPORT_LIST_IS_EMPTY);
+        }
+        // 1.2 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.3 校验辅助核算类别
+        FmsAuxiliaryTypeDO auxiliaryType = CollUtil.getFirst(auxiliaryTypeService
+                .validateAuxiliaryTypeList(accountSetId, Collections.singletonList(auxiliaryTypeId)));
+        // 1.4 加载已有辅助核算项目
+        Map<String, FmsAuxiliaryItemDO> itemMap = convertMap(
+                auxiliaryItemMapper.selectListByAccountSetIdAndAuxiliaryTypeId(accountSetId, auxiliaryTypeId),
+                FmsAuxiliaryItemDO::getCode);
+
+        // 2. 逐行导入辅助核算项目
+        Set<String> importCodes = new HashSet<>();
+        FmsAuxiliaryItemImportRespVO respVO = new FmsAuxiliaryItemImportRespVO()
+                .setTotalCount(importItems.size()).setSuccessItemCodes(new ArrayList<>())
+                .setFailureReasons(new LinkedHashMap<>());
+        for (int index = 0; index < importItems.size(); index++) {
+            FmsAuxiliaryItemImportExcelVO importItem = importItems.get(index);
+            String label = buildImportLabel(index + 2, importItem.getCode(), importItem.getName());
+            try {
+                // 2.1 校验导入字段和编码唯一
+                ValidationUtils.validate(importItem);
+                if (!importCodes.add(importItem.getCode())) {
+                    throw new IllegalArgumentException("导入文件内编码重复");
+                }
+                if (itemMap.containsKey(importItem.getCode())) {
+                    throw new IllegalArgumentException("编码已存在");
+                }
+
+                // 2.2 构造并创建辅助核算项目
+                FmsAuxiliaryItemDO item = new FmsAuxiliaryItemDO().setAccountSetId(accountSetId)
+                        .setAuxiliaryTypeId(auxiliaryTypeId).setCode(importItem.getCode())
+                        .setName(importItem.getName()).setRemark(importItem.getRemark())
+                        .setStatus(CommonStatusEnum.ENABLE.getStatus());
+                if (FmsAuxiliaryTypeEnum.INVENTORY.getType().equals(auxiliaryType.getType())) {
+                    item.setSpecification(importItem.getSpecification()).setUnit(importItem.getUnit());
+                }
+                auxiliaryItemMapper.insert(item);
+                itemMap.put(importItem.getCode(), item);
+
+                // 2.3 记录导入结果
+                respVO.getSuccessItemCodes().add(importItem.getCode());
+            } catch (ConstraintViolationException exception) {
+                respVO.getFailureReasons().put(label, exception.getMessage());
+            } catch (RuntimeException exception) {
+                respVO.getFailureReasons().put(
+                        label, StrUtil.blankToDefault(exception.getMessage(), "导入失败"));
+            }
+        }
+        return respVO;
+    }
+
+    @Override
+    public PageResult<FmsAuxiliaryItemDO> getAuxiliaryItemPage(FmsAuxiliaryItemPageReqVO pageReqVO, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(pageReqVO.getAccountSetId(), userId);
+        // 1.2 校验辅助核算类别
+        validateAuxiliaryType(pageReqVO.getAccountSetId(), pageReqVO.getAuxiliaryTypeId());
+
+        // 2. 查询辅助核算项目分页
+        return auxiliaryItemMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public FmsAuxiliaryItemDO getAuxiliaryItem(Long accountSetId, Long id, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询并校验辅助核算项目
+        return validateAuxiliaryItemExists(accountSetId, id);
+    }
+
+    @Override
+    public List<FmsAuxiliaryItemDO> getAuxiliaryItemList(Long accountSetId, Long auxiliaryTypeId, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 校验辅助核算类别
+        validateAuxiliaryType(accountSetId, auxiliaryTypeId);
+
+        // 2. 查询辅助核算项目
+        return auxiliaryItemMapper.selectListByAccountSetIdAndAuxiliaryTypeId(
+                accountSetId, auxiliaryTypeId);
+    }
+
+    @Override
+    public List<FmsAuxiliaryItemDO> getAuxiliaryItemListByAccountSetIdAndAuxiliaryTypeIdAndStatus(
+            Long accountSetId, Long auxiliaryTypeId, Integer status, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 校验辅助核算类别
+        validateAuxiliaryType(accountSetId, auxiliaryTypeId);
+
+        // 2. 查询指定状态的辅助核算项目
+        return auxiliaryItemMapper.selectListByAccountSetIdAndAuxiliaryTypeIdAndStatus(
+                accountSetId, auxiliaryTypeId, status);
+    }
+
+    @Override
+    public List<FmsAuxiliaryItemDO> getAuxiliaryItemListByAccountSetId(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询账套的全部辅助核算项目
+        return auxiliaryItemMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public Long getAuxiliaryItemCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId) {
+        return auxiliaryItemMapper.selectCountByAuxiliaryTypeId(accountSetId, auxiliaryTypeId);
+    }
+
+    @Override
+    public List<FmsAuxiliaryItemDO> validateAuxiliaryItemList(Long accountSetId, Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        List<FmsAuxiliaryItemDO> items = auxiliaryItemMapper.selectListByIdsAndAccountSetId(ids, accountSetId);
+        if (items.size() != new LinkedHashSet<>(ids).size()) {
+            throw exception(AUXILIARY_ITEM_NOT_EXISTS);
+        }
+        return items;
+    }
+
+    private FmsAuxiliaryItemDO validateAuxiliaryItemExists(Long accountSetId, Long id) {
+        FmsAuxiliaryItemDO auxiliaryItem = auxiliaryItemMapper.selectById(id);
+        if (auxiliaryItem == null || ObjUtil.notEqual(auxiliaryItem.getAccountSetId(), accountSetId)) {
+            throw exception(AUXILIARY_ITEM_NOT_EXISTS);
+        }
+        return auxiliaryItem;
+    }
+
+    private void validateAuxiliaryType(Long accountSetId, Long auxiliaryTypeId) {
+        auxiliaryTypeService.validateAuxiliaryTypeList(accountSetId, Collections.singletonList(auxiliaryTypeId));
+    }
+
+    private void validateAuxiliaryItemCodeUnique(Long id, Long accountSetId, Long auxiliaryTypeId, String code) {
+        FmsAuxiliaryItemDO auxiliaryItem = auxiliaryItemMapper
+                .selectByTypeIdAndCode(accountSetId, auxiliaryTypeId, code);
+        if (auxiliaryItem != null && ObjUtil.notEqual(auxiliaryItem.getId(), id)) {
+            throw exception(AUXILIARY_ITEM_CODE_DUPLICATE);
+        }
+    }
+
+    private String buildImportLabel(Integer rowNumber, String code, String name) {
+        return "第 " + rowNumber + " 行（" + StrUtil.blankToDefault(code, "未填写编码")
+                + (StrUtil.isBlank(name) ? "" : " " + name) + "）";
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeService.java
new file mode 100644
index 0000000..d762bac
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeService.java
@@ -0,0 +1,136 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliarytype.FmsAuxiliaryTypeSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * FMS 辅助核算类别 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsAuxiliaryTypeService {
+
+    /**
+     * 初始化系统预置辅助核算类别
+     *
+     * @param accountSetId 账套编号
+     */
+    void initializeDefaultTypes(Long accountSetId);
+
+    /**
+     * 创建辅助核算类别
+     *
+     * @param createReqVO 创建信息
+     * @param userId 当前用户编号
+     * @return 编号
+     */
+    Long createAuxiliaryType(FmsAuxiliaryTypeSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新辅助核算类别
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 当前用户编号
+     */
+    void updateAuxiliaryType(FmsAuxiliaryTypeSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除辅助核算类别
+     *
+     * @param accountSetId 账套编号
+     * @param id 编号
+     * @param userId 当前用户编号
+     */
+    void deleteAuxiliaryType(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得辅助核算类别
+     *
+     * @param accountSetId 账套编号
+     * @param id 辅助核算类别编号
+     * @param userId 当前用户编号
+     * @return 辅助核算类别
+     */
+    FmsAuxiliaryTypeDO getAuxiliaryType(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得辅助核算类别列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 辅助核算类别列表
+     */
+    List<FmsAuxiliaryTypeDO> getAuxiliaryTypeList(Long accountSetId, Long userId);
+
+    /**
+     * 获得账套的辅助核算类别列表
+     *
+     * @param accountSetId 账套编号
+     * @return 辅助核算类别列表
+     */
+    List<FmsAuxiliaryTypeDO> getAuxiliaryTypeList(Long accountSetId);
+
+    /**
+     * 获得辅助核算类别列表
+     *
+     * @param ids 辅助核算类别编号数组
+     * @return 辅助核算类别列表
+     */
+    List<FmsAuxiliaryTypeDO> getAuxiliaryTypeList(Collection<Long> ids);
+
+    /**
+     * 获得辅助核算类别 Map
+     *
+     * @param ids 辅助核算类别编号数组
+     * @return 辅助核算类别 Map
+     */
+    default Map<Long, FmsAuxiliaryTypeDO> getAuxiliaryTypeMap(Collection<Long> ids) {
+        return convertMap(getAuxiliaryTypeList(ids), FmsAuxiliaryTypeDO::getId);
+    }
+
+    /**
+     * 获得账套的辅助核算类别 Map
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 辅助核算类别 Map
+     */
+    default Map<Long, FmsAuxiliaryTypeDO> getAuxiliaryTypeMap(Long accountSetId, Long userId) {
+        return convertMap(getAuxiliaryTypeList(accountSetId, userId), FmsAuxiliaryTypeDO::getId);
+    }
+
+    /**
+     * 获得辅助核算类别名称与编号 Map
+     *
+     * @param accountSetId 账套编号
+     * @return 辅助核算类别名称与编号 Map
+     */
+    default Map<String, Long> getAuxiliaryTypeIdMap(Long accountSetId) {
+        return convertMap(getAuxiliaryTypeList(accountSetId),
+                FmsAuxiliaryTypeDO::getName, FmsAuxiliaryTypeDO::getId);
+    }
+
+    /**
+     * 校验并获得辅助核算类别列表
+     *
+     * @param ids 辅助核算类别编号数组
+     * @return 辅助核算类别列表
+     */
+    List<FmsAuxiliaryTypeDO> validateAuxiliaryTypeList(Collection<Long> ids);
+
+    /**
+     * 校验并获得辅助核算类别列表
+     *
+     * @param accountSetId 账套编号
+     * @param ids 辅助核算类别编号数组
+     * @return 辅助核算类别列表
+     */
+    List<FmsAuxiliaryTypeDO> validateAuxiliaryTypeList(Long accountSetId, Collection<Long> ids);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeServiceImpl.java
new file mode 100644
index 0000000..02a3a61
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeServiceImpl.java
@@ -0,0 +1,227 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliarytype.FmsAuxiliaryTypeSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAuxiliaryTypeMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherTemplateService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+
+/**
+ * FMS 辅助核算类别 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsAuxiliaryTypeServiceImpl implements FmsAuxiliaryTypeService {
+
+    @Resource
+    private FmsAuxiliaryTypeMapper auxiliaryTypeMapper;
+
+    @Resource
+    @Lazy // 延迟加载，解决循环依赖的问题
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    @Lazy // 延迟加载，解决循环依赖的问题
+    private FmsSubjectService subjectService;
+    @Resource
+    @Lazy // 延迟加载，解决循环依赖的问题
+    private FmsVoucherService voucherService;
+    @Resource
+    @Lazy // 延迟加载，解决循环依赖的问题
+    private FmsVoucherTemplateService voucherTemplateService;
+    @Resource
+    @Lazy // 延迟加载，解决循环依赖的问题
+    private FmsInitialBalanceService initialBalanceService;
+
+    @Override
+    public void initializeDefaultTypes(Long accountSetId) {
+        List<FmsAuxiliaryTypeDO> auxiliaryTypes = convertList(FmsAuxiliaryTypeEnum.SYSTEM_PRESET_TYPES,
+                type -> new FmsAuxiliaryTypeDO().setName(type.getName()).setSystemPreset(true)
+                        .setAccountSetId(accountSetId).setType(type.getType()));
+        auxiliaryTypeMapper.insertBatch(auxiliaryTypes);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_AUXILIARY_TYPE, subType = FMS_AUXILIARY_TYPE_CREATE_SUB_TYPE,
+            bizNo = "{{#auxiliaryTypeId}}", success = FMS_AUXILIARY_TYPE_CREATE_SUCCESS)
+    public Long createAuxiliaryType(FmsAuxiliaryTypeSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验名称唯一
+        validateAuxiliaryTypeNameUnique(null, createReqVO.getAccountSetId(), createReqVO.getName());
+
+        // 2. 创建自定义辅助核算类别
+        FmsAuxiliaryTypeDO auxiliaryType = BeanUtils.toBean(createReqVO, FmsAuxiliaryTypeDO.class)
+                .setId(null).setSystemPreset(false).setType(FmsAuxiliaryTypeEnum.CUSTOM.getType());
+        auxiliaryTypeMapper.insert(auxiliaryType);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("auxiliaryTypeId", auxiliaryType.getId());
+        return auxiliaryType.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_AUXILIARY_TYPE, subType = FMS_AUXILIARY_TYPE_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_AUXILIARY_TYPE_UPDATE_SUCCESS)
+    public void updateAuxiliaryType(FmsAuxiliaryTypeSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验辅助核算类别
+        FmsAuxiliaryTypeDO auxiliaryType = validateAuxiliaryTypeExists(
+                updateReqVO.getAccountSetId(), updateReqVO.getId());
+        validateCustomAuxiliaryType(auxiliaryType);
+        // 1.3 校验名称唯一
+        validateAuxiliaryTypeNameUnique(auxiliaryType.getId(), updateReqVO.getAccountSetId(), updateReqVO.getName());
+
+        // 2. 更新辅助核算类别
+        auxiliaryTypeMapper.updateById(new FmsAuxiliaryTypeDO()
+                .setId(auxiliaryType.getId()).setName(updateReqVO.getName()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_AUXILIARY_TYPE, subType = FMS_AUXILIARY_TYPE_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_AUXILIARY_TYPE_DELETE_SUCCESS)
+    public void deleteAuxiliaryType(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验辅助核算类别
+        FmsAuxiliaryTypeDO auxiliaryType = validateAuxiliaryTypeExists(accountSetId, id);
+        validateCustomAuxiliaryType(auxiliaryType);
+        // 1.3 校验辅助核算类别未被业务引用
+        // 1.3.1 校验辅助核算类别下没有项目
+        Long auxiliaryItemCount = auxiliaryItemService.getAuxiliaryItemCountByAuxiliaryTypeId(accountSetId, id);
+        if (auxiliaryItemCount > 0) {
+            throw exception(AUXILIARY_TYPE_HAS_ITEM, auxiliaryItemCount);
+        }
+        // 1.3.2 校验辅助核算类别未被科目使用
+        Long subjectCount = subjectService.getSubjectCountByAuxiliaryTypeId(accountSetId, id);
+        if (subjectCount > 0) {
+            throw exception(AUXILIARY_TYPE_SUBJECT_IN_USE, subjectCount);
+        }
+        // 1.3.3 校验辅助核算类别未被凭证使用
+        Long voucherEntryCount = voucherService.getVoucherEntryCountByAuxiliaryTypeId(accountSetId, id);
+        if (voucherEntryCount > 0) {
+            throw exception(AUXILIARY_TYPE_VOUCHER_IN_USE, voucherEntryCount);
+        }
+        // 1.3.4 校验辅助核算类别未被凭证模板使用
+        Long voucherTemplateCount = voucherTemplateService
+                .getVoucherTemplateCountByAuxiliaryTypeId(accountSetId, id);
+        if (voucherTemplateCount > 0) {
+            throw exception(AUXILIARY_TYPE_VOUCHER_TEMPLATE_IN_USE, voucherTemplateCount);
+        }
+        // 1.3.5 校验辅助核算类别未被初始余额使用
+        Long initialBalanceCount = initialBalanceService.getInitialBalanceCountByAuxiliaryTypeId(accountSetId, id);
+        if (initialBalanceCount > 0) {
+            throw exception(AUXILIARY_TYPE_INITIAL_BALANCE_IN_USE, initialBalanceCount);
+        }
+
+        // 2. 删除辅助核算类别
+        auxiliaryTypeMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("auxiliaryType", auxiliaryType);
+    }
+
+    @Override
+    public FmsAuxiliaryTypeDO getAuxiliaryType(Long accountSetId, Long id, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询并校验辅助核算类别
+        return validateAuxiliaryTypeExists(accountSetId, id);
+    }
+
+    @Override
+    public List<FmsAuxiliaryTypeDO> getAuxiliaryTypeList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询辅助核算类别
+        return auxiliaryTypeMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public List<FmsAuxiliaryTypeDO> getAuxiliaryTypeList(Long accountSetId) {
+        return auxiliaryTypeMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public List<FmsAuxiliaryTypeDO> getAuxiliaryTypeList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return auxiliaryTypeMapper.selectByIds(ids);
+    }
+
+    @Override
+    public List<FmsAuxiliaryTypeDO> validateAuxiliaryTypeList(Collection<Long> ids) {
+        List<FmsAuxiliaryTypeDO> types = getAuxiliaryTypeList(ids);
+        if (types.size() != CollUtil.size(ids)) {
+            throw exception(AUXILIARY_TYPE_NOT_EXISTS);
+        }
+        return types;
+    }
+
+    @Override
+    public List<FmsAuxiliaryTypeDO> validateAuxiliaryTypeList(Long accountSetId, Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        List<FmsAuxiliaryTypeDO> types = auxiliaryTypeMapper.selectListByIdsAndAccountSetId(ids, accountSetId);
+        if (types.size() != CollUtil.distinct(ids).size()) {
+            throw exception(AUXILIARY_TYPE_NOT_EXISTS);
+        }
+        return types;
+    }
+
+    private FmsAuxiliaryTypeDO validateAuxiliaryTypeExists(Long accountSetId, Long id) {
+        FmsAuxiliaryTypeDO auxiliaryType = auxiliaryTypeMapper.selectById(id);
+        if (auxiliaryType == null || ObjUtil.notEqual(auxiliaryType.getAccountSetId(), accountSetId)) {
+            throw exception(AUXILIARY_TYPE_NOT_EXISTS);
+        }
+        return auxiliaryType;
+    }
+
+    private void validateAuxiliaryTypeNameUnique(Long id, Long accountSetId, String name) {
+        FmsAuxiliaryTypeDO auxiliaryType = auxiliaryTypeMapper.selectByAccountSetIdAndName(accountSetId, name);
+        if (auxiliaryType != null && ObjUtil.notEqual(auxiliaryType.getId(), id)) {
+            throw exception(AUXILIARY_TYPE_NAME_DUPLICATE);
+        }
+    }
+
+    private void validateCustomAuxiliaryType(FmsAuxiliaryTypeDO auxiliaryType) {
+        if (Boolean.TRUE.equals(auxiliaryType.getSystemPreset())) {
+            throw exception(AUXILIARY_TYPE_SYSTEM_NOT_EDITABLE);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyService.java
new file mode 100644
index 0000000..4848d53
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyService.java
@@ -0,0 +1,79 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.currency.FmsCurrencySaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.enums.config.FmsCurrencyPresetEnum;
+
+import java.util.List;
+
+/**
+ * FMS 币别 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsCurrencyService {
+
+    /**
+     * 初始化本位币
+     *
+     * @param accountSetId 账套编号
+     * @param presetCurrency 预置币别
+     * @return 本位币
+     */
+    FmsCurrencyDO initializeStandardCurrency(Long accountSetId, FmsCurrencyPresetEnum presetCurrency);
+
+    /**
+     * 创建币别
+     *
+     * @param createReqVO 创建信息
+     * @param userId 用户编号
+     * @return 币别编号
+     */
+    Long createCurrency(FmsCurrencySaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新币别
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 用户编号
+     */
+    void updateCurrency(FmsCurrencySaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除币别
+     *
+     * @param accountSetId 账套编号
+     * @param id 币别编号
+     * @param userId 用户编号
+     */
+    void deleteCurrency(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得币别列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 币别列表
+     */
+    List<FmsCurrencyDO> getCurrencyList(Long accountSetId, Long userId);
+
+    /**
+     * 获得币别
+     *
+     * @param accountSetId 账套编号
+     * @param id 币别编号
+     * @param userId 用户编号
+     * @return 币别
+     */
+    FmsCurrencyDO getCurrency(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 校验并获得币别列表
+     *
+     * @param accountSetId 账套编号
+     * @param ids 币别编号数组
+     * @return 币别列表
+     */
+    List<FmsCurrencyDO> validateCurrencyList(Long accountSetId, List<Long> ids);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyServiceImpl.java
new file mode 100644
index 0000000..7286bee
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyServiceImpl.java
@@ -0,0 +1,174 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.currency.FmsCurrencySaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsCurrencyMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsCurrencyPresetEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_CODE_DUPLICATE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_STANDARD_NOT_DELETABLE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CURRENCY_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CURRENCY_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CURRENCY_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CURRENCY_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CURRENCY_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CURRENCY_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CURRENCY_UPDATE_SUCCESS;
+
+/**
+ * FMS 币别 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsCurrencyServiceImpl implements FmsCurrencyService {
+
+    @Resource
+    private FmsCurrencyMapper currencyMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    @Lazy // 延迟加载，解决循环依赖的问题
+    private FmsSubjectService subjectService;
+
+    @Override
+    public FmsCurrencyDO initializeStandardCurrency(Long accountSetId, FmsCurrencyPresetEnum presetCurrency) {
+        FmsCurrencyDO currency = new FmsCurrencyDO().setAccountSetId(accountSetId)
+                .setCode(presetCurrency.getCode()).setName(presetCurrency.getName())
+                .setExchangeRate(presetCurrency.getExchangeRate()).setStandard(true);
+        currencyMapper.insert(currency);
+        return currency;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CURRENCY_TYPE, subType = FMS_CURRENCY_CREATE_SUB_TYPE,
+            bizNo = "{{#currencyId}}", success = FMS_CURRENCY_CREATE_SUCCESS)
+    public Long createCurrency(FmsCurrencySaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验币别编码唯一
+        validateCurrencyCodeUnique(null, createReqVO.getAccountSetId(), createReqVO.getCode());
+
+        // 2. 创建币别
+        FmsCurrencyDO currency = BeanUtils.toBean(createReqVO, FmsCurrencyDO.class)
+                .setId(null).setStandard(false);
+        currencyMapper.insert(currency);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("currencyId", currency.getId());
+        return currency.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CURRENCY_TYPE, subType = FMS_CURRENCY_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_CURRENCY_UPDATE_SUCCESS)
+    public void updateCurrency(FmsCurrencySaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验币别
+        FmsCurrencyDO currency = validateCurrencyExists(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        if (Boolean.TRUE.equals(currency.getStandard())) {
+            updateReqVO.setCode(currency.getCode());
+        }
+        // 1.3 校验币别编码唯一
+        validateCurrencyCodeUnique(currency.getId(), updateReqVO.getAccountSetId(), updateReqVO.getCode());
+
+        // 2. 更新币别
+        if (Boolean.TRUE.equals(currency.getStandard())) {
+            updateReqVO.setExchangeRate(BigDecimal.ONE);
+        }
+        currencyMapper.updateById(BeanUtils.toBean(updateReqVO, FmsCurrencyDO.class));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CURRENCY_TYPE, subType = FMS_CURRENCY_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_CURRENCY_DELETE_SUCCESS)
+    public void deleteCurrency(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验币别存在且不是本位币
+        FmsCurrencyDO currency = validateCurrencyExists(accountSetId, id);
+        if (Boolean.TRUE.equals(currency.getStandard())) {
+            throw exception(CURRENCY_STANDARD_NOT_DELETABLE);
+        }
+        // 1.3 校验币别未被科目使用
+        if (subjectService.getSubjectCountByCurrencyId(accountSetId, id) > 0) {
+            throw exception(CURRENCY_IN_USE);
+        }
+
+        // 2. 删除币别
+        currencyMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("currency", currency);
+    }
+
+    @Override
+    public List<FmsCurrencyDO> getCurrencyList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询币别列表
+        return currencyMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public FmsCurrencyDO getCurrency(Long accountSetId, Long id, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询并校验币别
+        return validateCurrencyExists(accountSetId, id);
+    }
+
+    @Override
+    public List<FmsCurrencyDO> validateCurrencyList(Long accountSetId, List<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        List<FmsCurrencyDO> currencies = currencyMapper.selectListByIdsAndAccountSetId(ids, accountSetId);
+        if (currencies.size() != ids.size()) {
+            throw exception(CURRENCY_NOT_EXISTS);
+        }
+        return currencies;
+    }
+
+    private FmsCurrencyDO validateCurrencyExists(Long accountSetId, Long id) {
+        FmsCurrencyDO currency = currencyMapper.selectByIdAndAccountSetId(id, accountSetId);
+        if (currency == null) {
+            throw exception(CURRENCY_NOT_EXISTS);
+        }
+        return currency;
+    }
+
+    private void validateCurrencyCodeUnique(Long id, Long accountSetId, String code) {
+        FmsCurrencyDO currency = currencyMapper.selectByAccountSetIdAndCode(accountSetId, code);
+        if (currency != null && ObjUtil.notEqual(currency.getId(), id)) {
+            throw exception(CURRENCY_CODE_DUPLICATE);
+        }
+    }
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestService.java
new file mode 100644
index 0000000..e9dc147
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestService.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.digest.FmsDigestSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsDigestDO;
+
+import java.util.List;
+
+/**
+ * FMS 常用摘要 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsDigestService {
+
+    /**
+     * 创建常用摘要
+     *
+     * @param createReqVO 创建信息
+     * @param userId 当前用户编号
+     * @return 常用摘要编号
+     */
+    Long createDigest(FmsDigestSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 修改常用摘要
+     *
+     * @param updateReqVO 修改信息
+     * @param userId 当前用户编号
+     */
+    void updateDigest(FmsDigestSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除常用摘要
+     *
+     * @param accountSetId 账套编号
+     * @param id 常用摘要编号
+     * @param userId 当前用户编号
+     */
+    void deleteDigest(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得账套常用摘要列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 常用摘要列表
+     */
+    List<FmsDigestDO> getDigestList(Long accountSetId, Long userId);
+
+    /**
+     * 校验并获得常用摘要
+     *
+     * @param accountSetId 账套编号
+     * @param id 常用摘要编号
+     * @return 常用摘要
+     */
+    FmsDigestDO validateDigestExists(Long accountSetId, Long id);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestServiceImpl.java
new file mode 100644
index 0000000..0c0ea5d
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestServiceImpl.java
@@ -0,0 +1,106 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.digest.FmsDigestSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsDigestDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsDigestMapper;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.DIGEST_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_DIGEST_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_DIGEST_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_DIGEST_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_DIGEST_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_DIGEST_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_DIGEST_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_DIGEST_UPDATE_SUCCESS;
+
+/**
+ * FMS 常用摘要 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsDigestServiceImpl implements FmsDigestService {
+
+    @Resource
+    private FmsDigestMapper digestMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+
+    @Override
+    @LogRecord(type = FMS_DIGEST_TYPE, subType = FMS_DIGEST_CREATE_SUB_TYPE,
+            bizNo = "{{#digestId}}", success = FMS_DIGEST_CREATE_SUCCESS)
+    public Long createDigest(FmsDigestSaveReqVO createReqVO, Long userId) {
+        // 1. 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+
+        // 2. 创建常用摘要
+        FmsDigestDO digest = BeanUtils.toBean(createReqVO, FmsDigestDO.class)
+                .setId(null);
+        digestMapper.insert(digest);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("digestId", digest.getId());
+        return digest.getId();
+    }
+
+    @Override
+    @LogRecord(type = FMS_DIGEST_TYPE, subType = FMS_DIGEST_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_DIGEST_UPDATE_SUCCESS)
+    public void updateDigest(FmsDigestSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验常用摘要
+        validateDigestExists(updateReqVO.getAccountSetId(), updateReqVO.getId());
+
+        // 2. 更新常用摘要
+        digestMapper.updateById(BeanUtils.toBean(updateReqVO, FmsDigestDO.class));
+    }
+
+    @Override
+    @LogRecord(type = FMS_DIGEST_TYPE, subType = FMS_DIGEST_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_DIGEST_DELETE_SUCCESS)
+    public void deleteDigest(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验常用摘要
+        FmsDigestDO digest = validateDigestExists(accountSetId, id);
+
+        // 2. 删除常用摘要
+        digestMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("digest", digest);
+    }
+
+    @Override
+    public List<FmsDigestDO> getDigestList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询常用摘要列表
+        return digestMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public FmsDigestDO validateDigestExists(Long accountSetId, Long id) {
+        FmsDigestDO digest = digestMapper.selectById(id);
+        if (digest == null || ObjUtil.notEqual(digest.getAccountSetId(), accountSetId)) {
+            throw exception(DIGEST_NOT_EXISTS);
+        }
+        return digest;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceIndicatorService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceIndicatorService.java
new file mode 100644
index 0000000..b9277e8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceIndicatorService.java
@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeindicator.FmsFinanceIndicatorSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceIndicatorDO;
+
+import java.util.List;
+
+// TODO DONE @AI：Service 接口保留给 Controller、首页和账套初始化调用；方法文档已按 FMS 配置 Service 补齐。
+/**
+ * FMS 首页财务指标 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsFinanceIndicatorService {
+
+    /**
+     * 创建首页财务指标
+     *
+     * @param reqVO 创建信息
+     * @param userId 当前用户编号
+     * @return 指标编号
+     */
+    Long createFinanceIndicator(FmsFinanceIndicatorSaveReqVO reqVO, Long userId);
+
+    /**
+     * 更新首页财务指标
+     *
+     * @param reqVO 更新信息
+     * @param userId 当前用户编号
+     */
+    void updateFinanceIndicator(FmsFinanceIndicatorSaveReqVO reqVO, Long userId);
+
+    /**
+     * 删除首页财务指标
+     *
+     * @param accountSetId 账套编号
+     * @param id 指标编号
+     * @param userId 当前用户编号
+     */
+    void deleteFinanceIndicator(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得首页财务指标
+     *
+     * @param accountSetId 账套编号
+     * @param id 指标编号
+     * @param userId 当前用户编号
+     * @return 财务指标
+     */
+    FmsFinanceIndicatorDO getFinanceIndicator(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得首页财务指标列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 财务指标列表
+     */
+    List<FmsFinanceIndicatorDO> getFinanceIndicatorList(Long accountSetId, Long userId);
+
+    /**
+     * 获得已启用的首页财务指标列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 已启用的财务指标列表
+     */
+    List<FmsFinanceIndicatorDO> getEnabledFinanceIndicatorList(Long accountSetId, Long userId);
+
+    /**
+     * 初始化账套的默认首页财务指标
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     */
+    void initializeDefaultFinanceIndicators(Long accountSetId, Long userId);
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceIndicatorServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceIndicatorServiceImpl.java
new file mode 100644
index 0000000..12ee561
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceIndicatorServiceImpl.java
@@ -0,0 +1,243 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.io.IoUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeindicator.FmsFinanceIndicatorSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceIndicatorDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsFinanceIndicatorMapper;
+import cn.iocoder.yudao.module.fms.service.report.FmsReportCommonService;
+import jakarta.annotation.Resource;
+import lombok.Data;
+import org.springframework.core.io.ClassPathResource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.io.InputStream;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.regex.Pattern;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.HOME_METRIC_INVALID;
+
+/**
+ * FMS 首页财务指标 Service 实现类
+ *
+ * 指标公式复用报表已有表达式：行次公式使用 L1+L2，科目公式使用报表公式 JSON。
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsFinanceIndicatorServiceImpl implements FmsFinanceIndicatorService {
+
+    // TODO DONE @AI：补充行次公式正则说明。
+    /**
+     * 行次公式格式，例如 {@code L1+L2-L3}
+     */
+    private static final Pattern LINE_FORMULA_PATTERN = Pattern.compile("[+-]?L\\d+(?:[+-]L\\d+)*");
+
+    private static final String PRESET_RESOURCE = "fms/config/finance-indicator-presets.json";
+
+    @Resource
+    private FmsFinanceIndicatorMapper financeIndicatorMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsReportCommonService reportCommonService;
+
+    @Override
+    public Long createFinanceIndicator(FmsFinanceIndicatorSaveReqVO reqVO, Long userId) {
+        // TODO DONE @AI：方法步骤已对齐 FMS Service 风格。
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(reqVO.getAccountSetId(), userId);
+        // 1.2 校验指标公式
+        validateSaveReq(reqVO);
+        // 1.3 校验指标编码唯一
+        validateCodeUnique(reqVO.getAccountSetId(), null, reqVO.getCode());
+
+        // 2. 创建财务指标
+        FmsFinanceIndicatorDO indicator = BeanUtils.toBean(reqVO, FmsFinanceIndicatorDO.class).setId(null)
+                .setFormula(bindFormula(reqVO.getAccountSetId(), normalizeFormula(reqVO.getFormula()), userId));
+        financeIndicatorMapper.insert(indicator);
+        return indicator.getId();
+    }
+
+    @Override
+    public void updateFinanceIndicator(FmsFinanceIndicatorSaveReqVO reqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(reqVO.getAccountSetId(), userId);
+        // 1.2 校验财务指标存在
+        validateFinanceIndicatorExists(reqVO.getAccountSetId(), reqVO.getId());
+        // 1.3 校验指标公式
+        validateSaveReq(reqVO);
+        // 1.4 校验指标编码唯一
+        validateCodeUnique(reqVO.getAccountSetId(), reqVO.getId(), reqVO.getCode());
+
+        // 2. 更新指标
+        financeIndicatorMapper.updateById(BeanUtils.toBean(reqVO, FmsFinanceIndicatorDO.class)
+                .setFormula(bindFormula(reqVO.getAccountSetId(), normalizeFormula(reqVO.getFormula()), userId)));
+    }
+
+    @Override
+    public void deleteFinanceIndicator(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验财务指标存在
+        validateFinanceIndicatorExists(accountSetId, id);
+
+        // 2. 删除指标
+        financeIndicatorMapper.deleteById(id);
+    }
+
+    @Override
+    public List<FmsFinanceIndicatorDO> getFinanceIndicatorList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 2. 查询首页财务指标
+        return financeIndicatorMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public FmsFinanceIndicatorDO getFinanceIndicator(Long accountSetId, Long id, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询并校验财务指标
+        return validateFinanceIndicatorExists(accountSetId, id);
+    }
+
+    @Override
+    public List<FmsFinanceIndicatorDO> getEnabledFinanceIndicatorList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 2. 查询已启用的首页财务指标
+        return financeIndicatorMapper.selectListByAccountSetIdAndStatus(accountSetId,
+                CommonStatusEnum.ENABLE.getStatus());
+    }
+
+    private FmsFinanceIndicatorDO validateFinanceIndicatorExists(Long accountSetId, Long id) {
+        FmsFinanceIndicatorDO indicator = financeIndicatorMapper.selectByIdAndAccountSetId(id, accountSetId);
+        if (indicator == null) {
+            throw exception(HOME_METRIC_INVALID);
+        }
+        return indicator;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void initializeDefaultFinanceIndicators(Long accountSetId, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验财务指标尚未初始化
+        if (CollUtil.isNotEmpty(financeIndicatorMapper.selectListByAccountSetId(accountSetId))) {
+            return;
+        }
+
+        // 2. 加载预置配置并绑定当前账套科目
+        List<Preset> presets = loadPresetList();
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode);
+        financeIndicatorMapper.insertBatch(convertList(presets, preset -> new FmsFinanceIndicatorDO()
+                .setAccountSetId(accountSetId).setCode(preset.getCode()).setName(preset.getName())
+                .setType(preset.getType()).setFormula(bindFormula(normalizeFormula(preset.getFormula()), subjectMap))
+                .setSort(preset.getSort()).setStatus(CommonStatusEnum.ENABLE.getStatus())));
+    }
+
+    private void validateSaveReq(FmsFinanceIndicatorSaveReqVO reqVO) {
+        if (!isValidFormula(reqVO.getFormula())) {
+            throw exception(HOME_METRIC_INVALID);
+        }
+    }
+
+    private boolean isValidFormula(String formula) {
+        if (StrUtil.isBlank(formula)) {
+            return false;
+        }
+        if (LINE_FORMULA_PATTERN.matcher(formula.replace(" ", "")).matches()) {
+            return true;
+        }
+        try {
+            return JsonUtils.parseArray(formula, Object.class) != null;
+        } catch (Exception ignored) {
+            return false;
+        }
+    }
+
+    private String normalizeFormula(String formula) {
+        String normalized = formula.replace(" ", "");
+        return LINE_FORMULA_PATTERN.matcher(normalized).matches()
+                ? JsonUtils.toJsonString(Collections.singletonList(normalized)) : formula;
+    }
+
+    private String bindFormula(Long accountSetId, String formula, Long userId) {
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode);
+        return bindFormula(formula, subjectMap);
+    }
+
+    private String bindFormula(String formula, Map<String, FmsSubjectDO> subjectMap) {
+        if (StrUtil.isBlank(formula) || reportCommonService.isLineFormula(formula)) {
+            return formula;
+        }
+        return reportCommonService.bindSubjectFormula(formula, subjectMap);
+    }
+
+    /**
+     * 加载财务指标预置文件
+     *
+     * @return 财务指标预置配置数组
+     */
+    private List<Preset> loadPresetList() {
+        try (InputStream inputStream = new ClassPathResource(PRESET_RESOURCE).getInputStream()) {
+            return JsonUtils.parseArray(IoUtil.readUtf8(inputStream), Preset.class);
+        } catch (Exception exception) {
+            throw new IllegalStateException("首页财务指标预置文件加载失败", exception);
+        }
+    }
+
+    private void validateCodeUnique(Long accountSetId, Long id, String code) {
+        FmsFinanceIndicatorDO indicator = financeIndicatorMapper.selectByAccountSetIdAndCode(accountSetId, code);
+        if (indicator != null && ObjUtil.notEqual(indicator.getId(), id)) {
+            throw exception(HOME_METRIC_INVALID);
+        }
+    }
+
+    @Data
+    private static class Preset {
+
+        /**
+         * 指标编码
+         */
+        private String code;
+        /**
+         * 指标名称
+         */
+        private String name;
+        /**
+         * 取数报表类型
+         */
+        private Integer type;
+        /**
+         * 指标公式
+         */
+        private String formula;
+        /**
+         * 展示顺序
+         */
+        private Integer sort;
+    }
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterService.java
new file mode 100644
index 0000000..91d9e9a
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterService.java
@@ -0,0 +1,56 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetInitializeReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeparameter.FmsFinanceParameterUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+
+/**
+ * FMS 财务参数 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsFinanceParameterService {
+
+    /**
+     * 初始化财务参数
+     *
+     * @param accountSetId 账套编号
+     * @param initializeReqVO 账套初始化信息
+     */
+    void initializeFinanceParameter(Long accountSetId, FmsAccountSetInitializeReqVO initializeReqVO);
+
+    /**
+     * 获得财务参数
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 财务参数
+     */
+    FmsFinanceParameterDO getFinanceParameter(Long accountSetId, Long userId);
+
+    /**
+     * 获得财务参数
+     *
+     * @param accountSetId 账套编号
+     * @return 财务参数
+     */
+    FmsFinanceParameterDO getFinanceParameter(Long accountSetId);
+
+    /**
+     * 将标准科目编码转换为账套实际科目编码
+     *
+     * @param standardCode 标准科目编码
+     * @param subjectCodeRule 科目编码规则
+     * @return 账套实际科目编码
+     */
+    String convertStandardSubjectCode(String standardCode, String subjectCodeRule);
+
+    /**
+     * 更新财务参数
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 用户编号
+     */
+    void updateFinanceParameter(FmsFinanceParameterUpdateReqVO updateReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterServiceImpl.java
new file mode 100644
index 0000000..7c4cbf2
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterServiceImpl.java
@@ -0,0 +1,203 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.text.CharSequenceUtil;
+import cn.hutool.core.util.NumberUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.string.StrUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetInitializeReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeparameter.FmsFinanceParameterUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsFinanceParameterMapper;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_NOT_INITIALIZED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_SETTINGS_RULE_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_SETTINGS_RULE_SHRINK;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.FINANCE_PARAMETER_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_FINANCE_PARAMETER_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_FINANCE_PARAMETER_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_FINANCE_PARAMETER_UPDATE_SUCCESS;
+
+/**
+ * FMS 财务参数 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsFinanceParameterServiceImpl implements FmsFinanceParameterService {
+
+    private static final int SUBJECT_CODE_LENGTH_MIN = 2;
+    private static final int SUBJECT_CODE_LENGTH_MAX = 5;
+
+    @Resource
+    private FmsFinanceParameterMapper financeParameterMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private FmsSubjectService subjectService;
+
+    @Override
+    public void initializeFinanceParameter(Long accountSetId, FmsAccountSetInitializeReqVO initializeReqVO) {
+        // 1. 校验科目层级和编码规则
+        List<Integer> subjectCodeRules = parseSubjectCodeRules(initializeReqVO.getSubjectCodeRule());
+        validateSubjectCodeRules(initializeReqVO.getLevel(), subjectCodeRules);
+
+        // 2. 创建财务参数
+        FmsFinanceParameterDO financeParameter = new FmsFinanceParameterDO().setAccountSetId(accountSetId)
+                .setLevel(initializeReqVO.getLevel()).setSubjectCodeRule(initializeReqVO.getSubjectCodeRule())
+                .setLedgerBalanceMode(initializeReqVO.getLedgerBalanceMode())
+                .setVoucherReviewRequired(FmsFinanceParameterDO.DEFAULT_VOUCHER_REVIEW_REQUIRED)
+                .setDeficitCheck(FmsFinanceParameterDO.DEFAULT_DEFICIT_CHECK)
+                .setAssetPeriodLocked(FmsFinanceParameterDO.DEFAULT_ASSET_PERIOD_LOCKED);
+        financeParameterMapper.insert(financeParameter);
+    }
+
+    @Override
+    public FmsFinanceParameterDO getFinanceParameter(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询财务参数
+        return getFinanceParameter(accountSetId);
+    }
+
+    @Override
+    public FmsFinanceParameterDO getFinanceParameter(Long accountSetId) {
+        return financeParameterMapper.selectByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public String convertStandardSubjectCode(String standardCode, String subjectCodeRule) {
+        // 1. 解析标准编码规则和账套实际编码规则
+        List<Integer> standardRules = parseSubjectCodeRules(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE);
+        List<Integer> actualRules = parseSubjectCodeRules(subjectCodeRule);
+        // 2. 按科目层级逐段扩展编码
+        StringBuilder result = new StringBuilder();
+        int offset = 0;
+        for (int index = 0; index < standardRules.size() && offset < standardCode.length(); index++) {
+            int standardLength = standardRules.get(index);
+            int actualLength = actualRules.get(index);
+            if (offset + standardLength > standardCode.length()) {
+                throw exception(ACCOUNT_SET_SETTINGS_RULE_INVALID);
+            }
+            String segment = standardCode.substring(offset, offset + standardLength);
+            int increment = actualLength - standardLength;
+            if (increment > 0 && index == 0) {
+                result.append(segment.charAt(0)).append(CharSequenceUtil.repeat('0', increment)).append(segment.substring(1));
+            } else if (increment > 0) {
+                result.append(CharSequenceUtil.repeat('0', increment)).append(segment);
+            } else {
+                result.append(segment);
+            }
+            offset += standardLength;
+        }
+        // 3. 标准编码必须由完整的科目层级组成
+        if (offset != standardCode.length()) {
+            throw exception(ACCOUNT_SET_SETTINGS_RULE_INVALID);
+        }
+        return result.toString();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_FINANCE_PARAMETER_TYPE, subType = FMS_FINANCE_PARAMETER_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.accountSetId}}", success = FMS_FINANCE_PARAMETER_UPDATE_SUCCESS)
+    public void updateFinanceParameter(FmsFinanceParameterUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetWritePermission(
+                updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验账套初始化状态
+        validateAccountSetInitialized(accountSet);
+
+        // 2. 校验财务参数和编码规则
+        FmsFinanceParameterDO financeParameter = validateFinanceParameterExists(accountSet.getId());
+        List<Integer> oldRules = parseSubjectCodeRules(financeParameter.getSubjectCodeRule());
+        List<Integer> newRules = parseSubjectCodeRules(updateReqVO.getSubjectCodeRule());
+        validateSubjectCodeRules(financeParameter.getLevel(), oldRules, updateReqVO.getLevel(), newRules);
+
+        // 3. 扩展现有科目编码并更新财务参数
+        subjectService.expandSubjectCodes(accountSet.getId(), oldRules, newRules);
+        if (updateReqVO.getStandard() != null && !ObjUtil.equal(accountSet.getStandard(), updateReqVO.getStandard())) {
+            accountSetService.updateAccountSetStandard(accountSet.getId(), updateReqVO.getStandard(), userId);
+        }
+        // 当前页面未维护的领域参数保持原值
+        financeParameterMapper.updateById(new FmsFinanceParameterDO().setId(financeParameter.getId())
+                .setLevel(updateReqVO.getLevel()).setSubjectCodeRule(updateReqVO.getSubjectCodeRule())
+                .setLedgerBalanceMode(updateReqVO.getLedgerBalanceMode())
+                .setVoucherReviewRequired(updateReqVO.getVoucherReviewRequired()));
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("accountSet", accountSet);
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(financeParameter, FmsFinanceParameterUpdateReqVO.class));
+    }
+
+    private FmsFinanceParameterDO validateFinanceParameterExists(Long accountSetId) {
+        FmsFinanceParameterDO financeParameter = financeParameterMapper.selectByAccountSetId(accountSetId);
+        if (financeParameter == null) {
+            throw exception(FINANCE_PARAMETER_NOT_EXISTS);
+        }
+        return financeParameter;
+    }
+
+    private void validateAccountSetInitialized(FmsAccountSetDO accountSet) {
+        if (Boolean.TRUE.equals(accountSet.getInitialized())) {
+            return;
+        }
+        throw exception(ACCOUNT_SET_NOT_INITIALIZED);
+    }
+
+    private static List<Integer> parseSubjectCodeRules(String subjectCodeRule) {
+        return StrUtils.splitToInteger(subjectCodeRule, "-");
+    }
+
+    private static void validateSubjectCodeRules(Integer level, List<Integer> rules) {
+        if (ObjUtil.notEqual(rules.size(), level) || rules.stream().anyMatch(
+                rule -> rule < SUBJECT_CODE_LENGTH_MIN || rule > SUBJECT_CODE_LENGTH_MAX)) {
+            throw exception(ACCOUNT_SET_SETTINGS_RULE_INVALID);
+        }
+    }
+
+    /**
+     * 校验财务参数只扩展科目层级和各级编码长度，避免已使用的科目编码失效
+     *
+     * 每级编码长度限制为 2 至 5 位，与既有财务规则保持一致
+     *
+     * @param oldLevel 原科目层级
+     * @param oldRules 原科目编码规则
+     * @param newLevel 新科目层级
+     * @param newRules 新科目编码规则
+     */
+    private static void validateSubjectCodeRules(Integer oldLevel, List<Integer> oldRules,
+            Integer newLevel, List<Integer> newRules) {
+        validateSubjectCodeRules(newLevel, newRules);
+        if (newLevel < oldLevel || oldRules.size() != oldLevel) {
+            throw exception(ACCOUNT_SET_SETTINGS_RULE_SHRINK);
+        }
+        for (int index = 0; index < oldRules.size(); index++) {
+            if (newRules.get(index) < oldRules.get(index)) {
+                throw exception(ACCOUNT_SET_SETTINGS_RULE_SHRINK);
+            }
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceService.java
new file mode 100644
index 0000000..3eb1a00
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceService.java
@@ -0,0 +1,102 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsTrialBalanceRespVO;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 初始余额 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsInitialBalanceService {
+
+    /**
+     * 获得初始余额列表
+     *
+     * 返回按科目层级展开的平铺列表，父级科目排在子级之前，父级余额由末级科目逐级汇总
+     *
+     * @param accountSetId 账套编号
+     * @param subjectType 科目类别
+     * @param userId 用户编号
+     * @return 初始余额列表
+     */
+    List<FmsInitialBalanceRespVO> getInitialBalanceList(Long accountSetId, Integer subjectType, Long userId);
+
+    /**
+     * 保存初始余额
+     *
+     * @param saveReqVO 保存信息
+     * @param userId 用户编号
+     */
+    void saveInitialBalance(FmsInitialBalanceSaveReqVO saveReqVO, Long userId);
+
+    /**
+     * 获得试算平衡结果
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 试算平衡结果
+     */
+    FmsTrialBalanceRespVO getTrialBalance(Long accountSetId, Long userId);
+
+    /**
+     * 导入初始余额
+     *
+     * @param accountSetId 账套编号
+     * @param rows Excel 数据
+     * @param userId 用户编号
+     * @return 导入数量
+     */
+    int importInitialBalance(Long accountSetId, List<FmsInitialBalanceExcelVO> rows, Long userId);
+
+    /**
+     * 获得指定科目的初始余额数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号数组
+     * @return 初始余额数量
+     */
+    Long getInitialBalanceCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 获得指定科目包含数量数据的初始余额数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号数组
+     * @return 初始余额数量
+     */
+    Long getInitialBalanceQuantityCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 迁移科目的初始余额
+     *
+     * @param accountSetId 账套编号
+     * @param subjectId 科目编号
+     * @param targetSubjectId 目标科目编号
+     */
+    void updateInitialBalanceSubject(Long accountSetId, Long subjectId, Long targetSubjectId);
+
+    /**
+     * 获得引用指定辅助核算项目的初始余额数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryItemIds 辅助核算项目编号数组
+     * @return 初始余额数量
+     */
+    Long getInitialBalanceCountByAuxiliaryItemIds(Long accountSetId, Collection<Long> auxiliaryItemIds);
+
+    /**
+     * 获得引用指定辅助核算类别的初始余额数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @return 初始余额数量
+     */
+    Long getInitialBalanceCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceServiceImpl.java
new file mode 100644
index 0000000..62dda3e
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceServiceImpl.java
@@ -0,0 +1,725 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.map.MapUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsTrialBalanceRespVO;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsInitialBalanceDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsInitialBalanceMapper;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Collection;
+import java.util.Comparator;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.function.Predicate;
+import java.util.stream.Collectors;
+import java.util.stream.Stream;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sumBigDecimal;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_AUXILIARY_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_IMPORT_ROW_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_PERIOD_CLOSED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_PROFIT_LOSS_YEAR_OPENING_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_SUBJECT_NOT_LEAF;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+
+/**
+ * FMS 初始余额 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsInitialBalanceServiceImpl implements FmsInitialBalanceService {
+
+    private static final BigDecimal ZERO = BigDecimal.ZERO;
+
+    @Resource
+    private FmsInitialBalanceMapper initialBalanceMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @Resource
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+    @Resource
+    @Lazy // 延迟加载，避免与结账 Service 循环依赖
+    private FmsClosingPeriodService closingPeriodService;
+
+    @Override
+    public List<FmsInitialBalanceRespVO> getInitialBalanceList(Long accountSetId, Integer subjectType, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 加载科目、辅助核算类别和科目余额
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, subjectType, userId);
+        Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap = getAuxiliaryTypeMap(accountSetId, subjects);
+        Map<Long, FmsInitialBalanceDO> balanceMap = convertMap(
+                initialBalanceMapper.selectListByAccountSetId(accountSetId), FmsInitialBalanceDO::getSubjectId);
+
+        // 2.1 构建平铺列表，父级科目按编码排在子级之前
+        Map<Long, FmsInitialBalanceRespVO> balanceVOMap = new LinkedHashMap<>();
+        subjects.forEach(subject -> balanceVOMap.put(subject.getId(),
+                buildInitialBalanceRespVO(subject, balanceMap.get(subject.getId()), auxiliaryTypeMap)));
+        List<FmsInitialBalanceRespVO> list = new ArrayList<>(balanceVOMap.values());
+        list.sort(Comparator.comparing(FmsInitialBalanceRespVO::getSubjectCode)
+                .thenComparing(FmsInitialBalanceRespVO::getSubjectId));
+        // 2.2 父级余额由末级科目逐级汇总
+        aggregateParentBalances(list, balanceVOMap);
+        return list;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_INITIAL_BALANCE_TYPE, subType = FMS_INITIAL_BALANCE_SAVE_SUB_TYPE,
+            bizNo = "{{#saveReqVO.accountSetId}}", success = FMS_INITIAL_BALANCE_SAVE_SUCCESS)
+    public void saveInitialBalance(FmsInitialBalanceSaveReqVO saveReqVO, Long userId) {
+        // 1. 校验账套写权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetWritePermission(
+                saveReqVO.getAccountSetId(), userId);
+
+        // 2. 保存财务初始余额
+        saveInitialBalance(saveReqVO, userId, accountSet);
+    }
+
+    /**
+     * 保存财务初始余额
+     *
+     * @param saveReqVO 保存信息
+     * @param userId 用户编号
+     * @param accountSet 账套
+     */
+    private void saveInitialBalance(FmsInitialBalanceSaveReqVO saveReqVO, Long userId, FmsAccountSetDO accountSet) {
+        // 1.1 校验结账状态
+        validateAccountSetEditable(accountSet);
+        // 1.2 加载科目和辅助核算类别
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(saveReqVO.getAccountSetId(), null, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap = getAuxiliaryTypeMap(saveReqVO.getAccountSetId(), subjects);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId);
+        // 1.3 校验科目余额
+        for (FmsInitialBalanceSaveReqVO.Balance reqVO : saveReqVO.getBalances()) {
+            validateSaveBalance(subjectMap.get(reqVO.getSubjectId()), parentIds, reqVO);
+        }
+
+        // 2. 构建科目余额
+        List<FmsInitialBalanceDO> balances = convertList(saveReqVO.getBalances(),
+                reqVO -> buildBalance(saveReqVO.getAccountSetId(), subjectMap.get(reqVO.getSubjectId()),
+                        reqVO, auxiliaryTypeMap));
+
+        // 3.1 批量查询已有科目余额
+        Map<Long, FmsInitialBalanceDO> existingMap = convertMap(
+                initialBalanceMapper.selectListByAccountSetIdAndSubjectIds(saveReqVO.getAccountSetId(),
+                        convertList(balances, FmsInitialBalanceDO::getSubjectId)), FmsInitialBalanceDO::getSubjectId);
+        // 3.2 拆分新增和更新的科目余额
+        List<FmsInitialBalanceDO> insertBalances = new ArrayList<>();
+        List<FmsInitialBalanceDO> updateBalances = new ArrayList<>();
+        balances.forEach(balance -> {
+            FmsInitialBalanceDO existing = existingMap.get(balance.getSubjectId());
+            if (existing == null) {
+                insertBalances.add(balance);
+            } else {
+                balance.setId(existing.getId());
+                updateBalances.add(balance);
+            }
+        });
+        // 3.3 批量新增或更新科目余额
+        if (CollUtil.isNotEmpty(insertBalances)) {
+            initialBalanceMapper.insertBatch(insertBalances);
+        }
+        if (CollUtil.isNotEmpty(updateBalances)) {
+            initialBalanceMapper.updateBatch(updateBalances);
+        }
+    }
+
+    @Override
+    public FmsTrialBalanceRespVO getTrialBalance(Long accountSetId, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 加载末级科目余额
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        List<FmsInitialBalanceDO> balances = filterList(initialBalanceMapper.selectListByAccountSetId(accountSetId),
+                balance -> !parentIds.contains(balance.getSubjectId())
+                        && subjectMap.containsKey(balance.getSubjectId()));
+
+        // 2.1 汇总期初和本年累计的借贷金额
+        BigDecimal openingDebitAmount = sumByDirection(balances, subjectMap,
+                FmsDebitCreditDirectionEnum.DEBIT.getType(), FmsInitialBalanceDO::getOpeningAmount);
+        BigDecimal openingCreditAmount = sumByDirection(balances, subjectMap,
+                FmsDebitCreditDirectionEnum.CREDIT.getType(), FmsInitialBalanceDO::getOpeningAmount);
+        BigDecimal yearDebitAmount = sumBigDecimal(balances, FmsInitialBalanceDO::getYearDebitAmount);
+        BigDecimal yearCreditAmount = sumBigDecimal(balances, FmsInitialBalanceDO::getYearCreditAmount);
+        BigDecimal openingDifferenceAmount = openingDebitAmount.subtract(openingCreditAmount);
+        BigDecimal yearDifferenceAmount = yearDebitAmount.subtract(yearCreditAmount);
+        // 2.2 构建试算平衡结果
+        return new FmsTrialBalanceRespVO().setOpeningDebitAmount(openingDebitAmount)
+                .setOpeningCreditAmount(openingCreditAmount).setOpeningDifferenceAmount(openingDifferenceAmount)
+                .setYearDebitAmount(yearDebitAmount).setYearCreditAmount(yearCreditAmount)
+                .setYearDifferenceAmount(yearDifferenceAmount)
+                .setBalanced(openingDifferenceAmount.signum() == 0 && yearDifferenceAmount.signum() == 0);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_INITIAL_BALANCE_TYPE, subType = FMS_INITIAL_BALANCE_IMPORT_SUB_TYPE,
+            bizNo = "{{#accountSetId}}", success = FMS_INITIAL_BALANCE_IMPORT_SUCCESS)
+    public int importInitialBalance(Long accountSetId,
+            List<FmsInitialBalanceExcelVO> rows, Long userId) {
+        // 1.1 校验账套写权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验结账状态
+        validateAccountSetEditable(accountSet);
+        // 1.3 加载科目和辅助核算项目
+        boolean january = LocalDateTimeUtils.isJanuary(accountSet.getStartTime());
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode);
+        Set<Long> parentIds = convertSet(subjects, FmsSubjectDO::getParentId);
+        List<FmsAuxiliaryTypeDO> auxiliaryTypes = auxiliaryTypeService
+                .getAuxiliaryTypeList(accountSetId, userId);
+        Map<String, FmsAuxiliaryTypeDO> auxiliaryTypeMap = convertMap(auxiliaryTypes, FmsAuxiliaryTypeDO::getName);
+        Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeIdMap = convertMap(
+                auxiliaryTypes, FmsAuxiliaryTypeDO::getId);
+        List<FmsAuxiliaryItemDO> auxiliaryItems = auxiliaryItemService
+                .getAuxiliaryItemListByAccountSetId(accountSetId, userId);
+        Map<Long, List<FmsAuxiliaryItemDO>> auxiliaryItemMap = auxiliaryItems.stream()
+                .collect(Collectors.groupingBy(FmsAuxiliaryItemDO::getAuxiliaryTypeId));
+
+        // 2. 校验并转换导入数据
+        Map<Long, FmsInitialBalanceSaveReqVO.Balance> balanceMap = new LinkedHashMap<>();
+        Set<String> rowKeys = new HashSet<>();
+        for (FmsInitialBalanceExcelVO row : rows) {
+            // 2.1 校验科目和金额，辅助核算科目的全零明细行直接跳过
+            FmsSubjectDO subject = subjectMap.get(row.getSubjectCode());
+            validateImportSubject(row, subject, parentIds);
+            if (CollUtil.isNotEmpty(subject.getAuxiliaryTypeIds())
+                    && StrUtil.isBlank(row.getAuxiliaryItems()) && isZeroRow(row)) {
+                continue;
+            }
+            // 2.2 同一科目和辅助核算项目组合只允许出现一次
+            String rowKey = subject.getId() + "#" + row.getAuxiliaryItems();
+            if (!rowKeys.add(rowKey)) {
+                throw importRowException(row, "科目和辅助核算项目重复");
+            }
+            // 2.3 未启用辅助核算的科目直接复制金额，启用时按辅助核算项目逐行转换
+            FmsInitialBalanceSaveReqVO.Balance balance = balanceMap.computeIfAbsent(subject.getId(),
+                    key -> new FmsInitialBalanceSaveReqVO.Balance().setSubjectId(subject.getId())
+                            .setAssistBalances(new ArrayList<>()));
+            if (CollUtil.isEmpty(subject.getAuxiliaryTypeIds())) {
+                if (StrUtil.isNotBlank(row.getAuxiliaryItems())) {
+                    throw importRowException(row, "该科目未启用辅助核算");
+                }
+                copyAmounts(row, balance, subject, january);
+                continue;
+            }
+            FmsInitialBalanceSaveReqVO.AssistBalance assistBalance = new FmsInitialBalanceSaveReqVO.AssistBalance()
+                    .setAuxiliaryItemIds(parseAuxiliaryItemIds(row, subject, auxiliaryTypeMap, auxiliaryTypeIdMap, auxiliaryItemMap));
+            copyAmounts(row, assistBalance, subject, january);
+            balance.getAssistBalances().add(assistBalance);
+        }
+        if (MapUtil.isEmpty(balanceMap)) {
+            return 0;
+        }
+
+        // 3. 复用页面保存校验和持久化逻辑
+        FmsInitialBalanceSaveReqVO saveReqVO = new FmsInitialBalanceSaveReqVO()
+                .setAccountSetId(accountSetId).setBalances(new ArrayList<>(balanceMap.values()));
+        saveInitialBalance(saveReqVO, userId, accountSet);
+        return balanceMap.size();
+    }
+
+    @Override
+    public Long getInitialBalanceCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        return initialBalanceMapper.selectCountByAccountSetIdAndSubjectIds(accountSetId, subjectIds);
+    }
+
+    @Override
+    public Long getInitialBalanceQuantityCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        List<FmsInitialBalanceDO> balances = initialBalanceMapper.selectListByAccountSetIdAndSubjectIds(
+                accountSetId, subjectIds);
+        return (long) CollUtil.count(balances, this::hasQuantityData);
+    }
+
+    @Override
+    public void updateInitialBalanceSubject(Long accountSetId, Long subjectId, Long targetSubjectId) {
+        initialBalanceMapper.updateSubject(accountSetId, subjectId,
+                new FmsInitialBalanceDO().setSubjectId(targetSubjectId));
+    }
+
+    @Override
+    public Long getInitialBalanceCountByAuxiliaryItemIds(
+            Long accountSetId, Collection<Long> auxiliaryItemIds) {
+        if (CollUtil.isEmpty(auxiliaryItemIds)) {
+            return 0L;
+        }
+        Set<Long> auxiliaryItemIdSet = new HashSet<>(auxiliaryItemIds);
+        return countInitialBalancesByAuxiliary(accountSetId,
+                item -> auxiliaryItemIdSet.contains(item.getItemId()));
+    }
+
+    @Override
+    public Long getInitialBalanceCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId) {
+        return countInitialBalancesByAuxiliary(accountSetId,
+                item -> ObjUtil.equal(item.getTypeId(), auxiliaryTypeId));
+    }
+
+    /**
+     * 统计辅助核算项目满足条件的初始余额数量
+     */
+    private Long countInitialBalancesByAuxiliary(Long accountSetId,
+            Predicate<FmsInitialBalanceDO.AuxiliaryItem> predicate) {
+        List<FmsInitialBalanceDO> balances = initialBalanceMapper.selectListByAccountSetId(accountSetId);
+        // 展开每条初始余额的辅助核算项，任一辅助核算命中条件即计入
+        return (long) CollUtil.count(balances, balance -> CollUtil.isNotEmpty(balance.getAssistBalances())
+                && balance.getAssistBalances().stream()
+                        .filter(assistBalance -> CollUtil.isNotEmpty(assistBalance.getAuxiliaries()))
+                        .flatMap(assistBalance -> assistBalance.getAuxiliaries().stream())
+                        .anyMatch(predicate));
+    }
+
+    /**
+     * 判断初始余额是否包含数量数据
+     *
+     * @param balance 初始余额
+     * @return 是否包含数量数据
+     */
+    private boolean hasQuantityData(FmsInitialBalanceDO balance) {
+        // 科目余额存在实际数量
+        if (hasQuantityData(balance.getOpeningQuantity(), balance.getYearDebitQuantity(),
+                balance.getYearCreditQuantity(), balance.getYearOpeningQuantity(),
+                balance.getProfitLossQuantity())) {
+            return true;
+        }
+        // 辅助核算余额存在实际数量
+        return CollUtil.isNotEmpty(balance.getAssistBalances())
+                && CollUtil.findOne(balance.getAssistBalances(), assistBalance -> hasQuantityData(
+                        assistBalance.getOpeningQuantity(), assistBalance.getYearDebitQuantity(),
+                        assistBalance.getYearCreditQuantity(), assistBalance.getYearOpeningQuantity(),
+                        assistBalance.getProfitLossQuantity())) != null;
+    }
+
+    private boolean hasQuantityData(BigDecimal... quantities) {
+        return Stream.of(quantities).anyMatch(quantity -> NumberUtils.zeroIfNull(quantity).signum() != 0);
+    }
+
+    /**
+     * 校验账套未结账，结账后初始余额不允许修改或导入
+     */
+    private void validateAccountSetEditable(FmsAccountSetDO accountSet) {
+        if (ObjUtil.notEqual(closingPeriodService.getCurrentMonth(accountSet.getId(),
+                accountSet.getStartTime()), YearMonth.from(accountSet.getStartTime()))) {
+            throw exception(INITIAL_BALANCE_PERIOD_CLOSED);
+        }
+    }
+
+    /**
+     * 校验科目余额：科目必须存在且为末级，损益类科目的年初余额必须为 0
+     */
+    private void validateSaveBalance(FmsSubjectDO subject, Set<Long> parentIds,
+            FmsInitialBalanceSaveReqVO.Balance reqVO) {
+        if (subject == null) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+        if (parentIds.contains(subject.getId())) {
+            throw exception(INITIAL_BALANCE_SUBJECT_NOT_LEAF);
+        }
+        validateProfitLossBalance(subject, reqVO.getYearOpeningAmount());
+    }
+
+    /**
+     * 汇总父级科目余额：非末级科目先清零，再按“方向相同取正、相反取负”自底向上累加子级
+     */
+    private void aggregateParentBalances(List<FmsInitialBalanceRespVO> list,
+            Map<Long, FmsInitialBalanceRespVO> balanceVOMap) {
+        // 1. 非末级科目的余额由子级汇总，先清零
+        Set<Long> parentIds = convertSet(list, FmsInitialBalanceRespVO::getParentId);
+        list.forEach(balanceVO -> {
+            if (parentIds.contains(balanceVO.getSubjectId())) {
+                setZeroAmounts(balanceVO);
+            }
+        });
+        // 2. 平铺列表父级在前，倒序遍历时子级先完成汇总，再逐级累加到父级
+        for (int index = list.size() - 1; index >= 0; index--) {
+            FmsInitialBalanceRespVO balanceVO = list.get(index);
+            FmsInitialBalanceRespVO parent = balanceVOMap.get(balanceVO.getParentId());
+            if (parent == null) {
+                continue;
+            }
+            accumulateParentBalance(parent, balanceVO);
+        }
+    }
+
+    /**
+     * 将子级科目余额累加到父级：期初、年初和损益发生额均按余额方向取符号，累计发生额按借贷分别累加
+     */
+    private void accumulateParentBalance(FmsInitialBalanceRespVO parent, FmsInitialBalanceRespVO child) {
+        parent.setOpeningAmount(parent.getOpeningAmount().add(directional(child.getOpeningAmount(), child, parent)));
+        parent.setOpeningQuantity(parent.getOpeningQuantity().add(directional(child.getOpeningQuantity(), child, parent)));
+        parent.setYearDebitAmount(parent.getYearDebitAmount().add(child.getYearDebitAmount()));
+        parent.setYearDebitQuantity(parent.getYearDebitQuantity().add(child.getYearDebitQuantity()));
+        parent.setYearCreditAmount(parent.getYearCreditAmount().add(child.getYearCreditAmount()));
+        parent.setYearCreditQuantity(parent.getYearCreditQuantity().add(child.getYearCreditQuantity()));
+        parent.setYearOpeningAmount(parent.getYearOpeningAmount().add(directional(child.getYearOpeningAmount(), child, parent)));
+        parent.setYearOpeningQuantity(parent.getYearOpeningQuantity().add(directional(child.getYearOpeningQuantity(), child, parent)));
+        parent.setProfitLossAmount(parent.getProfitLossAmount().add(
+                directional(child.getProfitLossAmount(), child, parent)));
+        parent.setProfitLossQuantity(parent.getProfitLossQuantity().add(
+                directional(child.getProfitLossQuantity(), child, parent)));
+    }
+
+    /**
+     * 子级与父级余额方向相同时取正数，相反时取负数
+     */
+    private BigDecimal directional(BigDecimal amount, FmsInitialBalanceRespVO child, FmsInitialBalanceRespVO parent) {
+        return ObjUtil.equal(child.getBalanceDirection(), parent.getBalanceDirection()) ? amount : amount.negate();
+    }
+
+    /**
+     * 构建科目余额，启用辅助核算时科目金额由辅助核算明细汇总
+     */
+    private FmsInitialBalanceDO buildBalance(Long accountSetId, FmsSubjectDO subject,
+                                             FmsInitialBalanceSaveReqVO.Balance reqVO,
+                                             Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap) {
+        boolean auxiliaryAccounting = CollUtil.isNotEmpty(subject.getAuxiliaryTypeIds());
+        FmsInitialBalanceDO balance = new FmsInitialBalanceDO().setSubjectId(subject.getId())
+                .setAccountSetId(accountSetId).setAuxiliaryAccounting(auxiliaryAccounting)
+                .setAssistBalances(Collections.emptyList());
+        if (auxiliaryAccounting) {
+            List<FmsInitialBalanceDO.AssistBalance> assistBalances = buildAssistBalances(
+                    accountSetId, subject, reqVO.getAssistBalances(), auxiliaryTypeMap);
+            balance.setAssistBalances(assistBalances);
+            sumAssistBalances(balance, assistBalances);
+            return balance;
+        }
+        copyAmounts(reqVO, balance);
+        return balance;
+    }
+
+    /**
+     * 构建辅助核算余额明细：逐项校验项目与科目配置，并获取或创建辅助核算组合
+     */
+    private List<FmsInitialBalanceDO.AssistBalance> buildAssistBalances(Long accountSetId,
+            FmsSubjectDO subject, List<FmsInitialBalanceSaveReqVO.AssistBalance> reqVOs,
+            Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap) {
+        if (CollUtil.isEmpty(reqVOs)) {
+            return Collections.emptyList();
+        }
+        List<FmsInitialBalanceDO.AssistBalance> result = new ArrayList<>();
+        Set<Long> combinationIds = new HashSet<>();
+        for (FmsInitialBalanceSaveReqVO.AssistBalance reqVO : reqVOs) {
+            // 1. 校验辅助核算项目与科目启用的类别一致
+            List<Long> itemIds = new ArrayList<>(new LinkedHashSet<>(reqVO.getAuxiliaryItemIds()));
+            List<FmsAuxiliaryItemDO> items = auxiliaryItemService.validateAuxiliaryItemList(accountSetId, itemIds);
+            Map<Long, FmsAuxiliaryItemDO> itemMap = convertMap(items, FmsAuxiliaryItemDO::getAuxiliaryTypeId);
+            if (ObjUtil.notEqual(itemMap.size(), subject.getAuxiliaryTypeIds().size())
+                    || subject.getAuxiliaryTypeIds().stream().anyMatch(
+                    auxiliaryTypeId -> !itemMap.containsKey(auxiliaryTypeId))) {
+                throw exception(INITIAL_BALANCE_AUXILIARY_INVALID);
+            }
+            // 2. 按科目启用的类别顺序，构建辅助核算组合明细
+            List<FmsAuxiliaryCombinationDO.AuxiliaryItem> combinationItems = new ArrayList<>();
+            List<FmsInitialBalanceDO.AuxiliaryItem> auxiliaryItems = new ArrayList<>();
+            subject.getAuxiliaryTypeIds().forEach(auxiliaryTypeId -> {
+                FmsAuxiliaryTypeDO auxiliaryType = auxiliaryTypeMap.get(auxiliaryTypeId);
+                FmsAuxiliaryItemDO item = itemMap.get(auxiliaryTypeId);
+                combinationItems.add(FmsAuxiliaryCombinationDO.AuxiliaryItem.builder()
+                        .type(auxiliaryType.getType()).typeId(auxiliaryTypeId)
+                        .itemId(item.getId()).name(item.getName()).build());
+                auxiliaryItems.add(FmsInitialBalanceDO.AuxiliaryItem.builder()
+                        .type(auxiliaryType.getType()).typeId(auxiliaryTypeId)
+                        .itemId(item.getId()).name(item.getName()).build());
+            });
+            // 3. 保存辅助核算组合，同一科目下同一组合只允许一条明细
+            FmsAuxiliaryCombinationDO combination = auxiliaryCombinationService.saveAuxiliaryCombination(
+                    accountSetId, subject.getId(), combinationItems);
+            if (!combinationIds.add(combination.getId())) {
+                throw exception(INITIAL_BALANCE_AUXILIARY_INVALID);
+            }
+            FmsInitialBalanceDO.AssistBalance assist = new FmsInitialBalanceDO.AssistBalance()
+                    .setAssistCombinationId(combination.getId()).setAuxiliaries(auxiliaryItems);
+            copyAmounts(reqVO, assist);
+            validateProfitLossBalance(subject, assist.getYearOpeningAmount());
+            result.add(assist);
+        }
+        return result;
+    }
+
+    /**
+     * 构建科目初始余额响应，无余额记录时金额按 0 返回
+     */
+    private FmsInitialBalanceRespVO buildInitialBalanceRespVO(FmsSubjectDO subject,
+            FmsInitialBalanceDO balance, Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap) {
+        FmsInitialBalanceRespVO respVO = new FmsInitialBalanceRespVO().setSubjectId(subject.getId())
+                .setSubjectCode(subject.getCode()).setSubjectName(subject.getName())
+                .setParentId(subject.getParentId()).setType(subject.getType())
+                .setBalanceDirection(subject.getBalanceDirection())
+                .setQuantityAccounting(subject.getQuantityAccounting()).setQuantityUnit(subject.getQuantityUnit())
+                .setAuxiliaryAccounting(CollUtil.isNotEmpty(subject.getAuxiliaryTypeIds()))
+                .setAuxiliaryConfigs(convertList(subject.getAuxiliaryTypeIds(), auxiliaryTypeId -> {
+                    FmsAuxiliaryTypeDO auxiliaryType = auxiliaryTypeMap.get(auxiliaryTypeId);
+                    return new FmsInitialBalanceRespVO.AuxiliaryConfig().setAuxiliaryTypeId(auxiliaryTypeId)
+                            .setType(auxiliaryType.getType()).setName(auxiliaryType.getName());
+                }));
+        if (balance == null) {
+            setZeroAmounts(respVO);
+            respVO.setAssistBalances(Collections.emptyList());
+            return respVO;
+        }
+        respVO.setId(balance.getId());
+        copyAmounts(balance, respVO);
+        if (CollUtil.isEmpty(balance.getAssistBalances())) {
+            respVO.setAssistBalances(Collections.emptyList());
+        } else {
+            respVO.setAssistBalances(convertList(balance.getAssistBalances(), assist -> {
+                FmsInitialBalanceRespVO.AssistBalance assistVO =
+                        BeanUtils.toBean(assist, FmsInitialBalanceRespVO.AssistBalance.class);
+                assistVO.setAuxiliaries(convertList(assist.getAuxiliaries(),
+                        item -> BeanUtils.toBean(item, FmsInitialBalanceRespVO.AuxiliaryItem.class)));
+                return assistVO;
+            }));
+        }
+        return respVO;
+    }
+
+    private void copyAmounts(FmsInitialBalanceDO source, FmsInitialBalanceRespVO target) {
+        target.setOpeningAmount(NumberUtils.zeroIfNull(source.getOpeningAmount()))
+                .setOpeningQuantity(NumberUtils.zeroIfNull(source.getOpeningQuantity()))
+                .setYearDebitAmount(NumberUtils.zeroIfNull(source.getYearDebitAmount()))
+                .setYearDebitQuantity(NumberUtils.zeroIfNull(source.getYearDebitQuantity()))
+                .setYearCreditAmount(NumberUtils.zeroIfNull(source.getYearCreditAmount()))
+                .setYearCreditQuantity(NumberUtils.zeroIfNull(source.getYearCreditQuantity()))
+                .setYearOpeningAmount(NumberUtils.zeroIfNull(source.getYearOpeningAmount()))
+                .setYearOpeningQuantity(NumberUtils.zeroIfNull(source.getYearOpeningQuantity()))
+                .setProfitLossAmount(NumberUtils.zeroIfNull(source.getProfitLossAmount()))
+                .setProfitLossQuantity(NumberUtils.zeroIfNull(source.getProfitLossQuantity()));
+    }
+
+    /**
+     * 汇总指定余额方向的金额
+     */
+    private BigDecimal sumByDirection(List<FmsInitialBalanceDO> balances,
+            Map<Long, FmsSubjectDO> subjectMap, Integer direction,
+            Function<FmsInitialBalanceDO, BigDecimal> getter) {
+        List<FmsInitialBalanceDO> directionBalances = filterList(balances, balance -> ObjUtil.equal(
+                subjectMap.get(balance.getSubjectId()).getBalanceDirection(), direction));
+        return sumBigDecimal(directionBalances, getter);
+    }
+
+    private void copyAmounts(FmsInitialBalanceSaveReqVO.Amounts source, FmsInitialBalanceDO target) {
+        target.setOpeningAmount(NumberUtils.zeroIfNull(source.getOpeningAmount()))
+                .setOpeningQuantity(NumberUtils.zeroIfNull(source.getOpeningQuantity()))
+                .setYearDebitAmount(NumberUtils.zeroIfNull(source.getYearDebitAmount()))
+                .setYearDebitQuantity(NumberUtils.zeroIfNull(source.getYearDebitQuantity()))
+                .setYearCreditAmount(NumberUtils.zeroIfNull(source.getYearCreditAmount()))
+                .setYearCreditQuantity(NumberUtils.zeroIfNull(source.getYearCreditQuantity()))
+                .setYearOpeningAmount(NumberUtils.zeroIfNull(source.getYearOpeningAmount()))
+                .setYearOpeningQuantity(NumberUtils.zeroIfNull(source.getYearOpeningQuantity()))
+                .setProfitLossAmount(NumberUtils.zeroIfNull(source.getProfitLossAmount()))
+                .setProfitLossQuantity(NumberUtils.zeroIfNull(source.getProfitLossQuantity()));
+    }
+
+    private void copyAmounts(FmsInitialBalanceSaveReqVO.Amounts source,
+            FmsInitialBalanceDO.AssistBalance target) {
+        target.setOpeningAmount(NumberUtils.zeroIfNull(source.getOpeningAmount()))
+                .setOpeningQuantity(NumberUtils.zeroIfNull(source.getOpeningQuantity()))
+                .setYearDebitAmount(NumberUtils.zeroIfNull(source.getYearDebitAmount()))
+                .setYearDebitQuantity(NumberUtils.zeroIfNull(source.getYearDebitQuantity()))
+                .setYearCreditAmount(NumberUtils.zeroIfNull(source.getYearCreditAmount()))
+                .setYearCreditQuantity(NumberUtils.zeroIfNull(source.getYearCreditQuantity()))
+                .setYearOpeningAmount(NumberUtils.zeroIfNull(source.getYearOpeningAmount()))
+                .setYearOpeningQuantity(NumberUtils.zeroIfNull(source.getYearOpeningQuantity()))
+                .setProfitLossAmount(NumberUtils.zeroIfNull(source.getProfitLossAmount()))
+                .setProfitLossQuantity(NumberUtils.zeroIfNull(source.getProfitLossQuantity()));
+    }
+
+    private void sumAssistBalances(FmsInitialBalanceDO balance,
+            List<FmsInitialBalanceDO.AssistBalance> assists) {
+        balance.setOpeningAmount(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getOpeningAmount))
+                .setOpeningQuantity(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getOpeningQuantity))
+                .setYearDebitAmount(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getYearDebitAmount))
+                .setYearDebitQuantity(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getYearDebitQuantity))
+                .setYearCreditAmount(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getYearCreditAmount))
+                .setYearCreditQuantity(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getYearCreditQuantity))
+                .setYearOpeningAmount(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getYearOpeningAmount))
+                .setYearOpeningQuantity(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getYearOpeningQuantity))
+                .setProfitLossAmount(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getProfitLossAmount))
+                .setProfitLossQuantity(sumBigDecimal(assists, FmsInitialBalanceDO.AssistBalance::getProfitLossQuantity));
+    }
+
+    private void validateImportSubject(FmsInitialBalanceExcelVO row, FmsSubjectDO subject,
+            Set<Long> parentIds) {
+        if (StrUtil.isBlank(row.getSubjectCode())) {
+            throw importRowException(row, "科目编码不能为空");
+        }
+        if (subject == null) {
+            throw importRowException(row, "科目编码不存在");
+        }
+        if (parentIds.contains(subject.getId())) {
+            throw importRowException(row, "只能导入末级科目");
+        }
+        FmsDebitCreditDirectionEnum direction = FmsDebitCreditDirectionEnum
+                .valueOf(subject.getBalanceDirection());
+        if (StrUtil.isNotBlank(row.getDirectionName())
+                && !StrUtil.equals(direction.getName(), row.getDirectionName())) {
+            throw importRowException(row, "余额方向与科目不一致");
+        }
+        validateAmounts(row);
+    }
+
+    private void validateAmounts(FmsInitialBalanceExcelVO row) {
+        List<BigDecimal> amounts = Arrays.asList(row.getOpeningQuantity(), row.getOpeningAmount(),
+                row.getYearDebitQuantity(), row.getYearDebitAmount(), row.getYearCreditQuantity(),
+                row.getYearCreditAmount(), row.getProfitLossQuantity(), row.getProfitLossAmount());
+        if (amounts.stream().filter(ObjUtil::isNotNull).anyMatch(amount -> amount.signum() < 0)) {
+            throw importRowException(row, "数量和金额不能小于 0");
+        }
+    }
+
+    /**
+     * 解析导入行的辅助核算项目文本，按科目启用的类别顺序返回项目编号
+     */
+    private List<Long> parseAuxiliaryItemIds(FmsInitialBalanceExcelVO row,
+                                             FmsSubjectDO subject, Map<String, FmsAuxiliaryTypeDO> auxiliaryTypeMap,
+                                             Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeIdMap,
+                                             Map<Long, List<FmsAuxiliaryItemDO>> auxiliaryItemMap) {
+        // 1. 按“类别:名称/类别:名称”解析文本，类别不允许重复
+        if (StrUtil.isBlank(row.getAuxiliaryItems())) {
+            throw importRowException(row, "辅助核算项目不能为空");
+        }
+        Map<Long, String> values = new LinkedHashMap<>();
+        for (String segment : StrUtil.split(row.getAuxiliaryItems(), '/')) {
+            List<String> parts = StrUtil.split(segment, ':');
+            if (parts.size() != 2 || StrUtil.isBlank(parts.get(0)) || StrUtil.isBlank(parts.get(1))) {
+                throw importRowException(row, "辅助核算项目格式不正确");
+            }
+            FmsAuxiliaryTypeDO type = auxiliaryTypeMap.get(parts.get(0));
+            if (type == null || values.put(type.getId(), parts.get(1)) != null) {
+                throw importRowException(row, "辅助核算类别不存在或重复");
+            }
+        }
+        // 2. 按科目启用的类别匹配辅助核算项目，名称或编码均可
+        List<Long> itemIds = new ArrayList<>();
+        for (Long auxiliaryTypeId : subject.getAuxiliaryTypeIds()) {
+            String itemValue = values.get(auxiliaryTypeId);
+            if (StrUtil.isBlank(itemValue)) {
+                throw importRowException(row, "辅助核算项目与科目配置不一致");
+            }
+            FmsAuxiliaryItemDO item = CollUtil.findOne(
+                    auxiliaryItemMap.getOrDefault(auxiliaryTypeId, Collections.emptyList()),
+                    candidate -> StrUtil.equals(candidate.getName(), itemValue)
+                            || StrUtil.equals(candidate.getCode(), itemValue));
+            if (item == null) {
+                throw importRowException(row, auxiliaryTypeIdMap.get(auxiliaryTypeId).getName() + "项目不存在");
+            }
+            itemIds.add(item.getId());
+        }
+        // 3. 校验类别数量与科目配置一致
+        if (values.size() != subject.getAuxiliaryTypeIds().size()) {
+            throw importRowException(row, "辅助核算项目与科目配置不一致");
+        }
+        return itemIds;
+    }
+
+    private Map<Long, FmsAuxiliaryTypeDO> getAuxiliaryTypeMap(
+            Long accountSetId, List<FmsSubjectDO> subjects) {
+        List<FmsAuxiliaryTypeDO> list = auxiliaryTypeService.validateAuxiliaryTypeList(accountSetId,
+                convertSetByFlatMap(subjects, FmsSubjectDO::getAuxiliaryTypeIds, List::stream));
+        return convertMap(list, FmsAuxiliaryTypeDO::getId);
+    }
+
+    private void copyAmounts(FmsInitialBalanceExcelVO source,
+            FmsInitialBalanceSaveReqVO.Amounts target, FmsSubjectDO subject, boolean january) {
+        BigDecimal openingAmount = NumberUtils.zeroIfNull(source.getOpeningAmount());
+        BigDecimal openingQuantity = NumberUtils.zeroIfNull(source.getOpeningQuantity());
+        BigDecimal yearDebitAmount = january ? ZERO : NumberUtils.zeroIfNull(source.getYearDebitAmount());
+        BigDecimal yearDebitQuantity = january ? ZERO : NumberUtils.zeroIfNull(source.getYearDebitQuantity());
+        BigDecimal yearCreditAmount = january ? ZERO : NumberUtils.zeroIfNull(source.getYearCreditAmount());
+        BigDecimal yearCreditQuantity = january ? ZERO : NumberUtils.zeroIfNull(source.getYearCreditQuantity());
+        boolean debit = ObjUtil.equal(subject.getBalanceDirection(),
+                FmsDebitCreditDirectionEnum.DEBIT.getType());
+        BigDecimal yearOpeningAmount = january ? ZERO : debit
+                ? openingAmount.subtract(yearDebitAmount).add(yearCreditAmount)
+                : openingAmount.add(yearDebitAmount).subtract(yearCreditAmount);
+        BigDecimal yearOpeningQuantity = january ? ZERO : debit
+                ? openingQuantity.subtract(yearDebitQuantity).add(yearCreditQuantity)
+                : openingQuantity.add(yearDebitQuantity).subtract(yearCreditQuantity);
+        if (yearOpeningAmount.signum() < 0 || yearOpeningQuantity.signum() < 0) {
+            throw importRowException(source, "年初余额不能小于 0");
+        }
+        target.setOpeningAmount(openingAmount).setOpeningQuantity(openingQuantity)
+                .setYearDebitAmount(yearDebitAmount).setYearDebitQuantity(yearDebitQuantity)
+                .setYearCreditAmount(yearCreditAmount).setYearCreditQuantity(yearCreditQuantity)
+                .setYearOpeningAmount(yearOpeningAmount).setYearOpeningQuantity(yearOpeningQuantity)
+                .setProfitLossAmount(january ? ZERO : NumberUtils.zeroIfNull(source.getProfitLossAmount()))
+                .setProfitLossQuantity(january ? ZERO : NumberUtils.zeroIfNull(source.getProfitLossQuantity()));
+    }
+
+    private boolean isZeroRow(FmsInitialBalanceExcelVO row) {
+        List<BigDecimal> amounts = Arrays.asList(row.getOpeningQuantity(), row.getOpeningAmount(),
+                row.getYearDebitQuantity(), row.getYearDebitAmount(), row.getYearCreditQuantity(),
+                row.getYearCreditAmount(), row.getProfitLossQuantity(), row.getProfitLossAmount());
+        return amounts.stream().map(NumberUtils::zeroIfNull).allMatch(amount -> amount.signum() == 0);
+    }
+
+    private RuntimeException importRowException(FmsInitialBalanceExcelVO row, String message) {
+        return exception(INITIAL_BALANCE_IMPORT_ROW_INVALID, row.getRowNumber(), message);
+    }
+
+    private void setZeroAmounts(FmsInitialBalanceRespVO respVO) {
+        respVO.setOpeningAmount(ZERO).setOpeningQuantity(ZERO).setYearDebitAmount(ZERO)
+                .setYearDebitQuantity(ZERO).setYearCreditAmount(ZERO).setYearCreditQuantity(ZERO)
+                .setYearOpeningAmount(ZERO).setYearOpeningQuantity(ZERO)
+                .setProfitLossAmount(ZERO).setProfitLossQuantity(ZERO);
+    }
+
+    private void validateProfitLossBalance(FmsSubjectDO subject, BigDecimal yearOpeningAmount) {
+        if (ObjUtil.equal(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                && NumberUtils.zeroIfNull(yearOpeningAmount).signum() != 0) {
+            throw exception(INITIAL_BALANCE_PROFIT_LOSS_YEAR_OPENING_INVALID);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectService.java
new file mode 100644
index 0000000..e4036f4
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectService.java
@@ -0,0 +1,147 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectDeleteReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectStatusReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectUsageRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+
+import java.util.List;
+
+/**
+ * FMS 会计科目 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsSubjectService {
+
+    /**
+     * 初始化账套会计科目
+     *
+     * @param accountSetId 账套编号
+     */
+    void initializeDefaultSubjects(Long accountSetId);
+
+    /**
+     * 创建会计科目
+     *
+     * @param createReqVO 创建信息
+     * @param userId 当前用户编号
+     * @return 科目编号
+     */
+    Long createSubject(FmsSubjectSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新会计科目
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 当前用户编号
+     */
+    void updateSubject(FmsSubjectSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除会计科目
+     *
+     * @param deleteReqVO 删除信息
+     * @param userId 当前用户编号
+     */
+    void deleteSubjectList(FmsSubjectDeleteReqVO deleteReqVO, Long userId);
+
+    /**
+     * 更新会计科目状态
+     *
+     * @param statusReqVO 状态更新信息
+     * @param userId 当前用户编号
+     */
+    void updateSubjectStatus(FmsSubjectStatusReqVO statusReqVO, Long userId);
+
+    /**
+     * 获得会计科目
+     *
+     * @param accountSetId 账套编号
+     * @param id 科目编号
+     * @param userId 当前用户编号
+     * @return 会计科目
+     */
+    FmsSubjectDO getSubject(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得会计科目使用情况
+     *
+     * @param accountSetId 账套编号
+     * @param id 科目编号
+     * @param userId 当前用户编号
+     * @return 科目使用情况
+     */
+    FmsSubjectUsageRespVO getSubjectUsage(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得账套下的会计科目列表
+     *
+     * @param accountSetId 账套编号
+     * @param type 科目类型
+     * @param userId 当前用户编号
+     * @return 会计科目列表
+     */
+    List<FmsSubjectDO> getSubjectList(Long accountSetId, Integer type, Long userId);
+
+    /**
+     * 获得账套下的会计科目列表
+     *
+     * @param listReqVO 列表查询条件
+     * @param userId 当前用户编号
+     * @return 会计科目列表
+     */
+    List<FmsSubjectDO> getSubjectList(FmsSubjectListReqVO listReqVO, Long userId);
+
+    /**
+     * 获得科目及其所有下级科目编号
+     *
+     * @param accountSetId 账套编号
+     * @param id 科目编号
+     * @return 科目编号数组
+     */
+    List<Long> getSubjectIdListWithChildren(Long accountSetId, Long id);
+
+    /**
+     * 获得使用辅助核算类别的会计科目数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @return 会计科目数量
+     */
+    Long getSubjectCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId);
+
+    /**
+     * 获得使用币别的会计科目数量
+     *
+     * @param accountSetId 账套编号
+     * @param currencyId 币别编号
+     * @return 会计科目数量
+     */
+    Long getSubjectCountByCurrencyId(Long accountSetId, Long currencyId);
+
+    /**
+     * 按新的编码规则扩展会计科目编码
+     *
+     * @param accountSetId 账套编号
+     * @param oldRules 原编码规则
+     * @param newRules 新编码规则
+     */
+    void expandSubjectCodes(Long accountSetId, List<Integer> oldRules, List<Integer> newRules);
+
+    /**
+     * 导入会计科目
+     *
+     * @param accountSetId 账套编号
+     * @param importSubjects 导入数据
+     * @param userId 当前用户编号
+     * @return 导入结果
+     */
+    FmsSubjectImportRespVO importSubjectList(Long accountSetId, List<FmsSubjectImportExcelVO> importSubjects,
+                                            Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectServiceImpl.java
new file mode 100644
index 0000000..ab2b68c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectServiceImpl.java
@@ -0,0 +1,870 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.text.CharSequenceUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.validation.ValidationUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectDeleteReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectStatusReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectUsageRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsSubjectMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsSubjectTemplateMapper;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectCategoryEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingTemplateService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import jakarta.validation.ConstraintViolationException;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_CODE_DUPLICATE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_CODE_RULE_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_CURRENCY_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_HAS_CHILDREN;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_AUXILIARY_COMBINATION_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_AUXILIARY_MIGRATION_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_CLOSING_SCHEME_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_CLOSING_TEMPLATE_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_INITIAL_BALANCE_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_IMPORT_LIST_IS_EMPTY;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_NON_LEAF_CONFIG_IMMUTABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_PARENT_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_PARENT_CONFIG_INCOMPATIBLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_PARENT_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_QUANTITY_ACCOUNTING_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_USED_AUXILIARY_IMMUTABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_USED_BALANCE_DIRECTION_IMMUTABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_VOUCHER_ENTRY_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_VOUCHER_TEMPLATE_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_STATUS_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_STATUS_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_SUBJECT_UPDATE_SUCCESS;
+
+/**
+ * FMS 会计科目 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsSubjectServiceImpl implements FmsSubjectService {
+
+    @Resource
+    private FmsSubjectMapper subjectMapper;
+    @Resource
+    private FmsSubjectTemplateMapper subjectTemplateMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsFinanceParameterService financeParameterService;
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @Resource
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @Resource
+    private FmsCurrencyService currencyService;
+    @Resource
+    @Lazy // 延迟，避免循环依赖报错
+    private FmsVoucherService voucherService;
+    @Resource
+    @Lazy // 延迟，避免循环依赖报错
+    private FmsVoucherTemplateService voucherTemplateService;
+    @Resource
+    @Lazy // 延迟，避免循环依赖报错
+    private FmsInitialBalanceService initialBalanceService;
+    @Resource
+    @Lazy // 延迟，避免循环依赖报错
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+    @Resource
+    @Lazy // 延迟，避免循环依赖报错
+    private FmsClosingSchemeService closingSchemeService;
+    @Resource
+    @Lazy // 延迟，避免循环依赖报错
+    private FmsClosingTemplateService closingTemplateService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void initializeDefaultSubjects(Long accountSetId) {
+        // 1.1 查询标准科目模板并按编码排序
+        List<FmsSubjectTemplateDO> templates = subjectTemplateMapper.selectList();
+        if (CollUtil.isEmpty(templates)) {
+            return;
+        }
+        templates.sort(Comparator.comparing(FmsSubjectTemplateDO::getCode));
+        // 1.2 标准模板编码需要按账套科目编码规则转换后再创建
+        String subjectCodeRule = financeParameterService.getFinanceParameter(accountSetId).getSubjectCodeRule();
+
+        // 2. 按模板层级创建账套科目
+        Map<Long, Long> templateSubjectIdMap = new HashMap<>(templates.size());
+        for (FmsSubjectTemplateDO template : templates) {
+            FmsSubjectDO subject = BeanUtils.toBean(template, FmsSubjectDO.class)
+                    .setId(null).setAccountSetId(accountSetId)
+                    .setCode(financeParameterService.convertStandardSubjectCode(template.getCode(), subjectCodeRule))
+                    .setParentId(FmsSubjectTemplateDO.PARENT_ID_ROOT.equals(template.getParentId())
+                            ? FmsSubjectDO.PARENT_ID_ROOT : templateSubjectIdMap.get(template.getParentId()))
+                    .setAuxiliaryTypeIds(Collections.emptyList()).setCurrencyIds(Collections.emptyList());
+            subjectMapper.insert(subject);
+            templateSubjectIdMap.put(template.getId(), subject.getId());
+        }
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_SUBJECT_TYPE, subType = FMS_SUBJECT_CREATE_SUB_TYPE,
+            bizNo = "{{#subjectId}}", success = FMS_SUBJECT_CREATE_SUCCESS)
+    public Long createSubject(FmsSubjectSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 查询财务参数
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(createReqVO.getAccountSetId());
+        // 1.3 校验科目编码唯一
+        validateSubjectCodeUnique(null, createReqVO.getAccountSetId(), createReqVO.getCode());
+        // 1.4 校验上级科目和科目编码规则
+        FmsSubjectDO parent = validateParentSubject(createReqVO.getAccountSetId(),
+                createReqVO.getParentId(), createReqVO.getType(), createReqVO.getCategory());
+        FmsSubjectUsageRespVO parentUsage = validateParentSubjectDataMigration(createReqVO, parent);
+        int level = parent == null ? 1 : parent.getLevel() + 1;
+        validateSubjectCodeRule(createReqVO.getCode(), level, parent, financeParameter);
+        // 1.5 校验辅助核算类别
+        auxiliaryTypeService.validateAuxiliaryTypeList(
+                createReqVO.getAccountSetId(), createReqVO.getAuxiliaryTypeIds());
+        // 1.6 校验外币核算币别
+        validateCurrencyList(createReqVO.getAccountSetId(), createReqVO.getCurrencyIds());
+
+        // 2. 创建科目
+        FmsSubjectDO subject = BeanUtils.toBean(createReqVO, FmsSubjectDO.class)
+                .setId(null).setLevel(level).setStatus(CommonStatusEnum.ENABLE.getStatus());
+        subjectMapper.insert(subject);
+
+        // 3. 迁移上级科目的历史业务数据
+        if (parent != null && Boolean.TRUE.equals(parentUsage.getUsed())) {
+            voucherService.updateVoucherEntrySubject(createReqVO.getAccountSetId(), parent.getId(), subject);
+            initialBalanceService.updateInitialBalanceSubject(
+                    createReqVO.getAccountSetId(), parent.getId(), subject.getId());
+            auxiliaryCombinationService.updateAuxiliaryCombinationSubject(
+                    createReqVO.getAccountSetId(), parent.getId(), subject.getId());
+        }
+        // 父科目成为非末级后，辅助核算配置不再生效，避免残留配置继续占用辅助类别
+        if (parent != null && CollUtil.isNotEmpty(parent.getAuxiliaryTypeIds())) {
+            subjectMapper.updateById(new FmsSubjectDO().setId(parent.getId())
+                    .setAuxiliaryTypeIds(Collections.emptyList()));
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("subjectId", subject.getId());
+        return subject.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_SUBJECT_TYPE, subType = FMS_SUBJECT_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_SUBJECT_UPDATE_SUCCESS)
+    public void updateSubject(FmsSubjectSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 查询财务参数
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(
+                updateReqVO.getAccountSetId());
+        // 1.3 校验科目存在
+        FmsSubjectDO subject = validateSubjectExists(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        if (ObjUtil.notEqual(subject.getParentId(), updateReqVO.getParentId())) {
+            throw exception(SUBJECT_PARENT_INVALID);
+        }
+        // 1.4 校验已用科目的配置修改范围
+        FmsSubjectUsageRespVO usage = buildSubjectUsage(updateReqVO.getAccountSetId(), subject.getId());
+        validateSubjectConfigUpdate(subject, updateReqVO, usage);
+        // 1.5 校验科目编码唯一
+        validateSubjectCodeUnique(subject.getId(), updateReqVO.getAccountSetId(), updateReqVO.getCode());
+        // 1.6 校验上级科目和科目编码规则
+        FmsSubjectDO parent = validateParentSubject(updateReqVO.getAccountSetId(),
+                updateReqVO.getParentId(), updateReqVO.getType(), updateReqVO.getCategory());
+        validateSubjectCodeRule(updateReqVO.getCode(), subject.getLevel(), parent, financeParameter);
+        // 1.7 校验有下级科目时不能修改编码
+        if (ObjUtil.notEqual(subject.getCode(), updateReqVO.getCode())
+                && usage.getChildCount() > 0) {
+            throw exception(SUBJECT_HAS_CHILDREN);
+        }
+        // 1.8 校验辅助核算类别和外币核算币别
+        List<FmsAuxiliaryTypeDO> auxiliaryTypes = auxiliaryTypeService.validateAuxiliaryTypeList(
+                updateReqVO.getAccountSetId(), updateReqVO.getAuxiliaryTypeIds());
+        validateCurrencyList(updateReqVO.getAccountSetId(), updateReqVO.getCurrencyIds());
+        // 1.9 校验已用科目首次启用辅助核算的历史数据迁移项目
+        Map<Long, FmsAuxiliaryItemDO> migrationItemMap = validateSubjectAuxiliaryMigration(
+                subject, updateReqVO, usage);
+
+        // 2. 更新科目
+        subjectMapper.updateById(BeanUtils.toBean(updateReqVO, FmsSubjectDO.class)
+                .setParentId(subject.getParentId()).setLevel(subject.getLevel()));
+
+        // 3. 迁移科目的历史辅助核算数据
+        if (CollUtil.isNotEmpty(migrationItemMap)) {
+            Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap = convertMap(auxiliaryTypes, FmsAuxiliaryTypeDO::getId);
+            List<FmsAuxiliaryCombinationDO.AuxiliaryItem> combinationItems = convertList(updateReqVO.getAuxiliaryTypeIds(), typeId -> {
+                FmsAuxiliaryTypeDO auxiliaryType = auxiliaryTypeMap.get(typeId);
+                FmsAuxiliaryItemDO auxiliaryItem = migrationItemMap.get(typeId);
+                return FmsAuxiliaryCombinationDO.AuxiliaryItem.builder()
+                        .type(auxiliaryType.getType()).typeId(typeId)
+                        .itemId(auxiliaryItem.getId()).name(auxiliaryItem.getName()).build();
+            });
+            FmsAuxiliaryCombinationDO combination = auxiliaryCombinationService.saveAuxiliaryCombination(
+                    updateReqVO.getAccountSetId(), subject.getId(), combinationItems);
+            voucherService.migrateVoucherEntryAuxiliaries(updateReqVO.getAccountSetId(), subject.getId(), combination);
+        }
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_SUBJECT_TYPE, subType = FMS_SUBJECT_DELETE_SUB_TYPE,
+            bizNo = "{{#subjects.iterator().next().id}}", success = FMS_SUBJECT_DELETE_SUCCESS)
+    public void deleteSubjectList(FmsSubjectDeleteReqVO deleteReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(deleteReqVO.getAccountSetId(), userId);
+        // 1.2 校验科目存在
+        List<FmsSubjectDO> subjects = subjectMapper.selectListByIdsAndAccountSetId(
+                deleteReqVO.getIds(), deleteReqVO.getAccountSetId());
+        if (subjects.size() != deleteReqVO.getIds().size()) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+        // 1.3 校验科目没有下级
+        if (subjectMapper.selectCountByParentIds(deleteReqVO.getIds()) > 0) {
+            throw exception(SUBJECT_HAS_CHILDREN);
+        }
+        // 1.4 校验科目未被业务引用
+        validateSubjectNotInUse(deleteReqVO.getAccountSetId(), deleteReqVO.getIds());
+
+        // 2. 删除科目
+        subjectMapper.deleteByIds(deleteReqVO.getIds());
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("subjects", subjects);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_SUBJECT_TYPE, subType = FMS_SUBJECT_STATUS_SUB_TYPE,
+            bizNo = "{{#statusReqVO.accountSetId}}", success = FMS_SUBJECT_STATUS_SUCCESS)
+    public void updateSubjectStatus(FmsSubjectStatusReqVO statusReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(statusReqVO.getAccountSetId(), userId);
+        // 1.2 校验科目存在
+        List<FmsSubjectDO> subjects = subjectMapper.selectListByIdsAndAccountSetId(
+                statusReqVO.getIds(), statusReqVO.getAccountSetId());
+        if (subjects.size() != statusReqVO.getIds().size()) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+
+        // 2. 递归收集选中科目的全部子孙，批量更新状态
+        Set<Long> subjectIds = getSubjectIdSetWithChildren(
+                statusReqVO.getAccountSetId(), statusReqVO.getIds());
+        subjectMapper.updateStatusByIdsAndAccountSetId(
+                subjectIds, statusReqVO.getAccountSetId(),
+                new FmsSubjectDO().setStatus(statusReqVO.getStatus()));
+    }
+
+    @Override
+    public FmsSubjectDO getSubject(Long accountSetId, Long id, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询科目
+        return subjectMapper.selectByIdAndAccountSetId(id, accountSetId);
+    }
+
+    @Override
+    public FmsSubjectUsageRespVO getSubjectUsage(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 校验科目存在
+        validateSubjectExists(accountSetId, id);
+
+        // 2. 统计科目使用情况
+        return buildSubjectUsage(accountSetId, id);
+    }
+
+    @Override
+    public List<FmsSubjectDO> getSubjectList(Long accountSetId, Integer type, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询科目列表
+        return subjectMapper.selectListByAccountSetIdAndType(accountSetId, type);
+    }
+
+    @Override
+    public List<FmsSubjectDO> getSubjectList(FmsSubjectListReqVO listReqVO, Long userId) {
+        return getSubjectList(listReqVO.getAccountSetId(), listReqVO.getType(), userId);
+    }
+
+    @Override
+    public List<Long> getSubjectIdListWithChildren(Long accountSetId, Long id) {
+        // 1. 校验科目存在
+        validateSubjectExists(accountSetId, id);
+
+        // 2. 获得科目及全部下级科目
+        return new ArrayList<>(getSubjectIdSetWithChildren(accountSetId, Collections.singletonList(id)));
+    }
+
+    /**
+     * 按层查询并收集指定科目及全部子孙科目编号
+     *
+     * @param accountSetId 账套编号
+     * @param ids 起始科目编号集合
+     * @return 科目编号集合
+     */
+    private Set<Long> getSubjectIdSetWithChildren(Long accountSetId, Collection<Long> ids) {
+        Set<Long> subjectIds = new LinkedHashSet<>(ids);
+        Collection<Long> parentIds = ids;
+        for (int i = 0; i < Short.MAX_VALUE; i++) {
+            List<FmsSubjectDO> children = subjectMapper.selectListByParentIds(accountSetId, parentIds);
+            if (CollUtil.isEmpty(children)) {
+                break;
+            }
+            parentIds = convertList(children, FmsSubjectDO::getId);
+            subjectIds.addAll(parentIds);
+        }
+        return subjectIds;
+    }
+
+    @Override
+    public Long getSubjectCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId) {
+        List<FmsSubjectDO> subjects = subjectMapper.selectListByAccountSetIdAndType(accountSetId, null);
+        return (long) filterList(subjects,
+                subject -> CollUtil.contains(subject.getAuxiliaryTypeIds(), auxiliaryTypeId)).size();
+    }
+
+    @Override
+    public Long getSubjectCountByCurrencyId(Long accountSetId, Long currencyId) {
+        List<FmsSubjectDO> subjects = subjectMapper.selectListByAccountSetIdAndType(accountSetId, null);
+        return (long) filterList(subjects,
+                subject -> CollUtil.contains(subject.getCurrencyIds(), currencyId)).size();
+    }
+
+    @Override
+    public void expandSubjectCodes(Long accountSetId, List<Integer> oldRules, List<Integer> newRules) {
+        // 1. 查询账套全部会计科目
+        List<FmsSubjectDO> subjects = subjectMapper.selectListByAccountSetIdAndType(accountSetId, null);
+        if (CollUtil.isEmpty(subjects)) {
+            return;
+        }
+
+        // 2. 按各级编码增量扩展会计科目编码
+        List<FmsSubjectDO> updateSubjects = new ArrayList<>();
+        for (FmsSubjectDO subject : subjects) {
+            String expandedCode = expandSubjectCode(subject.getCode(), subject.getLevel(), oldRules, newRules);
+            if (ObjUtil.notEqual(expandedCode, subject.getCode())) {
+                updateSubjects.add(new FmsSubjectDO().setId(subject.getId()).setCode(expandedCode));
+            }
+        }
+        if (CollUtil.isNotEmpty(updateSubjects)) {
+            subjectMapper.updateBatch(updateSubjects);
+        }
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public FmsSubjectImportRespVO importSubjectList(Long accountSetId,
+            List<FmsSubjectImportExcelVO> importSubjects, Long userId) {
+        // 1.1 校验导入数据非空
+        if (CollUtil.isEmpty(importSubjects)) {
+            throw exception(SUBJECT_IMPORT_LIST_IS_EMPTY);
+        }
+        // 1.2 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.3 加载导入依赖
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(accountSetId);
+        Map<String, FmsSubjectDO> subjectMap = convertMap(
+                subjectMapper.selectListByAccountSetIdAndType(accountSetId, null), FmsSubjectDO::getCode);
+        Map<String, Long> auxiliaryTypeIdMap = auxiliaryTypeService.getAuxiliaryTypeIdMap(accountSetId);
+
+        // 2. 按科目级次依次导入
+        List<FmsSubjectImportExcelVO> sortedSubjects = new ArrayList<>(importSubjects);
+        sortedSubjects.sort(Comparator.comparingInt(item -> StrUtil.length(item.getCode())));
+        Set<String> importCodes = new HashSet<>();
+        FmsSubjectImportRespVO respVO = new FmsSubjectImportRespVO()
+                .setTotalCount(importSubjects.size()).setSuccessSubjectCodes(new ArrayList<>())
+                .setFailureReasons(new LinkedHashMap<>());
+        for (int index = 0; index < sortedSubjects.size(); index++) {
+            FmsSubjectImportExcelVO importSubject = sortedSubjects.get(index);
+            String subjectCode = importSubject.getCode();
+            String label = buildImportLabel(index + 2, subjectCode, importSubject.getName());
+            try {
+                // 2.1 校验导入字段和科目编码
+                ValidationUtils.validate(importSubject);
+                if (!importCodes.add(subjectCode)) {
+                    throw new IllegalArgumentException("导入文件内科目编码重复");
+                }
+                FmsSubjectDO existingSubject = subjectMap.get(subjectCode);
+                FmsSubjectCategoryEnum category = FmsSubjectCategoryEnum.valueOfName(
+                        importSubject.getCategoryName());
+                if (category == null) {
+                    throw new IllegalArgumentException("科目类别不存在");
+                }
+                FmsDebitCreditDirectionEnum direction = FmsDebitCreditDirectionEnum.valueOfName(
+                        importSubject.getBalanceDirection());
+                if (direction == null) {
+                    throw new IllegalArgumentException("余额方向只能填写借或贷");
+                }
+
+                // 2.2 解析上级科目和辅助核算类别
+                FmsSubjectDO parent = resolveImportParent(importSubject.getParentSubjectCode(), subjectMap);
+                if (parent != null && (ObjUtil.notEqual(parent.getType(), category.getType())
+                        || ObjUtil.notEqual(parent.getCategory(), category.getCategory()))) {
+                    throw new IllegalArgumentException("上级科目与当前科目类型或类别不一致");
+                }
+                List<Long> auxiliaryTypeIds = resolveImportAuxiliaryTypeIds(
+                        importSubject.getAuxiliaryNames(), auxiliaryTypeIdMap);
+
+                // 2.3 构造并创建或安全覆盖科目
+                FmsSubjectSaveReqVO reqVO = new FmsSubjectSaveReqVO();
+                reqVO.setAccountSetId(accountSetId).setCode(subjectCode)
+                        .setName(importSubject.getName())
+                        .setParentId(parent == null ? FmsSubjectDO.PARENT_ID_ROOT : parent.getId())
+                        .setType(category.getType()).setCategory(category.getCategory())
+                        .setBalanceDirection(direction.getType()).setAuxiliaryTypeIds(auxiliaryTypeIds)
+                        .setCurrencyIds(Collections.emptyList()).setQuantityAccounting(false).setCash(false);
+                FmsSubjectDO subject;
+                if (existingSubject == null) {
+                    subject = createImportedSubject(reqVO, parent, financeParameter);
+                } else {
+                    subject = updateImportedSubject(existingSubject, reqVO, parent, financeParameter);
+                }
+
+                // 2.4 记录导入结果
+                subjectMap.put(subjectCode, subject);
+                respVO.getSuccessSubjectCodes().add(subjectCode);
+            } catch (ConstraintViolationException exception) {
+                respVO.getFailureReasons().put(label, exception.getMessage());
+            } catch (RuntimeException exception) {
+                respVO.getFailureReasons().put(label, StrUtil.blankToDefault(exception.getMessage(), "导入失败"));
+            }
+        }
+        return respVO;
+    }
+
+    private FmsSubjectDO createImportedSubject(FmsSubjectSaveReqVO reqVO, FmsSubjectDO parent,
+            FmsFinanceParameterDO financeParameter) {
+        // 1.1 校验科目编码唯一
+        validateSubjectCodeUnique(null, reqVO.getAccountSetId(), reqVO.getCode());
+        // 1.2 校验科目层级和编码规则
+        int level = parent == null ? 1 : parent.getLevel() + 1;
+        validateSubjectCodeRule(reqVO.getCode(), level, parent, financeParameter);
+        // 1.3 校验上级科目没有历史业务数据
+        validateParentSubjectUnused(reqVO.getAccountSetId(), parent);
+        // 1.4 校验辅助核算类别
+        auxiliaryTypeService.validateAuxiliaryTypeList(reqVO.getAuxiliaryTypeIds());
+
+        // 2. 创建科目
+        FmsSubjectDO subject = BeanUtils.toBean(reqVO, FmsSubjectDO.class)
+                .setId(null).setLevel(level).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                .setCurrencyIds(Collections.emptyList());
+        subjectMapper.insert(subject);
+        return subject;
+    }
+
+    /**
+     * 覆盖导入时已存在但未被业务使用的科目
+     *
+     * @param subject 已存在的科目
+     * @param reqVO 导入科目信息
+     * @param parent 新上级科目
+     * @param financeParameter 财务参数
+     * @return 覆盖后的科目
+     */
+    private FmsSubjectDO updateImportedSubject(FmsSubjectDO subject, FmsSubjectSaveReqVO reqVO,
+            FmsSubjectDO parent, FmsFinanceParameterDO financeParameter) {
+        // 1. 仅允许覆盖没有下级、没有任何业务引用的科目
+        if (subjectMapper.selectCountByParentId(subject.getId()) > 0) {
+            throw new IllegalArgumentException("已有下级科目，不能覆盖");
+        }
+        validateSubjectNotInUse(reqVO.getAccountSetId(), Collections.singletonList(subject.getId()));
+
+        // 2. 校验新上级和导入配置
+        int level = parent == null ? 1 : parent.getLevel() + 1;
+        validateSubjectCodeRule(reqVO.getCode(), level, parent, financeParameter);
+        validateParentSubjectUnused(reqVO.getAccountSetId(), parent);
+        auxiliaryTypeService.validateAuxiliaryTypeList(reqVO.getAuxiliaryTypeIds());
+
+        // 3. 保留主键和状态，覆盖可导入的科目配置
+        FmsSubjectDO updateObj = BeanUtils.toBean(reqVO, FmsSubjectDO.class)
+                .setId(subject.getId()).setLevel(level).setStatus(subject.getStatus())
+                .setCurrencyIds(Collections.emptyList());
+        subjectMapper.updateById(updateObj);
+        if (parent != null && CollUtil.isNotEmpty(parent.getAuxiliaryTypeIds())) {
+            subjectMapper.updateById(new FmsSubjectDO().setId(parent.getId()).setAuxiliaryTypeIds(Collections.emptyList()));
+        }
+        return updateObj;
+    }
+
+    /**
+     * 按新旧编码规则扩展科目编码
+     *
+     * @param subjectCode 科目编码
+     * @param level 科目层级
+     * @param oldRules 原编码规则
+     * @param newRules 新编码规则
+     * @return 扩展后的科目编码
+     */
+    private String expandSubjectCode(String subjectCode, Integer level,
+            List<Integer> oldRules, List<Integer> newRules) {
+        StringBuilder result = new StringBuilder();
+        int offset = 0;
+        for (int index = 0; index < level; index++) {
+            int oldLength = oldRules.get(index);
+            int increment = newRules.get(index) - oldLength;
+            String segment = subjectCode.substring(offset, offset + oldLength);
+            if (increment > 0) {
+                if (index == 0) {
+                    result.append(segment.charAt(0)).append(CharSequenceUtil.repeat('0', increment))
+                            .append(segment.substring(1));
+                } else {
+                    result.append(CharSequenceUtil.repeat('0', increment)).append(segment);
+                }
+            } else {
+                result.append(segment);
+            }
+            offset += oldLength;
+        }
+        return result.toString();
+    }
+
+    private FmsSubjectDO resolveImportParent(String parentSubjectCode, Map<String, FmsSubjectDO> subjectMap) {
+        if (StrUtil.isBlank(parentSubjectCode) || "0".equals(parentSubjectCode)) {
+            return null;
+        }
+        FmsSubjectDO parent = subjectMap.get(parentSubjectCode);
+        if (parent == null) {
+            throw new IllegalArgumentException("上级科目编码不存在");
+        }
+        return parent;
+    }
+
+    private List<Long> resolveImportAuxiliaryTypeIds(String auxiliaryNames, Map<String, Long> auxiliaryTypeIdMap) {
+        if (StrUtil.isBlank(auxiliaryNames)) {
+            return Collections.emptyList();
+        }
+        List<Long> auxiliaryTypeIds = new ArrayList<>();
+        for (String auxiliaryName : StrUtil.split(auxiliaryNames.replace('、', '/'), '/')) {
+            Long auxiliaryTypeId = auxiliaryTypeIdMap.get(auxiliaryName);
+            if (auxiliaryTypeId == null) {
+                throw new IllegalArgumentException("辅助核算类别“" + auxiliaryName + "”不存在");
+            }
+            auxiliaryTypeIds.add(auxiliaryTypeId);
+        }
+        return auxiliaryTypeIds;
+    }
+
+    private String buildImportLabel(int rowNumber, String subjectCode, String name) {
+        return "第 " + rowNumber + " 行（" + StrUtil.blankToDefault(subjectCode, "未填写编码")
+                + (StrUtil.isBlank(name) ? "" : " " + name) + "）";
+    }
+
+    private FmsSubjectDO validateSubjectExists(Long accountSetId, Long id) {
+        FmsSubjectDO subject = subjectMapper.selectById(id);
+        if (subject == null || ObjUtil.notEqual(subject.getAccountSetId(), accountSetId)) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+        return subject;
+    }
+
+    private void validateSubjectNotInUse(Long accountSetId, List<Long> subjectIds) {
+        // 1. 校验科目未被凭证分录使用
+        Long voucherEntryCount = voucherService.getVoucherEntryCountBySubjectIds(accountSetId, subjectIds);
+        if (voucherEntryCount > 0) {
+            throw exception(SUBJECT_VOUCHER_ENTRY_IN_USE, voucherEntryCount);
+        }
+        // 2. 校验科目未被凭证模板使用
+        Long voucherTemplateCount = voucherTemplateService.getVoucherTemplateCountBySubjectIds(
+                accountSetId, subjectIds);
+        if (voucherTemplateCount > 0) {
+            throw exception(SUBJECT_VOUCHER_TEMPLATE_IN_USE, voucherTemplateCount);
+        }
+        // 3. 校验科目未被初始余额使用
+        Long initialBalanceCount = initialBalanceService.getInitialBalanceCountBySubjectIds(
+                accountSetId, subjectIds);
+        if (initialBalanceCount > 0) {
+            throw exception(SUBJECT_INITIAL_BALANCE_IN_USE, initialBalanceCount);
+        }
+        // 4. 校验科目未被辅助核算组合使用
+        Long auxiliaryCombinationCount = auxiliaryCombinationService.getAuxiliaryCombinationCountBySubjectIds(
+                accountSetId, subjectIds);
+        if (auxiliaryCombinationCount > 0) {
+            throw exception(SUBJECT_AUXILIARY_COMBINATION_IN_USE, auxiliaryCombinationCount);
+        }
+        // 5. 校验科目未被结账方案使用
+        Long closingSchemeCount = closingSchemeService.getClosingSchemeCountBySubjectIds(accountSetId, subjectIds);
+        if (closingSchemeCount > 0) {
+            throw exception(SUBJECT_CLOSING_SCHEME_IN_USE, closingSchemeCount);
+        }
+        // 6. 校验科目未被结账模板使用
+        Long closingTemplateCount = closingTemplateService.getClosingTemplateCountBySubjectIds(
+                accountSetId, subjectIds);
+        if (closingTemplateCount > 0) {
+            throw exception(SUBJECT_CLOSING_TEMPLATE_IN_USE, closingTemplateCount);
+        }
+    }
+
+    /**
+     * 构建科目使用情况
+     *
+     * @param accountSetId 账套编号
+     * @param subjectId 科目编号
+     * @return 科目使用情况
+     */
+    private FmsSubjectUsageRespVO buildSubjectUsage(Long accountSetId, Long subjectId) {
+        // 1. 查询科目的业务引用数量
+        List<Long> subjectIds = Collections.singletonList(subjectId);
+        Long voucherEntryCount = ObjUtil.defaultIfNull(
+                voucherService.getVoucherEntryCountBySubjectIds(accountSetId, subjectIds), 0L);
+        Long initialBalanceCount = ObjUtil.defaultIfNull(
+                initialBalanceService.getInitialBalanceCountBySubjectIds(accountSetId, subjectIds), 0L);
+        Long auxiliaryCombinationCount = ObjUtil.defaultIfNull(
+                auxiliaryCombinationService.getAuxiliaryCombinationCountBySubjectIds(accountSetId, subjectIds), 0L);
+
+        // 2. 查询科目的数量核算数据数量
+        Long voucherEntryQuantityCount = ObjUtil.defaultIfNull(
+                voucherService.getVoucherEntryQuantityCountBySubjectIds(accountSetId, subjectIds), 0L);
+        Long initialBalanceQuantityCount = ObjUtil.defaultIfNull(
+                initialBalanceService.getInitialBalanceQuantityCountBySubjectIds(accountSetId, subjectIds), 0L);
+        Long quantityDataCount = voucherEntryQuantityCount + initialBalanceQuantityCount;
+
+        // 3. 构建科目使用情况
+        return new FmsSubjectUsageRespVO()
+                .setChildCount(subjectMapper.selectCountByParentId(subjectId))
+                .setVoucherEntryCount(voucherEntryCount).setInitialBalanceCount(initialBalanceCount)
+                .setAuxiliaryCombinationCount(auxiliaryCombinationCount).setQuantityDataCount(quantityDataCount)
+                .setUsed(voucherEntryCount + initialBalanceCount + auxiliaryCombinationCount > 0);
+    }
+
+    /**
+     * 校验上级科目未被业务使用
+     *
+     * @param accountSetId 账套编号
+     * @param parent 上级科目
+     */
+    private void validateParentSubjectUnused(Long accountSetId, FmsSubjectDO parent) {
+        if (parent != null && Boolean.TRUE.equals(buildSubjectUsage(accountSetId, parent.getId()).getUsed())) {
+            throw exception(SUBJECT_PARENT_IN_USE);
+        }
+    }
+
+    /**
+     * 校验上级科目历史数据迁移
+     *
+     * @param createReqVO 创建信息
+     * @param parent 上级科目
+     * @return 上级科目使用情况
+     */
+    private FmsSubjectUsageRespVO validateParentSubjectDataMigration(
+            FmsSubjectSaveReqVO createReqVO, FmsSubjectDO parent) {
+        if (parent == null) {
+            return new FmsSubjectUsageRespVO().setUsed(false);
+        }
+        FmsSubjectUsageRespVO usage = buildSubjectUsage(createReqVO.getAccountSetId(), parent.getId());
+        if (Boolean.FALSE.equals(usage.getUsed())) {
+            return usage;
+        }
+        // 只有新增第一个下级科目并明确确认时，才允许迁移上级科目的历史数据
+        if (usage.getChildCount() > 0 || !Boolean.TRUE.equals(createReqVO.getMigrateParentData())) {
+            throw exception(SUBJECT_PARENT_IN_USE);
+        }
+        // 历史数据使用原科目核算配置，新子科目必须完整继承相关配置
+        boolean auxiliarySame = new HashSet<>(CollUtil.emptyIfNull(parent.getAuxiliaryTypeIds()))
+                .equals(new HashSet<>(CollUtil.emptyIfNull(createReqVO.getAuxiliaryTypeIds())));
+        boolean currencySame = new HashSet<>(CollUtil.emptyIfNull(parent.getCurrencyIds()))
+                .equals(new HashSet<>(CollUtil.emptyIfNull(createReqVO.getCurrencyIds())));
+        boolean quantityUnitSame = Boolean.FALSE.equals(parent.getQuantityAccounting())
+                || ObjUtil.equal(parent.getQuantityUnit(), createReqVO.getQuantityUnit());
+        if (ObjUtil.notEqual(parent.getBalanceDirection(), createReqVO.getBalanceDirection())
+                || !auxiliarySame || !currencySame
+                || ObjUtil.notEqual(parent.getQuantityAccounting(), createReqVO.getQuantityAccounting())
+                || !quantityUnitSame) {
+            throw exception(SUBJECT_PARENT_CONFIG_INCOMPATIBLE);
+        }
+        return usage;
+    }
+
+    /**
+     * 校验已用科目的配置修改范围
+     *
+     * @param subject 科目
+     * @param updateReqVO 更新信息
+     * @param usage 科目使用情况
+     */
+    private void validateSubjectConfigUpdate(FmsSubjectDO subject, FmsSubjectSaveReqVO updateReqVO,
+            FmsSubjectUsageRespVO usage) {
+        boolean auxiliaryChanged = !new HashSet<>(CollUtil.emptyIfNull(subject.getAuxiliaryTypeIds()))
+                .equals(new HashSet<>(CollUtil.emptyIfNull(updateReqVO.getAuxiliaryTypeIds())));
+        // 非末级科目不允许修改类型、类别和辅助核算
+        if (usage.getChildCount() > 0 && (ObjUtil.notEqual(subject.getType(), updateReqVO.getType())
+                || ObjUtil.notEqual(subject.getCategory(), updateReqVO.getCategory()) || auxiliaryChanged)) {
+            throw exception(SUBJECT_NON_LEAF_CONFIG_IMMUTABLE);
+        }
+        // 已用科目不允许修改余额方向
+        if (Boolean.TRUE.equals(usage.getUsed())
+                && ObjUtil.notEqual(subject.getBalanceDirection(), updateReqVO.getBalanceDirection())) {
+            throw exception(SUBJECT_USED_BALANCE_DIRECTION_IMMUTABLE);
+        }
+        // 已用科目仅允许从未启用辅助核算迁移为启用状态，其他辅助核算变更仍禁止
+        boolean auxiliaryMigration = CollUtil.isEmpty(subject.getAuxiliaryTypeIds())
+                && CollUtil.isNotEmpty(updateReqVO.getAuxiliaryTypeIds());
+        if (Boolean.TRUE.equals(usage.getUsed()) && auxiliaryChanged && !auxiliaryMigration) {
+            throw exception(SUBJECT_USED_AUXILIARY_IMMUTABLE);
+        }
+        // 存在实际数量时不允许关闭数量核算
+        if (Boolean.TRUE.equals(subject.getQuantityAccounting())
+                && Boolean.FALSE.equals(updateReqVO.getQuantityAccounting()) && usage.getQuantityDataCount() > 0) {
+            throw exception(SUBJECT_QUANTITY_ACCOUNTING_IN_USE);
+        }
+    }
+
+    /**
+     * 校验已用科目首次启用辅助核算的历史数据迁移项目
+     *
+     * @param subject 科目
+     * @param updateReqVO 更新信息
+     * @param usage 科目使用情况
+     * @return 迁移项目 Map，键为辅助核算类别编号
+     */
+    private Map<Long, FmsAuxiliaryItemDO> validateSubjectAuxiliaryMigration(FmsSubjectDO subject,
+            FmsSubjectSaveReqVO updateReqVO, FmsSubjectUsageRespVO usage) {
+        // 1. 未触发历史数据迁移时，无需校验迁移项目
+        if (usage.getVoucherEntryCount() <= 0 || CollUtil.isNotEmpty(subject.getAuxiliaryTypeIds())
+                || CollUtil.isEmpty(updateReqVO.getAuxiliaryTypeIds())) {
+            return Collections.emptyMap();
+        }
+
+        // 2. 校验每个新增辅助核算类别只配置一个迁移项目
+        List<FmsSubjectSaveReqVO.AuxiliaryMapping> mappings = updateReqVO.getAuxiliaryMappings();
+        if (CollUtil.size(mappings) != updateReqVO.getAuxiliaryTypeIds().size()) {
+            throw exception(SUBJECT_AUXILIARY_MIGRATION_INVALID);
+        }
+        Map<Long, Long> itemIdMap = new LinkedHashMap<>();
+        for (FmsSubjectSaveReqVO.AuxiliaryMapping mapping : mappings) {
+            if (mapping == null || mapping.getTypeId() == null || mapping.getItemId() == null
+                    || itemIdMap.put(mapping.getTypeId(), mapping.getItemId()) != null) {
+                throw exception(SUBJECT_AUXILIARY_MIGRATION_INVALID);
+            }
+        }
+        if (!new HashSet<>(updateReqVO.getAuxiliaryTypeIds()).equals(itemIdMap.keySet())) {
+            throw exception(SUBJECT_AUXILIARY_MIGRATION_INVALID);
+        }
+
+        // 3. 校验迁移项目属于对应类别且处于启用状态
+        List<FmsAuxiliaryItemDO> items = auxiliaryItemService.validateAuxiliaryItemList(
+                updateReqVO.getAccountSetId(), itemIdMap.values());
+        Map<Long, FmsAuxiliaryItemDO> itemMap = convertMap(items, FmsAuxiliaryItemDO::getAuxiliaryTypeId);
+        if (itemMap.size() != itemIdMap.size()) {
+            throw exception(SUBJECT_AUXILIARY_MIGRATION_INVALID);
+        }
+        for (Map.Entry<Long, Long> entry : itemIdMap.entrySet()) {
+            FmsAuxiliaryItemDO item = itemMap.get(entry.getKey());
+            if (item == null || ObjUtil.notEqual(item.getId(), entry.getValue())
+                    || ObjUtil.notEqual(item.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+                throw exception(SUBJECT_AUXILIARY_MIGRATION_INVALID);
+            }
+        }
+        return itemMap;
+    }
+
+    private void validateSubjectCodeUnique(Long id, Long accountSetId, String subjectCode) {
+        FmsSubjectDO subject = subjectMapper.selectByAccountSetIdAndCode(accountSetId, subjectCode);
+        if (subject != null && ObjUtil.notEqual(subject.getId(), id)) {
+            throw exception(SUBJECT_CODE_DUPLICATE);
+        }
+    }
+
+    private FmsSubjectDO validateParentSubject(Long accountSetId, Long parentId, Integer type, Integer category) {
+        if (FmsSubjectDO.PARENT_ID_ROOT.equals(parentId)) {
+            return null;
+        }
+        FmsSubjectDO parent = subjectMapper.selectById(parentId);
+        if (parent == null || ObjUtil.notEqual(parent.getAccountSetId(), accountSetId)
+                || ObjUtil.notEqual(parent.getType(), type)
+                || ObjUtil.notEqual(parent.getCategory(), category)) {
+            throw exception(SUBJECT_PARENT_INVALID);
+        }
+        return parent;
+    }
+
+    /**
+     * 校验科目编码是否符合当前科目级次规则
+     *
+     * @param subjectCode 科目编码
+     * @param level 科目层级
+     * @param parent 上级科目
+     * @param financeParameter 财务参数
+     */
+    private void validateSubjectCodeRule(String subjectCode, int level, FmsSubjectDO parent,
+            FmsFinanceParameterDO financeParameter) {
+        String[] levels = financeParameter.getSubjectCodeRule().split("-");
+        if (level > levels.length || !subjectCode.matches("\\d+")) {
+            throw exception(SUBJECT_CODE_RULE_INVALID);
+        }
+        int expectedLength = 0;
+        for (int index = 0; index < level; index++) {
+            expectedLength += Integer.parseInt(levels[index]);
+        }
+        if (subjectCode.length() != expectedLength
+                || parent != null && !subjectCode.startsWith(parent.getCode())) {
+            throw exception(SUBJECT_CODE_RULE_INVALID);
+        }
+    }
+
+    /**
+     * 校验外币核算币别，不允许选择本位币
+     *
+     * @param accountSetId 账套编号
+     * @param currencyIds 币别编号数组
+     */
+    private void validateCurrencyList(Long accountSetId, List<Long> currencyIds) {
+        List<FmsCurrencyDO> currencies = currencyService.validateCurrencyList(accountSetId, currencyIds);
+        if (CollUtil.findOne(currencies, currency -> Boolean.TRUE.equals(currency.getStandard())) != null) {
+            throw exception(SUBJECT_CURRENCY_INVALID);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateService.java
new file mode 100644
index 0000000..008515c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateService.java
@@ -0,0 +1,127 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplatecategory.FmsVoucherTemplateCategorySaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate.FmsVoucherTemplateSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateCategoryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * FMS 凭证模板 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsVoucherTemplateService {
+
+    /**
+     * 创建凭证模板分类
+     *
+     * @param createReqVO 创建信息
+     * @param userId 用户编号
+     * @return 分类编号
+     */
+    Long createTemplateCategory(FmsVoucherTemplateCategorySaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新凭证模板分类
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 用户编号
+     */
+    void updateTemplateCategory(FmsVoucherTemplateCategorySaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除凭证模板分类
+     *
+     * @param accountSetId 账套编号
+     * @param id 分类编号
+     * @param userId 用户编号
+     */
+    void deleteTemplateCategory(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得凭证模板分类列表
+     *
+     * @param accountSetId 账套编号
+     * @return 凭证模板分类列表
+     */
+    List<FmsVoucherTemplateCategoryDO> getTemplateCategoryList(Long accountSetId);
+
+    /**
+     * 获得凭证模板分类 Map
+     *
+     * @param accountSetId 账套编号
+     * @return 凭证模板分类 Map
+     */
+    default Map<Long, FmsVoucherTemplateCategoryDO> getTemplateCategoryMap(Long accountSetId) {
+        return convertMap(getTemplateCategoryList(accountSetId), FmsVoucherTemplateCategoryDO::getId);
+    }
+
+    /**
+     * 创建凭证模板
+     *
+     * @param createReqVO 创建信息
+     * @param userId 用户编号
+     * @return 模板编号
+     */
+    Long createVoucherTemplate(FmsVoucherTemplateSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新凭证模板
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 用户编号
+     */
+    void updateVoucherTemplate(FmsVoucherTemplateSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除凭证模板
+     *
+     * @param accountSetId 账套编号
+     * @param id 模板编号
+     * @param userId 用户编号
+     */
+    void deleteVoucherTemplate(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得凭证模板列表
+     *
+     * @param accountSetId 账套编号
+     * @return 凭证模板列表
+     */
+    List<FmsVoucherTemplateDO> getVoucherTemplateList(Long accountSetId);
+
+    /**
+     * 获得使用指定科目的凭证模板数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号数组
+     * @return 凭证模板数量
+     */
+    Long getVoucherTemplateCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 获得使用指定辅助核算项目的凭证模板数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryItemIds 辅助核算项目编号数组
+     * @return 凭证模板数量
+     */
+    Long getVoucherTemplateCountByAuxiliaryItemIds(
+            Long accountSetId, Collection<Long> auxiliaryItemIds);
+
+    /**
+     * 获得使用指定辅助核算类别的凭证模板数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @return 凭证模板数量
+     */
+    Long getVoucherTemplateCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateServiceImpl.java
new file mode 100644
index 0000000..09e9f13
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateServiceImpl.java
@@ -0,0 +1,370 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplatecategory.FmsVoucherTemplateCategorySaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate.FmsVoucherTemplateEntryVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate.FmsVoucherTemplateSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateCategoryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsVoucherTemplateCategoryMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsVoucherTemplateMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Predicate;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+
+/**
+ * FMS 凭证模板 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsVoucherTemplateServiceImpl implements FmsVoucherTemplateService {
+
+    @Resource
+    private FmsVoucherTemplateCategoryMapper templateCategoryMapper;
+
+    @Resource
+    private FmsVoucherTemplateMapper templateMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+
+    @Override
+    @LogRecord(type = FMS_VOUCHER_TEMPLATE_CATEGORY_TYPE,
+            subType = FMS_VOUCHER_TEMPLATE_CATEGORY_CREATE_SUB_TYPE,
+            bizNo = "{{#categoryId}}", success = FMS_VOUCHER_TEMPLATE_CATEGORY_CREATE_SUCCESS)
+    public Long createTemplateCategory(FmsVoucherTemplateCategorySaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验分类名称
+        validateTemplateCategoryNameUnique(null, createReqVO.getAccountSetId(), createReqVO.getName());
+
+        // 2. 创建模板分类
+        FmsVoucherTemplateCategoryDO category = BeanUtils.toBean(
+                createReqVO, FmsVoucherTemplateCategoryDO.class).setId(null);
+        templateCategoryMapper.insert(category);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("categoryId", category.getId());
+        return category.getId();
+    }
+
+    @Override
+    @LogRecord(type = FMS_VOUCHER_TEMPLATE_CATEGORY_TYPE,
+            subType = FMS_VOUCHER_TEMPLATE_CATEGORY_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_VOUCHER_TEMPLATE_CATEGORY_UPDATE_SUCCESS)
+    public void updateTemplateCategory(FmsVoucherTemplateCategorySaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验模板分类
+        validateTemplateCategory(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        // 1.3 校验分类名称唯一
+        validateTemplateCategoryNameUnique(updateReqVO.getId(), updateReqVO.getAccountSetId(), updateReqVO.getName());
+
+        // 2. 更新模板分类
+        templateCategoryMapper.updateById(new FmsVoucherTemplateCategoryDO()
+                .setId(updateReqVO.getId()).setName(updateReqVO.getName()));
+    }
+
+    @Override
+    @LogRecord(type = FMS_VOUCHER_TEMPLATE_CATEGORY_TYPE,
+            subType = FMS_VOUCHER_TEMPLATE_CATEGORY_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_VOUCHER_TEMPLATE_CATEGORY_DELETE_SUCCESS)
+    public void deleteTemplateCategory(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验模板分类
+        FmsVoucherTemplateCategoryDO category = validateTemplateCategory(accountSetId, id);
+        // 1.3 校验模板分类未被使用
+        if (templateMapper.selectCountByCategoryId(id) > 0) {
+            throw exception(VOUCHER_TEMPLATE_CATEGORY_IN_USE);
+        }
+
+        // 2. 删除模板分类
+        templateCategoryMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("category", category);
+    }
+
+    @Override
+    public List<FmsVoucherTemplateCategoryDO> getTemplateCategoryList(Long accountSetId) {
+        return templateCategoryMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    @LogRecord(type = FMS_VOUCHER_TEMPLATE_TYPE, subType = FMS_VOUCHER_TEMPLATE_CREATE_SUB_TYPE,
+            bizNo = "{{#templateId}}", success = FMS_VOUCHER_TEMPLATE_CREATE_SUCCESS)
+    public Long createVoucherTemplate(FmsVoucherTemplateSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验模板分类
+        validateTemplateCategory(createReqVO.getAccountSetId(), createReqVO.getCategoryId());
+        // 1.3 校验并构造模板分录
+        List<FmsVoucherTemplateDO.Entry> entries = validateAndBuildTemplateEntries(
+                createReqVO.getAccountSetId(), createReqVO.getEntries(), userId);
+
+        // 2. 创建凭证模板
+        FmsVoucherTemplateDO template = BeanUtils.toBean(createReqVO, FmsVoucherTemplateDO.class)
+                .setId(null).setEntries(entries);
+        templateMapper.insert(template);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("templateId", template.getId());
+        return template.getId();
+    }
+
+    @Override
+    @LogRecord(type = FMS_VOUCHER_TEMPLATE_TYPE, subType = FMS_VOUCHER_TEMPLATE_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_VOUCHER_TEMPLATE_UPDATE_SUCCESS)
+    public void updateVoucherTemplate(FmsVoucherTemplateSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验凭证模板
+        validateVoucherTemplate(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        // 1.3 校验模板分类
+        validateTemplateCategory(updateReqVO.getAccountSetId(), updateReqVO.getCategoryId());
+        // 1.4 校验并构造模板分录
+        List<FmsVoucherTemplateDO.Entry> entries = validateAndBuildTemplateEntries(
+                updateReqVO.getAccountSetId(), updateReqVO.getEntries(), userId);
+
+        // 2. 更新凭证模板
+        templateMapper.updateById(new FmsVoucherTemplateDO().setId(updateReqVO.getId())
+                .setName(updateReqVO.getName())
+                .setCategoryId(updateReqVO.getCategoryId()).setEntries(entries));
+    }
+
+    @Override
+    @LogRecord(type = FMS_VOUCHER_TEMPLATE_TYPE, subType = FMS_VOUCHER_TEMPLATE_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_VOUCHER_TEMPLATE_DELETE_SUCCESS)
+    public void deleteVoucherTemplate(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验凭证模板
+        FmsVoucherTemplateDO template = validateVoucherTemplate(accountSetId, id);
+
+        // 2. 删除凭证模板
+        templateMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("template", template);
+    }
+
+    @Override
+    public List<FmsVoucherTemplateDO> getVoucherTemplateList(Long accountSetId) {
+        return templateMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public Long getVoucherTemplateCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        // 1. 处理空参数
+        if (CollUtil.isEmpty(subjectIds)) {
+            return 0L;
+        }
+
+        // 2. 查询凭证模板列表
+        List<FmsVoucherTemplateDO> templates = templateMapper.selectListByAccountSetId(accountSetId);
+
+        // 3. 计算使用指定科目的凭证模板数量
+        Set<Long> subjectIdSet = new HashSet<>(subjectIds);
+        return (long) filterList(templates, template -> CollUtil.isNotEmpty(template.getEntries())
+                && template.getEntries().stream()
+                        .map(FmsVoucherTemplateDO.Entry::getSubjectId)
+                        .anyMatch(subjectIdSet::contains)).size();
+    }
+
+    @Override
+    public Long getVoucherTemplateCountByAuxiliaryItemIds(
+            Long accountSetId, Collection<Long> auxiliaryItemIds) {
+        // 1. 处理空参数
+        if (CollUtil.isEmpty(auxiliaryItemIds)) {
+            return 0L;
+        }
+
+        // 2. 计算使用指定辅助核算项目的凭证模板数量
+        Set<Long> auxiliaryItemIdSet = new HashSet<>(auxiliaryItemIds);
+        return getVoucherTemplateCountByAuxiliary(accountSetId,
+                item -> auxiliaryItemIdSet.contains(item.getItemId()));
+    }
+
+    @Override
+    public Long getVoucherTemplateCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId) {
+        return getVoucherTemplateCountByAuxiliary(accountSetId,
+                item -> ObjUtil.equal(item.getTypeId(), auxiliaryTypeId));
+    }
+
+    private Long getVoucherTemplateCountByAuxiliary(Long accountSetId,
+            Predicate<FmsVoucherEntryDO.AuxiliaryItem> predicate) {
+        List<FmsVoucherTemplateDO> templates = templateMapper.selectListByAccountSetId(accountSetId);
+        return (long) filterList(templates, template -> CollUtil.isNotEmpty(template.getEntries())
+                && template.getEntries().stream()
+                        .filter(entry -> CollUtil.isNotEmpty(entry.getAuxiliaries()))
+                        .flatMap(entry -> entry.getAuxiliaries().stream())
+                        .anyMatch(predicate)).size();
+    }
+
+    private FmsVoucherTemplateCategoryDO validateTemplateCategory(Long accountSetId, Long id) {
+        FmsVoucherTemplateCategoryDO category = templateCategoryMapper.selectById(id);
+        if (category == null || ObjUtil.notEqual(category.getAccountSetId(), accountSetId)) {
+            throw exception(VOUCHER_TEMPLATE_CATEGORY_NOT_EXISTS);
+        }
+        return category;
+    }
+
+    private void validateTemplateCategoryNameUnique(Long id, Long accountSetId, String name) {
+        FmsVoucherTemplateCategoryDO category = templateCategoryMapper
+                .selectByAccountSetIdAndName(accountSetId, name);
+        if (category != null && ObjUtil.notEqual(category.getId(), id)) {
+            throw exception(VOUCHER_TEMPLATE_CATEGORY_NAME_DUPLICATE);
+        }
+    }
+
+    private FmsVoucherTemplateDO validateVoucherTemplate(Long accountSetId, Long id) {
+        FmsVoucherTemplateDO template = templateMapper.selectById(id);
+        if (template == null || ObjUtil.notEqual(template.getAccountSetId(), accountSetId)) {
+            throw exception(VOUCHER_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    private List<FmsVoucherTemplateDO.Entry> validateAndBuildTemplateEntries(
+            Long accountSetId, List<FmsVoucherTemplateEntryVO> entries, Long userId) {
+        // 1. 批量校验科目
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(
+                subjectService.getSubjectList(accountSetId, null, userId), FmsSubjectDO::getId);
+        Set<Long> subjectIds = convertSet(entries, FmsVoucherTemplateEntryVO::getSubjectId);
+        if (!subjectMap.keySet().containsAll(subjectIds)) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+        Set<Long> parentSubjectIds = convertSet(subjectMap.values(), FmsSubjectDO::getParentId);
+        BigDecimal debitAmount = BigDecimal.ZERO;
+        BigDecimal creditAmount = BigDecimal.ZERO;
+        boolean saveAmount = false;
+        for (FmsVoucherTemplateEntryVO entry : entries) {
+            FmsSubjectDO subject = subjectMap.get(entry.getSubjectId());
+            if (ObjUtil.notEqual(subject.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+                throw exception(VOUCHER_SUBJECT_DISABLED);
+            }
+            if (parentSubjectIds.contains(subject.getId())) {
+                throw exception(VOUCHER_SUBJECT_HAS_CHILDREN);
+            }
+            BigDecimal entryDebitAmount = ObjUtil.defaultIfNull(entry.getDebitAmount(), BigDecimal.ZERO);
+            BigDecimal entryCreditAmount = ObjUtil.defaultIfNull(entry.getCreditAmount(), BigDecimal.ZERO);
+            if (entryDebitAmount.signum() != 0 && entryCreditAmount.signum() != 0) {
+                throw exception(VOUCHER_ENTRY_AMOUNT_INVALID);
+            }
+            BigDecimal entryAmount = entryDebitAmount.abs().max(entryCreditAmount.abs());
+            validateTemplateQuantity(entry, subject, entryAmount);
+            debitAmount = debitAmount.add(entryDebitAmount);
+            creditAmount = creditAmount.add(entryCreditAmount);
+            saveAmount = saveAmount || entryAmount.signum() > 0;
+        }
+        if (saveAmount && debitAmount.compareTo(creditAmount) != 0) {
+            throw exception(VOUCHER_AMOUNT_UNBALANCED);
+        }
+
+        // 2. 批量校验辅助核算类别和项目
+        Set<Long> auxiliaryItemIds = CollUtil.newHashSet();
+        Set<Long> auxiliaryTypeIds = CollUtil.newHashSet();
+        entries.forEach(entry -> {
+            if (CollUtil.isNotEmpty(entry.getAuxiliaries())) {
+                auxiliaryItemIds.addAll(convertSet(entry.getAuxiliaries(), FmsVoucherTemplateEntryVO.AuxiliaryItem::getItemId));
+                auxiliaryTypeIds.addAll(convertSet(entry.getAuxiliaries(), FmsVoucherTemplateEntryVO.AuxiliaryItem::getTypeId));
+            }
+        });
+        Map<Long, FmsAuxiliaryItemDO> auxiliaryItemMap = convertMap(
+                auxiliaryItemService.validateAuxiliaryItemList(accountSetId, auxiliaryItemIds),
+                FmsAuxiliaryItemDO::getId);
+        Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap = convertMap(
+                auxiliaryTypeService.validateAuxiliaryTypeList(accountSetId, auxiliaryTypeIds),
+                FmsAuxiliaryTypeDO::getId);
+
+        // 3. 构造模板 JSON 分录
+        return convertList(entries, source -> {
+            validateTemplateAuxiliaries(source, subjectMap.get(source.getSubjectId()));
+            FmsVoucherTemplateDO.Entry target = BeanUtils.toBean(source, FmsVoucherTemplateDO.Entry.class);
+            if (CollUtil.isEmpty(source.getAuxiliaries())) {
+                target.setAuxiliaries(Collections.emptyList());
+                return target;
+            }
+            target.setAuxiliaries(convertList(source.getAuxiliaries(), itemSource -> {
+                FmsAuxiliaryItemDO auxiliaryItem = auxiliaryItemMap.get(itemSource.getItemId());
+                if (auxiliaryItem == null
+                        || ObjUtil.notEqual(auxiliaryItem.getAuxiliaryTypeId(), itemSource.getTypeId())) {
+                    throw exception(AUXILIARY_ITEM_NOT_EXISTS);
+                }
+                if (ObjUtil.notEqual(auxiliaryItem.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+                    throw exception(VOUCHER_AUXILIARY_REQUIRED);
+                }
+                return BeanUtils.toBean(itemSource, FmsVoucherEntryDO.AuxiliaryItem.class)
+                        .setType(auxiliaryTypeMap.get(itemSource.getTypeId()).getType())
+                        .setName(auxiliaryItem.getName());
+            }));
+            return target;
+        });
+    }
+
+    private void validateTemplateQuantity(FmsVoucherTemplateEntryVO entry,
+            FmsSubjectDO subject, BigDecimal amount) {
+        BigDecimal quantity = ObjUtil.defaultIfNull(entry.getQuantity(), BigDecimal.ZERO);
+        BigDecimal unitPrice = ObjUtil.defaultIfNull(entry.getUnitPrice(), BigDecimal.ZERO);
+        if (Boolean.FALSE.equals(subject.getQuantityAccounting())) {
+            if (quantity.signum() > 0 || unitPrice.signum() > 0) {
+                throw exception(VOUCHER_QUANTITY_INVALID);
+            }
+            return;
+        }
+        if (quantity.signum() == 0 && unitPrice.signum() == 0) {
+            return;
+        }
+        if (quantity.signum() <= 0 || unitPrice.signum() <= 0
+                || quantity.multiply(unitPrice).setScale(2, RoundingMode.FLOOR).compareTo(amount) != 0) {
+            throw exception(VOUCHER_QUANTITY_INVALID);
+        }
+    }
+
+    private void validateTemplateAuxiliaries(FmsVoucherTemplateEntryVO entry, FmsSubjectDO subject) {
+        List<Long> auxiliaryTypeIds = ObjUtil.defaultIfNull(subject.getAuxiliaryTypeIds(), Collections.emptyList());
+        List<FmsVoucherTemplateEntryVO.AuxiliaryItem> auxiliaries = ObjUtil.defaultIfNull(entry.getAuxiliaries(), Collections.emptyList());
+        Set<Long> requestedTypeIds = convertSet(auxiliaries, FmsVoucherTemplateEntryVO.AuxiliaryItem::getTypeId);
+        if (auxiliaryTypeIds.size() != auxiliaries.size()
+                || !requestedTypeIds.containsAll(auxiliaryTypeIds)) {
+            throw exception(VOUCHER_AUXILIARY_REQUIRED);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordService.java
new file mode 100644
index 0000000..421aea8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordService.java
@@ -0,0 +1,97 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.voucherword.FmsVoucherWordSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * FMS 凭证字 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsVoucherWordService {
+
+    /**
+     * 创建凭证字
+     *
+     * @param createReqVO 创建信息
+     * @param userId 当前用户编号
+     * @return 凭证字编号
+     */
+    Long createVoucherWord(FmsVoucherWordSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 修改凭证字
+     *
+     * @param updateReqVO 修改信息
+     * @param userId 当前用户编号
+     */
+    void updateVoucherWord(FmsVoucherWordSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除凭证字
+     *
+     * @param accountSetId 账套编号
+     * @param id 凭证字编号
+     * @param userId 当前用户编号
+     */
+    void deleteVoucherWord(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 初始化账套默认凭证字
+     *
+     * @param accountSetId 账套编号
+     */
+    void initializeDefaultVoucherWords(Long accountSetId);
+
+    /**
+     * 获得账套凭证字列表
+     *
+     * @param accountSetId 账套编号
+     * @return 凭证字列表
+     */
+    List<FmsVoucherWordDO> getVoucherWordList(Long accountSetId);
+
+    /**
+     * 获得账套凭证字 Map
+     *
+     * @param accountSetId 账套编号
+     * @return 凭证字 Map
+     */
+    default Map<Long, FmsVoucherWordDO> getVoucherWordMap(Long accountSetId) {
+        return convertMap(getVoucherWordList(accountSetId), FmsVoucherWordDO::getId);
+    }
+
+    /**
+     * 获得账套凭证字 Map
+     *
+     * @param accountSetId 账套编号
+     * @return 凭证字 Map，key 为凭证字名称
+     */
+    default Map<String, FmsVoucherWordDO> getVoucherWordMapByName(Long accountSetId) {
+        return convertMap(getVoucherWordList(accountSetId), FmsVoucherWordDO::getName);
+    }
+
+    /**
+     * 获得账套凭证字列表
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 凭证字列表
+     */
+    List<FmsVoucherWordDO> getVoucherWordList(Long accountSetId, Long userId);
+
+    /**
+     * 校验并获得凭证字
+     *
+     * @param accountSetId 账套编号
+     * @param id 凭证字编号
+     * @return 凭证字
+     */
+    FmsVoucherWordDO validateVoucherWordExists(Long accountSetId, Long id);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordServiceImpl.java
new file mode 100644
index 0000000..cdc2fa8
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordServiceImpl.java
@@ -0,0 +1,196 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.voucherword.FmsVoucherWordSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsVoucherWordMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsVoucherWordPresetEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_WORD_DEFAULT_NOT_DELETABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_WORD_DEFAULT_REQUIRED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_WORD_IN_USE_NOT_DELETABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_WORD_IN_USE_NOT_EDITABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_WORD_IN_USE_BY_CLOSING_SCHEME_NOT_DELETABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_WORD_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_WORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_VOUCHER_WORD_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_VOUCHER_WORD_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_VOUCHER_WORD_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_VOUCHER_WORD_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_VOUCHER_WORD_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_VOUCHER_WORD_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_VOUCHER_WORD_UPDATE_SUCCESS;
+
+/**
+ * FMS 凭证字 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsVoucherWordServiceImpl implements FmsVoucherWordService {
+
+    @Resource
+    private FmsVoucherWordMapper voucherWordMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    @Lazy // 懒加载，避免循环依赖
+    private FmsVoucherService voucherService;
+    @Resource
+    @Lazy // 懒加载，避免循环依赖
+    private FmsClosingSchemeService closingSchemeService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_WORD_TYPE, subType = FMS_VOUCHER_WORD_CREATE_SUB_TYPE,
+            bizNo = "{{#voucherWordId}}", success = FMS_VOUCHER_WORD_CREATE_SUCCESS)
+    public Long createVoucherWord(FmsVoucherWordSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 校验凭证字名称唯一
+        validateVoucherWordNameUnique(null, createReqVO.getAccountSetId(), createReqVO.getName());
+        // 1.3 确定默认状态，并清除原默认凭证字
+        FmsVoucherWordDO defaultVoucherWord = voucherWordMapper.selectDefaultByAccountSetId(
+                createReqVO.getAccountSetId());
+        boolean defaultStatus = Boolean.TRUE.equals(createReqVO.getDefaultStatus())
+                || defaultVoucherWord == null;
+        if (defaultStatus && defaultVoucherWord != null) {
+            voucherWordMapper.updateById(new FmsVoucherWordDO().setId(defaultVoucherWord.getId())
+                    .setDefaultStatus(false));
+        }
+
+        // 2. 创建凭证字
+        FmsVoucherWordDO lastVoucherWord = voucherWordMapper.selectLastByAccountSetId(createReqVO.getAccountSetId());
+        FmsVoucherWordDO voucherWord = BeanUtils.toBean(createReqVO, FmsVoucherWordDO.class)
+                .setId(null).setDefaultStatus(defaultStatus)
+                .setSort(lastVoucherWord == null ? 1 : lastVoucherWord.getSort() + 1);
+        voucherWordMapper.insert(voucherWord);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("voucherWordId", voucherWord.getId());
+        return voucherWord.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_WORD_TYPE, subType = FMS_VOUCHER_WORD_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_VOUCHER_WORD_UPDATE_SUCCESS)
+    public void updateVoucherWord(FmsVoucherWordSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验凭证字存在、使用状态和名称唯一
+        FmsVoucherWordDO voucherWord = validateVoucherWordExists(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        boolean contentChanged = ObjUtil.notEqual(voucherWord.getName(), updateReqVO.getName())
+                || ObjUtil.notEqual(voucherWord.getPrintTitle(), updateReqVO.getPrintTitle());
+        if (contentChanged && voucherService.getVoucherCountByVoucherWordId(
+                updateReqVO.getAccountSetId(), voucherWord.getId()) > 0) {
+            throw exception(VOUCHER_WORD_IN_USE_NOT_EDITABLE);
+        }
+        validateVoucherWordNameUnique(voucherWord.getId(), updateReqVO.getAccountSetId(), updateReqVO.getName());
+
+        // 1.3 校验并切换默认凭证字
+        if (Boolean.TRUE.equals(voucherWord.getDefaultStatus())
+                && Boolean.FALSE.equals(updateReqVO.getDefaultStatus())) {
+            throw exception(VOUCHER_WORD_DEFAULT_REQUIRED);
+        }
+        if (Boolean.TRUE.equals(updateReqVO.getDefaultStatus())) {
+            FmsVoucherWordDO defaultVoucherWord = voucherWordMapper.selectDefaultByAccountSetId(
+                    updateReqVO.getAccountSetId());
+            if (defaultVoucherWord != null && ObjUtil.notEqual(defaultVoucherWord.getId(), voucherWord.getId())) {
+                voucherWordMapper.updateById(new FmsVoucherWordDO().setId(defaultVoucherWord.getId())
+                        .setDefaultStatus(false));
+            }
+        }
+
+        // 2. 更新凭证字
+        voucherWordMapper.updateById(new FmsVoucherWordDO().setId(voucherWord.getId())
+                .setName(updateReqVO.getName()).setPrintTitle(updateReqVO.getPrintTitle())
+                .setDefaultStatus(updateReqVO.getDefaultStatus()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_WORD_TYPE, subType = FMS_VOUCHER_WORD_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = FMS_VOUCHER_WORD_DELETE_SUCCESS)
+    public void deleteVoucherWord(Long accountSetId, Long id, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验凭证字存在且不是默认凭证字
+        FmsVoucherWordDO voucherWord = validateVoucherWordExists(accountSetId, id);
+        if (Boolean.TRUE.equals(voucherWord.getDefaultStatus())) {
+            throw exception(VOUCHER_WORD_DEFAULT_NOT_DELETABLE);
+        }
+        // 1.3 校验凭证字未被凭证使用
+        Long voucherCount = voucherService.getVoucherCountByVoucherWordId(accountSetId, id);
+        if (voucherCount > 0) {
+            throw exception(VOUCHER_WORD_IN_USE_NOT_DELETABLE, voucherCount);
+        }
+        // 1.4 校验凭证字未被结账方案使用
+        Long closingSchemeCount = closingSchemeService.getClosingSchemeCountByVoucherWordId(accountSetId, id);
+        if (closingSchemeCount > 0) {
+            throw exception(VOUCHER_WORD_IN_USE_BY_CLOSING_SCHEME_NOT_DELETABLE, closingSchemeCount);
+        }
+
+        // 2. 删除凭证字
+        voucherWordMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("voucherWord", voucherWord);
+    }
+
+    @Override
+    public void initializeDefaultVoucherWords(Long accountSetId) {
+        List<FmsVoucherWordDO> list = convertList(FmsVoucherWordPresetEnum.values(), preset ->
+                new FmsVoucherWordDO().setAccountSetId(accountSetId).setName(preset.getName())
+                        .setPrintTitle(preset.getPrintTitle()).setDefaultStatus(preset.getDefaultStatus())
+                        .setSort(preset.getSort()));
+        voucherWordMapper.insertBatch(list);
+    }
+
+    @Override
+    public List<FmsVoucherWordDO> getVoucherWordList(Long accountSetId) {
+        return voucherWordMapper.selectListByAccountSetId(accountSetId);
+    }
+
+    @Override
+    public List<FmsVoucherWordDO> getVoucherWordList(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询凭证字列表
+        return getVoucherWordList(accountSetId);
+    }
+
+    @Override
+    public FmsVoucherWordDO validateVoucherWordExists(Long accountSetId, Long id) {
+        FmsVoucherWordDO voucherWord = voucherWordMapper.selectById(id);
+        if (voucherWord == null || ObjUtil.notEqual(voucherWord.getAccountSetId(), accountSetId)) {
+            throw exception(VOUCHER_WORD_NOT_EXISTS);
+        }
+        return voucherWord;
+    }
+
+    private void validateVoucherWordNameUnique(Long id, Long accountSetId, String name) {
+        FmsVoucherWordDO voucherWord = voucherWordMapper.selectByAccountSetIdAndName(accountSetId, name);
+        if (voucherWord != null && ObjUtil.notEqual(voucherWord.getId(), id)) {
+            throw exception(VOUCHER_WORD_NAME_DUPLICATE);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeService.java
new file mode 100644
index 0000000..ea1c8ab
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeService.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.fms.service.home;
+
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeMetricDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeRespVO;
+
+/**
+ * FMS 首页 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsHomeService {
+
+    /**
+     * 获得首页
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 首页信息
+     */
+    FmsHomeRespVO getHome(Long accountSetId, Long userId);
+
+    /**
+     * 获得财务指标明细
+     *
+     * @param accountSetId 账套编号
+     * @param metricKey 指标标识
+     * @param userId 当前用户编号
+     * @return 财务指标明细
+     */
+    FmsHomeMetricDetailRespVO getMetricDetail(Long accountSetId, String metricKey, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeServiceImpl.java
new file mode 100644
index 0000000..dcc870c
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeServiceImpl.java
@@ -0,0 +1,444 @@
+package cn.iocoder.yudao.module.fms.service.home;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeMetricDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceIndicatorDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.enums.config.FmsFinanceIndicatorTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.home.FmsHomeMetricEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceIndicatorService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.report.FmsBalanceSheetService;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import cn.iocoder.yudao.module.fms.service.report.FmsReportCommonService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Comparator;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_NOT_INITIALIZED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.HOME_METRIC_INVALID;
+
+/**
+ * FMS 首页 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsHomeServiceImpl implements FmsHomeService {
+
+    private static final int TREND_MONTH_COUNT = 12;
+    private static final Pattern LINE_FORMULA_PATTERN = Pattern.compile("([+-]?)L(\\d+)");
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsClosingPeriodService closingPeriodService;
+    @Resource
+    private FmsIncomeStatementService incomeStatementService;
+    @Resource
+    private FmsBalanceSheetService balanceSheetService;
+    @Resource
+    private FmsReportCommonService reportCommonService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsFinanceIndicatorService financeIndicatorService;
+
+    @Override
+    public FmsHomeRespVO getHome(Long accountSetId, Long userId) {
+        // 1.1 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 校验账套初始化状态
+        if (!Boolean.TRUE.equals(accountSet.getInitialized()) || accountSet.getStartTime() == null) {
+            throw exception(ACCOUNT_SET_NOT_INITIALIZED);
+        }
+        // 1.3 确定当前会计期间
+        YearMonth currentMonth = closingPeriodService.getCurrentMonth(accountSetId, accountSet.getStartTime());
+        YearMonth startMonth = YearMonth.from(accountSet.getStartTime());
+        List<FmsFinanceIndicatorDO> indicators = getEnabledIndicators(accountSetId, userId);
+
+        // 2. 计算最近十二期财务指标
+        List<FmsHomeRespVO.Trend> trends = new ArrayList<>();
+        for (int index = TREND_MONTH_COUNT - 1; index >= 0; index--) {
+            YearMonth month = currentMonth.minusMonths(index);
+            trends.add(month.isBefore(startMonth) ? buildEmptyTrend(month)
+                    : buildTrend(accountSetId, month, indicators, userId));
+        }
+
+        // 3. 返回当期指标和趋势
+        FmsHomeRespVO.Trend currentTrend = CollUtil.getLast(trends);
+        return new FmsHomeRespVO().setCurrentMonth(currentMonth.toString())
+                .setMetrics(currentTrend.getMetrics()).setTrends(trends);
+    }
+
+    @Override
+    public FmsHomeMetricDetailRespVO getMetricDetail(
+            Long accountSetId, String metricKey, Long userId) {
+        // 1.1 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 校验财务指标
+        FmsFinanceIndicatorDO metric = CollUtil.findOne(
+                getEnabledIndicators(accountSetId, userId),
+                item -> StrUtil.equals(item.getCode(), metricKey));
+        if (metric == null) throw exception(HOME_METRIC_INVALID);
+        // 1.3 校验账套初始化状态
+        if (!Boolean.TRUE.equals(accountSet.getInitialized()) || accountSet.getStartTime() == null) {
+            throw exception(ACCOUNT_SET_NOT_INITIALIZED);
+        }
+        // 1.4 确定当前会计期间
+        YearMonth currentMonth = closingPeriodService.getCurrentMonth(accountSetId, accountSet.getStartTime());
+        YearMonth startMonth = YearMonth.from(accountSet.getStartTime());
+
+        // 2. 计算最近十二期指标趋势
+        List<FmsHomeMetricDetailRespVO.Trend> trends = new ArrayList<>();
+        List<FmsReportItemRespVO> currentItems = new ArrayList<>();
+        List<FmsHomeMetricDetailRespVO.Structure> currentStructure = new ArrayList<>();
+        for (int index = TREND_MONTH_COUNT - 1; index >= 0; index--) {
+            YearMonth month = currentMonth.minusMonths(index);
+            BigDecimal amount = BigDecimal.ZERO;
+            if (!month.isBefore(startMonth)) {
+                amount = calculateIndicator(metric, accountSetId, month, userId);
+                if (month.equals(currentMonth)) {
+                    // TODO DONE @AI：行次公式统一复用报表公共判断能力。
+                    // TODO DONE @AI：报表查询结果先取得，再转换为首页明细结构。
+                    if (reportCommonService.isLineFormula(metric.getFormula())) {
+                        if (FmsFinanceIndicatorTypeEnum.isIncomeStatement(metric.getType())) {
+                            currentItems = getIncomeStatement(accountSetId, month, userId);
+                        } else {
+                            // 先查询资产负债表行次数据，再转换为首页明细项目
+                            FmsReportListReqVO reqVO = new FmsReportListReqVO().setAccountSetId(accountSetId)
+                                    .setStartMonth(month.toString()).setEndMonth(month.toString());
+                            Map<Integer, FmsReportItemRespVO> lineMap = balanceSheetService.getBalanceSheetLineMap(
+                                    reqVO, month, month, userId);
+                            currentItems = new ArrayList<>(lineMap.values());
+                        }
+                    } else {
+                        currentStructure = buildSubjectStructure(metric.getFormula(), accountSetId, month, userId,
+                                FmsFinanceIndicatorTypeEnum.isIncomeStatement(metric.getType()));
+                    }
+                }
+            }
+            trends.add(new FmsHomeMetricDetailRespVO.Trend()
+                    .setMonth(month.toString()).setAmount(amount));
+        }
+
+        // 3. 返回趋势和当期科目构成
+        return new FmsHomeMetricDetailRespVO().setKey(metric.getCode()).setName(metric.getName())
+                .setTrends(trends).setStructure(CollUtil.isNotEmpty(currentStructure)
+                        ? currentStructure : buildStructure(metric.getFormula(), currentItems));
+    }
+
+    /**
+     * 构建指定会计期间的首页财务指标趋势
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 当前用户编号
+     * @return 首页财务指标趋势
+     */
+    private FmsHomeRespVO.Trend buildTrend(Long accountSetId, YearMonth month,
+                                            List<FmsFinanceIndicatorDO> indicators, Long userId) {
+        boolean hasIncome = CollUtil.findOne(indicators,
+                item -> FmsFinanceIndicatorTypeEnum.isIncomeStatement(item.getType())) != null;
+        boolean hasBalance = CollUtil.findOne(indicators,
+                item -> FmsFinanceIndicatorTypeEnum.isBalanceSheet(item.getType())) != null;
+        Map<Integer, FmsReportItemRespVO> incomeLineMap = hasIncome
+                ? convertMap(getIncomeStatement(accountSetId, month, userId), FmsReportItemRespVO::getRowNo)
+                : Collections.emptyMap();
+        Map<Integer, FmsReportItemRespVO> balanceLineMap = hasBalance
+                ? balanceSheetService.getBalanceSheetLineMap(new FmsReportListReqVO().setAccountSetId(accountSetId)
+                        .setStartMonth(month.toString()).setEndMonth(month.toString()), month, month, userId)
+                : Collections.emptyMap();
+        List<FmsHomeRespVO.Metric> metrics = convertList(indicators, indicator ->
+                new FmsHomeRespVO.Metric().setKey(indicator.getCode()).setName(indicator.getName())
+                        .setAmount(reportCommonService.isLineFormula(indicator.getFormula())
+                                ? calculateIndicator(indicator, incomeLineMap, balanceLineMap)
+                                : calculateIndicator(indicator, accountSetId, month, userId)));
+        return new FmsHomeRespVO.Trend().setMonth(month.toString()).setMetrics(metrics)
+                .setIncome(findAmount(metrics, "income")).setOperatingCost(findAmount(metrics, "operatingCost"))
+                .setProfit(findAmount(metrics, "profit")).setExpense(findAmount(metrics, "expense"))
+                .setOther(findAmount(metrics, "other"));
+    }
+
+    /**
+     * 获得指定会计期间的利润表
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 当前用户编号
+     * @return 利润表项目数组
+     */
+    private List<FmsReportItemRespVO> getIncomeStatement(Long accountSetId, YearMonth month, Long userId) {
+        // TODO DONE @AI：查询参数先构建，再执行查询。
+        FmsReportListReqVO reqVO = new FmsReportListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(month.toString()).setEndMonth(month.toString());
+        return incomeStatementService.getIncomeStatement(reqVO, userId);
+    }
+
+    /**
+     * 构建未启用会计期间的空趋势
+     *
+     * @param month 会计期间
+     * @return 空趋势
+     */
+    private FmsHomeRespVO.Trend buildEmptyTrend(YearMonth month) {
+        return new FmsHomeRespVO.Trend().setMonth(month.toString())
+                .setMetrics(new ArrayList<>())
+                .setIncome(BigDecimal.ZERO).setOperatingCost(BigDecimal.ZERO).setProfit(BigDecimal.ZERO)
+                .setExpense(BigDecimal.ZERO).setOther(BigDecimal.ZERO);
+    }
+
+    /**
+     * 根据指标公式计算首页财务指标
+     *
+     * @param indicator 财务指标
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param userId 当前用户编号
+     * @return 指标金额
+     */
+    private BigDecimal calculateIndicator(FmsFinanceIndicatorDO indicator, Long accountSetId, YearMonth month,
+                                          Long userId) {
+        // 1. 准备当前会计期间的报表查询条件
+        FmsReportListReqVO reqVO = new FmsReportListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(month.toString()).setEndMonth(month.toString());
+        // 2. 查询指标所属报表的行次数据
+        Map<Integer, FmsReportItemRespVO> lineMap;
+        if (FmsFinanceIndicatorTypeEnum.isBalanceSheet(indicator.getType())) {
+            lineMap = balanceSheetService.getBalanceSheetLineMap(reqVO, month, month, userId);
+        } else {
+            lineMap = convertMap(getIncomeStatement(accountSetId, month, userId), FmsReportItemRespVO::getRowNo);
+        }
+        // 3. 行次公式直接按报表行次汇总
+        if (reportCommonService.isLineFormula(indicator.getFormula())) {
+            return calculateLineFormula(indicator.getFormula(), lineMap,
+                    FmsFinanceIndicatorTypeEnum.isIncomeStatement(indicator.getType()));
+        }
+        // 4. 科目公式查询余额和科目，并按公式规则计算
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = reportCommonService.getSubjectBalanceMap(accountSetId, month, month, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjectService.getSubjectList(accountSetId, null, userId), FmsSubjectDO::getId);
+        BigDecimal result = BigDecimal.ZERO;
+        for (FmsReportFormulaRespVO formula : reportCommonService.parseSubjectFormula(indicator.getFormula())) {
+            FmsSubjectDO subject = subjectMap.get(formula.getSubjectId());
+            BigDecimal amount = FmsFinanceIndicatorTypeEnum.isBalanceSheet(indicator.getType())
+                    ? reportCommonService.calculateBalanceAmount(formula.getRules(), subject, balanceMap,
+                            subjectMap, false)
+                    : reportCommonService.calculateIncomeOccurrenceAmount(formula.getRules(), subject,
+                            balanceMap.get(formula.getSubjectId()), true, formula.getOperator());
+            result = reportCommonService.applyOperator(result, amount, formula.getOperator());
+        }
+        return result;
+    }
+
+    private BigDecimal calculateIndicator(FmsFinanceIndicatorDO indicator,
+                                          Map<Integer, FmsReportItemRespVO> incomeLineMap,
+                                          Map<Integer, FmsReportItemRespVO> balanceLineMap) {
+        Map<Integer, FmsReportItemRespVO> lineMap = FmsFinanceIndicatorTypeEnum.isBalanceSheet(indicator.getType())
+                ? balanceLineMap : incomeLineMap;
+        return reportCommonService.isLineFormula(indicator.getFormula())
+                ? calculateLineFormula(indicator.getFormula(), lineMap,
+                        FmsFinanceIndicatorTypeEnum.isIncomeStatement(indicator.getType()))
+                : BigDecimal.ZERO;
+    }
+
+    private BigDecimal findAmount(List<FmsHomeRespVO.Metric> metrics, String key) {
+        FmsHomeRespVO.Metric metric = CollUtil.findOne(metrics, item -> StrUtil.equals(item.getKey(), key));
+        return metric == null ? BigDecimal.ZERO : NumberUtils.zeroIfNull(metric.getAmount());
+    }
+
+    /**
+     * 查询账套下已启用的首页财务指标；历史账套未初始化指标时回退到原有五项指标
+     *
+     * @param accountSetId 账套编号
+     * @param userId 当前用户编号
+     * @return 已启用的首页财务指标
+     */
+    private List<FmsFinanceIndicatorDO> getEnabledIndicators(Long accountSetId, Long userId) {
+        List<FmsFinanceIndicatorDO> indicators = financeIndicatorService.getEnabledFinanceIndicatorList(accountSetId,
+                userId);
+        if (CollUtil.isNotEmpty(indicators)) {
+            return indicators;
+        }
+        // 兼容尚未执行新初始化流程的历史账套，保留原有五项首页指标
+        return convertList(Arrays.asList(FmsHomeMetricEnum.values()), metric -> new FmsFinanceIndicatorDO()
+                .setCode(metric.getKey()).setName(metric.getName())
+                .setType(FmsFinanceIndicatorTypeEnum.INCOME_STATEMENT.getType())
+                .setFormula(JsonUtils.toJsonString(Collections.singletonList(metric.getStructureFormula())))
+                .setSort(metric.ordinal()).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                .setAccountSetId(accountSetId));
+    }
+
+    /**
+     * 计算报表行次公式
+     *
+     * @param formula 指标公式 JSON
+     * @param lineMap 报表行次映射
+     * @param current 是否取本期发生额
+     * @return 公式计算结果
+     */
+    private BigDecimal calculateLineFormula(String formula, Map<Integer, FmsReportItemRespVO> lineMap, boolean current) {
+        List<String> expressions = JsonUtils.parseArray(formula, String.class);
+        String expression = CollUtil.getFirst(expressions);
+        if (StrUtil.isEmpty(expression)) {
+            return BigDecimal.ZERO;
+        }
+        BigDecimal result = BigDecimal.ZERO;
+        Matcher matcher = LINE_FORMULA_PATTERN.matcher(expression);
+        while (matcher.find()) {
+            FmsReportItemRespVO item = lineMap.get(Integer.valueOf(matcher.group(2)));
+            BigDecimal amount = item == null ? BigDecimal.ZERO : current
+                    ? NumberUtils.zeroIfNull(item.getCurrentAmount())
+                    : NumberUtils.zeroIfNull(item.getClosingAmount());
+            result = StrUtil.equals(matcher.group(1), "-") ? result.subtract(amount) : result.add(amount);
+        }
+        return result;
+    }
+
+    /**
+     * 构建指定财务指标的当期科目构成
+     *
+     * @param formula 指标公式
+     * @param items 当期报表项目数组
+     * @return 科目构成数组
+     */
+    private List<FmsHomeMetricDetailRespVO.Structure> buildStructure(String formula, List<FmsReportItemRespVO> items) {
+        // 1. 报表无当期项目时，不生成科目构成
+        if (CollUtil.isEmpty(items)) {
+            return new ArrayList<>();
+        }
+
+        // 2. 建立有效报表行次映射
+        Map<Integer, FmsReportItemRespVO> itemMap = convertMap(
+                filterList(items, item -> item.getRowNo() != null && item.getRowNo() > 0),
+                FmsReportItemRespVO::getRowNo);
+
+        // 3. 递归解析指标行次公式，按科目汇总当期金额
+        Map<Long, FmsHomeMetricDetailRespVO.Structure> structureMap = new LinkedHashMap<>();
+        collectLineFormula(formula, BigDecimal.ONE, itemMap, structureMap, new HashSet<>());
+
+        // 4. 仅保留正数科目构成，并按金额从大到小排列
+        List<FmsHomeMetricDetailRespVO.Structure> result = filterList(structureMap.values(),
+                item -> item.getAmount().signum() > 0);
+        result.sort(Comparator.comparing(FmsHomeMetricDetailRespVO.Structure::getAmount).reversed());
+        return result;
+    }
+
+    private List<FmsHomeMetricDetailRespVO.Structure> buildSubjectStructure(String formula, Long accountSetId,
+                                                                            YearMonth month, Long userId, boolean income) {
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = reportCommonService.getSubjectBalanceMap(accountSetId, month, month, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjectService.getSubjectList(accountSetId, null, userId), FmsSubjectDO::getId);
+        Map<Long, FmsHomeMetricDetailRespVO.Structure> structureMap = new LinkedHashMap<>();
+        for (FmsReportFormulaRespVO item : reportCommonService.parseSubjectFormula(formula)) {
+            FmsSubjectDO subject = subjectMap.get(item.getSubjectId());
+            BigDecimal amount = income
+                    ? reportCommonService.calculateIncomeOccurrenceAmount(item.getRules(), subject, balanceMap.get(item.getSubjectId()), true, item.getOperator())
+                    : reportCommonService.calculateBalanceAmount(item.getRules(), subject, balanceMap, subjectMap, false);
+            if (StrUtil.equals(item.getOperator(), "-")) {
+                amount = amount.negate();
+            }
+            FmsHomeMetricDetailRespVO.Structure structure = structureMap.computeIfAbsent(item.getSubjectId(),
+                    subjectId -> new FmsHomeMetricDetailRespVO.Structure().setSubjectId(subjectId)
+                            .setSubjectCode(subject == null ? item.getSubjectNumber() : subject.getCode())
+                            .setSubjectName(subject == null ? item.getSubjectName() : subject.getName())
+                            .setAmount(BigDecimal.ZERO));
+            structure.setAmount(structure.getAmount().add(amount));
+        }
+        List<FmsHomeMetricDetailRespVO.Structure> result = filterList(structureMap.values(), item -> item.getAmount().signum() > 0);
+        result.sort(Comparator.comparing(FmsHomeMetricDetailRespVO.Structure::getAmount).reversed());
+        return result;
+    }
+
+    /**
+     * 递归解析行次公式并汇总科目构成
+     *
+     * @param expression 行次公式
+     * @param factor 金额系数
+     * @param itemMap 行次及利润表项目的映射
+     * @param structureMap 科目编号及科目构成的映射
+     * @param visitingRowNumbers 当前递归链路中的行次集合
+     */
+    private void collectLineFormula(String expression, BigDecimal factor, Map<Integer, FmsReportItemRespVO> itemMap,
+                                    Map<Long, FmsHomeMetricDetailRespVO.Structure> structureMap, Set<Integer> visitingRowNumbers) {
+        Matcher matcher = LINE_FORMULA_PATTERN.matcher(expression);
+        while (matcher.find()) {
+            BigDecimal rowFactor = StrUtil.equals(matcher.group(1), "-") ? factor.negate() : factor;
+            collectRowStructure(Integer.valueOf(matcher.group(2)), rowFactor, itemMap, structureMap, visitingRowNumbers);
+        }
+    }
+
+    /**
+     * 解析利润表行的公式并汇总科目构成
+     *
+     * @param rowNo 行次
+     * @param factor 金额系数
+     * @param itemMap 行次及利润表项目的映射
+     * @param structureMap 科目编号及科目构成的映射
+     * @param visitingRowNumbers 当前递归链路中的行次集合
+     */
+    private void collectRowStructure(Integer rowNo, BigDecimal factor,
+                                     Map<Integer, FmsReportItemRespVO> itemMap,
+                                     Map<Long, FmsHomeMetricDetailRespVO.Structure> structureMap,
+                                     Set<Integer> visitingRowNumbers) {
+        FmsReportItemRespVO item = itemMap.get(rowNo);
+        if (item == null || StrUtil.isEmpty(item.getFormula()) || !visitingRowNumbers.add(rowNo)) {
+            return;
+        }
+        try {
+            if (item.getFormula().contains("L")) {
+                List<String> expressions = JsonUtils.parseArray(item.getFormula(), String.class);
+                if (CollUtil.isNotEmpty(expressions)) {
+                    collectLineFormula(CollUtil.getFirst(expressions), factor, itemMap, structureMap, visitingRowNumbers);
+                }
+                return;
+            }
+            for (FmsReportFormulaRespVO formula : JsonUtils.parseArray(item.getFormula(), FmsReportFormulaRespVO.class)) {
+                if (formula.getSubjectId() == null) {
+                    continue;
+                }
+                BigDecimal amount = NumberUtils.zeroIfNull(formula.getCurrentAmount()).multiply(factor);
+                if (StrUtil.equals(formula.getOperator(), "-")) {
+                    amount = amount.negate();
+                }
+                FmsHomeMetricDetailRespVO.Structure structure = structureMap.computeIfAbsent(
+                        formula.getSubjectId(), subjectId -> new FmsHomeMetricDetailRespVO.Structure()
+                                .setSubjectId(subjectId).setSubjectCode(formula.getSubjectNumber())
+                                .setSubjectName(formula.getSubjectName()).setAmount(BigDecimal.ZERO));
+                structure.setAmount(structure.getAmount().add(amount));
+            }
+        } finally {
+            visitingRowNumbers.remove(rowNo);
+        }
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerService.java
new file mode 100644
index 0000000..7e42a69
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerService.java
@@ -0,0 +1,155 @@
+package cn.iocoder.yudao.module.fms.service.ledger;
+
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerAuxiliaryListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerEntryVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarybalance.FmsLedgerAuxiliaryBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarydetail.FmsLedgerAuxiliaryDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.general.FmsLedgerGeneralRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.multicolumn.FmsLedgerMultiColumnRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitydetail.FmsLedgerQuantityDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitygeneral.FmsLedgerQuantityGeneralRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * FMS 账簿 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsLedgerService {
+
+    // ==================== 公共查询 ====================
+
+    /**
+     * 获得指定期间的账簿凭证分录列表
+     *
+     * @param accountSetId 账套编号
+     * @param beginTime 开始时间
+     * @param endTime 结束时间
+     * @param userId 用户编号
+     * @return 凭证分录列表
+     */
+    List<FmsLedgerEntryVO> getEntryList(Long accountSetId, LocalDateTime beginTime,
+            LocalDateTime endTime, Long userId);
+
+    /**
+     * 获得指定辅助核算组合的余额
+     *
+     * @param accountSetId 账套编号
+     * @param month 会计期间
+     * @param subjectId 科目编号
+     * @param auxiliaryItemIds 辅助核算项目编号数组
+     * @param userId 用户编号
+     * @return 借方为正、贷方为负的余额
+     */
+    BigDecimal getAuxiliaryCombinationBalance(Long accountSetId, String month, Long subjectId,
+            Collection<Long> auxiliaryItemIds, Long userId);
+
+    // ==================== 明细账 ====================
+
+    /**
+     * 获得明细账列表
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 明细账列表
+     */
+    List<FmsLedgerDetailRespVO> getDetailList(FmsLedgerListReqVO listReqVO, Long userId);
+
+    /**
+     * 获得指定期间有发生额的明细账科目树
+     *
+     * @param listReqVO 查询参数
+     * @param userId 用户编号
+     * @return 科目列表
+     */
+    List<FmsSubjectDO> getDetailSubjectList(FmsLedgerListReqVO listReqVO, Long userId);
+
+    // ==================== 总账 ====================
+
+    /**
+     * 获得总账列表
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 总账列表
+     */
+    List<FmsLedgerGeneralRespVO> getGeneralList(FmsLedgerListReqVO listReqVO, Long userId);
+
+    // ==================== 科目余额表 ====================
+
+    /**
+     * 获得科目余额表列表
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 科目余额表列表
+     */
+    List<FmsLedgerSubjectBalanceRespVO> getSubjectBalanceList(
+            FmsLedgerListReqVO listReqVO, Long userId);
+
+    // ==================== 多栏账 ====================
+
+    /**
+     * 获得多栏账
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 多栏账
+     */
+    FmsLedgerMultiColumnRespVO getMultiColumn(FmsLedgerListReqVO listReqVO, Long userId);
+
+    // ==================== 核算项目明细账 ====================
+
+    /**
+     * 获得核算项目明细账列表
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 核算项目明细账列表
+     */
+    List<FmsLedgerAuxiliaryDetailRespVO> getAuxiliaryDetailList(
+            FmsLedgerAuxiliaryListReqVO listReqVO, Long userId);
+
+    // ==================== 核算项目余额表 ====================
+
+    /**
+     * 获得核算项目余额表列表
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 核算项目余额表列表
+     */
+    List<FmsLedgerAuxiliaryBalanceRespVO> getAuxiliaryBalanceList(
+            FmsLedgerAuxiliaryListReqVO listReqVO, Long userId);
+
+    // ==================== 数量金额明细账 ====================
+
+    /**
+     * 获得数量金额明细账列表
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 数量金额明细账列表
+     */
+    List<FmsLedgerQuantityDetailRespVO> getQuantityDetailList(FmsLedgerListReqVO listReqVO, Long userId);
+
+    // ==================== 数量金额总账 ====================
+
+    /**
+     * 获得数量金额总账列表
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 数量金额总账列表
+     */
+    List<FmsLedgerQuantityGeneralRespVO> getQuantityGeneralList(FmsLedgerListReqVO listReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerServiceImpl.java
new file mode 100644
index 0000000..15feee0
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerServiceImpl.java
@@ -0,0 +1,1850 @@
+package cn.iocoder.yudao.module.fms.service.ledger;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerAuxiliaryListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerEntryVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarybalance.FmsLedgerAuxiliaryBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarydetail.FmsLedgerAuxiliaryDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.general.FmsLedgerGeneralRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.multicolumn.FmsLedgerMultiColumnRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitydetail.FmsLedgerQuantityDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitygeneral.FmsLedgerQuantityGeneralRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsInitialBalanceDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsInitialBalanceMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.ledger.FmsLedgerQueryMapper;
+import cn.iocoder.yudao.module.fms.enums.common.FmsBalanceDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.ledger.FmsLedgerBalanceModeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryItemService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import jakarta.annotation.Resource;
+import lombok.AllArgsConstructor;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.function.Predicate;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertListByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sumBigDecimal;
+import static cn.iocoder.yudao.framework.common.util.number.NumberUtils.zeroIfNull;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.AUXILIARY_ITEM_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.LEDGER_PERIOD_BEFORE_ACCOUNT_START;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.LEDGER_PERIOD_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.VOUCHER_AUXILIARY_REQUIRED;
+
+/**
+ * FMS 账簿 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsLedgerServiceImpl implements FmsLedgerService {
+
+    @Resource
+    private FmsLedgerQueryMapper ledgerQueryMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsFinanceParameterService financeParameterService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @Resource
+    private FmsInitialBalanceMapper initialBalanceMapper;
+
+    // ==================== 公共查询 ====================
+
+    @Override
+    public List<FmsLedgerEntryVO> getEntryList(Long accountSetId, LocalDateTime beginTime,
+            LocalDateTime endTime, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询指定期间的凭证分录
+        return filterList(ledgerQueryMapper.selectEntryListBeforeTime(accountSetId, endTime),
+                entry -> !entry.getVoucherTime().isBefore(beginTime));
+    }
+
+    @Override
+    public BigDecimal getAuxiliaryCombinationBalance(Long accountSetId, String month, Long subjectId,
+            Collection<Long> auxiliaryItemIds, Long userId) {
+        // 1. 加载账簿上下文
+        LedgerContext context = buildContext(new FmsLedgerListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(month).setEndMonth(month), userId);
+
+        // 2. 校验科目和辅助核算项目
+        FmsSubjectDO subject = context.subjectMap.get(subjectId);
+        if (subject == null) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+        List<FmsAuxiliaryItemDO> auxiliaryItems = auxiliaryItemService
+                .validateAuxiliaryItemList(accountSetId, auxiliaryItemIds);
+        Set<Long> auxiliaryItemIdSet = new LinkedHashSet<>(auxiliaryItemIds);
+        if (CollUtil.size(subject.getAuxiliaryTypeIds()) != auxiliaryItemIdSet.size()
+                || !new LinkedHashSet<>(subject.getAuxiliaryTypeIds()).equals(
+                convertSet(auxiliaryItems, FmsAuxiliaryItemDO::getAuxiliaryTypeId))) {
+            throw exception(VOUCHER_AUXILIARY_REQUIRED);
+        }
+
+        // 3. 计算辅助核算组合的初始余额
+        BigDecimal signedBalance = BigDecimal.ZERO;
+        List<FmsInitialBalanceDO> initialBalances = filterList(context.initialBalances,
+                initial -> ObjUtil.equal(initial.getSubjectId(), subjectId));
+        for (FmsInitialBalanceDO initial : initialBalances) {
+            if (CollUtil.isEmpty(initial.getAssistBalances())) {
+                continue;
+            }
+            List<FmsInitialBalanceDO.AssistBalance> assistBalances = filterList(initial.getAssistBalances(),
+                    assist -> CollUtil.isNotEmpty(assist.getAuxiliaries())
+                            && auxiliaryItemIdSet.equals(convertSet(assist.getAuxiliaries(),
+                            FmsInitialBalanceDO.AuxiliaryItem::getItemId)));
+            BigDecimal initialAmount = sumBigDecimal(assistBalances,
+                    FmsInitialBalanceDO.AssistBalance::getOpeningAmount);
+            signedBalance = signedBalance.add(ObjUtil.equal(subject.getBalanceDirection(),
+                    FmsDebitCreditDirectionEnum.DEBIT.getType()) ? initialAmount : initialAmount.negate());
+        }
+
+        // 4. 累加会计期间结束前的凭证发生额
+        List<FmsLedgerEntryVO> entries = filterList(context.entries,
+                entry -> ObjUtil.equal(entry.getSubjectId(), subjectId)
+                        && CollUtil.isNotEmpty(entry.getAuxiliaries())
+                        && auxiliaryItemIdSet.equals(convertSet(entry.getAuxiliaries(),
+                        FmsVoucherEntryDO.AuxiliaryItem::getItemId)));
+        return signedBalance.add(calculateSignedAmount(entries, null,
+                context.endMonth.plusMonths(1).atDay(1).atStartOfDay()));
+    }
+
+    // ==================== 明细账 ====================
+
+    @Override
+    public List<FmsLedgerDetailRespVO> getDetailList(FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 加载账簿上下文
+        LedgerContext context = buildContext(listReqVO, userId);
+        // 2. 校验科目
+        FmsSubjectDO subject = context.subjectMap.get(listReqVO.getSubjectId());
+        if (subject == null) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+
+        // 3. 计算明细账
+        return buildLedgerRows(context, subject, true);
+    }
+
+    @Override
+    public List<FmsSubjectDO> getDetailSubjectList(FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 加载指定期间的账簿上下文
+        LedgerContext context = buildContext(listReqVO, userId);
+        LocalDateTime beginTime = context.startMonth.atDay(1).atStartOfDay();
+        LocalDateTime endTime = context.endMonth.plusMonths(1).atDay(1).atStartOfDay();
+
+        // 2. 收集期间有凭证发生额的科目，并补齐其父级节点
+        Set<Long> subjectIds = filterEntriesByTime(context.entries, beginTime, endTime).stream()
+                .map(FmsLedgerEntryVO::getSubjectId).collect(Collectors.toCollection(LinkedHashSet::new));
+        Set<Long> visibleSubjectIds = new LinkedHashSet<>(subjectIds);
+        for (FmsSubjectDO subject : context.subjects) {
+            if (!subjectIds.contains(subject.getId())) {
+                continue;
+            }
+            // TODO @AI：尽量不要 while true 死循环，而是有一个 for i 《 short 的上限》
+            Long parentId = subject.getParentId();
+            while (parentId != null && visibleSubjectIds.add(parentId)) {
+                FmsSubjectDO parent = context.subjectMap.get(parentId);
+                parentId = parent == null ? null : parent.getParentId();
+            }
+        }
+        return filterList(context.subjects, subject -> visibleSubjectIds.contains(subject.getId()));
+    }
+
+    // ==================== 总账 ====================
+
+    @Override
+    public List<FmsLedgerGeneralRespVO> getGeneralList(FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 加载账簿上下文
+        LedgerContext context = buildContext(listReqVO, userId);
+
+        // 2. 筛选总账科目
+        List<FmsSubjectDO> subjects = filterSubjects(context, listReqVO);
+
+        // 3. 计算总账
+        List<FmsLedgerDetailRespVO> detailRows = new ArrayList<>();
+        for (FmsSubjectDO subject : subjects) {
+            List<FmsLedgerDetailRespVO> rows = buildLedgerRows(context, subject, false);
+            if (CollUtil.isNotEmpty(rows)
+                    && rows.stream().anyMatch(row -> row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_VOUCHER)
+                    || zeroIfNull(row.getDebitAmount()).signum() != 0
+                    || zeroIfNull(row.getCreditAmount()).signum() != 0
+                    || zeroIfNull(row.getBalance()).signum() != 0)) {
+                detailRows.addAll(rows);
+            }
+        }
+        return BeanUtils.toBean(detailRows, FmsLedgerGeneralRespVO.class);
+    }
+
+    // ==================== 科目余额表 ====================
+
+    @Override
+    public List<FmsLedgerSubjectBalanceRespVO> getSubjectBalanceList(
+            FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 加载账簿上下文
+        LedgerContext context = buildContext(listReqVO, userId);
+
+        // 2. 计算辅助核算组合余额
+        Map<Long, FmsAuxiliaryItemDO> auxiliaryItemMap = convertMap(
+                auxiliaryItemService.getAuxiliaryItemListByAccountSetId(listReqVO.getAccountSetId(), userId),
+                FmsAuxiliaryItemDO::getId);
+        Map<Long, List<FmsLedgerSubjectBalanceRespVO>> auxiliaryBalanceMap =
+                buildAuxiliaryCombinationBalanceMap(context, auxiliaryItemMap);
+
+        // 3. 计算科目余额并过滤八项金额全零且没有辅助组合余额的科目
+        List<FmsLedgerSubjectBalanceRespVO> result = buildSubjectBalanceList(context, listReqVO,
+                balance -> hasSubjectBalanceAmount(balance)
+                        || auxiliaryBalanceMap.containsKey(balance.getSubjectId()));
+        appendAuxiliaryCombinationBalances(result, auxiliaryBalanceMap);
+        return result;
+    }
+
+    // ==================== 多栏账 ====================
+
+    @Override
+    public FmsLedgerMultiColumnRespVO getMultiColumn(FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 加载账簿上下文
+        LedgerContext context = buildContext(listReqVO, userId);
+        // 2. 校验科目
+        FmsSubjectDO subject = context.subjectMap.get(listReqVO.getSubjectId());
+        if (subject == null) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+
+        // 3. 筛选有数据的动态科目列
+        Set<Long> subjectIds = collectSubjectIds(context, subject.getId());
+        List<FmsSubjectDO> columns = filterList(context.subjects, column -> subjectIds.contains(column.getId())
+                && (context.entries.stream().anyMatch(entry -> ObjUtil.equal(entry.getSubjectId(), column.getId()))
+                || context.initialBalances.stream().anyMatch(initial -> ObjUtil.equal(
+                        initial.getSubjectId(), column.getId())
+                        && (zeroIfNull(initial.getOpeningAmount()).signum() != 0
+                        || zeroIfNull(initial.getYearDebitAmount()).signum() != 0
+                        || zeroIfNull(initial.getYearCreditAmount()).signum() != 0))));
+
+        // 4. 计算多栏账
+        List<FmsLedgerDetailRespVO> rows = appendMultiColumnEndingRows(
+                buildLedgerRows(context, subject, true));
+        rows.forEach(row -> {
+            Map<Long, BigDecimal> columnAmounts = buildColumnAmounts(context, columns, row);
+            row.setColumnAmounts(columnAmounts);
+        });
+        return new FmsLedgerMultiColumnRespVO()
+                .setColumns(convertList(columns, column -> new FmsLedgerMultiColumnRespVO.Column()
+                        .setSubjectId(column.getId()).setSubjectCode(column.getCode())
+                        .setSubjectName(column.getName())
+                        .setBalanceDirection(column.getBalanceDirection())))
+                .setRows(rows);
+    }
+
+    // ==================== 核算项目明细账 ====================
+
+    @Override
+    public List<FmsLedgerAuxiliaryDetailRespVO> getAuxiliaryDetailList(
+            FmsLedgerAuxiliaryListReqVO listReqVO, Long userId) {
+        // 1. 加载辅助核算账簿上下文
+        AuxiliaryLedgerContext context = buildAuxiliaryContext(listReqVO.getAccountSetId(),
+                listReqVO.getStartMonth(), listReqVO.getEndMonth(), listReqVO.getAuxiliaryTypeId(),
+                listReqVO.getSubjectId(), userId);
+        // 2. 校验辅助核算项目
+        validateAuxiliaryItem(context, listReqVO.getAuxiliaryItemId());
+
+        // 3. 计算核算项目明细账
+        return buildAuxiliaryDetailRows(context, listReqVO.getAuxiliaryItemId());
+    }
+
+    // ==================== 核算项目余额表 ====================
+
+    @Override
+    public List<FmsLedgerAuxiliaryBalanceRespVO> getAuxiliaryBalanceList(
+            FmsLedgerAuxiliaryListReqVO listReqVO, Long userId) {
+        // 1. 加载辅助核算账簿上下文
+        AuxiliaryLedgerContext context = buildAuxiliaryContext(listReqVO.getAccountSetId(),
+                listReqVO.getStartMonth(), listReqVO.getEndMonth(), listReqVO.getAuxiliaryTypeId(),
+                listReqVO.getSubjectId(), userId);
+        // 2. 校验辅助核算项目
+        if (listReqVO.getAuxiliaryItemId() != null) {
+            validateAuxiliaryItem(context, listReqVO.getAuxiliaryItemId());
+        }
+
+        // 3. 计算核算项目余额并过滤八项金额全零的项目
+        List<FmsLedgerAuxiliaryBalanceRespVO> balances = convertList(context.auxiliaryItems,
+                item -> buildAuxiliaryBalance(context, item),
+                item -> (listReqVO.getAuxiliaryItemId() == null
+                        || ObjUtil.equal(item.getId(), listReqVO.getAuxiliaryItemId()))
+                        && (CollUtil.isNotEmpty(filterAuxiliaryEntries(context, item.getId()))
+                        || CollUtil.isNotEmpty(filterInitialAssists(context, item.getId()))));
+        return filterList(balances, this::hasAuxiliaryBalanceAmount);
+    }
+
+    // ==================== 数量金额明细账 ====================
+
+    @Override
+    public List<FmsLedgerQuantityDetailRespVO> getQuantityDetailList(
+            FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 加载账簿上下文并校验科目
+        LedgerContext context = buildContext(listReqVO, userId);
+        FmsSubjectDO subject = context.subjectMap.get(listReqVO.getSubjectId());
+        if (subject == null) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+
+        // 2. 仅汇总所选子树中启用数量核算的科目
+        Set<Long> subjectIds = collectSubjectIds(context, subject.getId());
+        Set<Long> quantitySubjectIds = convertSet(filterList(context.subjects,
+                item -> subjectIds.contains(item.getId()) && Boolean.TRUE.equals(item.getQuantityAccounting())),
+                FmsSubjectDO::getId);
+        List<FmsLedgerQuantityDetailRespVO> result = BeanUtils.toBean(
+                buildLedgerRows(context, subject, true, quantitySubjectIds), FmsLedgerQuantityDetailRespVO.class);
+        result.forEach(this::fillQuantityDetailUnitPrices);
+        return result;
+    }
+
+    /**
+     * 补充数量明细账的期初、本期、累计和期末单价
+     *
+     * @param row 数量明细账行
+     */
+    private void fillQuantityDetailUnitPrices(FmsLedgerQuantityDetailRespVO row) {
+        // 1. 汇总当前行的数量和金额
+        BigDecimal periodQuantity = zeroIfNull(row.getDebitQuantity()).add(zeroIfNull(row.getCreditQuantity()));
+        BigDecimal periodAmount = zeroIfNull(row.getDebitAmount()).add(zeroIfNull(row.getCreditAmount()));
+        BigDecimal balanceQuantity = zeroIfNull(row.getBalanceQuantity());
+        BigDecimal balanceAmount = zeroIfNull(row.getBalance());
+        BigDecimal price = row.getUnitPrice();
+        // 2. 按行类型计算对应期间单价
+        if (row.getRowType().equals(FmsLedgerQuantityDetailRespVO.ROW_TYPE_OPENING)) {
+            row.setOpeningUnitPrice(unitPrice(balanceAmount, balanceQuantity));
+        } else if (row.getRowType().equals(FmsLedgerQuantityDetailRespVO.ROW_TYPE_PERIOD_TOTAL)) {
+            row.setPeriodUnitPrice(unitPrice(periodAmount, periodQuantity));
+        } else if (row.getRowType().equals(FmsLedgerQuantityDetailRespVO.ROW_TYPE_YEAR_TOTAL)) {
+            row.setYearUnitPrice(unitPrice(periodAmount, periodQuantity));
+        } else if (row.getRowType().equals(FmsLedgerQuantityDetailRespVO.ROW_TYPE_VOUCHER)) {
+            row.setPeriodUnitPrice(price);
+        }
+        // 3. 统一计算期末单价
+        row.setEndingUnitPrice(unitPrice(balanceAmount, balanceQuantity));
+    }
+
+    private BigDecimal unitPrice(BigDecimal amount, BigDecimal quantity) {
+        return quantity.signum() == 0 ? BigDecimal.ZERO : amount.divide(quantity, 6, RoundingMode.HALF_UP);
+    }
+
+    // ==================== 数量金额总账 ====================
+
+    @Override
+    public List<FmsLedgerQuantityGeneralRespVO> getQuantityGeneralList(FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 加载账簿上下文
+        LedgerContext context = buildContext(listReqVO, userId);
+
+        // 2. 计算科目余额；保留有数量业务节点及其非数量父级汇总节点
+        List<FmsLedgerSubjectBalanceRespVO> balances = buildSubjectBalanceList(context, listReqVO,
+                balance -> true, subject -> buildSubjectBalance(context, subject, true));
+        pruneQuantityGeneralTree(balances);
+        return buildQuantityGeneralRespVOList(balances);
+    }
+
+    /**
+     * 构建普通账簿计算上下文
+     *
+     * @param listReqVO 列表查询参数
+     * @param userId 用户编号
+     * @return 普通账簿计算上下文
+     */
+    private LedgerContext buildContext(FmsLedgerListReqVO listReqVO, Long userId) {
+        // 1. 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(
+                listReqVO.getAccountSetId(), userId);
+
+        // 2. 校验会计期间
+        YearMonth startMonth = LocalDateTimeUtils.parseYearMonth(listReqVO.getStartMonth());
+        YearMonth endMonth = LocalDateTimeUtils.parseYearMonth(listReqVO.getEndMonth());
+        validateLedgerPeriod(accountSet, startMonth, endMonth);
+
+        // 3. 加载财务参数和科目
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(
+                listReqVO.getAccountSetId(), userId);
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(
+                listReqVO.getAccountSetId(), null, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        Map<Long, List<Long>> childMap = new HashMap<>();
+        subjects.forEach(subject -> childMap.computeIfAbsent(subject.getParentId(), key -> new ArrayList<>())
+                .add(subject.getId()));
+
+        // 4. 加载初始余额和查询期间结束前的凭证分录
+        LocalDateTime endTime = endMonth.plusMonths(1).atDay(1).atStartOfDay();
+        return new LedgerContext(accountSet, financeParameter, startMonth, endMonth, subjects, subjectMap, childMap,
+                initialBalanceMapper.selectListByAccountSetId(listReqVO.getAccountSetId()),
+                ledgerQueryMapper.selectEntryListBeforeTime(listReqVO.getAccountSetId(), endTime));
+    }
+
+    /**
+     * 根据科目范围和级次筛选科目
+     *
+     * @param context 普通账簿计算上下文
+     * @param listReqVO 列表查询参数
+     * @return 科目列表
+     */
+    private List<FmsSubjectDO> filterSubjects(LedgerContext context, FmsLedgerListReqVO listReqVO) {
+        FmsSubjectDO startSubject = getOptionalSubject(context, listReqVO.getStartSubjectId());
+        FmsSubjectDO endSubject = getOptionalSubject(context, listReqVO.getEndSubjectId());
+        String startCode = startSubject == null ? null : startSubject.getCode();
+        String endCode = endSubject == null ? null : endSubject.getCode();
+        Set<Long> endSubjectIds = endSubject == null ? Collections.emptySet()
+                : collectSubjectIds(context, endSubject.getId());
+        return filterList(context.subjects, subject -> (listReqVO.getMinLevel() == null
+                || subject.getLevel() >= listReqVO.getMinLevel())
+                && (listReqVO.getMaxLevel() == null || subject.getLevel() <= listReqVO.getMaxLevel())
+                && (startCode == null || subject.getCode().compareTo(startCode) >= 0)
+                && (endCode == null || subject.getCode().compareTo(endCode) <= 0
+                || endSubjectIds.contains(subject.getId())));
+    }
+
+    /**
+     * 构建科目余额树
+     *
+     * @param context 普通账簿计算上下文
+     * @param listReqVO 列表查询参数
+     * @param balancePredicate 余额行保留条件
+     * @return 科目余额树
+     */
+    private List<FmsLedgerSubjectBalanceRespVO> buildSubjectBalanceList(LedgerContext context,
+            FmsLedgerListReqVO listReqVO, Predicate<FmsLedgerSubjectBalanceRespVO> balancePredicate) {
+        return buildSubjectBalanceList(context, listReqVO, balancePredicate,
+                subject -> buildSubjectBalance(context, subject, false));
+    }
+
+    /**
+     * 构建科目余额树
+     *
+     * @param context 普通账簿计算上下文
+     * @param listReqVO 列表查询参数
+     * @param balancePredicate 余额行保留条件
+     * @param balanceBuilder 科目余额构建函数
+     * @return 科目余额树
+     */
+    private List<FmsLedgerSubjectBalanceRespVO> buildSubjectBalanceList(LedgerContext context,
+            FmsLedgerListReqVO listReqVO, Predicate<FmsLedgerSubjectBalanceRespVO> balancePredicate,
+            Function<FmsSubjectDO, FmsLedgerSubjectBalanceRespVO> balanceBuilder) {
+        // 1. 计算科目余额并过滤空行
+        List<FmsSubjectDO> subjects = filterSubjects(context, listReqVO);
+        Map<Long, FmsLedgerSubjectBalanceRespVO> resultMap = convertMap(subjects, FmsSubjectDO::getId,
+                balanceBuilder, (oldValue, newValue) -> oldValue,
+                LinkedHashMap::new);
+        resultMap.values().removeIf(balancePredicate.negate());
+
+        // 2. 组装科目树
+        List<FmsLedgerSubjectBalanceRespVO> roots = new ArrayList<>();
+        subjects.forEach(subject -> {
+            FmsLedgerSubjectBalanceRespVO current = resultMap.get(subject.getId());
+            if (current == null) {
+                return;
+            }
+            FmsLedgerSubjectBalanceRespVO parent = resultMap.get(subject.getParentId());
+            if (parent == null) {
+                roots.add(current);
+            } else {
+                parent.getChildren().add(current);
+            }
+        });
+        return roots;
+    }
+
+    /**
+     * 获得可选科目，不存在时抛出业务异常
+     *
+     * @param context 普通账簿计算上下文
+     * @param subjectId 科目编号
+     * @return 科目
+     */
+    private FmsSubjectDO getOptionalSubject(LedgerContext context, Long subjectId) {
+        if (subjectId == null) {
+            return null;
+        }
+        FmsSubjectDO subject = context.subjectMap.get(subjectId);
+        if (subject == null) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+        return subject;
+    }
+
+    /**
+     * 构建指定科目的账簿行
+     *
+     * @param context 普通账簿计算上下文
+     * @param subject 科目
+     * @param includeVoucherRows 是否包含凭证分录行
+     * @return 账簿行列表
+     */
+    private List<FmsLedgerDetailRespVO> buildLedgerRows(LedgerContext context, FmsSubjectDO subject, boolean includeVoucherRows) {
+        return buildLedgerRows(context, subject, includeVoucherRows, collectSubjectIds(context, subject.getId()));
+    }
+
+    /**
+     * 构建指定科目范围的账簿行
+     *
+     * @param context 普通账簿计算上下文
+     * @param subject 查询科目
+     * @param includeVoucherRows 是否包含凭证分录行
+     * @param subjectIds 参与汇总的科目编号集合
+     * @return 账簿行列表
+     */
+    private List<FmsLedgerDetailRespVO> buildLedgerRows(LedgerContext context, FmsSubjectDO subject,
+            boolean includeVoucherRows, Set<Long> subjectIds) {
+        // 1. 筛选科目及下级科目的凭证分录
+        List<FmsLedgerEntryVO> entries = filterList(context.entries,
+                entry -> subjectIds.contains(entry.getSubjectId()));
+
+        // 2. 计算并添加期初余额行
+        BigDecimal openingSignedAmount = calculateInitialSignedAmount(context, subjectIds)
+                .add(calculateSignedAmount(entries, null, context.startMonth.atDay(1).atStartOfDay()));
+        BigDecimal openingSignedQuantity = calculateInitialSignedQuantity(context, subjectIds)
+                .add(calculateSignedQuantity(entries, null, context.startMonth.atDay(1).atStartOfDay()));
+        List<FmsLedgerDetailRespVO> result = new ArrayList<>();
+        result.add(buildSummaryRow(context, subject, FmsLedgerDetailRespVO.ROW_TYPE_OPENING, context.startMonth,
+                context.startMonth.atEndOfMonth(), "期初余额", BigDecimal.ZERO, BigDecimal.ZERO,
+                BigDecimal.ZERO, BigDecimal.ZERO, openingSignedAmount, openingSignedQuantity));
+
+        // 3. 逐月计算凭证分录、本期合计和本年累计行
+        BigDecimal runningSignedAmount = openingSignedAmount;
+        BigDecimal runningSignedQuantity = openingSignedQuantity;
+        YearMonth currentMonth = context.startMonth;
+        while (!currentMonth.isAfter(context.endMonth)) {
+            LocalDateTime monthBeginTime = currentMonth.atDay(1).atStartOfDay();
+            LocalDateTime nextMonthBeginTime = currentMonth.plusMonths(1).atDay(1).atStartOfDay();
+            List<FmsLedgerEntryVO> monthEntries = entries.stream()
+                    .filter(entry -> !entry.getVoucherTime().isBefore(monthBeginTime)
+                            && entry.getVoucherTime().isBefore(nextMonthBeginTime))
+                    .collect(Collectors.toList());
+            if (includeVoucherRows) {
+                for (FmsLedgerEntryVO entry : monthEntries) {
+                    runningSignedAmount = runningSignedAmount.add(zeroIfNull(entry.getDebitAmount()))
+                            .subtract(zeroIfNull(entry.getCreditAmount()));
+                    BigDecimal signedQuantity = signedQuantity(entry);
+                    runningSignedQuantity = runningSignedQuantity.add(signedQuantity);
+                    result.add(buildVoucherRow(context, subject, entry,
+                            runningSignedAmount, runningSignedQuantity));
+                }
+            } else {
+                runningSignedAmount = runningSignedAmount.add(calculateSignedAmount(
+                        monthEntries, null, null));
+                runningSignedQuantity = runningSignedQuantity.add(calculateSignedQuantity(
+                        monthEntries, null, null));
+            }
+            BigDecimal periodDebitAmount = sumDebitAmount(monthEntries);
+            BigDecimal periodCreditAmount = sumCreditAmount(monthEntries);
+            BigDecimal periodDebitQuantity = sumQuantity(monthEntries, true);
+            BigDecimal periodCreditQuantity = sumQuantity(monthEntries, false);
+            result.add(buildSummaryRow(context, subject, FmsLedgerDetailRespVO.ROW_TYPE_PERIOD_TOTAL,
+                    currentMonth, currentMonth.atEndOfMonth(), "本期合计", periodDebitAmount,
+                    periodCreditAmount, periodDebitQuantity, periodCreditQuantity,
+                    runningSignedAmount, runningSignedQuantity));
+
+            LocalDateTime yearBeginTime = currentMonth.atDay(1).withDayOfYear(1).atStartOfDay();
+            List<FmsLedgerEntryVO> yearEntries = entries.stream()
+                    .filter(entry -> !entry.getVoucherTime().isBefore(yearBeginTime)
+                            && entry.getVoucherTime().isBefore(nextMonthBeginTime))
+                    .collect(Collectors.toList());
+            BigDecimal yearDebitAmount = sumDebitAmount(yearEntries)
+                    .add(calculateInitialYearAmount(context, subjectIds, true, currentMonth.getYear()));
+            BigDecimal yearCreditAmount = sumCreditAmount(yearEntries)
+                    .add(calculateInitialYearAmount(context, subjectIds, false, currentMonth.getYear()));
+            BigDecimal yearDebitQuantity = sumQuantity(yearEntries, true)
+                    .add(calculateInitialYearQuantity(context, subjectIds, true, currentMonth.getYear()));
+            BigDecimal yearCreditQuantity = sumQuantity(yearEntries, false)
+                    .add(calculateInitialYearQuantity(context, subjectIds, false, currentMonth.getYear()));
+            result.add(buildSummaryRow(context, subject, FmsLedgerDetailRespVO.ROW_TYPE_YEAR_TOTAL,
+                    currentMonth, currentMonth.atEndOfMonth(), "本年累计", yearDebitAmount,
+                    yearCreditAmount, yearDebitQuantity, yearCreditQuantity,
+                    runningSignedAmount, runningSignedQuantity));
+            currentMonth = currentMonth.plusMonths(1);
+        }
+        return result;
+    }
+
+    /**
+     * 构建凭证分录账簿行
+     *
+     * @param context 普通账簿计算上下文
+     * @param subject 查询科目
+     * @param entry 凭证分录
+     * @param signedBalance 余额方向金额
+     * @param signedQuantity 余额方向数量
+     * @return 凭证分录账簿行
+     */
+    private FmsLedgerDetailRespVO buildVoucherRow(LedgerContext context, FmsSubjectDO subject,
+            FmsLedgerEntryVO entry, BigDecimal signedBalance, BigDecimal signedQuantity) {
+        return fillBalance(context, subject, new FmsLedgerDetailRespVO()
+                .setRowType(FmsLedgerDetailRespVO.ROW_TYPE_VOUCHER)
+                .setEntryId(entry.getEntryId()).setEntrySubjectId(entry.getSubjectId())
+                .setSubjectId(subject.getId()).setSubjectCode(subject.getCode())
+                .setSubjectName(subject.getName()).setPeriod(YearMonth.from(entry.getVoucherTime()).toString())
+                .setAccountDate(entry.getVoucherTime().toLocalDate()).setVoucherId(entry.getVoucherId())
+                .setVoucherNumber(entry.getVoucherWordName() + "-" + entry.getVoucherNumber())
+                .setDigest(entry.getDigest()).setDebitAmount(zeroIfNull(entry.getDebitAmount()))
+                .setCreditAmount(zeroIfNull(entry.getCreditAmount()))
+                .setDebitQuantity(isDebit(entry) ? zeroIfNull(entry.getQuantity()) : BigDecimal.ZERO)
+                .setCreditQuantity(isDebit(entry) ? BigDecimal.ZERO : zeroIfNull(entry.getQuantity()))
+                .setUnitPrice(zeroIfNull(entry.getUnitPrice())).setQuantityUnit(subject.getQuantityUnit()),
+                signedBalance, signedQuantity);
+    }
+
+    /**
+     * 构建多栏账各科目列金额
+     *
+     * @param context 普通账簿计算上下文
+     * @param columns 多栏账科目列
+     * @param row 账簿行
+     * @return 科目编号与金额 Map
+     */
+    private Map<Long, BigDecimal> buildColumnAmounts(LedgerContext context,
+            List<FmsSubjectDO> columns, FmsLedgerDetailRespVO row) {
+        Map<Long, BigDecimal> result = new LinkedHashMap<>();
+        for (FmsSubjectDO column : columns) {
+            BigDecimal amount;
+            if (row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_VOUCHER)) {
+                amount = ObjUtil.equal(row.getEntrySubjectId(), column.getId())
+                        ? nominalAmount(column, row.getDebitAmount(), row.getCreditAmount()) : BigDecimal.ZERO;
+            } else {
+                amount = calculateColumnSummaryAmount(context, column, row);
+            }
+            result.put(column.getId(), amount);
+        }
+        return result;
+    }
+
+    /**
+     * 为多栏账每月追加期末余额行
+     *
+     * @param rows 账簿行
+     * @return 包含每月期末余额的账簿行
+     */
+    private List<FmsLedgerDetailRespVO> appendMultiColumnEndingRows(List<FmsLedgerDetailRespVO> rows) {
+        List<FmsLedgerDetailRespVO> result = new ArrayList<>();
+        for (FmsLedgerDetailRespVO row : rows) {
+            result.add(row);
+            if (!ObjUtil.equal(row.getRowType(), FmsLedgerDetailRespVO.ROW_TYPE_YEAR_TOTAL)) {
+                continue;
+            }
+            YearMonth period = LocalDateTimeUtils.parseYearMonth(row.getPeriod());
+            result.add(BeanUtils.toBean(row, FmsLedgerDetailRespVO.class)
+                    .setRowType(FmsLedgerDetailRespVO.ROW_TYPE_ENDING)
+                    .setAccountDate(period.atEndOfMonth()).setDigest("期末余额")
+                    .setDebitAmount(BigDecimal.ZERO).setCreditAmount(BigDecimal.ZERO)
+                    .setColumnAmounts(null));
+        }
+        return result;
+    }
+
+    /**
+     * 计算多栏账科目汇总金额
+     *
+     * @param context 普通账簿计算上下文
+     * @param column 多栏账科目列
+     * @param row 汇总账簿行
+     * @return 科目汇总金额
+     */
+    private BigDecimal calculateColumnSummaryAmount(LedgerContext context,
+            FmsSubjectDO column, FmsLedgerDetailRespVO row) {
+        List<FmsLedgerEntryVO> entries = filterList(context.entries,
+                entry -> ObjUtil.equal(entry.getSubjectId(), column.getId()));
+        YearMonth period = LocalDateTimeUtils.parseYearMonth(row.getPeriod());
+        if (row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_OPENING)) {
+            BigDecimal initialAmount = sumBigDecimal(filterList(context.initialBalances,
+                    initial -> ObjUtil.equal(initial.getSubjectId(), column.getId())),
+                    FmsInitialBalanceDO::getOpeningAmount);
+            return initialAmount.add(sumBigDecimal(entries, entry -> entry.getVoucherTime()
+                    .isBefore(period.atDay(1).atStartOfDay())
+                    ? nominalAmount(column, entry.getDebitAmount(), entry.getCreditAmount()) : BigDecimal.ZERO));
+        }
+        LocalDateTime nextMonthBeginTime = period.plusMonths(1).atDay(1).atStartOfDay();
+        if (row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_ENDING)) {
+            BigDecimal initialAmount = sumBigDecimal(filterList(context.initialBalances,
+                    initial -> ObjUtil.equal(initial.getSubjectId(), column.getId())),
+                    FmsInitialBalanceDO::getOpeningAmount);
+            return initialAmount.add(sumBigDecimal(entries, entry -> entry.getVoucherTime()
+                    .isBefore(nextMonthBeginTime)
+                    ? nominalAmount(column, entry.getDebitAmount(), entry.getCreditAmount()) : BigDecimal.ZERO));
+        }
+        LocalDateTime beginTime = row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_YEAR_TOTAL)
+                ? LocalDate.of(period.getYear(), 1, 1).atStartOfDay() : period.atDay(1).atStartOfDay();
+        BigDecimal amount = sumBigDecimal(filterEntriesByTime(entries, beginTime, nextMonthBeginTime),
+                entry -> nominalAmount(column, entry.getDebitAmount(), entry.getCreditAmount()));
+        if (row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_YEAR_TOTAL)
+                && context.accountSet.getStartTime().getYear() == period.getYear()) {
+            amount = amount.add(sumBigDecimal(filterList(context.initialBalances,
+                    initial -> ObjUtil.equal(initial.getSubjectId(), column.getId())),
+                    initial -> ObjUtil.equal(column.getBalanceDirection(),
+                            FmsDebitCreditDirectionEnum.DEBIT.getType())
+                            ? zeroIfNull(initial.getYearDebitAmount()).subtract(
+                                    zeroIfNull(initial.getYearCreditAmount()))
+                            : zeroIfNull(initial.getYearCreditAmount()).subtract(
+                                    zeroIfNull(initial.getYearDebitAmount()))));
+        }
+        return amount;
+    }
+
+    /**
+     * 按科目余额方向计算名义金额
+     *
+     * @param subject 科目
+     * @param debitAmount 借方金额
+     * @param creditAmount 贷方金额
+     * @return 名义金额
+     */
+    private BigDecimal nominalAmount(FmsSubjectDO subject, BigDecimal debitAmount,
+            BigDecimal creditAmount) {
+        return ObjUtil.equal(subject.getBalanceDirection(), FmsDebitCreditDirectionEnum.DEBIT.getType())
+                ? zeroIfNull(debitAmount).subtract(zeroIfNull(creditAmount))
+                : zeroIfNull(creditAmount).subtract(zeroIfNull(debitAmount));
+    }
+
+    /**
+     * 构建账簿汇总行
+     *
+     * @param context 普通账簿计算上下文
+     * @param subject 科目
+     * @param rowType 行类型
+     * @param period 会计期间
+     * @param accountDate 记账日期
+     * @param digest 摘要
+     * @param debitAmount 借方金额
+     * @param creditAmount 贷方金额
+     * @param debitQuantity 借方数量
+     * @param creditQuantity 贷方数量
+     * @param signedBalance 余额方向金额
+     * @param signedQuantity 余额方向数量
+     * @return 账簿汇总行
+     */
+    private FmsLedgerDetailRespVO buildSummaryRow(LedgerContext context, FmsSubjectDO subject,
+                                                  Integer rowType, YearMonth period, LocalDate accountDate, String digest,
+                                                  BigDecimal debitAmount, BigDecimal creditAmount, BigDecimal debitQuantity,
+                                                  BigDecimal creditQuantity, BigDecimal signedBalance, BigDecimal signedQuantity) {
+        return fillBalance(context, subject, new FmsLedgerDetailRespVO().setRowType(rowType)
+                .setSubjectId(subject.getId()).setSubjectCode(subject.getCode())
+                .setSubjectName(subject.getName()).setPeriod(period.toString()).setAccountDate(accountDate)
+                .setDigest(digest).setDebitAmount(debitAmount).setCreditAmount(creditAmount)
+                .setDebitQuantity(debitQuantity).setCreditQuantity(creditQuantity)
+                .setQuantityUnit(subject.getQuantityUnit()), signedBalance, signedQuantity);
+    }
+
+    /**
+     * 按账簿余额方向模式填充余额
+     *
+     * @param context 普通账簿计算上下文
+     * @param subject 科目
+     * @param result 账簿行
+     * @param signedBalance 余额方向金额
+     * @param signedQuantity 余额方向数量
+     * @return 账簿行
+     */
+    private FmsLedgerDetailRespVO fillBalance(LedgerContext context, FmsSubjectDO subject, FmsLedgerDetailRespVO result,
+                                              BigDecimal signedBalance, BigDecimal signedQuantity) {
+        Integer balanceMode = context.financeParameter.getLedgerBalanceMode();
+        if (ObjUtil.equal(balanceMode, FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode())) {
+            boolean debitSubject = ObjUtil.equal(subject.getBalanceDirection(),
+                    FmsDebitCreditDirectionEnum.DEBIT.getType());
+            result.setBalanceDirection(signedBalance.signum() == 0 ? FmsBalanceDirectionEnum.FLAT.getName()
+                    : FmsDebitCreditDirectionEnum.valueOf(subject.getBalanceDirection()).getName())
+                    .setBalance(debitSubject ? signedBalance : signedBalance.negate())
+                    .setBalanceQuantity(debitSubject ? signedQuantity : signedQuantity.negate());
+        } else {
+            result.setBalanceDirection(balanceDirection(signedBalance))
+                    .setBalance(signedBalance.abs()).setBalanceQuantity(signedQuantity.abs());
+        }
+        return result;
+    }
+
+    /**
+     * 构建科目余额
+     *
+     * @param context 普通账簿计算上下文
+     * @param subject 科目
+     * @return 科目余额
+     */
+    private FmsLedgerSubjectBalanceRespVO buildSubjectBalance(
+            LedgerContext context, FmsSubjectDO subject, boolean quantityGeneral) {
+        // 1. 筛选科目及下级科目的凭证分录
+        Set<Long> subjectIds = collectSubjectIds(context, subject.getId());
+        List<FmsLedgerEntryVO> entries = filterList(context.entries,
+                entry -> subjectIds.contains(entry.getSubjectId()));
+
+        // 2. 计算期初余额和查询期间发生额
+        LocalDateTime startTime = context.startMonth.atDay(1).atStartOfDay();
+        LocalDateTime endTime = context.endMonth.plusMonths(1).atDay(1).atStartOfDay();
+        BigDecimal openingSignedAmount = calculateInitialSignedAmount(context, subjectIds)
+                .add(calculateSignedAmount(entries, null, startTime));
+        BigDecimal openingSignedQuantity = calculateInitialSignedQuantity(context, subjectIds)
+                .add(calculateSignedQuantity(entries, null, startTime));
+        List<FmsLedgerEntryVO> periodEntries = filterEntriesByTime(entries, startTime, endTime);
+        LocalDateTime yearBeginTime = LocalDate.of(context.endMonth.getYear(), 1, 1).atStartOfDay();
+        List<FmsLedgerEntryVO> yearEntries = filterEntriesByTime(entries, yearBeginTime, endTime);
+        BigDecimal endingSignedAmount = openingSignedAmount.add(calculateSignedAmount(
+                periodEntries, null, null));
+        BigDecimal endingSignedQuantity = openingSignedQuantity.add(calculateSignedQuantity(
+                periodEntries, null, null));
+        BigDecimal yearDebitQuantity = sumQuantity(yearEntries, true).add(calculateInitialYearQuantity(
+                context, subjectIds, true, context.endMonth.getYear()));
+        BigDecimal yearCreditQuantity = sumQuantity(yearEntries, false).add(calculateInitialYearQuantity(
+                context, subjectIds, false, context.endMonth.getYear()));
+
+        // 3. 组装科目余额响应
+        FmsLedgerSubjectBalanceRespVO result = new FmsLedgerSubjectBalanceRespVO()
+                .setNodeKey("S:" + subject.getId())
+                .setNodeType(FmsLedgerSubjectBalanceRespVO.NODE_TYPE_SUBJECT)
+                .setSubjectId(subject.getId())
+                .setSubjectCode(subject.getCode()).setSubjectName(subject.getName())
+                .setLevel(subject.getLevel()).setQuantityAccounting(subject.getQuantityAccounting())
+                .setQuantityUnit(subject.getQuantityUnit())
+                .setOpeningDebitAmount(debitPart(openingSignedAmount))
+                .setOpeningCreditAmount(creditPart(openingSignedAmount))
+                .setOpeningBalanceDirection(balanceDirection(openingSignedAmount))
+                .setOpeningQuantity(openingSignedQuantity.abs())
+                .setOpeningUnitPrice(calculateUnitPrice(openingSignedAmount, openingSignedQuantity))
+                .setPeriodDebitAmount(sumDebitAmount(periodEntries))
+                .setPeriodCreditAmount(sumCreditAmount(periodEntries))
+                .setPeriodDebitQuantity(sumQuantity(periodEntries, true))
+                .setPeriodCreditQuantity(sumQuantity(periodEntries, false))
+                .setYearDebitAmount(sumDebitAmount(yearEntries).add(calculateInitialYearAmount(
+                        context, subjectIds, true, context.endMonth.getYear())))
+                .setYearCreditAmount(sumCreditAmount(yearEntries).add(calculateInitialYearAmount(
+                        context, subjectIds, false, context.endMonth.getYear())))
+                .setYearDebitQuantity(yearDebitQuantity).setYearCreditQuantity(yearCreditQuantity)
+                .setEndingDebitAmount(debitPart(endingSignedAmount))
+                .setEndingCreditAmount(creditPart(endingSignedAmount))
+                .setEndingBalanceDirection(balanceDirection(endingSignedAmount))
+                .setEndingQuantity(endingSignedQuantity.abs())
+                .setEndingUnitPrice(calculateUnitPrice(endingSignedAmount, endingSignedQuantity));
+        if (quantityGeneral && ObjUtil.equal(context.financeParameter.getLedgerBalanceMode(),
+                FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode())) {
+            fillQuantityGeneralBalance(subject, result, openingSignedAmount, openingSignedQuantity,
+                    endingSignedAmount, endingSignedQuantity);
+        }
+        return result;
+    }
+
+    /**
+     * 构建科目对应的辅助核算组合余额 Map
+     *
+     * @param context 普通账簿计算上下文
+     * @param auxiliaryItemMap 辅助核算项目 Map
+     * @return 科目编号与辅助核算组合余额 Map
+     */
+    private Map<Long, List<FmsLedgerSubjectBalanceRespVO>> buildAuxiliaryCombinationBalanceMap(
+            LedgerContext context, Map<Long, FmsAuxiliaryItemDO> auxiliaryItemMap) {
+        // 1. 收集期初余额和凭证分录中实际使用的辅助核算组合
+        Map<Long, AuxiliaryCombinationRecord> combinationMap = new LinkedHashMap<>();
+        for (FmsInitialBalanceDO initial : context.initialBalances) {
+            for (FmsInitialBalanceDO.AssistBalance assist : CollUtil.emptyIfNull(initial.getAssistBalances())) {
+                if (assist.getAssistCombinationId() == null) {
+                    continue;
+                }
+                AuxiliaryCombinationRecord record = combinationMap.computeIfAbsent(
+                        assist.getAssistCombinationId(), id -> new AuxiliaryCombinationRecord(
+                                id, initial.getSubjectId(), buildAuxiliarySnapshots(assist.getAuxiliaries()),
+                                new ArrayList<>()));
+                record.initialAssists.add(assist);
+            }
+        }
+        for (FmsLedgerEntryVO entry : context.entries) {
+            if (entry.getAssistCombinationId() == null || CollUtil.isEmpty(entry.getAuxiliaries())) {
+                continue;
+            }
+            combinationMap.computeIfAbsent(entry.getAssistCombinationId(), id -> new AuxiliaryCombinationRecord(
+                    id, entry.getSubjectId(), buildAuxiliarySnapshotsFromEntries(entry.getAuxiliaries()),
+                    new ArrayList<>()));
+        }
+
+        // 2. 计算非零组合余额并按科目分组
+        Map<Long, List<FmsLedgerSubjectBalanceRespVO>> result = new LinkedHashMap<>();
+        for (AuxiliaryCombinationRecord record : combinationMap.values()) {
+            FmsSubjectDO subject = context.subjectMap.get(record.subjectId);
+            if (subject == null) {
+                continue;
+            }
+            FmsLedgerSubjectBalanceRespVO balance = buildAuxiliaryCombinationBalance(
+                    context, subject, record, auxiliaryItemMap);
+            if (hasSubjectBalanceAmount(balance)) {
+                result.computeIfAbsent(record.subjectId, key -> new ArrayList<>()).add(balance);
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 构建辅助核算组合余额
+     *
+     * @param context 普通账簿计算上下文
+     * @param subject 科目
+     * @param record 辅助核算组合记录
+     * @param auxiliaryItemMap 辅助核算项目 Map
+     * @return 辅助核算组合余额
+     */
+    private FmsLedgerSubjectBalanceRespVO buildAuxiliaryCombinationBalance(LedgerContext context,
+            FmsSubjectDO subject, AuxiliaryCombinationRecord record,
+            Map<Long, FmsAuxiliaryItemDO> auxiliaryItemMap) {
+        // 1. 筛选组合分录并计算期初、期末余额
+        List<FmsLedgerEntryVO> entries = filterList(context.entries,
+                entry -> ObjUtil.equal(entry.getSubjectId(), subject.getId())
+                        && ObjUtil.equal(entry.getAssistCombinationId(), record.id));
+        LocalDateTime startTime = context.startMonth.atDay(1).atStartOfDay();
+        LocalDateTime endTime = context.endMonth.plusMonths(1).atDay(1).atStartOfDay();
+        boolean debitSubject = ObjUtil.equal(subject.getBalanceDirection(),
+                FmsDebitCreditDirectionEnum.DEBIT.getType());
+        BigDecimal initialAmount = sumBigDecimal(record.initialAssists,
+                assist -> zeroIfNull(assist.getOpeningAmount()));
+        BigDecimal initialQuantity = sumBigDecimal(record.initialAssists,
+                assist -> zeroIfNull(assist.getOpeningQuantity()));
+        BigDecimal openingSignedAmount = (debitSubject ? initialAmount : initialAmount.negate())
+                .add(calculateSignedAmount(entries, null, startTime));
+        BigDecimal openingSignedQuantity = (debitSubject ? initialQuantity : initialQuantity.negate())
+                .add(calculateSignedQuantity(entries, null, startTime));
+        List<FmsLedgerEntryVO> periodEntries = filterEntriesByTime(entries, startTime, endTime);
+        BigDecimal endingSignedAmount = openingSignedAmount.add(calculateSignedAmount(
+                periodEntries, null, null));
+        BigDecimal endingSignedQuantity = openingSignedQuantity.add(calculateSignedQuantity(
+                periodEntries, null, null));
+
+        // 2. 计算本年累计发生额
+        LocalDateTime yearBeginTime = LocalDate.of(context.endMonth.getYear(), 1, 1).atStartOfDay();
+        List<FmsLedgerEntryVO> yearEntries = filterEntriesByTime(entries, yearBeginTime, endTime);
+        BigDecimal initialYearDebitAmount = BigDecimal.ZERO;
+        BigDecimal initialYearCreditAmount = BigDecimal.ZERO;
+        BigDecimal initialYearDebitQuantity = BigDecimal.ZERO;
+        BigDecimal initialYearCreditQuantity = BigDecimal.ZERO;
+        if (context.accountSet.getStartTime().getYear() == context.endMonth.getYear()) {
+            initialYearDebitAmount = sumBigDecimal(record.initialAssists,
+                    assist -> zeroIfNull(assist.getYearDebitAmount()));
+            initialYearCreditAmount = sumBigDecimal(record.initialAssists,
+                    assist -> zeroIfNull(assist.getYearCreditAmount()));
+            initialYearDebitQuantity = sumBigDecimal(record.initialAssists,
+                    assist -> zeroIfNull(assist.getYearDebitQuantity()));
+            initialYearCreditQuantity = sumBigDecimal(record.initialAssists,
+                    assist -> zeroIfNull(assist.getYearCreditQuantity()));
+        }
+
+        // 3. 组装辅助核算组合节点
+        String codeSuffix = record.items.stream().map(item -> {
+            FmsAuxiliaryItemDO auxiliaryItem = auxiliaryItemMap.get(item.itemId);
+            return auxiliaryItem == null ? String.valueOf(item.itemId) : auxiliaryItem.getCode();
+        }).collect(Collectors.joining("_"));
+        String nameSuffix = record.items.stream().map(item -> {
+            FmsAuxiliaryItemDO auxiliaryItem = auxiliaryItemMap.get(item.itemId);
+            return item.name != null ? item.name
+                    : auxiliaryItem == null ? String.valueOf(item.itemId) : auxiliaryItem.getName();
+        }).collect(Collectors.joining("_"));
+        return new FmsLedgerSubjectBalanceRespVO().setNodeKey("A:" + record.id)
+                .setNodeType(FmsLedgerSubjectBalanceRespVO.NODE_TYPE_AUXILIARY_COMBINATION)
+                .setSubjectId(subject.getId()).setAssistCombinationId(record.id)
+                .setSubjectCode(subject.getCode() + "_" + codeSuffix)
+                .setSubjectName(subject.getName() + "_" + nameSuffix).setLevel(subject.getLevel() + 1)
+                .setQuantityAccounting(subject.getQuantityAccounting()).setQuantityUnit(subject.getQuantityUnit())
+                .setOpeningDebitAmount(debitPart(openingSignedAmount))
+                .setOpeningCreditAmount(creditPart(openingSignedAmount))
+                .setOpeningBalanceDirection(balanceDirection(openingSignedAmount))
+                .setOpeningQuantity(openingSignedQuantity.abs())
+                .setOpeningUnitPrice(calculateUnitPrice(openingSignedAmount, openingSignedQuantity))
+                .setPeriodDebitAmount(sumDebitAmount(periodEntries))
+                .setPeriodCreditAmount(sumCreditAmount(periodEntries))
+                .setPeriodDebitQuantity(sumQuantity(periodEntries, true))
+                .setPeriodCreditQuantity(sumQuantity(periodEntries, false))
+                .setYearDebitAmount(sumDebitAmount(yearEntries).add(initialYearDebitAmount))
+                .setYearCreditAmount(sumCreditAmount(yearEntries).add(initialYearCreditAmount))
+                .setYearDebitQuantity(sumQuantity(yearEntries, true).add(initialYearDebitQuantity))
+                .setYearCreditQuantity(sumQuantity(yearEntries, false).add(initialYearCreditQuantity))
+                .setEndingDebitAmount(debitPart(endingSignedAmount))
+                .setEndingCreditAmount(creditPart(endingSignedAmount))
+                .setEndingBalanceDirection(balanceDirection(endingSignedAmount))
+                .setEndingQuantity(endingSignedQuantity.abs())
+                .setEndingUnitPrice(calculateUnitPrice(endingSignedAmount, endingSignedQuantity));
+    }
+
+    /**
+     * 将辅助核算组合余额挂到对应科目节点
+     *
+     * @param balances 科目余额树
+     * @param auxiliaryBalanceMap 科目编号与辅助核算组合余额 Map
+     */
+    private void appendAuxiliaryCombinationBalances(List<FmsLedgerSubjectBalanceRespVO> balances,
+            Map<Long, List<FmsLedgerSubjectBalanceRespVO>> auxiliaryBalanceMap) {
+        for (FmsLedgerSubjectBalanceRespVO balance : balances) {
+            appendAuxiliaryCombinationBalances(balance.getChildren(), auxiliaryBalanceMap);
+            balance.getChildren().addAll(auxiliaryBalanceMap.getOrDefault(
+                    balance.getSubjectId(), Collections.emptyList()));
+        }
+    }
+
+    private List<AuxiliarySnapshot> buildAuxiliarySnapshots(
+            List<FmsInitialBalanceDO.AuxiliaryItem> auxiliaries) {
+        return convertList(CollUtil.emptyIfNull(auxiliaries),
+                item -> new AuxiliarySnapshot(item.getItemId(), item.getName()));
+    }
+
+    private List<AuxiliarySnapshot> buildAuxiliarySnapshotsFromEntries(
+            List<FmsVoucherEntryDO.AuxiliaryItem> auxiliaries) {
+        return convertList(CollUtil.emptyIfNull(auxiliaries),
+                item -> new AuxiliarySnapshot(item.getItemId(), item.getName()));
+    }
+
+    /**
+     * 按科目方向填充数量金额总账余额
+     *
+     * @param subject 科目
+     * @param result 科目余额
+     * @param openingSignedAmount 期初借贷净额
+     * @param openingSignedQuantity 期初借贷净数量
+     * @param endingSignedAmount 期末借贷净额
+     * @param endingSignedQuantity 期末借贷净数量
+     */
+    private void fillQuantityGeneralBalance(FmsSubjectDO subject, FmsLedgerSubjectBalanceRespVO result,
+            BigDecimal openingSignedAmount, BigDecimal openingSignedQuantity,
+            BigDecimal endingSignedAmount, BigDecimal endingSignedQuantity) {
+        boolean debitSubject = ObjUtil.equal(subject.getBalanceDirection(), FmsDebitCreditDirectionEnum.DEBIT.getType());
+        String subjectDirection = FmsDebitCreditDirectionEnum.valueOf(subject.getBalanceDirection()).getName();
+        BigDecimal openingBalance = debitSubject ? openingSignedAmount : openingSignedAmount.negate();
+        BigDecimal endingBalance = debitSubject ? endingSignedAmount : endingSignedAmount.negate();
+        result.setOpeningBalanceDirection(openingBalance.signum() == 0 ? FmsBalanceDirectionEnum.FLAT.getName() : subjectDirection)
+                .setOpeningDebitAmount(debitSubject ? openingBalance : BigDecimal.ZERO)
+                .setOpeningCreditAmount(debitSubject ? BigDecimal.ZERO : openingBalance)
+                .setOpeningQuantity(debitSubject ? openingSignedQuantity : openingSignedQuantity.negate())
+                .setEndingBalanceDirection(endingBalance.signum() == 0 ? FmsBalanceDirectionEnum.FLAT.getName() : subjectDirection)
+                .setEndingDebitAmount(debitSubject ? endingBalance : BigDecimal.ZERO)
+                .setEndingCreditAmount(debitSubject ? BigDecimal.ZERO : endingBalance)
+                .setEndingQuantity(debitSubject ? endingSignedQuantity : endingSignedQuantity.negate());
+    }
+
+    /**
+     * 判断科目余额表是否存在非零金额
+     *
+     * @param balance 科目余额
+     * @return 是否存在非零金额
+     */
+    private boolean hasSubjectBalanceAmount(FmsLedgerSubjectBalanceRespVO balance) {
+        return hasAnyNonZero(balance.getOpeningDebitAmount(), balance.getOpeningCreditAmount(),
+                balance.getPeriodDebitAmount(), balance.getPeriodCreditAmount(),
+                balance.getYearDebitAmount(), balance.getYearCreditAmount(),
+                balance.getEndingDebitAmount(), balance.getEndingCreditAmount());
+    }
+
+    /**
+     * 判断数量金额总账期初或本期是否存在非零金额、数量
+     *
+     * @param balance 科目余额
+     * @return 期初或本期是否存在非零金额、数量
+     */
+    private boolean hasQuantityGeneralBalance(FmsLedgerSubjectBalanceRespVO balance) {
+        return hasAnyNonZero(balance.getOpeningDebitAmount(), balance.getOpeningCreditAmount(),
+                balance.getPeriodDebitAmount(), balance.getPeriodCreditAmount(), balance.getOpeningQuantity(),
+                balance.getPeriodDebitQuantity(), balance.getPeriodCreditQuantity());
+    }
+
+    /**
+     * 裁剪数量金额总账树：保留数量核算节点及其必要的父级汇总节点。
+     *
+     * @param balances 科目余额树
+     */
+    private void pruneQuantityGeneralTree(List<FmsLedgerSubjectBalanceRespVO> balances) {
+        for (int index = balances.size() - 1; index >= 0; index--) {
+            FmsLedgerSubjectBalanceRespVO balance = balances.get(index);
+            pruneQuantityGeneralTree(balance.getChildren());
+            if (CollUtil.isEmpty(balance.getChildren()) && !hasQuantityGeneralBalance(balance)) {
+                balances.remove(index);
+            }
+        }
+    }
+
+    /**
+     * 判断核算项目余额表是否存在非零金额
+     *
+     * @param balance 核算项目余额
+     * @return 是否存在非零金额
+     */
+    private boolean hasAuxiliaryBalanceAmount(FmsLedgerAuxiliaryBalanceRespVO balance) {
+        return hasAnyNonZero(balance.getOpeningDebitAmount(), balance.getOpeningCreditAmount(),
+                balance.getPeriodDebitAmount(), balance.getPeriodCreditAmount(),
+                balance.getYearDebitAmount(), balance.getYearCreditAmount(),
+                balance.getEndingDebitAmount(), balance.getEndingCreditAmount());
+    }
+
+    /**
+     * 判断数值数组中是否存在非零值
+     *
+     * @param values 数值数组
+     * @return 是否存在非零值
+     */
+    private boolean hasAnyNonZero(BigDecimal... values) {
+        for (BigDecimal value : values) {
+            if (zeroIfNull(value).signum() != 0) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /**
+     * 收集科目及其全部下级科目编号
+     *
+     * @param context 普通账簿计算上下文
+     * @param subjectId 科目编号
+     * @return 科目编号集合
+     */
+    private Set<Long> collectSubjectIds(LedgerContext context, Long subjectId) {
+        Set<Long> result = new LinkedHashSet<>();
+        collectSubjectIds(context.childMap, subjectId, result);
+        return result;
+    }
+
+    /**
+     * 递归收集科目及其全部下级科目编号
+     *
+     * @param childMap 父科目编号与子科目编号 Map
+     * @param subjectId 科目编号
+     * @param result 科目编号集合
+     */
+    private void collectSubjectIds(Map<Long, List<Long>> childMap, Long subjectId, Set<Long> result) {
+        result.add(subjectId);
+        for (Long childId : childMap.getOrDefault(subjectId, Collections.emptyList())) {
+            collectSubjectIds(childMap, childId, result);
+        }
+    }
+
+    /**
+     * 计算科目初始余额方向金额
+     *
+     * @param context 普通账簿计算上下文
+     * @param subjectIds 科目编号集合
+     * @return 初始余额方向金额
+     */
+    private BigDecimal calculateInitialSignedAmount(LedgerContext context, Set<Long> subjectIds) {
+        BigDecimal result = BigDecimal.ZERO;
+        for (FmsInitialBalanceDO initial : context.initialBalances) {
+            if (subjectIds.contains(initial.getSubjectId())) {
+                FmsSubjectDO subject = context.subjectMap.get(initial.getSubjectId());
+                result = result.add(ObjUtil.equal(subject.getBalanceDirection(),
+                        FmsDebitCreditDirectionEnum.DEBIT.getType())
+                        ? zeroIfNull(initial.getOpeningAmount()) : zeroIfNull(initial.getOpeningAmount()).negate());
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 计算科目初始余额方向数量
+     *
+     * @param context 普通账簿计算上下文
+     * @param subjectIds 科目编号集合
+     * @return 初始余额方向数量
+     */
+    private BigDecimal calculateInitialSignedQuantity(LedgerContext context, Set<Long> subjectIds) {
+        BigDecimal result = BigDecimal.ZERO;
+        for (FmsInitialBalanceDO initial : context.initialBalances) {
+            if (subjectIds.contains(initial.getSubjectId())) {
+                FmsSubjectDO subject = context.subjectMap.get(initial.getSubjectId());
+                result = result.add(ObjUtil.equal(subject.getBalanceDirection(),
+                        FmsDebitCreditDirectionEnum.DEBIT.getType())
+                        ? zeroIfNull(initial.getOpeningQuantity())
+                        : zeroIfNull(initial.getOpeningQuantity()).negate());
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 计算账套启用年度的年初累计发生额
+     *
+     * @param context 普通账簿计算上下文
+     * @param subjectIds 科目编号集合
+     * @param debit 是否借方
+     * @param year 年度
+     * @return 年初累计发生额
+     */
+    private BigDecimal calculateInitialYearAmount(LedgerContext context, Set<Long> subjectIds, boolean debit, int year) {
+        if (context.accountSet.getStartTime().getYear() != year) {
+            return BigDecimal.ZERO;
+        }
+        return sumBigDecimal(filterList(context.initialBalances,
+                initial -> subjectIds.contains(initial.getSubjectId())),
+                initial -> debit ? initial.getYearDebitAmount() : initial.getYearCreditAmount());
+    }
+
+    /**
+     * 计算账套启用年度的年初累计数量
+     *
+     * @param context 普通账簿计算上下文
+     * @param subjectIds 科目编号集合
+     * @param debit 是否借方
+     * @param year 年度
+     * @return 年初累计数量
+     */
+    private BigDecimal calculateInitialYearQuantity(LedgerContext context, Set<Long> subjectIds, boolean debit, int year) {
+        if (context.accountSet.getStartTime().getYear() != year) {
+            return BigDecimal.ZERO;
+        }
+        return sumBigDecimal(filterList(context.initialBalances,
+                initial -> subjectIds.contains(initial.getSubjectId())),
+                initial -> debit ? initial.getYearDebitQuantity() : initial.getYearCreditQuantity());
+    }
+
+    /**
+     * 计算指定时间范围的借贷方向净额
+     *
+     * @param entries 凭证分录列表
+     * @param beginTime 开始时间，为空时不限制
+     * @param endTime 结束时间，为空时不限制
+     * @return 借贷方向净额
+     */
+    private BigDecimal calculateSignedAmount(List<FmsLedgerEntryVO> entries,
+                                             LocalDateTime beginTime, LocalDateTime endTime) {
+        return sumBigDecimal(filterEntriesByTime(entries, beginTime, endTime),
+                entry -> zeroIfNull(entry.getDebitAmount()).subtract(zeroIfNull(entry.getCreditAmount())));
+    }
+
+    /**
+     * 计算指定时间范围的借贷方向净数量
+     *
+     * @param entries 凭证分录列表
+     * @param beginTime 开始时间，为空时不限制
+     * @param endTime 结束时间，为空时不限制
+     * @return 借贷方向净数量
+     */
+    private BigDecimal calculateSignedQuantity(List<FmsLedgerEntryVO> entries,
+                                               LocalDateTime beginTime, LocalDateTime endTime) {
+        return sumBigDecimal(filterEntriesByTime(entries, beginTime, endTime), this::signedQuantity);
+    }
+
+    /**
+     * 计算凭证分录的借贷方向数量
+     *
+     * @param entry 凭证分录
+     * @return 借贷方向数量
+     */
+    private BigDecimal signedQuantity(FmsLedgerEntryVO entry) {
+        return isDebit(entry) ? zeroIfNull(entry.getQuantity()) : zeroIfNull(entry.getQuantity()).negate();
+    }
+
+    /**
+     * 汇总借方金额
+     *
+     * @param entries 凭证分录列表
+     * @return 借方金额
+     */
+    private BigDecimal sumDebitAmount(List<FmsLedgerEntryVO> entries) {
+        return sumBigDecimal(entries, FmsLedgerEntryVO::getDebitAmount);
+    }
+
+    /**
+     * 汇总贷方金额
+     *
+     * @param entries 凭证分录列表
+     * @return 贷方金额
+     */
+    private BigDecimal sumCreditAmount(List<FmsLedgerEntryVO> entries) {
+        return sumBigDecimal(entries, FmsLedgerEntryVO::getCreditAmount);
+    }
+
+    /**
+     * 汇总指定借贷方向的数量
+     *
+     * @param entries 凭证分录列表
+     * @param debit 是否借方
+     * @return 数量
+     */
+    private BigDecimal sumQuantity(List<FmsLedgerEntryVO> entries, boolean debit) {
+        return sumBigDecimal(filterList(entries, entry -> debit == isDebit(entry)),
+                FmsLedgerEntryVO::getQuantity);
+    }
+
+    /**
+     * 判断凭证分录是否为借方分录
+     *
+     * @param entry 凭证分录
+     * @return 是否为借方分录
+     */
+    private boolean isDebit(FmsLedgerEntryVO entry) {
+        return zeroIfNull(entry.getDebitAmount()).signum() != 0;
+    }
+
+    /**
+     * 提取借方余额
+     *
+     * @param signedAmount 余额方向金额
+     * @return 借方余额
+     */
+    private BigDecimal debitPart(BigDecimal signedAmount) {
+        return signedAmount.signum() > 0 ? signedAmount : BigDecimal.ZERO;
+    }
+
+    /**
+     * 提取贷方余额
+     *
+     * @param signedAmount 余额方向金额
+     * @return 贷方余额
+     */
+    private BigDecimal creditPart(BigDecimal signedAmount) {
+        return signedAmount.signum() < 0 ? signedAmount.abs() : BigDecimal.ZERO;
+    }
+
+    /**
+     * 获得余额方向
+     *
+     * @param signedAmount 余额方向金额
+     * @return 余额方向
+     */
+    private String balanceDirection(BigDecimal signedAmount) {
+        return FmsBalanceDirectionEnum.valueOf(signedAmount).getName();
+    }
+
+    /**
+     * 根据结存金额和数量计算单价
+     *
+     * @param signedAmount 余额方向金额
+     * @param signedQuantity 余额方向数量
+     * @return 单价
+     */
+    private BigDecimal calculateUnitPrice(BigDecimal signedAmount, BigDecimal signedQuantity) {
+        if (signedQuantity.signum() == 0) {
+            return BigDecimal.ZERO;
+        }
+        return signedAmount.abs().divide(signedQuantity.abs(), 6, RoundingMode.HALF_UP);
+    }
+
+    /**
+     * 构建辅助核算账簿计算上下文
+     *
+     * @param accountSetId 账套编号
+     * @param startMonthValue 开始会计期间
+     * @param endMonthValue 结束会计期间
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @param subjectId 科目编号
+     * @param userId 用户编号
+     * @return 辅助核算账簿计算上下文
+     */
+    private AuxiliaryLedgerContext buildAuxiliaryContext(Long accountSetId, String startMonthValue,
+                                                         String endMonthValue, Long auxiliaryTypeId, Long subjectId, Long userId) {
+        // 1. 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 校验会计期间
+        YearMonth startMonth = LocalDateTimeUtils.parseYearMonth(startMonthValue);
+        YearMonth endMonth = LocalDateTimeUtils.parseYearMonth(endMonthValue);
+        validateLedgerPeriod(accountSet, startMonth, endMonth);
+
+        // 3. 加载财务参数、辅助核算项目和科目
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(accountSetId, userId);
+        List<FmsAuxiliaryItemDO> auxiliaryItems = auxiliaryItemService.getAuxiliaryItemList(
+                accountSetId, auxiliaryTypeId, userId);
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        Map<Long, List<Long>> childMap = new HashMap<>();
+        subjects.forEach(subject -> childMap.computeIfAbsent(subject.getParentId(), key -> new ArrayList<>())
+                .add(subject.getId()));
+
+        // 4. 确定科目查询范围
+        Set<Long> subjectIds;
+        if (subjectId == null) {
+            subjectIds = subjects.stream().map(FmsSubjectDO::getId)
+                    .collect(Collectors.toCollection(LinkedHashSet::new));
+        } else {
+            if (!subjectMap.containsKey(subjectId)) {
+                throw exception(SUBJECT_NOT_EXISTS);
+            }
+            subjectIds = collectSubjectIds(childMap, subjectId);
+        }
+
+        // 5. 加载初始余额和查询期间结束前的凭证分录
+        List<FmsInitialBalanceDO> initialBalances = initialBalanceMapper.selectListByAccountSetId(accountSetId);
+        List<FmsLedgerEntryVO> entries = ledgerQueryMapper.selectEntryListBeforeTime(
+                accountSetId, endMonth.plusMonths(1).atDay(1).atStartOfDay());
+        return new AuxiliaryLedgerContext(accountSet, financeParameter, startMonth, endMonth,
+                auxiliaryTypeId, subjectId, auxiliaryItems, subjectMap, subjectIds, initialBalances, entries);
+    }
+
+    /**
+     * 校验账簿查询会计期间
+     *
+     * @param accountSet 账套
+     * @param startMonth 开始会计期间
+     * @param endMonth 结束会计期间
+     */
+    private void validateLedgerPeriod(FmsAccountSetDO accountSet, YearMonth startMonth, YearMonth endMonth) {
+        if (startMonth.isAfter(endMonth)) {
+            throw exception(LEDGER_PERIOD_INVALID);
+        }
+        if (startMonth.isBefore(YearMonth.from(accountSet.getStartTime()))) {
+            throw exception(LEDGER_PERIOD_BEFORE_ACCOUNT_START);
+        }
+    }
+
+    /**
+     * 构建核算项目明细账行
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param auxiliaryItemId 辅助核算项目编号
+     * @return 核算项目明细账行列表
+     */
+    private List<FmsLedgerAuxiliaryDetailRespVO> buildAuxiliaryDetailRows(AuxiliaryLedgerContext context, Long auxiliaryItemId) {
+        // 1. 筛选核算项目凭证分录并计算期初余额
+        List<FmsLedgerEntryVO> entries = filterAuxiliaryEntries(context, auxiliaryItemId);
+        LocalDateTime startTime = context.startMonth.atDay(1).atStartOfDay();
+        BigDecimal runningSignedAmount = calculateAuxiliaryInitialSignedAmount(context, auxiliaryItemId)
+                .add(calculateSignedAmount(entries, null, startTime));
+
+        // 2. 添加期初余额行
+        List<FmsLedgerAuxiliaryDetailRespVO> result = new ArrayList<>();
+        result.add(buildAuxiliarySummaryRow(context, FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_OPENING,
+                context.startMonth, "期初余额", BigDecimal.ZERO, BigDecimal.ZERO, runningSignedAmount));
+
+        // 3. 逐月计算凭证分录、本期合计和本年累计行
+        YearMonth currentMonth = context.startMonth;
+        while (!currentMonth.isAfter(context.endMonth)) {
+            LocalDateTime monthBeginTime = currentMonth.atDay(1).atStartOfDay();
+            LocalDateTime nextMonthBeginTime = currentMonth.plusMonths(1).atDay(1).atStartOfDay();
+            List<FmsLedgerEntryVO> monthEntries = filterEntriesByTime(
+                    entries, monthBeginTime, nextMonthBeginTime);
+            for (FmsLedgerEntryVO entry : monthEntries) {
+                runningSignedAmount = runningSignedAmount.add(zeroIfNull(entry.getDebitAmount()))
+                        .subtract(zeroIfNull(entry.getCreditAmount()));
+                result.add(buildAuxiliaryVoucherRow(context, entry, runningSignedAmount));
+            }
+            result.add(buildAuxiliarySummaryRow(context,
+                    FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_PERIOD_TOTAL, currentMonth, "本期合计",
+                    sumDebitAmount(monthEntries), sumCreditAmount(monthEntries), runningSignedAmount));
+
+            LocalDateTime yearBeginTime = LocalDate.of(currentMonth.getYear(), 1, 1).atStartOfDay();
+            List<FmsLedgerEntryVO> yearEntries = filterEntriesByTime(
+                    entries, yearBeginTime, nextMonthBeginTime);
+            result.add(buildAuxiliarySummaryRow(context,
+                    FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_YEAR_TOTAL, currentMonth, "本年累计",
+                    sumDebitAmount(yearEntries).add(calculateAuxiliaryInitialYearAmount(
+                            context, auxiliaryItemId, true, currentMonth.getYear())),
+                    sumCreditAmount(yearEntries).add(calculateAuxiliaryInitialYearAmount(
+                            context, auxiliaryItemId, false, currentMonth.getYear())),
+                    runningSignedAmount));
+            currentMonth = currentMonth.plusMonths(1);
+        }
+        return result;
+    }
+
+    /**
+     * 构建核算项目凭证分录行
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param entry 凭证分录
+     * @param signedBalance 余额方向金额
+     * @return 核算项目凭证分录行
+     */
+    private FmsLedgerAuxiliaryDetailRespVO buildAuxiliaryVoucherRow(AuxiliaryLedgerContext context,
+            FmsLedgerEntryVO entry, BigDecimal signedBalance) {
+        FmsSubjectDO subject = context.subjectMap.get(entry.getSubjectId());
+        return fillAuxiliaryBalance(context, new FmsLedgerAuxiliaryDetailRespVO()
+                .setRowType(FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_VOUCHER)
+                .setEntryId(entry.getEntryId()).setSubjectId(entry.getSubjectId())
+                .setSubjectCode(subject.getCode()).setSubjectName(subject.getName())
+                .setPeriod(YearMonth.from(entry.getVoucherTime()).toString())
+                .setAccountDate(entry.getVoucherTime().toLocalDate()).setVoucherId(entry.getVoucherId())
+                .setVoucherNumber(entry.getVoucherWordName() + "-" + entry.getVoucherNumber())
+                .setDigest(entry.getDigest()).setDebitAmount(zeroIfNull(entry.getDebitAmount()))
+                .setCreditAmount(zeroIfNull(entry.getCreditAmount())), signedBalance);
+    }
+
+    /**
+     * 构建核算项目明细账汇总行
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param rowType 行类型
+     * @param period 会计期间
+     * @param digest 摘要
+     * @param debitAmount 借方金额
+     * @param creditAmount 贷方金额
+     * @param signedBalance 余额方向金额
+     * @return 核算项目明细账汇总行
+     */
+    private FmsLedgerAuxiliaryDetailRespVO buildAuxiliarySummaryRow(AuxiliaryLedgerContext context,
+            Integer rowType, YearMonth period, String digest, BigDecimal debitAmount,
+            BigDecimal creditAmount, BigDecimal signedBalance) {
+        return fillAuxiliaryBalance(context, new FmsLedgerAuxiliaryDetailRespVO().setRowType(rowType)
+                .setSubjectId(context.selectedSubjectId).setPeriod(period.toString())
+                .setAccountDate(period.atEndOfMonth()).setDigest(digest)
+                .setDebitAmount(debitAmount).setCreditAmount(creditAmount), signedBalance);
+    }
+
+    /**
+     * 填充核算项目明细账余额
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param result 核算项目明细账行
+     * @param signedBalance 余额方向金额
+     * @return 核算项目明细账行
+     */
+    private FmsLedgerAuxiliaryDetailRespVO fillAuxiliaryBalance(
+            AuxiliaryLedgerContext context, FmsLedgerAuxiliaryDetailRespVO result, BigDecimal signedBalance) {
+        // 1. 按科目方向展示时，余额方向固定为科目方向，反向净额保留负数
+        FmsSubjectDO subject = context.subjectMap.get(context.selectedSubjectId);
+        if (subject != null && ObjUtil.equal(context.financeParameter.getLedgerBalanceMode(),
+                FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode())) {
+            boolean debitSubject = ObjUtil.equal(subject.getBalanceDirection(),
+                    FmsDebitCreditDirectionEnum.DEBIT.getType());
+            return result.setBalanceDirection(signedBalance.signum() == 0
+                            ? FmsBalanceDirectionEnum.FLAT.getName()
+                            : FmsDebitCreditDirectionEnum.valueOf(subject.getBalanceDirection()).getName())
+                    .setBalance(debitSubject ? signedBalance : signedBalance.negate());
+        }
+        // 2. 按实际方向展示；未指定科目时可能聚合不同余额方向的科目
+        return result.setBalanceDirection(balanceDirection(signedBalance)).setBalance(signedBalance.abs());
+    }
+
+    /**
+     * 构建核算项目余额
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param item 辅助核算项目
+     * @return 核算项目余额
+     */
+    private FmsLedgerAuxiliaryBalanceRespVO buildAuxiliaryBalance(AuxiliaryLedgerContext context, FmsAuxiliaryItemDO item) {
+        // 1. 筛选核算项目凭证分录
+        List<FmsLedgerEntryVO> entries = filterAuxiliaryEntries(context, item.getId());
+        LocalDateTime startTime = context.startMonth.atDay(1).atStartOfDay();
+        LocalDateTime endTime = context.endMonth.plusMonths(1).atDay(1).atStartOfDay();
+
+        // 2. 计算期初和期末余额
+        BigDecimal openingSignedAmount = calculateAuxiliaryInitialSignedAmount(context, item.getId())
+                .add(calculateSignedAmount(entries, null, startTime));
+        List<FmsLedgerEntryVO> periodEntries = filterEntriesByTime(entries, startTime, endTime);
+        BigDecimal endingSignedAmount = openingSignedAmount.add(calculateSignedAmount(periodEntries, null, null));
+
+        // 3. 计算本年累计发生额
+        LocalDateTime yearBeginTime = LocalDate.of(context.endMonth.getYear(), 1, 1).atStartOfDay();
+        List<FmsLedgerEntryVO> yearEntries = filterEntriesByTime(entries, yearBeginTime, endTime);
+
+        // 4. 组装核算项目余额响应
+        return new FmsLedgerAuxiliaryBalanceRespVO().setAuxiliaryItemId(item.getId())
+                .setCode(item.getCode()).setName(item.getName())
+                .setOpeningDebitAmount(debitPart(openingSignedAmount))
+                .setOpeningCreditAmount(creditPart(openingSignedAmount))
+                .setPeriodDebitAmount(sumDebitAmount(periodEntries))
+                .setPeriodCreditAmount(sumCreditAmount(periodEntries))
+                .setYearDebitAmount(sumDebitAmount(yearEntries).add(calculateAuxiliaryInitialYearAmount(
+                        context, item.getId(), true, context.endMonth.getYear())))
+                .setYearCreditAmount(sumCreditAmount(yearEntries).add(calculateAuxiliaryInitialYearAmount(
+                        context, item.getId(), false, context.endMonth.getYear())))
+                .setEndingDebitAmount(debitPart(endingSignedAmount))
+                .setEndingCreditAmount(creditPart(endingSignedAmount));
+    }
+
+    /**
+     * 筛选指定辅助核算项目的凭证分录
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param auxiliaryItemId 辅助核算项目编号
+     * @return 凭证分录列表
+     */
+    private List<FmsLedgerEntryVO> filterAuxiliaryEntries(AuxiliaryLedgerContext context, Long auxiliaryItemId) {
+        return filterList(context.entries, entry -> context.subjectIds.contains(entry.getSubjectId())
+                && CollUtil.emptyIfNull(entry.getAuxiliaries()).stream()
+                        .anyMatch(auxiliary -> ObjUtil.equal(auxiliary.getTypeId(), context.auxiliaryTypeId)
+                                && ObjUtil.equal(auxiliary.getItemId(), auxiliaryItemId)));
+    }
+
+    /**
+     * 筛选指定时间范围的凭证分录
+     *
+     * @param entries 凭证分录列表
+     * @param beginTime 开始时间，为空时不限制
+     * @param endTime 结束时间，为空时不限制
+     * @return 凭证分录列表
+     */
+    private List<FmsLedgerEntryVO> filterEntriesByTime(List<FmsLedgerEntryVO> entries,
+                                                       LocalDateTime beginTime, LocalDateTime endTime) {
+        return filterList(entries, entry -> (beginTime == null || !entry.getVoucherTime().isBefore(beginTime))
+                && (endTime == null || entry.getVoucherTime().isBefore(endTime)));
+    }
+
+    /**
+     * 计算辅助核算项目初始余额方向金额
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param auxiliaryItemId 辅助核算项目编号
+     * @return 初始余额方向金额
+     */
+    private BigDecimal calculateAuxiliaryInitialSignedAmount(AuxiliaryLedgerContext context, Long auxiliaryItemId) {
+        BigDecimal result = BigDecimal.ZERO;
+        for (InitialAssistRecord record : filterInitialAssists(context, auxiliaryItemId)) {
+            FmsSubjectDO subject = context.subjectMap.get(record.initial.getSubjectId());
+            if (subject != null) {
+                result = result.add(ObjUtil.equal(subject.getBalanceDirection(),
+                        FmsDebitCreditDirectionEnum.DEBIT.getType())
+                        ? zeroIfNull(record.assist.getOpeningAmount())
+                        : zeroIfNull(record.assist.getOpeningAmount()).negate());
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 计算辅助核算项目在账套启用年度的年初累计发生额
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param auxiliaryItemId 辅助核算项目编号
+     * @param debit 是否借方
+     * @param year 年度
+     * @return 年初累计发生额
+     */
+    private BigDecimal calculateAuxiliaryInitialYearAmount(AuxiliaryLedgerContext context,
+            Long auxiliaryItemId, boolean debit, int year) {
+        if (context.accountSet.getStartTime().getYear() != year) {
+            return BigDecimal.ZERO;
+        }
+        return sumBigDecimal(filterInitialAssists(context, auxiliaryItemId),
+                record -> debit ? record.assist.getYearDebitAmount() : record.assist.getYearCreditAmount());
+    }
+
+    /**
+     * 筛选辅助核算项目的初始余额记录
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param auxiliaryItemId 辅助核算项目编号
+     * @return 初始余额记录列表
+     */
+    private List<InitialAssistRecord> filterInitialAssists(AuxiliaryLedgerContext context, Long auxiliaryItemId) {
+        return convertListByFlatMap(filterList(context.initialBalances,
+                initial -> context.subjectIds.contains(initial.getSubjectId())
+                        && CollUtil.isNotEmpty(initial.getAssistBalances())), initial ->
+                initial.getAssistBalances().stream()
+                        .filter(assist -> CollUtil.isNotEmpty(assist.getAuxiliaries())
+                                && assist.getAuxiliaries().stream().anyMatch(auxiliary ->
+                                ObjUtil.equal(auxiliary.getTypeId(), context.auxiliaryTypeId)
+                                        && ObjUtil.equal(auxiliary.getItemId(), auxiliaryItemId)))
+                        .map(assist -> new InitialAssistRecord(initial, assist)));
+    }
+
+    /**
+     * 校验辅助核算项目存在
+     *
+     * @param context 辅助核算账簿计算上下文
+     * @param auxiliaryItemId 辅助核算项目编号
+     */
+    private void validateAuxiliaryItem(AuxiliaryLedgerContext context, Long auxiliaryItemId) {
+        if (context.auxiliaryItems.stream().noneMatch(item -> ObjUtil.equal(item.getId(), auxiliaryItemId))) {
+            throw exception(AUXILIARY_ITEM_NOT_EXISTS);
+        }
+    }
+
+    /**
+     * 收集科目及其全部下级科目编号
+     *
+     * @param childMap 父科目编号与子科目编号 Map
+     * @param subjectId 科目编号
+     * @return 科目编号集合
+     */
+    private Set<Long> collectSubjectIds(Map<Long, List<Long>> childMap, Long subjectId) {
+        Set<Long> result = new LinkedHashSet<>();
+        result.add(subjectId);
+        for (Long childId : childMap.getOrDefault(subjectId, Collections.emptyList())) {
+            result.addAll(collectSubjectIds(childMap, childId));
+        }
+        return result;
+    }
+
+    /**
+     * 将科目余额树转换为数量金额总账树
+     *
+     * @param balances 科目余额树
+     * @return 数量金额总账树
+     */
+    private List<FmsLedgerQuantityGeneralRespVO> buildQuantityGeneralRespVOList(List<FmsLedgerSubjectBalanceRespVO> balances) {
+        List<FmsLedgerQuantityGeneralRespVO> result = new ArrayList<>(balances.size());
+        balances.forEach(balance -> {
+            FmsLedgerQuantityGeneralRespVO item = BeanUtils.toBean(balance, FmsLedgerQuantityGeneralRespVO.class)
+                    .setOpeningAmount(firstAmount(balance.getOpeningDebitAmount(), balance.getOpeningCreditAmount()))
+                    .setEndingAmount(firstAmount(balance.getEndingDebitAmount(), balance.getEndingCreditAmount()))
+                    .setChildren(buildQuantityGeneralRespVOList(balance.getChildren()));
+            result.add(item);
+        });
+        return result;
+    }
+
+    private static BigDecimal firstAmount(BigDecimal debitAmount, BigDecimal creditAmount) {
+        return debitAmount != null ? debitAmount : creditAmount;
+    }
+
+    /**
+     * 普通账簿计算上下文
+     */
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class LedgerContext {
+
+        /**
+         * 账套
+         */
+        private final FmsAccountSetDO accountSet;
+        /**
+         * 财务参数
+         */
+        private final FmsFinanceParameterDO financeParameter;
+        /**
+         * 开始会计期间
+         */
+        private final YearMonth startMonth;
+        /**
+         * 结束会计期间
+         */
+        private final YearMonth endMonth;
+        /**
+         * 科目列表
+         */
+        private final List<FmsSubjectDO> subjects;
+        /**
+         * 科目 Map
+         */
+        private final Map<Long, FmsSubjectDO> subjectMap;
+        /**
+         * 父科目编号与子科目编号 Map
+         */
+        private final Map<Long, List<Long>> childMap;
+        /**
+         * 科目初始余额列表
+         */
+        private final List<FmsInitialBalanceDO> initialBalances;
+        /**
+         * 凭证分录列表
+         */
+        private final List<FmsLedgerEntryVO> entries;
+    }
+
+    /**
+     * 辅助核算账簿计算上下文
+     */
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class AuxiliaryLedgerContext {
+
+        /**
+         * 账套
+         */
+        private final FmsAccountSetDO accountSet;
+        /**
+         * 财务参数
+         */
+        private final FmsFinanceParameterDO financeParameter;
+        /**
+         * 开始会计期间
+         */
+        private final YearMonth startMonth;
+        /**
+         * 结束会计期间
+         */
+        private final YearMonth endMonth;
+        /**
+         * 辅助核算类别编号
+         */
+        private final Long auxiliaryTypeId;
+        /**
+         * 选中的科目编号
+         */
+        private final Long selectedSubjectId;
+        /**
+         * 辅助核算项目列表
+         */
+        private final List<FmsAuxiliaryItemDO> auxiliaryItems;
+        /**
+         * 科目 Map
+         */
+        private final Map<Long, FmsSubjectDO> subjectMap;
+        /**
+         * 查询范围内的科目编号集合
+         */
+        private final Set<Long> subjectIds;
+        /**
+         * 科目初始余额列表
+         */
+        private final List<FmsInitialBalanceDO> initialBalances;
+        /**
+         * 凭证分录列表
+         */
+        private final List<FmsLedgerEntryVO> entries;
+    }
+
+    /**
+     * 辅助核算组合余额计算记录
+     */
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class AuxiliaryCombinationRecord {
+
+        private final Long id;
+        private final Long subjectId;
+        private final List<AuxiliarySnapshot> items;
+        private final List<FmsInitialBalanceDO.AssistBalance> initialAssists;
+    }
+
+    /**
+     * 辅助核算项目快照
+     */
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class AuxiliarySnapshot {
+
+        private final Long itemId;
+        private final String name;
+    }
+
+    /**
+     * 科目初始余额与辅助核算余额记录
+     */
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class InitialAssistRecord {
+
+        /**
+         * 科目初始余额
+         */
+        private final FmsInitialBalanceDO initial;
+        /**
+         * 辅助核算余额
+         */
+        private final FmsInitialBalanceDO.AssistBalance assist;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetService.java
new file mode 100644
index 0000000..caa0457
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetService.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetRowRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+
+import java.time.YearMonth;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * FMS 资产负债表 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsBalanceSheetService {
+
+    /**
+     * 获得资产负债表
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 资产负债表
+     */
+    List<FmsBalanceSheetRowRespVO> getBalanceSheet(FmsReportListReqVO listReqVO, Long userId);
+
+    /**
+     * 获得资产负债行次金额 Map，供现金流量表取数
+     *
+     * 账套权限由调用方校验；报表快照按查询条件的期间初始化，行次金额按取数区间实时计算
+     *
+     * @param listReqVO 查询条件，用于初始化报表快照
+     * @param startMonth 取数开始月份
+     * @param endMonth 取数结束月份
+     * @param userId 用户编号
+     * @return 行次到报表项目的 Map
+     */
+    Map<Integer, FmsReportItemRespVO> getBalanceSheetLineMap(FmsReportListReqVO listReqVO,
+            YearMonth startMonth, YearMonth endMonth, Long userId);
+
+    /**
+     * 检查资产负债表的平衡、初始余额、损益结转和公式覆盖状态
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 检查结果
+     */
+    FmsBalanceSheetCheckRespVO checkBalanceSheet(FmsReportListReqVO listReqVO, Long userId);
+
+    /**
+     * 更新资产负债表公式
+     *
+     * @param updateReqVO 公式信息
+     * @param userId 用户编号
+     */
+    void updateBalanceSheetFormula(FmsReportFormulaUpdateReqVO updateReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetServiceImpl.java
new file mode 100644
index 0000000..f7d912f
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetServiceImpl.java
@@ -0,0 +1,458 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingOverviewRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetRowRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.FmsReportTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.balance.FmsBalanceSheetConfigDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.balance.FmsBalanceSheetReportDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.FmsReportTemplateMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.balance.FmsBalanceSheetConfigMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.balance.FmsBalanceSheetReportMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsReportTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.util.FmsPeriodUtils;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_CONFIG_NOT_EXISTS;
+
+/**
+ * FMS 资产负债表 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsBalanceSheetServiceImpl implements FmsBalanceSheetService {
+
+    /**
+     * 货币资金行次，现金流量表的现金余额取数行
+     */
+    public static final Integer MONETARY_CASH_ROW_NO = 1;
+    /**
+     * 资产总计行次，资产侧与负债侧的分界
+     */
+    public static final Integer ASSET_TOTAL_ROW_NO = 30;
+    /**
+     * 负债和所有者权益总计行次，与资产总计勾稽平衡
+     */
+    public static final Integer LIABILITY_TOTAL_ROW_NO = 53;
+    /**
+     * 表头行的行次，例如“流动资产：”“流动负债：”，正文行次均大于该值
+     */
+    private static final int HEADER_ROW_NO = 0;
+    /**
+     * 负债和所有者权益侧表头的最小显示顺序，资产侧表头和小计的显示顺序均小于该值
+     */
+    private static final int LIABILITY_SIDE_START_SORT = 32;
+    /**
+     * 资本化支出科目编码，余额不纳入资产负债表公式覆盖检查
+     */
+    private static final String CAPITALIZED_EXPENSE_SUBJECT_CODE = "4404";
+
+    @Resource
+    private FmsBalanceSheetConfigMapper balanceSheetConfigMapper;
+    @Resource
+    private FmsBalanceSheetReportMapper balanceSheetReportMapper;
+    @Resource
+    private FmsReportTemplateMapper reportTemplateMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsReportCommonService reportCommonService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsInitialBalanceService initialBalanceService;
+    @Resource
+    private FmsFinanceParameterService financeParameterService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private FmsClosingPeriodService closingPeriodService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<FmsBalanceSheetRowRespVO> getBalanceSheet(FmsReportListReqVO listReqVO, Long userId) {
+        // 1.1 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(
+                listReqVO.getAccountSetId(), userId);
+        // 1.2 加载科目并初始化报表配置
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO.getAccountSetId(), null, userId);
+        List<FmsBalanceSheetConfigDO> configs = getOrInitBalanceConfigs(listReqVO.getAccountSetId(), subjects);
+        List<FmsBalanceSheetReportDO> reports = getOrCreateBalanceReports(listReqVO, configs);
+
+        // 2. 查询年初至期末的科目余额
+        YearMonth endMonth = LocalDateTimeUtils.parseYearMonth(listReqVO.getEndMonth());
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = reportCommonService.getSubjectBalanceMap(
+                listReqVO.getAccountSetId(), FmsPeriodUtils.getYearStartMonth(accountSet, endMonth), endMonth, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+
+        // 3. 计算报表项目，并按行编号配对资产与负债两侧
+        Map<Integer, FmsReportItemRespVO> lineMap = new LinkedHashMap<>();
+        Map<Integer, FmsBalanceSheetRowRespVO> rowMap = new LinkedHashMap<>();
+        for (FmsBalanceSheetReportDO report : reports) {
+            FmsBalanceSheetConfigDO config = BeanUtils.toBean(report, FmsBalanceSheetConfigDO.class);
+            FmsReportItemRespVO item = buildBalanceItem(config, subjectMap, balanceMap, lineMap);
+            if (config.getRowNo() > HEADER_ROW_NO) {
+                lineMap.put(config.getRowNo(), item);
+            }
+            FmsBalanceSheetRowRespVO row = rowMap.computeIfAbsent(config.getRowId(),
+                    rowId -> new FmsBalanceSheetRowRespVO().setRowId(rowId));
+            fillRowItem(row, item, isAssetItem(config));
+        }
+        return new ArrayList<>(rowMap.values());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Map<Integer, FmsReportItemRespVO> getBalanceSheetLineMap(FmsReportListReqVO listReqVO,
+                                                                    YearMonth startMonth, YearMonth endMonth, Long userId) {
+        // 1. 加载科目并初始化报表配置，报表快照按查询期间只初始化一次
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO.getAccountSetId(), null, userId);
+        List<FmsBalanceSheetConfigDO> configs = getOrInitBalanceConfigs(listReqVO.getAccountSetId(), subjects);
+        List<FmsBalanceSheetReportDO> reports = getOrCreateBalanceReports(listReqVO, configs);
+        List<FmsBalanceSheetConfigDO> reportConfigs = convertList(
+                reports, report -> BeanUtils.toBean(report, FmsBalanceSheetConfigDO.class));
+
+        // 2. 查询取数区间的科目余额
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = reportCommonService.getSubjectBalanceMap(
+                listReqVO.getAccountSetId(), startMonth, endMonth, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+
+        // 3. 计算各报表行次金额
+        Map<Integer, FmsReportItemRespVO> lineMap = new LinkedHashMap<>();
+        for (FmsBalanceSheetConfigDO config : reportConfigs) {
+            FmsReportItemRespVO item = buildBalanceItem(config, subjectMap, balanceMap, lineMap);
+            if (config.getRowNo() > HEADER_ROW_NO) {
+                lineMap.put(config.getRowNo(), item);
+            }
+        }
+        return lineMap;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public FmsBalanceSheetCheckRespVO checkBalanceSheet(FmsReportListReqVO listReqVO, Long userId) {
+        // 1. 检查资产负债表平衡状态
+        List<FmsBalanceSheetRowRespVO> rows = getBalanceSheet(listReqVO, userId);
+        FmsBalanceSheetRowRespVO assetTotalRow = CollUtil.findOne(rows,
+                row -> ObjUtil.equal(row.getAssetRowNo(), ASSET_TOTAL_ROW_NO));
+        FmsBalanceSheetRowRespVO liabilityTotalRow = CollUtil.findOne(rows,
+                row -> ObjUtil.equal(row.getLiabilityRowNo(), LIABILITY_TOTAL_ROW_NO));
+        BigDecimal openingDifferenceAmount = NumberUtils.zeroIfNull(
+                assetTotalRow == null ? null : assetTotalRow.getAssetOpeningAmount())
+                .subtract(NumberUtils.zeroIfNull(
+                        liabilityTotalRow == null ? null : liabilityTotalRow.getLiabilityOpeningAmount()));
+        BigDecimal closingDifferenceAmount = NumberUtils.zeroIfNull(
+                assetTotalRow == null ? null : assetTotalRow.getAssetClosingAmount())
+                .subtract(NumberUtils.zeroIfNull(
+                        liabilityTotalRow == null ? null : liabilityTotalRow.getLiabilityClosingAmount()));
+
+        // 2. 检查初始余额和损益结转状态
+        boolean initialBalanceBalanced = Boolean.TRUE.equals(
+                initialBalanceService.getTrialBalance(listReqVO.getAccountSetId(), userId).getBalanced());
+        boolean profitLossTransferred = isProfitLossTransferred(listReqVO, userId);
+
+        // 3. 检查未纳入报表公式的非损益类科目
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO.getAccountSetId(), null, userId);
+        FmsFinanceParameterDO financeParameter = financeParameterService.getFinanceParameter(listReqVO.getAccountSetId());
+        String capitalizedExpenseSubjectCode = financeParameterService.convertStandardSubjectCode(
+                CAPITALIZED_EXPENSE_SUBJECT_CODE, financeParameter.getSubjectCodeRule());
+        Set<Long> formulaSubjectIds = collectRowFormulaSubjectIds(rows);
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = reportCommonService.getSubjectBalanceMap(
+                listReqVO.getAccountSetId(), LocalDateTimeUtils.parseYearMonth(listReqVO.getStartMonth()),
+                LocalDateTimeUtils.parseYearMonth(listReqVO.getEndMonth()), userId);
+        List<FmsBalanceSheetCheckRespVO.UnmappedSubject> unmappedSubjects = new ArrayList<>();
+        for (FmsSubjectDO subject : subjects) {
+            // 一级非损益科目存在余额且未纳入公式时，需要提示补充报表公式；资本化支出科目除外
+            if (!reportCommonService.isRootSubject(subject)
+                    || ObjUtil.equal(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                    || StrUtil.equals(subject.getCode(), capitalizedExpenseSubjectCode)
+                    || reportCommonService.isSubjectTreeMapped(subject, subjects, formulaSubjectIds)
+                    || !hasBalance(balanceMap.get(subject.getId()))) {
+                continue;
+            }
+            unmappedSubjects.add(new FmsBalanceSheetCheckRespVO.UnmappedSubject()
+                    .setId(subject.getId()).setCode(subject.getCode()).setName(subject.getName()));
+        }
+        return new FmsBalanceSheetCheckRespVO()
+                .setBalanced(openingDifferenceAmount.signum() == 0 && closingDifferenceAmount.signum() == 0)
+                .setInitialBalanceBalanced(initialBalanceBalanced)
+                .setProfitLossTransferred(profitLossTransferred)
+                .setOpeningDifferenceAmount(openingDifferenceAmount)
+                .setClosingDifferenceAmount(closingDifferenceAmount)
+                .setUnmappedSubjects(unmappedSubjects);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @SuppressWarnings("DataFlowIssue")
+    public void updateBalanceSheetFormula(FmsReportFormulaUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验报表项目
+        FmsBalanceSheetReportDO report = balanceSheetReportMapper.selectById(updateReqVO.getId());
+        reportCommonService.validateReportItemEditable(updateReqVO.getAccountSetId(),
+                report == null ? null : report.getAccountSetId(), report == null ? null : report.getEditable());
+        List<FmsBalanceSheetConfigDO> configs = balanceSheetConfigMapper.selectListByAccountSetId(
+                updateReqVO.getAccountSetId());
+        FmsBalanceSheetConfigDO config = CollUtil.findOne(configs, item ->
+                        ObjUtil.equal(item.getName(), report.getName())
+                                && ObjUtil.equal(item.getRowNo(), report.getRowNo())
+                                && ObjUtil.equal(item.getLevel(), report.getLevel())
+                                && ObjUtil.equal(item.getSort(), report.getSort()));
+        if (config == null) {
+            throw exception(REPORT_CONFIG_NOT_EXISTS);
+        }
+
+        // 2. 校验并构造资产负债表公式
+        List<FmsReportFormulaRespVO> formulas = reportCommonService.buildReportFormulaList(updateReqVO,
+                FmsFormulaRuleEnum.BALANCE.getRule(), FmsFormulaRuleEnum.SUBJECT_CREDIT_BALANCE.getRule(), userId);
+
+        // 3. 更新当前期间和未出报表期间使用的公式
+        String formula = JsonUtils.toJsonString(formulas);
+        balanceSheetReportMapper.updateById(new FmsBalanceSheetReportDO().setId(report.getId()).setFormula(formula));
+        balanceSheetConfigMapper.updateById(new FmsBalanceSheetConfigDO().setId(config.getId()).setFormula(formula));
+    }
+
+    /**
+     * 判断报表配置是否属于资产侧
+     *
+     * 行次大于表头行次且不超过资产总计行次的为正文资产项；行次为表头行次时，按显示顺序是否早于负债侧表头判断
+     *
+     * @param config 报表配置
+     * @return 是否资产侧
+     */
+    private boolean isAssetItem(FmsBalanceSheetConfigDO config) {
+        return config.getRowNo() > HEADER_ROW_NO && config.getRowNo() <= ASSET_TOTAL_ROW_NO
+                || config.getRowNo() == HEADER_ROW_NO && config.getSort() < LIABILITY_SIDE_START_SORT;
+    }
+
+    /**
+     * 将报表项目填充到配对行的资产侧或负债侧字段
+     *
+     * @param row 报表行
+     * @param item 报表项目
+     * @param asset 是否资产侧
+     */
+    private void fillRowItem(FmsBalanceSheetRowRespVO row, FmsReportItemRespVO item, boolean asset) {
+        if (asset) {
+            row.setAssetId(item.getId()).setAssetName(item.getName()).setAssetRowNo(item.getRowNo())
+                    .setAssetClosingAmount(item.getClosingAmount()).setAssetOpeningAmount(item.getOpeningAmount())
+                    .setAssetLevel(item.getLevel()).setAssetEditable(item.getEditable())
+                    .setAssetFormula(item.getFormula());
+        } else {
+            row.setLiabilityId(item.getId()).setLiabilityName(item.getName())
+                    .setLiabilityRowNo(item.getRowNo()).setLiabilityClosingAmount(item.getClosingAmount())
+                    .setLiabilityOpeningAmount(item.getOpeningAmount()).setLiabilityLevel(item.getLevel())
+                    .setLiabilityEditable(item.getEditable()).setLiabilityFormula(item.getFormula());
+        }
+    }
+
+    /**
+     * 判断查询期间内各月的损益是否均已结转，逐月检查结账概览的损益余额
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 是否已结转
+     */
+    private boolean isProfitLossTransferred(FmsReportListReqVO listReqVO, Long userId) {
+        YearMonth endMonth = LocalDateTimeUtils.parseYearMonth(listReqVO.getEndMonth());
+        for (YearMonth currentMonth = LocalDateTimeUtils.parseYearMonth(listReqVO.getStartMonth());
+                !currentMonth.isAfter(endMonth); currentMonth = currentMonth.plusMonths(1)) {
+            FmsClosingQueryReqVO closingQueryReqVO = new FmsClosingQueryReqVO();
+            closingQueryReqVO.setAccountSetId(listReqVO.getAccountSetId());
+            closingQueryReqVO.setMonth(currentMonth.toString());
+            FmsClosingOverviewRespVO overview = closingPeriodService.getClosingOverview(closingQueryReqVO, userId);
+            // 当月损益余额不为零时，说明存在尚未结转的损益
+            if (NumberUtils.zeroIfNull(overview.getProfitLossBalance()).signum() != 0) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * 收集报表各行公式中引用的科目编号集合，用于公式覆盖检查
+     *
+     * @param rows 报表行
+     * @return 公式中的科目编号集合
+     */
+    private Set<Long> collectRowFormulaSubjectIds(List<FmsBalanceSheetRowRespVO> rows) {
+        Set<Long> subjectIds = new LinkedHashSet<>();
+        for (FmsBalanceSheetRowRespVO row : rows) {
+            subjectIds.addAll(reportCommonService.parseFormulaSubjectIds(row.getAssetFormula()));
+            subjectIds.addAll(reportCommonService.parseFormulaSubjectIds(row.getLiabilityFormula()));
+        }
+        return subjectIds;
+    }
+
+    /**
+     * 判断科目是否存在期初或期末余额
+     *
+     * @param balance 科目余额
+     * @return 是否存在余额
+     */
+    private boolean hasBalance(FmsLedgerSubjectBalanceRespVO balance) {
+        return balance != null && (NumberUtils.zeroIfNull(balance.getOpeningDebitAmount()).signum() != 0
+                || NumberUtils.zeroIfNull(balance.getOpeningCreditAmount()).signum() != 0
+                || NumberUtils.zeroIfNull(balance.getEndingDebitAmount()).signum() != 0
+                || NumberUtils.zeroIfNull(balance.getEndingCreditAmount()).signum() != 0);
+    }
+
+    /**
+     * 计算报表项目的期初和期末金额
+     *
+     * 行次公式直接引用已计算的行次金额；科目公式逐项取数并按运算符累加，取数结果回写公式项用于前端展示
+     *
+     * @param config 报表配置
+     * @param subjectMap 科目编号到科目的 Map
+     * @param balanceMap 科目编号到余额的 Map
+     * @param lineMap 行次到已计算报表项目的 Map
+     * @return 报表项目
+     */
+    private FmsReportItemRespVO buildBalanceItem(FmsBalanceSheetConfigDO config,
+                                                 Map<Long, FmsSubjectDO> subjectMap,
+                                                 Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap,
+                                                 Map<Integer, FmsReportItemRespVO> lineMap) {
+        FmsReportItemRespVO item = new FmsReportItemRespVO().setId(config.getId()).setName(config.getName())
+                .setRowNo(config.getRowNo()).setLevel(config.getLevel()).setEditable(config.getEditable())
+                .setFormula(config.getFormula()).setOpeningAmount(BigDecimal.ZERO)
+                .setClosingAmount(BigDecimal.ZERO);
+        // 行次公式直接引用前面已计算的行次金额，例如 ["L1-L2"]
+        if (reportCommonService.isLineFormula(config.getFormula())) {
+            item.setOpeningAmount(reportCommonService.calculateItemLineFormula(config.getFormula(), lineMap, true, false))
+                    .setClosingAmount(reportCommonService.calculateItemLineFormula(config.getFormula(), lineMap, false, false));
+            return item;
+        }
+        // 科目公式逐项取数，按运算符累加到期初、期末金额
+        List<FmsReportFormulaRespVO> formulas = reportCommonService.parseSubjectFormula(config.getFormula());
+        for (FmsReportFormulaRespVO formula : formulas) {
+            FmsSubjectDO subject = subjectMap.get(formula.getSubjectId());
+            reportCommonService.normalizeSubjectFormula(formula, subject);
+            BigDecimal openingAmount = reportCommonService.calculateBalanceAmount(
+                    formula.getRules(), subject, balanceMap, subjectMap, true);
+            BigDecimal closingAmount = reportCommonService.calculateBalanceAmount(
+                    formula.getRules(), subject, balanceMap, subjectMap, false);
+            formula.setOpeningAmount(openingAmount).setClosingAmount(closingAmount);
+            item.setOpeningAmount(reportCommonService.applyOperator(item.getOpeningAmount(), openingAmount, formula.getOperator()))
+                    .setClosingAmount(reportCommonService.applyOperator(item.getClosingAmount(), closingAmount, formula.getOperator()));
+        }
+        // 回写含取数结果的公式，供前端公式编辑弹窗展示各项金额
+        item.setFormula(JsonUtils.toJsonString(formulas));
+        return item;
+    }
+
+    /**
+     * 获得账套的报表配置，首次查询时按报表模板初始化
+     *
+     * 初始化时将模板公式中的科目编码绑定为账套下的科目编号，编码不存在的科目编号置空
+     *
+     * @param accountSetId 账套编号
+     * @param subjects 账套下的科目列表
+     * @return 报表配置列表
+     */
+    private List<FmsBalanceSheetConfigDO> getOrInitBalanceConfigs(Long accountSetId, List<FmsSubjectDO> subjects) {
+        // 1. 已初始化时直接返回
+        List<FmsBalanceSheetConfigDO> configs = balanceSheetConfigMapper.selectListByAccountSetId(accountSetId);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 2. 锁定账套后二次查询，避免并发首次查询重复初始化
+        accountSetService.lockAccountSet(accountSetId);
+        configs = balanceSheetConfigMapper.selectListByAccountSetId(accountSetId);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 3. 按报表模板初始化，模板为空时返回空列表
+        List<FmsReportTemplateDO> templates = reportTemplateMapper.selectListByType(
+                FmsReportTypeEnum.BALANCE_SHEET.getType());
+        if (CollUtil.isEmpty(templates)) {
+            return Collections.emptyList();
+        }
+        // 4. 模板公式中的科目编码绑定为账套下的科目编号后批量插入
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode,
+                Function.identity(), (first, second) -> first);
+        configs = convertList(templates, template -> BeanUtils.toBean(template, FmsBalanceSheetConfigDO.class)
+                .setId(null).setAccountSetId(accountSetId)
+                .setFormula(reportCommonService.bindSubjectFormula(template.getFormula(), subjectMap)));
+        balanceSheetConfigMapper.insertBatch(configs);
+        return configs;
+    }
+
+    /**
+     * 获得查询期间的报表快照，首次查询该期间时按当前配置创建
+     *
+     * @param listReqVO 查询条件
+     * @param configs 报表配置列表
+     * @return 报表快照列表
+     */
+    private List<FmsBalanceSheetReportDO> getOrCreateBalanceReports(
+            FmsReportListReqVO listReqVO, List<FmsBalanceSheetConfigDO> configs) {
+        // 1. 已生成快照时直接返回；配置为空时不生成
+        Integer fromPeriod = reportCommonService.parsePeriod(listReqVO.getStartMonth());
+        Integer toPeriod = reportCommonService.parsePeriod(listReqVO.getEndMonth());
+        Integer periodType = reportCommonService.getPeriodType(fromPeriod, toPeriod);
+        List<FmsBalanceSheetReportDO> reports = balanceSheetReportMapper.selectListByPeriod(
+                listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType);
+        if (CollUtil.isNotEmpty(reports) || CollUtil.isEmpty(configs)) {
+            return reports;
+        }
+        // 2. 锁定账套后二次查询，避免并发首次查询重复生成期间快照
+        accountSetService.lockAccountSet(listReqVO.getAccountSetId());
+        reports = balanceSheetReportMapper.selectListByPeriod(
+                listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType);
+        if (CollUtil.isNotEmpty(reports)) {
+            return reports;
+        }
+        // 3. 按当前配置创建期间快照，金额初始化为零、未结账
+        reports = convertList(configs, config -> BeanUtils.toBean(config, FmsBalanceSheetReportDO.class)
+                .setId(null).setFromPeriod(fromPeriod).setToPeriod(toPeriod).setType(periodType)
+                .setOpeningAmount(BigDecimal.ZERO).setClosingAmount(BigDecimal.ZERO).setSettled(false));
+        balanceSheetReportMapper.insertBatch(reports);
+        return reports;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementService.java
new file mode 100644
index 0000000..0e99f03
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementService.java
@@ -0,0 +1,73 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowStatementUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+
+import java.util.List;
+
+/**
+ * FMS 现金流量表 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsCashFlowStatementService {
+
+    /**
+     * 获得现金流量表
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 现金流量表
+     */
+    List<FmsReportItemRespVO> getCashFlowStatement(FmsReportListReqVO listReqVO, Long userId);
+
+    /**
+     * 更新现金流量表
+     *
+     * @param updateReqVO 修改信息
+     * @param userId 用户编号
+     */
+    void updateCashFlowStatement(FmsCashFlowStatementUpdateReqVO updateReqVO, Long userId);
+
+    /**
+     * 检查现金流量表取数依赖的资产负债表状态
+     *
+     * 现金流量表本身无独立平衡关系，检查结果复用资产负债表检查，并汇总是否满足取数条件
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 检查结果
+     */
+    FmsCashFlowCheckRespVO checkCashFlowStatement(FmsReportListReqVO listReqVO, Long userId);
+
+    /**
+     * 获得现金流量辅助数据列表
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 现金流量辅助数据列表
+     */
+    List<FmsCashFlowAdjustmentRespVO> getCashFlowAdjustmentList(FmsReportListReqVO listReqVO, Long userId);
+
+    /**
+     * 更新现金流量辅助数据的人工调整金额
+     *
+     * @param updateReqVO 辅助数据
+     * @param userId 用户编号
+     */
+    void updateCashFlowAdjustment(FmsCashFlowAdjustmentUpdateReqVO updateReqVO, Long userId);
+
+    /**
+     * 更新现金流量辅助数据公式
+     *
+     * @param updateReqVO 公式信息
+     * @param userId 用户编号
+     */
+    void updateCashFlowAdjustmentFormula(FmsReportFormulaUpdateReqVO updateReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementServiceImpl.java
new file mode 100644
index 0000000..888aa1b
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementServiceImpl.java
@@ -0,0 +1,704 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowStatementUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.FmsReportTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowExtendConfigDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowExtendDataDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowStatementConfigDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowStatementReportDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.FmsReportTemplateMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow.FmsCashFlowExtendConfigMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow.FmsCashFlowExtendDataMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow.FmsCashFlowStatementConfigMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow.FmsCashFlowStatementReportMapper;
+import cn.iocoder.yudao.module.fms.enums.report.FmsCashFlowExtendTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsCashFlowParamTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsReportTypeEnum;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.util.FmsPeriodUtils;
+import com.googlecode.aviator.AviatorEvaluator;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.*;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_ADJUSTMENT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_AMOUNT_NOT_ADJUSTABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_CONFIG_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_CONFIG_NOT_EDITABLE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CASH_FLOW_ADJUSTMENT_FORMULA_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CASH_FLOW_ADJUSTMENT_FORMULA_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CASH_FLOW_ADJUSTMENT_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CASH_FLOW_ADJUSTMENT_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CASH_FLOW_STATEMENT_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CASH_FLOW_STATEMENT_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.FMS_CASH_FLOW_STATEMENT_UPDATE_SUCCESS;
+
+/**
+ * FMS 现金流量表 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsCashFlowStatementServiceImpl implements FmsCashFlowStatementService {
+
+    /**
+     * 现金流量表主表分类
+     */
+    private static final Integer CASH_FLOW_CATEGORY_MAIN = 1;
+    /**
+     * 其他经营活动现金行次，未明确归类的经营活动现金流归入该行
+     */
+    private static final int OTHER_OPERATING_ROW_NO = 6;
+    /**
+     * 期末现金及现金等价物余额行次
+     */
+    private static final int ENDING_CASH_ROW_NO = 22;
+
+    private static final Pattern LINE_FORMULA_PATTERN = Pattern.compile("([+-]?)(L\\d+)");
+    private static final Pattern CASH_FLOW_PARAM_PATTERN = Pattern.compile("BA\\[\\d+,[12]]|IN\\d+|EX\\d+|L\\d+");
+    private static final Pattern CASH_FLOW_EXPRESSION_PATTERN = Pattern.compile("[A-Z0-9_+\\-*/().?:<>=\\s]+");
+
+    @Resource
+    private FmsCashFlowStatementConfigMapper cashFlowStatementConfigMapper;
+    @Resource
+    private FmsCashFlowStatementReportMapper cashFlowStatementReportMapper;
+    @Resource
+    private FmsCashFlowExtendConfigMapper cashFlowExtendConfigMapper;
+    @Resource
+    private FmsCashFlowExtendDataMapper cashFlowExtendDataMapper;
+    @Resource
+    private FmsReportTemplateMapper reportTemplateMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsReportCommonService reportCommonService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsBalanceSheetService balanceSheetService;
+    @Resource
+    private FmsIncomeStatementService incomeStatementService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<FmsReportItemRespVO> getCashFlowStatement(FmsReportListReqVO listReqVO, Long userId) {
+        // 1.1 校验账套读权限
+        FmsAccountSetDO accountSet = accountSetService.validateAccountSetReadPermission(
+                listReqVO.getAccountSetId(), userId);
+        // 1.2 初始化报表配置
+        List<FmsCashFlowStatementConfigDO> configs = getOrInitCashFlowConfigs(listReqVO.getAccountSetId());
+        List<FmsCashFlowStatementReportDO> reports = getOrCreateCashFlowReports(listReqVO, configs);
+
+        // 2. 查询本期和本年的资产负债、利润表和辅助数据取数
+        YearMonth startMonth = LocalDateTimeUtils.parseYearMonth(listReqVO.getStartMonth());
+        YearMonth endMonth = LocalDateTimeUtils.parseYearMonth(listReqVO.getEndMonth());
+        Map<Integer, FmsReportItemRespVO> currentBalanceMap = balanceSheetService.getBalanceSheetLineMap(
+                listReqVO, startMonth, endMonth, userId);
+        Map<Integer, FmsReportItemRespVO> yearBalanceMap = balanceSheetService.getBalanceSheetLineMap(
+                listReqVO, FmsPeriodUtils.getYearStartMonth(accountSet, endMonth), endMonth, userId);
+        List<FmsReportItemRespVO> incomeItems = incomeStatementService.getIncomeStatement(listReqVO, userId);
+        Map<Integer, FmsReportItemRespVO> incomeMap = convertMap(
+                filterList(incomeItems, item -> item.getRowNo() != null && item.getRowNo() > 0),
+                FmsReportItemRespVO::getRowNo, Function.identity(), (first, second) -> first);
+        List<FmsCashFlowAdjustmentRespVO> adjustments = getCashFlowAdjustmentListInternal(listReqVO, userId);
+        Map<Integer, FmsCashFlowAdjustmentRespVO> adjustmentMap = convertMap(
+                filterList(adjustments, item -> item.getRowNo() != null && item.getRowNo() > 0),
+                FmsCashFlowAdjustmentRespVO::getRowNo, Function.identity(), (first, second) -> first);
+
+        // 3. 计算现金流量表项目
+        Map<Integer, FmsCashFlowStatementReportDO> reportMap = convertMap(
+                filterList(reports, report -> report.getRowNo() != null && report.getRowNo() > 0),
+                FmsCashFlowStatementReportDO::getRowNo, Function.identity(), (first, second) -> first);
+        Map<Integer, FmsReportItemRespVO> lineMap = new LinkedHashMap<>();
+        List<FmsReportItemRespVO> result = new ArrayList<>();
+        for (FmsCashFlowStatementReportDO report : reports) {
+            FmsCashFlowStatementConfigDO config = BeanUtils.toBean(report, FmsCashFlowStatementConfigDO.class);
+            FmsReportItemRespVO item = BeanUtils.toBean(report, FmsReportItemRespVO.class);
+            BigDecimal currentAmount = calculateCashFlowFormula(config.getFormula(), currentBalanceMap,
+                    incomeMap, adjustmentMap, lineMap, true);
+            BigDecimal yearAmount = calculateCashFlowFormula(config.getFormula(), yearBalanceMap,
+                    incomeMap, adjustmentMap, lineMap, false);
+            if (isAmountAdjustable(report)) {
+                currentAmount = getSavedAmount(report.getCurrentAmount(), currentAmount);
+                yearAmount = getSavedAmount(report.getYearAmount(), yearAmount);
+            }
+            item.setCurrentAmount(currentAmount).setYearAmount(yearAmount);
+            if (config.getRowNo() != null && config.getRowNo() > 0) {
+                lineMap.put(config.getRowNo(), item);
+            }
+            result.add(item);
+        }
+
+        // 4. 将未明确归类的经营活动现金流归入其他经营活动
+        reconcileCashFlow(result, lineMap, currentBalanceMap, yearBalanceMap, adjustmentMap, reportMap);
+        return result;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CASH_FLOW_STATEMENT_TYPE,
+            subType = FMS_CASH_FLOW_STATEMENT_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.accountSetId}}", success = FMS_CASH_FLOW_STATEMENT_UPDATE_SUCCESS)
+    public void updateCashFlowStatement(FmsCashFlowStatementUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验现金流量表项目属于指定期间
+        Integer fromPeriod = reportCommonService.parsePeriod(updateReqVO.getStartMonth());
+        Integer toPeriod = reportCommonService.parsePeriod(updateReqVO.getEndMonth());
+        Integer periodType = reportCommonService.getPeriodType(fromPeriod, toPeriod);
+        List<Long> ids = convertList(updateReqVO.getItems(), FmsCashFlowStatementUpdateReqVO.Item::getId);
+        List<FmsCashFlowStatementReportDO> reports = cashFlowStatementReportMapper.selectListByIdsAndPeriod(
+                ids, updateReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType);
+        Map<Long, FmsCashFlowStatementReportDO> reportMap = convertMap(
+                reports, FmsCashFlowStatementReportDO::getId);
+        if (reportMap.size() != new LinkedHashSet<>(ids).size()) {
+            throw exception(REPORT_CONFIG_NOT_EXISTS);
+        }
+        // 1.3 校验报表项目允许调整金额
+        for (FmsCashFlowStatementUpdateReqVO.Item item : updateReqVO.getItems()) {
+            if (!isAmountAdjustable(reportMap.get(item.getId()))) {
+                throw exception(REPORT_AMOUNT_NOT_ADJUSTABLE);
+            }
+        }
+
+        // 2. 更新现金流量表金额，金额为零时重新按公式计算
+        cashFlowStatementReportMapper.updateBatch(convertList(updateReqVO.getItems(), item ->
+                new FmsCashFlowStatementReportDO().setId(item.getId())
+                        .setCurrentAmount(item.getCurrentAmount())
+                        .setYearAmount(item.getYearAmount())));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public FmsCashFlowCheckRespVO checkCashFlowStatement(FmsReportListReqVO listReqVO, Long userId) {
+        // 现金流量表本身无独立平衡关系，直接复用资产负债表检查，并汇总是否满足取数条件
+        FmsBalanceSheetCheckRespVO balanceCheck = balanceSheetService.checkBalanceSheet(listReqVO, userId);
+        return BeanUtils.toBean(balanceCheck, FmsCashFlowCheckRespVO.class)
+                .setBalanceSheetReady(Boolean.TRUE.equals(balanceCheck.getBalanced())
+                        && Boolean.TRUE.equals(balanceCheck.getInitialBalanceBalanced())
+                        && Boolean.TRUE.equals(balanceCheck.getProfitLossTransferred())
+                        && CollUtil.isEmpty(balanceCheck.getUnmappedSubjects()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<FmsCashFlowAdjustmentRespVO> getCashFlowAdjustmentList(
+            FmsReportListReqVO listReqVO, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(listReqVO.getAccountSetId(), userId);
+
+        // 2. 初始化并计算辅助数据
+        return getCashFlowAdjustmentListInternal(listReqVO, userId);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CASH_FLOW_STATEMENT_TYPE,
+            subType = FMS_CASH_FLOW_ADJUSTMENT_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.accountSetId}}", success = FMS_CASH_FLOW_ADJUSTMENT_UPDATE_SUCCESS)
+    public void updateCashFlowAdjustment(
+            FmsCashFlowAdjustmentUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验现金流量辅助数据
+        List<Long> ids = convertList(updateReqVO.getItems(), FmsCashFlowAdjustmentUpdateReqVO.Item::getId);
+        List<FmsCashFlowExtendDataDO> dataList = cashFlowExtendDataMapper.selectListByIdsAndAccountSetId(
+                ids, updateReqVO.getAccountSetId());
+        Map<Long, FmsCashFlowExtendDataDO> dataMap = convertMap(dataList, FmsCashFlowExtendDataDO::getId);
+        if (dataMap.size() != new LinkedHashSet<>(ids).size()) {
+            throw exception(REPORT_ADJUSTMENT_NOT_EXISTS);
+        }
+        // 1.3 校验辅助数据允许编辑
+        for (FmsCashFlowAdjustmentUpdateReqVO.Item item : updateReqVO.getItems()) {
+            if (Boolean.FALSE.equals(dataMap.get(item.getId()).getEditable())) {
+                throw exception(REPORT_CONFIG_NOT_EDITABLE);
+            }
+        }
+
+        // 2. 批量更新可编辑金额
+        cashFlowExtendDataMapper.updateBatch(convertList(updateReqVO.getItems(),
+                item -> new FmsCashFlowExtendDataDO().setId(item.getId())
+                        .setCurrentAmount(item.getCurrentAmount()).setYearAmount(item.getYearAmount())));
+
+        // 3. 辅助资料变化后，主表人工调整失效，下次查询重新按公式计算
+        FmsCashFlowExtendDataDO periodData = CollUtil.getFirst(dataList);
+        cashFlowStatementReportMapper.clearAdjustedAmounts(updateReqVO.getAccountSetId(),
+                periodData.getFromPeriod(), periodData.getToPeriod(), periodData.getType());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_CASH_FLOW_STATEMENT_TYPE,
+            subType = FMS_CASH_FLOW_ADJUSTMENT_FORMULA_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.accountSetId}}", success = FMS_CASH_FLOW_ADJUSTMENT_FORMULA_UPDATE_SUCCESS)
+    public void updateCashFlowAdjustmentFormula(FmsReportFormulaUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验现金流量辅助数据
+        FmsCashFlowExtendDataDO data = cashFlowExtendDataMapper.selectById(updateReqVO.getId());
+        if (data == null || ObjUtil.notEqual(data.getAccountSetId(), updateReqVO.getAccountSetId())) {
+            throw exception(REPORT_ADJUSTMENT_NOT_EXISTS);
+        }
+        if (Boolean.FALSE.equals(data.getEditable())) {
+            throw exception(REPORT_CONFIG_NOT_EDITABLE);
+        }
+
+        // 2. 校验并构造辅助数据公式
+        List<FmsReportFormulaRespVO> formulas = reportCommonService.buildReportFormulaList(updateReqVO,
+                FmsFormulaRuleEnum.DEBIT_AMOUNT.getRule(),
+                FmsFormulaRuleEnum.PROFIT_LOSS_AMOUNT.getRule(), userId);
+
+        // 3. 更新当前期间公式并清空人工调整金额
+        cashFlowExtendDataMapper.updateById(new FmsCashFlowExtendDataDO().setId(data.getId())
+                .setFormula(JsonUtils.toJsonString(formulas))
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO));
+    }
+
+    /**
+     * 初始化并计算当前期间的现金流量辅助数据
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 现金流量辅助数据列表
+     */
+    private List<FmsCashFlowAdjustmentRespVO> getCashFlowAdjustmentListInternal(
+            FmsReportListReqVO listReqVO, Long userId) {
+        // 1. 初始化当前期间辅助数据
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO.getAccountSetId(), null, userId);
+        List<FmsCashFlowExtendConfigDO> configs = getOrInitCashFlowExtendConfigs(listReqVO.getAccountSetId(), subjects);
+        Integer fromPeriod = reportCommonService.parsePeriod(listReqVO.getStartMonth());
+        Integer toPeriod = reportCommonService.parsePeriod(listReqVO.getEndMonth());
+        Integer periodType = reportCommonService.getPeriodType(fromPeriod, toPeriod);
+        List<FmsCashFlowExtendDataDO> dataList = cashFlowExtendDataMapper.selectListByPeriod(
+                listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType, CASH_FLOW_CATEGORY_MAIN);
+        if (CollUtil.isEmpty(dataList) && CollUtil.isNotEmpty(configs)) {
+            accountSetService.lockAccountSet(listReqVO.getAccountSetId());
+            dataList = cashFlowExtendDataMapper.selectListByPeriod(
+                    listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType, CASH_FLOW_CATEGORY_MAIN);
+            if (CollUtil.isEmpty(dataList)) {
+                dataList = convertList(configs, config -> BeanUtils.toBean(config,
+                        FmsCashFlowExtendDataDO.class).setId(null)
+                        .setFromPeriod(fromPeriod).setToPeriod(toPeriod).setType(periodType)
+                        .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO));
+                cashFlowExtendDataMapper.insertBatch(dataList);
+            }
+        }
+
+        // 2. 查询科目发生额
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = reportCommonService.getSubjectBalanceMap(
+                listReqVO.getAccountSetId(), LocalDateTimeUtils.parseYearMonth(listReqVO.getStartMonth()),
+                LocalDateTimeUtils.parseYearMonth(listReqVO.getEndMonth()), userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+
+        // 3. 计算辅助数据项目
+        Map<Integer, FmsCashFlowAdjustmentRespVO> lineMap = new LinkedHashMap<>();
+        List<FmsCashFlowAdjustmentRespVO> result = new ArrayList<>();
+        for (FmsCashFlowExtendDataDO data : dataList) {
+            FmsCashFlowAdjustmentRespVO item = buildCashFlowAdjustmentItem(data, subjectMap, balanceMap, lineMap);
+            if (data.getRowNo() != null && data.getRowNo() > 0) {
+                lineMap.put(data.getRowNo(), item);
+            }
+            result.add(item);
+        }
+        return result;
+    }
+
+    /**
+     * 获得账套的现金流量辅助数据配置，首次查询时按报表模板初始化
+     *
+     * 行次公式的辅助数据标记为固定类型，科目公式标记为自定义类型；模板公式中的科目编码绑定为账套下的科目编号
+     *
+     * @param accountSetId 账套编号
+     * @param subjects 账套下的科目列表
+     * @return 辅助数据配置列表
+     */
+    private List<FmsCashFlowExtendConfigDO> getOrInitCashFlowExtendConfigs(Long accountSetId, List<FmsSubjectDO> subjects) {
+        // 1. 已初始化时直接返回
+        List<FmsCashFlowExtendConfigDO> configs = cashFlowExtendConfigMapper.selectListByAccountSetIdAndCategory(
+                accountSetId, CASH_FLOW_CATEGORY_MAIN);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 2. 锁定账套后二次查询，避免并发首次查询重复初始化
+        accountSetService.lockAccountSet(accountSetId);
+        configs = cashFlowExtendConfigMapper.selectListByAccountSetIdAndCategory(
+                accountSetId, CASH_FLOW_CATEGORY_MAIN);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 3. 按报表模板初始化，模板为空时返回空列表
+        List<FmsReportTemplateDO> templates = reportTemplateMapper.selectListByType(FmsReportTypeEnum.CASH_FLOW_ADJUSTMENT.getType());
+        if (CollUtil.isEmpty(templates)) {
+            return Collections.emptyList();
+        }
+        // 4. 模板公式中的科目编码绑定为账套下的科目编号后批量插入
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode,
+                Function.identity(), (first, second) -> first);
+        configs = convertList(templates, template -> BeanUtils.toBean(template,
+                        FmsCashFlowExtendConfigDO.class).setId(null).setAccountSetId(accountSetId)
+                .setType(reportCommonService.isLineFormula(template.getFormula())
+                        ? FmsCashFlowExtendTypeEnum.FIXED.getType()
+                        : FmsCashFlowExtendTypeEnum.CUSTOM.getType())
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO)
+                .setFormula(reportCommonService.bindSubjectFormula(template.getFormula(), subjectMap)));
+        cashFlowExtendConfigMapper.insertBatch(configs);
+        return configs;
+    }
+
+    /**
+     * 计算辅助数据项目的本期和本年累计金额，人工调整金额非零时覆盖公式计算结果
+     *
+     * @param data 辅助数据
+     * @param subjectMap 科目编号到科目的 Map
+     * @param balanceMap 科目编号到余额的 Map
+     * @param lineMap 行次到已计算辅助数据项目的 Map
+     * @return 辅助数据项目
+     */
+    private FmsCashFlowAdjustmentRespVO buildCashFlowAdjustmentItem(
+            FmsCashFlowExtendDataDO data, Map<Long, FmsSubjectDO> subjectMap,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap,
+            Map<Integer, FmsCashFlowAdjustmentRespVO> lineMap) {
+        FmsCashFlowAdjustmentRespVO item = new FmsCashFlowAdjustmentRespVO()
+                .setId(data.getId()).setName(data.getName()).setRowNo(data.getRowNo())
+                .setFormula(data.getFormula()).setRemark(data.getRemark())
+                .setEditable(data.getEditable()).setLevel(data.getLevel())
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO);
+        // 行次公式直接引用前面已计算的行次金额，例如 ["L1+L2"]
+        if (reportCommonService.isLineFormula(data.getFormula())) {
+            return item.setCurrentAmount(calculateAdjustmentLineFormula(data.getFormula(), lineMap, true))
+                    .setYearAmount(calculateAdjustmentLineFormula(data.getFormula(), lineMap, false));
+        }
+        // 科目公式逐项取数，按运算符累加到本期、本年累计金额
+        List<FmsReportFormulaRespVO> formulas = reportCommonService.parseSubjectFormula(data.getFormula());
+        for (FmsReportFormulaRespVO formula : formulas) {
+            FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(formula.getSubjectId());
+            FmsSubjectDO subject = subjectMap.get(formula.getSubjectId());
+            reportCommonService.normalizeSubjectFormula(formula, subject);
+            BigDecimal currentAmount = reportCommonService.calculateOccurrenceAmount(formula.getRules(), subject, balance, true);
+            BigDecimal yearAmount = reportCommonService.calculateOccurrenceAmount(formula.getRules(), subject, balance, false);
+            formula.setCurrentAmount(currentAmount).setYearAmount(yearAmount);
+            item.setCurrentAmount(reportCommonService.applyOperator(item.getCurrentAmount(), currentAmount, formula.getOperator()))
+                    .setYearAmount(reportCommonService.applyOperator(item.getYearAmount(), yearAmount, formula.getOperator()));
+        }
+        // 人工调整金额非零时覆盖公式计算结果
+        if (NumberUtils.zeroIfNull(data.getCurrentAmount()).signum() != 0) {
+            item.setCurrentAmount(data.getCurrentAmount());
+        }
+        if (NumberUtils.zeroIfNull(data.getYearAmount()).signum() != 0) {
+            item.setYearAmount(data.getYearAmount());
+        }
+        return item.setFormula(JsonUtils.toJsonString(formulas));
+    }
+
+    /**
+     * 计算辅助数据的行次公式金额，例如 ["L1+L2"]
+     *
+     * @param formula 行次公式
+     * @param lineMap 行次到已计算辅助数据项目的 Map
+     * @param current 是否取本期金额，否则取本年累计金额
+     * @return 金额
+     */
+    private BigDecimal calculateAdjustmentLineFormula(String formula, Map<Integer, FmsCashFlowAdjustmentRespVO> lineMap, boolean current) {
+        // 逐个匹配 L 行次引用，按运算符累加对应行次金额
+        String expression = CollUtil.getFirst(reportCommonService.parseLineFormula(formula));
+        if (StrUtil.isEmpty(expression)) {
+            return BigDecimal.ZERO;
+        }
+        BigDecimal result = BigDecimal.ZERO;
+        Matcher matcher = LINE_FORMULA_PATTERN.matcher(expression);
+        while (matcher.find()) {
+            FmsCashFlowAdjustmentRespVO item = lineMap.get(Integer.valueOf(matcher.group(2).substring(1)));
+            BigDecimal amount = item == null ? BigDecimal.ZERO : current
+                    ? NumberUtils.zeroIfNull(item.getCurrentAmount())
+                    : NumberUtils.zeroIfNull(item.getYearAmount());
+            result = reportCommonService.applyOperator(result, amount, matcher.group(1));
+        }
+        return result;
+    }
+
+    /**
+     * 计算现金流量表项目的跨报表表达式金额
+     *
+     * 表达式中的 BA（资产负债取数）、IN（利润表取数）、EX（辅助数据取数）和 L（行次取数）参数
+     * 替换为变量后交由 Aviator 计算；表达式含非法字符时按零处理
+     *
+     * @param formula 行次公式
+     * @param balanceMap 资产负债行次到报表项目的 Map
+     * @param incomeMap 利润表行次到报表项目的 Map
+     * @param adjustmentMap 辅助数据行次到项目的 Map
+     * @param lineMap 行次到已计算报表项目的 Map
+     * @param current 是否取本期金额，否则取本年累计金额
+     * @return 金额
+     */
+    private BigDecimal calculateCashFlowFormula(String formula, Map<Integer, FmsReportItemRespVO> balanceMap,
+                                                Map<Integer, FmsReportItemRespVO> incomeMap,
+                                                Map<Integer, FmsCashFlowAdjustmentRespVO> adjustmentMap,
+                                                Map<Integer, FmsReportItemRespVO> lineMap, boolean current) {
+        String expression = CollUtil.getFirst(reportCommonService.parseLineFormula(formula));
+        if (StrUtil.isEmpty(expression)) {
+            return BigDecimal.ZERO;
+        }
+        // 1. 将 BA、IN、EX、L 参数逐个替换为 Aviator 变量，并放入对应的取数金额
+        Map<String, Object> environment = new HashMap<>();
+        Matcher matcher = CASH_FLOW_PARAM_PATTERN.matcher(expression);
+        StringBuffer normalizedExpression = new StringBuffer();
+        while (matcher.find()) {
+            String param = matcher.group();
+            String variable = param.replace("[", "_").replace(",", "_").replace("]", "");
+            environment.put(variable, getCashFlowParamValue(
+                    param, balanceMap, incomeMap, adjustmentMap, lineMap, current));
+            matcher.appendReplacement(normalizedExpression, variable);
+        }
+        matcher.appendTail(normalizedExpression);
+        // 2. 校验替换后的表达式只含合法字符，避免公式被注入任意代码
+        if (!CASH_FLOW_EXPRESSION_PATTERN.matcher(normalizedExpression).matches()) {
+            return BigDecimal.ZERO;
+        }
+        // 3. 交由 Aviator 计算表达式结果
+        Object value = AviatorEvaluator.execute(normalizedExpression.toString(), environment);
+        return value == null ? BigDecimal.ZERO : new BigDecimal(value.toString());
+    }
+
+    /**
+     * 判断现金流量表项目是否允许调整金额
+     *
+     * 表头没有行次，汇总行使用 L 行次公式，两类项目都由系统自动计算
+     *
+     * @param report 现金流量表项目
+     * @return 是否允许调整金额
+     */
+    private boolean isAmountAdjustable(FmsCashFlowStatementReportDO report) {
+        return report.getRowNo() != null && report.getRowNo() > 0
+                && !reportCommonService.isLineFormula(report.getFormula());
+    }
+
+    /**
+     * 获得跨报表表达式单个参数的取数金额，参数缺失时按零处理
+     *
+     * @param param 参数，例如 BA[1,2]、IN32、EX4、L7
+     * @param balanceMap 资产负债行次到报表项目的 Map
+     * @param incomeMap 利润表行次到报表项目的 Map
+     * @param adjustmentMap 辅助数据行次到项目的 Map
+     * @param lineMap 行次到已计算报表项目的 Map
+     * @param current 是否取本期金额，否则取本年累计金额
+     * @return 金额
+     */
+    private BigDecimal getCashFlowParamValue(String param,
+            Map<Integer, FmsReportItemRespVO> balanceMap,
+            Map<Integer, FmsReportItemRespVO> incomeMap,
+            Map<Integer, FmsCashFlowAdjustmentRespVO> adjustmentMap,
+            Map<Integer, FmsReportItemRespVO> lineMap, boolean current) {
+        FmsCashFlowParamTypeEnum paramType = FmsCashFlowParamTypeEnum.of(param);
+        if (paramType == null) {
+            return BigDecimal.ZERO;
+        }
+        // BA[行次,1期初|2期末]：资产负债行次金额
+        if (paramType == FmsCashFlowParamTypeEnum.BALANCE) {
+            String[] parts = param.substring(paramType.getPrefix().length() + 1, param.length() - 1).split(",");
+            FmsReportItemRespVO item = balanceMap.get(Integer.valueOf(parts[0]));
+            if (item == null) {
+                return BigDecimal.ZERO;
+            }
+            return "1".equals(parts[1]) ? NumberUtils.zeroIfNull(item.getOpeningAmount())
+                    : NumberUtils.zeroIfNull(item.getClosingAmount());
+        }
+        // IN行次：利润表行次金额
+        if (paramType == FmsCashFlowParamTypeEnum.INCOME) {
+            FmsReportItemRespVO item = incomeMap.get(
+                    Integer.valueOf(param.substring(paramType.getPrefix().length())));
+            return item == null ? BigDecimal.ZERO : current
+                    ? NumberUtils.zeroIfNull(item.getCurrentAmount())
+                    : NumberUtils.zeroIfNull(item.getYearAmount());
+        }
+        // EX行次：辅助数据行次金额
+        if (paramType == FmsCashFlowParamTypeEnum.EXTEND) {
+            FmsCashFlowAdjustmentRespVO item = adjustmentMap.get(
+                    Integer.valueOf(param.substring(paramType.getPrefix().length())));
+            return item == null ? BigDecimal.ZERO : current
+                    ? NumberUtils.zeroIfNull(item.getCurrentAmount())
+                    : NumberUtils.zeroIfNull(item.getYearAmount());
+        }
+        // L行次：本表已计算行次金额
+        FmsReportItemRespVO item = lineMap.get(
+                Integer.valueOf(param.substring(paramType.getPrefix().length())));
+        return item == null ? BigDecimal.ZERO : current
+                ? NumberUtils.zeroIfNull(item.getCurrentAmount())
+                : NumberUtils.zeroIfNull(item.getYearAmount());
+    }
+
+    /**
+     * 获得现金流量表金额
+     *
+     * 既有财务规则使用非零金额覆盖公式计算结果，保存零值时重新按公式计算
+     *
+     * @param savedAmount 已保存金额
+     * @param calculatedAmount 公式计算金额
+     * @return 现金流量表金额
+     */
+    private BigDecimal getSavedAmount(BigDecimal savedAmount, BigDecimal calculatedAmount) {
+        return NumberUtils.zeroIfNull(savedAmount).signum() != 0 ? savedAmount : calculatedAmount;
+    }
+
+    /**
+     * 将未明确归类的经营活动现金流归入其他经营活动，并重算受其影响的行次公式项目
+     *
+     * 其他经营活动现金 = 期末现金余额 - 资产负债表现金余额的倒挤差额，差额为正时覆盖原计算值
+     *
+     * @param result 现金流量表项目列表
+     * @param lineMap 行次到已计算报表项目的 Map
+     * @param currentBalanceMap 本期资产负债行次到报表项目的 Map
+     * @param yearBalanceMap 本年资产负债行次到报表项目的 Map
+     * @param adjustmentMap 辅助数据行次到项目的 Map
+     */
+    private void reconcileCashFlow(List<FmsReportItemRespVO> result,
+            Map<Integer, FmsReportItemRespVO> lineMap,
+            Map<Integer, FmsReportItemRespVO> currentBalanceMap,
+            Map<Integer, FmsReportItemRespVO> yearBalanceMap,
+            Map<Integer, FmsCashFlowAdjustmentRespVO> adjustmentMap,
+            Map<Integer, FmsCashFlowStatementReportDO> reportMap) {
+        FmsReportItemRespVO otherOperating = lineMap.get(OTHER_OPERATING_ROW_NO);
+        FmsReportItemRespVO endingCash = lineMap.get(ENDING_CASH_ROW_NO);
+        if (otherOperating == null || endingCash == null) {
+            return;
+        }
+        // 1. 按资产负债表的货币资金期末余额，倒挤其他经营活动现金流
+        FmsReportItemRespVO currentCashItem = currentBalanceMap.get(FmsBalanceSheetServiceImpl.MONETARY_CASH_ROW_NO);
+        FmsReportItemRespVO yearCashItem = yearBalanceMap.get(FmsBalanceSheetServiceImpl.MONETARY_CASH_ROW_NO);
+        BigDecimal currentCash = currentCashItem == null ? BigDecimal.ZERO
+                : NumberUtils.zeroIfNull(currentCashItem.getClosingAmount());
+        BigDecimal yearCash = yearCashItem == null ? BigDecimal.ZERO
+                : NumberUtils.zeroIfNull(yearCashItem.getClosingAmount());
+        BigDecimal currentAmount = NumberUtils.zeroIfNull(otherOperating.getCurrentAmount())
+                .add(NumberUtils.zeroIfNull(endingCash.getCurrentAmount())).subtract(currentCash);
+        BigDecimal yearAmount = NumberUtils.zeroIfNull(otherOperating.getYearAmount())
+                .add(NumberUtils.zeroIfNull(endingCash.getYearAmount())).subtract(yearCash);
+        // 2. 倒挤差额为正时，覆盖其他经营活动的原计算值
+        FmsCashFlowStatementReportDO otherOperatingReport = reportMap.get(OTHER_OPERATING_ROW_NO);
+        if (currentAmount.signum() > 0
+                && NumberUtils.zeroIfNull(otherOperatingReport.getCurrentAmount()).signum() == 0) {
+            otherOperating.setCurrentAmount(currentAmount);
+        }
+        if (yearAmount.signum() > 0
+                && NumberUtils.zeroIfNull(otherOperatingReport.getYearAmount()).signum() == 0) {
+            otherOperating.setYearAmount(yearAmount);
+        }
+        // 3. 重算其他经营活动之后的行次公式项目，使净额和余额联动更新
+        for (FmsReportItemRespVO item : result) {
+            if (item.getRowNo() == null || item.getRowNo() <= OTHER_OPERATING_ROW_NO
+                    || !reportCommonService.isLineFormula(item.getFormula())) {
+                continue;
+            }
+            item.setCurrentAmount(calculateCashFlowFormula(item.getFormula(), currentBalanceMap,
+                            Collections.emptyMap(), adjustmentMap, lineMap, true))
+                    .setYearAmount(calculateCashFlowFormula(item.getFormula(), yearBalanceMap,
+                            Collections.emptyMap(), adjustmentMap, lineMap, false));
+            lineMap.put(item.getRowNo(), item);
+        }
+    }
+
+    /**
+     * 获得账套的现金流量表配置，首次查询时按报表模板初始化
+     *
+     * @param accountSetId 账套编号
+     * @return 报表配置列表
+     */
+    private List<FmsCashFlowStatementConfigDO> getOrInitCashFlowConfigs(Long accountSetId) {
+        // 1. 已初始化时直接返回
+        List<FmsCashFlowStatementConfigDO> configs = cashFlowStatementConfigMapper
+                .selectListByAccountSetId(accountSetId);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 2. 锁定账套后二次查询，避免并发首次查询重复初始化
+        accountSetService.lockAccountSet(accountSetId);
+        configs = cashFlowStatementConfigMapper.selectListByAccountSetId(accountSetId);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 3. 按报表模板初始化，模板为空时返回空列表
+        List<FmsReportTemplateDO> templates = reportTemplateMapper.selectListByType(
+                FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType());
+        if (CollUtil.isEmpty(templates)) {
+            return Collections.emptyList();
+        }
+        // 4. 现金流量表公式使用跨报表表达式，不涉及科目绑定，直接复制模板配置
+        configs = convertList(templates, template -> BeanUtils.toBean(template,
+                        FmsCashFlowStatementConfigDO.class).setId(null).setAccountSetId(accountSetId));
+        cashFlowStatementConfigMapper.insertBatch(configs);
+        return configs;
+    }
+
+    /**
+     * 获得查询期间的报表快照，首次查询该期间时按当前配置创建
+     *
+     * @param listReqVO 查询条件
+     * @param configs 报表配置列表
+     * @return 报表快照列表
+     */
+    private List<FmsCashFlowStatementReportDO> getOrCreateCashFlowReports(
+            FmsReportListReqVO listReqVO, List<FmsCashFlowStatementConfigDO> configs) {
+        // 1. 已生成快照时直接返回；配置为空时不生成
+        Integer fromPeriod = reportCommonService.parsePeriod(listReqVO.getStartMonth());
+        Integer toPeriod = reportCommonService.parsePeriod(listReqVO.getEndMonth());
+        Integer periodType = reportCommonService.getPeriodType(fromPeriod, toPeriod);
+        List<FmsCashFlowStatementReportDO> reports = cashFlowStatementReportMapper.selectListByPeriod(
+                listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType);
+        if (CollUtil.isNotEmpty(reports) || CollUtil.isEmpty(configs)) {
+            return reports;
+        }
+        // 2. 锁定账套后二次查询，避免并发首次查询重复生成期间快照
+        accountSetService.lockAccountSet(listReqVO.getAccountSetId());
+        reports = cashFlowStatementReportMapper.selectListByPeriod(
+                listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType);
+        if (CollUtil.isNotEmpty(reports)) {
+            return reports;
+        }
+        // 3. 按当前配置创建期间快照，金额初始化为零
+        reports = convertList(configs, config -> BeanUtils.toBean(config, FmsCashFlowStatementReportDO.class)
+                .setId(null).setFromPeriod(fromPeriod).setToPeriod(toPeriod).setType(periodType)
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO));
+        cashFlowStatementReportMapper.insertBatch(reports);
+        return reports;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementService.java
new file mode 100644
index 0000000..5ea2b17
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementService.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.income.FmsIncomeStatementCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+
+import java.util.List;
+
+/**
+ * FMS 利润表 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsIncomeStatementService {
+
+    /**
+     * 获得利润表
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 利润表
+     */
+    List<FmsReportItemRespVO> getIncomeStatement(FmsReportListReqVO listReqVO, Long userId);
+
+    /**
+     * 检查利润表与资产负债表的勾稽关系和公式覆盖状态
+     *
+     * @param listReqVO 查询条件
+     * @param userId 用户编号
+     * @return 检查结果
+     */
+    FmsIncomeStatementCheckRespVO checkIncomeStatement(FmsReportListReqVO listReqVO, Long userId);
+
+    /**
+     * 更新利润表公式
+     *
+     * @param updateReqVO 公式信息
+     * @param userId 用户编号
+     */
+    void updateIncomeStatementFormula(FmsReportFormulaUpdateReqVO updateReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementServiceImpl.java
new file mode 100644
index 0000000..1ac5cbb
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementServiceImpl.java
@@ -0,0 +1,290 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetRowRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.income.FmsIncomeStatementCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.FmsReportTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.income.FmsIncomeStatementConfigDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.income.FmsIncomeStatementReportDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.FmsReportTemplateMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.income.FmsIncomeStatementConfigMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.income.FmsIncomeStatementReportMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsReportTypeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_CONFIG_NOT_EXISTS;
+
+/**
+ * FMS 利润表 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsIncomeStatementServiceImpl implements FmsIncomeStatementService {
+
+    /**
+     * 利润表净利润行次
+     */
+    private static final int NET_PROFIT_ROW_NO = 32;
+    /**
+     * 资产负债表未分配利润行次
+     */
+    private static final int RETAINED_EARNINGS_ROW_NO = 51;
+    /**
+     * 以前年度损益调整等科目编码前缀，不纳入利润表公式覆盖检查
+     */
+    private static final String EXCLUDED_PROFIT_LOSS_CODE_PREFIX = "6";
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    private FmsReportCommonService reportCommonService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsBalanceSheetService balanceSheetService;
+    @Resource
+    private FmsReportTemplateMapper reportTemplateMapper;
+    @Resource
+    private FmsIncomeStatementConfigMapper incomeStatementConfigMapper;
+    @Resource
+    private FmsIncomeStatementReportMapper incomeStatementReportMapper;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<FmsReportItemRespVO> getIncomeStatement(FmsReportListReqVO listReqVO, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(listReqVO.getAccountSetId(), userId);
+        // 1.2 加载科目并初始化报表配置
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO.getAccountSetId(), null, userId);
+        List<FmsIncomeStatementConfigDO> configs = getOrInitIncomeConfigs(listReqVO.getAccountSetId(), subjects);
+        List<FmsIncomeStatementReportDO> reports = getOrCreateIncomeReports(listReqVO, configs);
+
+        // 2. 查询本期和本年科目发生额
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = reportCommonService.getSubjectBalanceMap(
+                listReqVO.getAccountSetId(), LocalDateTimeUtils.parseYearMonth(listReqVO.getStartMonth()),
+                LocalDateTimeUtils.parseYearMonth(listReqVO.getEndMonth()), userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+
+        // 3. 计算报表项目
+        Map<Integer, FmsReportItemRespVO> lineMap = new LinkedHashMap<>();
+        List<FmsReportItemRespVO> result = new ArrayList<>();
+        for (FmsIncomeStatementReportDO report : reports) {
+            FmsIncomeStatementConfigDO config = BeanUtils.toBean(report, FmsIncomeStatementConfigDO.class);
+            FmsReportItemRespVO item = buildIncomeItem(config, subjectMap, balanceMap, lineMap);
+            if (config.getRowNo() != null && config.getRowNo() > 0) {
+                lineMap.put(config.getRowNo(), item);
+            }
+            result.add(item);
+        }
+        return result;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public FmsIncomeStatementCheckRespVO checkIncomeStatement(FmsReportListReqVO listReqVO, Long userId) {
+        // 1. 检查利润表与资产负债表的勾稽关系：净利润本年累计应等于未分配利润变动
+        List<FmsReportItemRespVO> incomeItems = getIncomeStatement(listReqVO, userId);
+        FmsReportItemRespVO netProfitItem = CollUtil.findOne(incomeItems,
+                item -> ObjUtil.equal(item.getRowNo(), NET_PROFIT_ROW_NO));
+        List<FmsBalanceSheetRowRespVO> balanceRows = balanceSheetService.getBalanceSheet(listReqVO, userId);
+        FmsBalanceSheetRowRespVO retainedEarningsRow = CollUtil.findOne(balanceRows,
+                row -> ObjUtil.equal(row.getLiabilityRowNo(), RETAINED_EARNINGS_ROW_NO));
+        BigDecimal retainedEarningsChange = NumberUtils.zeroIfNull(retainedEarningsRow == null
+                ? null : retainedEarningsRow.getLiabilityClosingAmount()).subtract(NumberUtils.zeroIfNull(
+                        retainedEarningsRow == null ? null : retainedEarningsRow.getLiabilityOpeningAmount()));
+        BigDecimal differenceAmount = NumberUtils.zeroIfNull(
+                netProfitItem == null ? null : netProfitItem.getYearAmount()).subtract(retainedEarningsChange);
+
+        // 2. 检查未纳入利润表公式的一级损益类科目
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(listReqVO.getAccountSetId(), null, userId);
+        Set<Long> formulaSubjectIds = new LinkedHashSet<>();
+        for (FmsReportItemRespVO item : incomeItems) {
+            formulaSubjectIds.addAll(reportCommonService.parseFormulaSubjectIds(item.getFormula()));
+        }
+        List<FmsIncomeStatementCheckRespVO.UnmappedSubject> unmappedSubjects = new ArrayList<>();
+        for (FmsSubjectDO subject : subjects) {
+            // 一级损益类科目未纳入公式时需要提示补充；以前年度损益调整等 6 开头科目除外
+            if (!reportCommonService.isRootSubject(subject)
+                    || ObjUtil.notEqual(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                    || StrUtil.startWith(subject.getCode(), EXCLUDED_PROFIT_LOSS_CODE_PREFIX)
+                    || reportCommonService.isSubjectTreeMapped(subject, subjects, formulaSubjectIds)) {
+                continue;
+            }
+            unmappedSubjects.add(new FmsIncomeStatementCheckRespVO.UnmappedSubject()
+                    .setId(subject.getId()).setCode(subject.getCode()).setName(subject.getName()));
+        }
+        return new FmsIncomeStatementCheckRespVO().setBalanced(differenceAmount.signum() == 0)
+                .setDifferenceAmount(differenceAmount).setUnmappedSubjects(unmappedSubjects);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @SuppressWarnings("DataFlowIssue")
+    public void updateIncomeStatementFormula(FmsReportFormulaUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验报表项目
+        FmsIncomeStatementReportDO report = incomeStatementReportMapper.selectById(updateReqVO.getId());
+        reportCommonService.validateReportItemEditable(updateReqVO.getAccountSetId(),
+                report == null ? null : report.getAccountSetId(), report == null ? null : report.getEditable());
+        // 2. 校验并构造利润表公式
+        List<FmsReportFormulaRespVO> formulas = reportCommonService.buildReportFormulaList(updateReqVO,
+                FmsFormulaRuleEnum.DEBIT_AMOUNT.getRule(), FmsFormulaRuleEnum.PROFIT_LOSS_AMOUNT.getRule(), userId);
+
+        // 3. 只更新当前期间报表快照，后续期间仍使用基础配置
+        incomeStatementReportMapper.updateById(new FmsIncomeStatementReportDO().setId(report.getId())
+                .setFormula(JsonUtils.toJsonString(formulas)));
+    }
+
+    /**
+     * 计算报表项目的本期和本年累计金额
+     *
+     * 行次公式直接引用已计算的行次金额；科目公式逐项取数并按运算符累加，取数结果回写公式项用于前端展示
+     *
+     * @param config 报表配置
+     * @param subjectMap 科目编号到科目的 Map
+     * @param balanceMap 科目编号到余额的 Map
+     * @param lineMap 行次到已计算报表项目的 Map
+     * @return 报表项目
+     */
+    private FmsReportItemRespVO buildIncomeItem(FmsIncomeStatementConfigDO config,
+            Map<Long, FmsSubjectDO> subjectMap, Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap,
+            Map<Integer, FmsReportItemRespVO> lineMap) {
+        FmsReportItemRespVO item = new FmsReportItemRespVO().setId(config.getId()).setName(config.getName())
+                .setRowNo(config.getRowNo()).setLevel(config.getLevel()).setEditable(config.getEditable())
+                .setFormula(config.getFormula()).setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO);
+        // 行次公式直接引用前面已计算的行次金额，例如 ["L1-L2"]
+        if (reportCommonService.isLineFormula(config.getFormula())) {
+            item.setCurrentAmount(reportCommonService.calculateItemLineFormula(
+                            config.getFormula(), lineMap, false, true))
+                    .setYearAmount(reportCommonService.calculateItemLineFormula(
+                            config.getFormula(), lineMap, false, false));
+            return item;
+        }
+        // 科目公式逐项取数，按运算符累加到本期、本年累计金额
+        List<FmsReportFormulaRespVO> formulas = reportCommonService.parseSubjectFormula(config.getFormula());
+        for (FmsReportFormulaRespVO formula : formulas) {
+            FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(formula.getSubjectId());
+            FmsSubjectDO subject = subjectMap.get(formula.getSubjectId());
+            reportCommonService.normalizeSubjectFormula(formula, subject);
+            BigDecimal currentAmount = reportCommonService.calculateIncomeOccurrenceAmount(
+                    formula.getRules(), subject, balance, true, formula.getOperator());
+            BigDecimal yearAmount = reportCommonService.calculateIncomeOccurrenceAmount(
+                    formula.getRules(), subject, balance, false, formula.getOperator());
+            formula.setCurrentAmount(currentAmount).setYearAmount(yearAmount);
+            item.setCurrentAmount(reportCommonService.applyOperator(
+                            item.getCurrentAmount(), currentAmount, formula.getOperator()))
+                    .setYearAmount(reportCommonService.applyOperator(
+                            item.getYearAmount(), yearAmount, formula.getOperator()));
+        }
+        // 回写含取数结果的公式，供前端公式编辑弹窗展示各项金额
+        item.setFormula(JsonUtils.toJsonString(formulas));
+        return item;
+    }
+
+    /**
+     * 获得账套的报表配置，首次查询时按报表模板初始化
+     *
+     * 初始化时将模板公式中的科目编码绑定为账套下的科目编号，编码不存在的科目编号置空
+     *
+     * @param accountSetId 账套编号
+     * @param subjects 账套下的科目列表
+     * @return 报表配置列表
+     */
+    private List<FmsIncomeStatementConfigDO> getOrInitIncomeConfigs(
+            Long accountSetId, List<FmsSubjectDO> subjects) {
+        // 1. 已初始化时直接返回
+        List<FmsIncomeStatementConfigDO> configs = incomeStatementConfigMapper.selectListByAccountSetId(accountSetId);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 2. 锁定账套后二次查询，避免并发首次查询重复初始化
+        accountSetService.lockAccountSet(accountSetId);
+        configs = incomeStatementConfigMapper.selectListByAccountSetId(accountSetId);
+        if (CollUtil.isNotEmpty(configs)) {
+            return configs;
+        }
+        // 3. 按报表模板初始化，模板为空时返回空列表
+        List<FmsReportTemplateDO> templates = reportTemplateMapper.selectListByType(
+                FmsReportTypeEnum.INCOME_STATEMENT.getType());
+        if (CollUtil.isEmpty(templates)) {
+            return Collections.emptyList();
+        }
+        // 4. 模板公式中的科目编码绑定为账套下的科目编号后批量插入
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode,
+                Function.identity(), (first, second) -> first);
+        configs = convertList(templates, template -> BeanUtils.toBean(template, FmsIncomeStatementConfigDO.class)
+                .setId(null).setAccountSetId(accountSetId)
+                .setFormula(reportCommonService.bindSubjectFormula(template.getFormula(), subjectMap)));
+        incomeStatementConfigMapper.insertBatch(configs);
+        return configs;
+    }
+
+    /**
+     * 获得查询期间的报表快照，首次查询该期间时按当前配置创建
+     *
+     * @param listReqVO 查询条件
+     * @param configs 报表配置列表
+     * @return 报表快照列表
+     */
+    private List<FmsIncomeStatementReportDO> getOrCreateIncomeReports(
+            FmsReportListReqVO listReqVO, List<FmsIncomeStatementConfigDO> configs) {
+        // 1. 已生成快照时直接返回；配置为空时不生成
+        Integer fromPeriod = reportCommonService.parsePeriod(listReqVO.getStartMonth());
+        Integer toPeriod = reportCommonService.parsePeriod(listReqVO.getEndMonth());
+        Integer periodType = reportCommonService.getPeriodType(fromPeriod, toPeriod);
+        List<FmsIncomeStatementReportDO> reports = incomeStatementReportMapper.selectListByPeriod(
+                listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType);
+        if (CollUtil.isNotEmpty(reports) || CollUtil.isEmpty(configs)) {
+            return reports;
+        }
+        // 2. 锁定账套后二次查询，避免并发首次查询重复生成期间快照
+        accountSetService.lockAccountSet(listReqVO.getAccountSetId());
+        reports = incomeStatementReportMapper.selectListByPeriod(
+                listReqVO.getAccountSetId(), fromPeriod, toPeriod, periodType);
+        if (CollUtil.isNotEmpty(reports)) {
+            return reports;
+        }
+        // 3. 按当前配置创建期间快照，金额初始化为零、未结账
+        reports = convertList(configs, config -> BeanUtils.toBean(config, FmsIncomeStatementReportDO.class)
+                .setId(null).setFromPeriod(fromPeriod).setToPeriod(toPeriod).setType(periodType)
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO).setSettled(false));
+        incomeStatementReportMapper.insertBatch(reports);
+        return reports;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonService.java
new file mode 100644
index 0000000..d1a85fb
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonService.java
@@ -0,0 +1,203 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * FMS 报表共用 Service 接口
+ *
+ * 负责资产负债、利润和现金流量三大报表共用的账簿余额查询、报表公式解析计算和公式覆盖检查
+ *
+ * @author 芋道源码
+ */
+public interface FmsReportCommonService {
+
+    /**
+     * 获得指定月份区间的科目余额 Map，树形余额扁平化后按科目编号唯一存放
+     *
+     * @param accountSetId 账套编号
+     * @param startMonth 开始月份
+     * @param endMonth 结束月份
+     * @param userId 用户编号
+     * @return 科目编号到余额的 Map
+     */
+    Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(Long accountSetId,
+            YearMonth startMonth, YearMonth endMonth, Long userId);
+
+    /**
+     * 校验并构造报表公式项，公式项中的科目必须存在且不重复
+     *
+     * @param updateReqVO 公式更新请求
+     * @param minimumRule 允许的最小取数规则
+     * @param maximumRule 允许的最大取数规则
+     * @param userId 用户编号
+     * @return 报表公式项
+     */
+    List<FmsReportFormulaRespVO> buildReportFormulaList(FmsReportFormulaUpdateReqVO updateReqVO,
+            Integer minimumRule, Integer maximumRule, Long userId);
+
+    /**
+     * 校验报表项目属于当前账套且允许编辑公式
+     *
+     * @param accountSetId 账套编号
+     * @param itemAccountSetId 报表项目的账套编号
+     * @param editable 报表项目是否可编辑
+     */
+    void validateReportItemEditable(Long accountSetId, Long itemAccountSetId, Boolean editable);
+
+    /**
+     * 将模板公式中的科目编码绑定为账套下的科目编号和名称，编码不存在时科目编号置空
+     *
+     * @param formula 模板公式
+     * @param subjectMap 科目编码到科目的 Map
+     * @return 绑定后的公式
+     */
+    String bindSubjectFormula(String formula, Map<String, FmsSubjectDO> subjectMap);
+
+    /**
+     * 解析科目公式，空公式返回空列表
+     *
+     * @param formula 公式
+     * @return 公式项列表
+     */
+    List<FmsReportFormulaRespVO> parseSubjectFormula(String formula);
+
+    /**
+     * 解析科目公式中的科目编号集合，空公式和行次公式返回空集合
+     *
+     * @param formula 公式
+     * @return 科目编号集合
+     */
+    Set<Long> parseFormulaSubjectIds(String formula);
+
+    /**
+     * 判断一级科目自身或下级科目是否已纳入报表公式
+     *
+     * @param rootSubject 一级科目
+     * @param subjects 科目列表
+     * @param formulaSubjectIds 公式中的科目编号集合
+     * @return 是否已纳入报表公式
+     */
+    boolean isSubjectTreeMapped(FmsSubjectDO rootSubject, List<FmsSubjectDO> subjects,
+            Set<Long> formulaSubjectIds);
+
+    /**
+     * 判断是否为一级科目
+     *
+     * @param subject 科目
+     * @return 是否一级科目
+     */
+    boolean isRootSubject(FmsSubjectDO subject);
+
+    /**
+     * 判断是否为行次公式，例如 ["L1-L2"]
+     *
+     * @param formula 公式
+     * @return 是否行次公式
+     */
+    boolean isLineFormula(String formula);
+
+    /**
+     * 按运算符累加或扣减金额
+     *
+     * @param result 累计结果
+     * @param amount 金额
+     * @param operator 运算符
+     * @return 计算结果
+     */
+    BigDecimal applyOperator(BigDecimal result, BigDecimal amount, String operator);
+
+    /**
+     * 将公式项的科目名称和编码刷新为科目当前值
+     *
+     * @param formula 公式项
+     * @param subject 科目
+     */
+    void normalizeSubjectFormula(FmsReportFormulaRespVO formula, FmsSubjectDO subject);
+
+    /**
+     * 计算余额类取数规则的金额，按科目余额方向决定借贷相减的方向
+     *
+     * @param rule 取数规则
+     * @param subject 科目
+     * @param balanceMap 科目编号到余额的 Map
+     * @param subjectMap 科目编号到科目的 Map
+     * @param opening 是否取期初余额，否则取期末余额
+     * @return 金额
+     */
+    BigDecimal calculateBalanceAmount(Integer rule, FmsSubjectDO subject,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap,
+            Map<Long, FmsSubjectDO> subjectMap, boolean opening);
+
+    /**
+     * 计算发生额类取数规则的金额，损益发生额按科目余额方向决定借贷相减的方向
+     *
+     * @param rule 取数规则
+     * @param subject 科目
+     * @param balance 科目余额
+     * @param current 是否取本期发生额，否则取本年累计发生额
+     * @return 金额
+     */
+    BigDecimal calculateOccurrenceAmount(Integer rule, FmsSubjectDO subject,
+            FmsLedgerSubjectBalanceRespVO balance, boolean current);
+
+    /**
+     * 计算利润表发生额，正向公式项按既有业务语义抵减反方向发生额
+     *
+     * @param rule 取数规则
+     * @param subject 科目
+     * @param balance 科目余额
+     * @param current 是否取本期发生额，否则取本年累计发生额
+     * @param operator 运算符
+     * @return 金额
+     */
+    BigDecimal calculateIncomeOccurrenceAmount(Integer rule, FmsSubjectDO subject,
+            FmsLedgerSubjectBalanceRespVO balance, boolean current, String operator);
+
+    /**
+     * 计算报表项目的行次公式金额，例如 ["L1-L2"]
+     *
+     * @param formula 行次公式
+     * @param lineMap 行次到报表项目的 Map
+     * @param opening 是否取期初金额
+     * @param current 非期初时是否取本期金额，否则取本年累计或期末金额
+     * @return 金额
+     */
+    BigDecimal calculateItemLineFormula(String formula, Map<Integer, FmsReportItemRespVO> lineMap,
+            boolean opening, boolean current);
+
+    /**
+     * 解析行次公式表达式数组
+     *
+     * @param formula 行次公式
+     * @return 表达式列表
+     */
+    List<String> parseLineFormula(String formula);
+
+    /**
+     * 解析会计期间，格式为 yyyyMM
+     *
+     * @param month 月份，格式为 yyyy-MM
+     * @return 会计期间
+     */
+    Integer parsePeriod(String month);
+
+    /**
+     * 获得报表期间类型，开始和结束期间相同为月度，否则为季度
+     *
+     * @param fromPeriod 开始会计期间
+     * @param toPeriod 结束会计期间
+     * @return 报表期间类型
+     */
+    Integer getPeriodType(Integer fromPeriod, Integer toPeriod);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonServiceImpl.java
new file mode 100644
index 0000000..92fb620
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonServiceImpl.java
@@ -0,0 +1,504 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.date.DatePattern;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSubjectAmountVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsReportPeriodTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.LEDGER_PERIOD_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_CONFIG_NOT_EDITABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_CONFIG_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_FORMULA_OPERATOR_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_FORMULA_RULE_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_FORMULA_SUBJECT_DUPLICATE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.SUBJECT_NOT_EXISTS;
+
+/**
+ * FMS 报表共用 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsReportCommonServiceImpl implements FmsReportCommonService {
+
+    private static final DateTimeFormatter MONTH_FORMATTER = DatePattern.NORM_MONTH_FORMATTER;
+    private static final Pattern LINE_FORMULA_PATTERN = Pattern.compile("([+-]?)(L\\d+)");
+
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsLedgerService ledgerService;
+    @Resource
+    @Lazy // 避免循环依赖
+    private FmsClosingSchemeService closingSchemeService;
+    @Resource
+    @Lazy // 避免循环依赖
+    private FmsClosingVoucherService closingVoucherService;
+    @Resource
+    @Lazy // 避免循环依赖
+    private FmsVoucherService voucherService;
+
+    @Override
+    public Map<Long, FmsLedgerSubjectBalanceRespVO> getSubjectBalanceMap(Long accountSetId,
+            YearMonth startMonth, YearMonth endMonth, Long userId) {
+        // 1. 查询普通账簿科目余额
+        FmsLedgerListReqVO listReqVO = new FmsLedgerListReqVO().setAccountSetId(accountSetId)
+                .setStartMonth(startMonth.format(MONTH_FORMATTER))
+                .setEndMonth(endMonth.format(MONTH_FORMATTER));
+        List<FmsLedgerSubjectBalanceRespVO> balances = flattenBalances(ledgerService.getSubjectBalanceList(listReqVO, userId));
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = convertMap(
+                balances, FmsLedgerSubjectBalanceRespVO::getSubjectId, Function.identity(),
+                (first, second) -> first, LinkedHashMap::new);
+
+        // 2. 查询结转损益凭证在期初、本期和本年的科目发生额
+        LocalDateTime startTime = LocalDateTimeUtils.getMonthBeginTime(startMonth);
+        LocalDateTime endTime = LocalDateTimeUtils.getNextMonthBeginTime(endMonth);
+        LocalDateTime yearBeginTime = LocalDateTimeUtils.getMonthBeginTime(endMonth.getYear(), 1);
+        FmsClosingSchemeDO profitLossClosing = closingSchemeService.getClosingSchemeByAccountSetIdAndType(
+                accountSetId, FmsClosingTypeEnum.PROFIT_LOSS.getType());
+        if (profitLossClosing == null) {
+            return balanceMap;
+        }
+        List<FmsClosingVoucherDO> closingVouchers = closingVoucherService
+                .getClosingVoucherListByClosingIdAndPeriod(profitLossClosing.getId(), null, endTime);
+        List<FmsVoucherSubjectAmountVO> openingAmounts = getProfitLossClosingSubjectAmountList(
+                closingVouchers, null, startTime);
+        List<FmsVoucherSubjectAmountVO> periodAmounts = getProfitLossClosingSubjectAmountList(
+                closingVouchers, startTime, endTime);
+        List<FmsVoucherSubjectAmountVO> yearAmounts = getProfitLossClosingSubjectAmountList(
+                closingVouchers, yearBeginTime, endTime);
+
+        // 3. 从损益类科目及其父级余额中扣除结转损益凭证发生额
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(
+                subjectService.getSubjectList(accountSetId, null, userId), FmsSubjectDO::getId);
+        adjustProfitLossClosingAmounts(balanceMap, subjectMap, openingAmounts, periodAmounts, yearAmounts);
+        return balanceMap;
+    }
+
+    /**
+     * 获得指定期间内损益结转凭证的科目发生额
+     *
+     * @param closingVouchers 损益结转凭证关联列表
+     * @param beginTime 开始时间，为空时不限制
+     * @param endTime 结束时间
+     * @return 科目发生额列表
+     */
+    private List<FmsVoucherSubjectAmountVO> getProfitLossClosingSubjectAmountList(
+            List<FmsClosingVoucherDO> closingVouchers, LocalDateTime beginTime, LocalDateTime endTime) {
+        // 1. 按期间筛选损益结转凭证编号
+        List<FmsClosingVoucherDO> periodClosingVouchers = filterList(closingVouchers,
+                item -> (beginTime == null || !item.getVoucherTime().isBefore(beginTime))
+                        && item.getVoucherTime().isBefore(endTime));
+        // 2. 按关联凭证编号聚合科目发生额
+        return voucherService.getVoucherSubjectAmountList(
+                convertList(periodClosingVouchers, FmsClosingVoucherDO::getVoucherId));
+    }
+
+    /**
+     * 从报表余额中扣除结转损益凭证发生额
+     *
+     * 只处理损益类科目，并同步调整其父级汇总；普通结转凭证和非损益结转科目保持原余额
+     *
+     * @param balanceMap 科目余额 Map
+     * @param subjectMap 科目 Map
+     * @param openingAmounts 期初前发生额
+     * @param periodAmounts 本期发生额
+     * @param yearAmounts 本年发生额
+     */
+    private void adjustProfitLossClosingAmounts(Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap, Map<Long, FmsSubjectDO> subjectMap,
+                                                List<FmsVoucherSubjectAmountVO> openingAmounts, List<FmsVoucherSubjectAmountVO> periodAmounts,
+                                                List<FmsVoucherSubjectAmountVO> yearAmounts) {
+        // 1. 按科目编号建立各期间结转损益发生额索引
+        Map<Long, FmsVoucherSubjectAmountVO> openingAmountMap = convertMap(openingAmounts, FmsVoucherSubjectAmountVO::getSubjectId);
+        Map<Long, FmsVoucherSubjectAmountVO> periodAmountMap = convertMap(periodAmounts, FmsVoucherSubjectAmountVO::getSubjectId);
+        Map<Long, FmsVoucherSubjectAmountVO> yearAmountMap = convertMap(yearAmounts, FmsVoucherSubjectAmountVO::getSubjectId);
+        // 2. 从损益科目及其父级汇总余额中逐级扣除结转发生额
+        for (FmsSubjectDO subject : subjectMap.values()) {
+            if (ObjUtil.notEqual(subject.getType(), FmsSubjectTypeEnum.PROFIT_LOSS.getType())) {
+                continue;
+            }
+            FmsVoucherSubjectAmountVO openingAmount = openingAmountMap.get(subject.getId());
+            FmsVoucherSubjectAmountVO periodAmount = periodAmountMap.get(subject.getId());
+            FmsVoucherSubjectAmountVO yearAmount = yearAmountMap.get(subject.getId());
+            if (openingAmount == null && periodAmount == null && yearAmount == null) {
+                continue;
+            }
+            FmsSubjectDO currentSubject = subject;
+            for (int level = 0; currentSubject != null && level < subjectMap.size(); level++) {
+                adjustSubjectBalance(balanceMap.get(currentSubject.getId()), openingAmount, periodAmount, yearAmount);
+                currentSubject = subjectMap.get(currentSubject.getParentId());
+            }
+        }
+    }
+
+    /**
+     * 扣除单个损益科目发生额
+     *
+     * @param balance 科目余额
+     * @param openingAmount 期初前发生额
+     * @param periodAmount 本期发生额
+     * @param yearAmount 本年发生额
+     */
+    private void adjustSubjectBalance(FmsLedgerSubjectBalanceRespVO balance,
+                                      FmsVoucherSubjectAmountVO openingAmount, FmsVoucherSubjectAmountVO periodAmount,
+                                      FmsVoucherSubjectAmountVO yearAmount) {
+        // 1. 账簿中不存在的科目无需调整
+        if (balance == null) {
+            return;
+        }
+        // 2. 扣除结转损益凭证，重新计算期初和期末净余额
+        BigDecimal openingDebitAmount = getDebitAmount(openingAmount);
+        BigDecimal openingCreditAmount = getCreditAmount(openingAmount);
+        BigDecimal periodDebitAmount = getDebitAmount(periodAmount);
+        BigDecimal periodCreditAmount = getCreditAmount(periodAmount);
+        BigDecimal openingBalance = NumberUtils.zeroIfNull(balance.getOpeningDebitAmount())
+                .subtract(NumberUtils.zeroIfNull(balance.getOpeningCreditAmount()))
+                .subtract(openingDebitAmount).add(openingCreditAmount);
+        BigDecimal endingBalance = NumberUtils.zeroIfNull(balance.getEndingDebitAmount())
+                .subtract(NumberUtils.zeroIfNull(balance.getEndingCreditAmount()))
+                .subtract(openingDebitAmount).add(openingCreditAmount)
+                .subtract(periodDebitAmount).add(periodCreditAmount);
+        // 3. 回写期初、本期、本年和期末借贷金额
+        balance.setOpeningDebitAmount(openingBalance.max(BigDecimal.ZERO))
+                .setOpeningCreditAmount(openingBalance.min(BigDecimal.ZERO).abs())
+                .setPeriodDebitAmount(NumberUtils.zeroIfNull(balance.getPeriodDebitAmount()).subtract(periodDebitAmount))
+                .setPeriodCreditAmount(NumberUtils.zeroIfNull(balance.getPeriodCreditAmount()).subtract(periodCreditAmount))
+                .setYearDebitAmount(NumberUtils.zeroIfNull(balance.getYearDebitAmount()).subtract(getDebitAmount(yearAmount)))
+                .setYearCreditAmount(NumberUtils.zeroIfNull(balance.getYearCreditAmount()).subtract(getCreditAmount(yearAmount)))
+                .setEndingDebitAmount(endingBalance.max(BigDecimal.ZERO))
+                .setEndingCreditAmount(endingBalance.min(BigDecimal.ZERO).abs());
+    }
+
+    private BigDecimal getDebitAmount(FmsVoucherSubjectAmountVO amount) {
+        return amount == null ? BigDecimal.ZERO : NumberUtils.zeroIfNull(amount.getDebitAmount());
+    }
+
+    private BigDecimal getCreditAmount(FmsVoucherSubjectAmountVO amount) {
+        return amount == null ? BigDecimal.ZERO : NumberUtils.zeroIfNull(amount.getCreditAmount());
+    }
+
+    @Override
+    public List<FmsReportFormulaRespVO> buildReportFormulaList(FmsReportFormulaUpdateReqVO updateReqVO,
+            Integer minimumRule, Integer maximumRule, Long userId) {
+        // 1. 校验科目不重复
+        List<FmsReportFormulaUpdateReqVO.Formula> formulaReqVOs = updateReqVO.getFormulas();
+        List<Long> subjectIds = convertList(formulaReqVOs, FmsReportFormulaUpdateReqVO.Formula::getSubjectId);
+        if (new LinkedHashSet<>(subjectIds).size() != subjectIds.size()) {
+            throw exception(REPORT_FORMULA_SUBJECT_DUPLICATE);
+        }
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(
+                subjectService.getSubjectList(updateReqVO.getAccountSetId(), null, userId), FmsSubjectDO::getId);
+        // 2. 校验运算符、取数规则和科目存在性，构造公式项
+        List<FmsReportFormulaRespVO> formulas = new ArrayList<>();
+        for (FmsReportFormulaUpdateReqVO.Formula formulaReqVO : formulaReqVOs) {
+            if (!StrUtil.equalsAny(formulaReqVO.getOperator(), "+", "-")) {
+                throw exception(REPORT_FORMULA_OPERATOR_INVALID);
+            }
+            if (formulaReqVO.getRules() == null || formulaReqVO.getRules() < minimumRule
+                    || formulaReqVO.getRules() > maximumRule) {
+                throw exception(REPORT_FORMULA_RULE_INVALID);
+            }
+            FmsSubjectDO subject = subjectMap.get(formulaReqVO.getSubjectId());
+            if (subject == null) {
+                throw exception(SUBJECT_NOT_EXISTS);
+            }
+            formulas.add(new FmsReportFormulaRespVO().setSubjectId(subject.getId())
+                    .setSubjectName(subject.getName()).setSubjectNumber(subject.getCode())
+                    .setOperator(formulaReqVO.getOperator()).setRules(formulaReqVO.getRules()));
+        }
+        return formulas;
+    }
+
+    @Override
+    public void validateReportItemEditable(Long accountSetId, Long itemAccountSetId, Boolean editable) {
+        if (itemAccountSetId == null || ObjUtil.notEqual(accountSetId, itemAccountSetId)) {
+            throw exception(REPORT_CONFIG_NOT_EXISTS);
+        }
+        if (Boolean.FALSE.equals(editable)) {
+            throw exception(REPORT_CONFIG_NOT_EDITABLE);
+        }
+    }
+
+    @Override
+    public String bindSubjectFormula(String formula, Map<String, FmsSubjectDO> subjectMap) {
+        // 空公式和行次公式不含科目编码，直接返回原公式
+        if (StrUtil.isEmpty(formula) || isLineFormula(formula)) {
+            return formula;
+        }
+        // 按科目编码绑定账套下的科目编号和名称，编码不存在时科目编号置空，由前端提示科目已失效
+        List<FmsReportFormulaRespVO> formulas = parseSubjectFormula(formula);
+        formulas.forEach(item -> {
+            FmsSubjectDO subject = subjectMap.get(item.getSubjectNumber());
+            if (subject != null) {
+                item.setSubjectId(subject.getId()).setSubjectName(subject.getName()).setSubjectNumber(subject.getCode());
+            } else {
+                item.setSubjectId(null);
+            }
+        });
+        return JsonUtils.toJsonString(formulas);
+    }
+
+    @Override
+    public List<FmsReportFormulaRespVO> parseSubjectFormula(String formula) {
+        if (StrUtil.isEmpty(formula)) {
+            return new ArrayList<>();
+        }
+        return JsonUtils.parseArray(formula, FmsReportFormulaRespVO.class);
+    }
+
+    @Override
+    public Set<Long> parseFormulaSubjectIds(String formula) {
+        Set<Long> subjectIds = new HashSet<>();
+        if (StrUtil.isEmpty(formula) || !formula.contains("{")) {
+            return subjectIds;
+        }
+        for (FmsReportFormulaRespVO formulaItem : parseSubjectFormula(formula)) {
+            if (formulaItem.getSubjectId() != null) {
+                subjectIds.add(formulaItem.getSubjectId());
+            }
+        }
+        return subjectIds;
+    }
+
+    @Override
+    public boolean isSubjectTreeMapped(FmsSubjectDO rootSubject, List<FmsSubjectDO> subjects, Set<Long> formulaSubjectIds) {
+        // 一级科目自身已纳入公式时直接命中，否则沿公式科目的父级链向上查找
+        if (formulaSubjectIds.contains(rootSubject.getId())) {
+            return true;
+        }
+        // 逐个公式科目沿父级链向上查找，任一祖先为当前一级科目即视为已纳入
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getId);
+        for (Long subjectId : formulaSubjectIds) {
+            FmsSubjectDO currentSubject = subjectMap.get(subjectId);
+            while (currentSubject != null && currentSubject.getParentId() != null
+                    && currentSubject.getParentId() > 0) {
+                if (ObjUtil.equal(currentSubject.getParentId(), rootSubject.getId())) {
+                    return true;
+                }
+                currentSubject = subjectMap.get(currentSubject.getParentId());
+            }
+        }
+        return false;
+    }
+
+    @Override
+    public boolean isRootSubject(FmsSubjectDO subject) {
+        return subject.getParentId() == null || subject.getParentId() == 0;
+    }
+
+    @Override
+    public boolean isLineFormula(String formula) {
+        return StrUtil.isNotEmpty(formula) && formula.contains("L");
+    }
+
+    @Override
+    public BigDecimal applyOperator(BigDecimal result, BigDecimal amount, String operator) {
+        return StrUtil.equals(operator, "-") ? result.subtract(amount) : result.add(amount);
+    }
+
+    @Override
+    public void normalizeSubjectFormula(FmsReportFormulaRespVO formula, FmsSubjectDO subject) {
+        if (subject != null) {
+            formula.setSubjectName(subject.getName()).setSubjectNumber(subject.getCode());
+        }
+    }
+
+    @Override
+    public BigDecimal calculateBalanceAmount(Integer rule, FmsSubjectDO subject,
+            Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap,
+            Map<Long, FmsSubjectDO> subjectMap, boolean opening) {
+        // 科目缺失时按零处理
+        if (subject == null) {
+            return BigDecimal.ZERO;
+        }
+        // 科目借/贷方余额按一级子科目分别判断后求和，避免父科目先净额抵销
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.SUBJECT_DEBIT_BALANCE.getRule())
+                || ObjUtil.equal(rule, FmsFormulaRuleEnum.SUBJECT_CREDIT_BALANCE.getRule())) {
+            List<Long> childSubjectIds = convertList(filterList(subjectMap.values(),
+                    item -> ObjUtil.equal(item.getParentId(), subject.getId())), FmsSubjectDO::getId);
+            if (CollUtil.isEmpty(childSubjectIds)) {
+                childSubjectIds = Collections.singletonList(subject.getId());
+            }
+            boolean debitRule = ObjUtil.equal(rule, FmsFormulaRuleEnum.SUBJECT_DEBIT_BALANCE.getRule());
+            BigDecimal amount = BigDecimal.ZERO;
+            for (Long childSubjectId : childSubjectIds) {
+                FmsLedgerSubjectBalanceRespVO childBalance = balanceMap.get(childSubjectId);
+                if (childBalance == null) {
+                    continue;
+                }
+                BigDecimal childAmount = opening
+                        ? (debitRule ? childBalance.getOpeningDebitAmount() : childBalance.getOpeningCreditAmount())
+                        : (debitRule ? childBalance.getEndingDebitAmount() : childBalance.getEndingCreditAmount());
+                amount = amount.add(NumberUtils.zeroIfNull(childAmount));
+            }
+            return amount;
+        }
+        FmsLedgerSubjectBalanceRespVO balance = balanceMap.get(subject.getId());
+        if (balance == null) {
+            return BigDecimal.ZERO;
+        }
+        // 余额规则按科目余额方向决定借贷相减方向，借方、贷方余额规则直接取对应方向金额
+        BigDecimal debitAmount = opening ? NumberUtils.zeroIfNull(balance.getOpeningDebitAmount())
+                : NumberUtils.zeroIfNull(balance.getEndingDebitAmount());
+        BigDecimal creditAmount = opening ? NumberUtils.zeroIfNull(balance.getOpeningCreditAmount())
+                : NumberUtils.zeroIfNull(balance.getEndingCreditAmount());
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.BALANCE.getRule())) {
+            return ObjUtil.equal(subject.getBalanceDirection(), 1)
+                    ? debitAmount.subtract(creditAmount) : creditAmount.subtract(debitAmount);
+        }
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())) {
+            return debitAmount;
+        }
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.CREDIT_BALANCE.getRule())) {
+            return creditAmount;
+        }
+        return BigDecimal.ZERO;
+    }
+
+    @Override
+    public BigDecimal calculateOccurrenceAmount(Integer rule, FmsSubjectDO subject,
+            FmsLedgerSubjectBalanceRespVO balance, boolean current) {
+        // 余额或科目缺失时按零处理；按取数规则选择本期或本年累计的借贷方向金额
+        if (balance == null || subject == null) {
+            return BigDecimal.ZERO;
+        }
+        // 损益发生额按科目余额方向决定借贷相减方向，借方、贷方发生额规则直接取对应方向金额
+        BigDecimal debitAmount = current ? NumberUtils.zeroIfNull(balance.getPeriodDebitAmount())
+                : NumberUtils.zeroIfNull(balance.getYearDebitAmount());
+        BigDecimal creditAmount = current ? NumberUtils.zeroIfNull(balance.getPeriodCreditAmount())
+                : NumberUtils.zeroIfNull(balance.getYearCreditAmount());
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.DEBIT_AMOUNT.getRule())) {
+            return debitAmount;
+        }
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.CREDIT_AMOUNT.getRule())) {
+            return creditAmount;
+        }
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.PROFIT_LOSS_AMOUNT.getRule())) {
+            return ObjUtil.equal(subject.getBalanceDirection(), 1)
+                    ? debitAmount.subtract(creditAmount) : creditAmount.subtract(debitAmount);
+        }
+        return BigDecimal.ZERO;
+    }
+
+    @Override
+    public BigDecimal calculateIncomeOccurrenceAmount(Integer rule, FmsSubjectDO subject,
+            FmsLedgerSubjectBalanceRespVO balance, boolean current, String operator) {
+        BigDecimal amount = calculateOccurrenceAmount(rule, subject, balance, current);
+        if (subject == null || balance == null || !StrUtil.equals(operator, "+")) {
+            return amount;
+        }
+        BigDecimal debitAmount = current ? NumberUtils.zeroIfNull(balance.getPeriodDebitAmount())
+                : NumberUtils.zeroIfNull(balance.getYearDebitAmount());
+        BigDecimal creditAmount = current ? NumberUtils.zeroIfNull(balance.getPeriodCreditAmount())
+                : NumberUtils.zeroIfNull(balance.getYearCreditAmount());
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.DEBIT_AMOUNT.getRule())) {
+            return debitAmount.subtract(creditAmount);
+        }
+        if (ObjUtil.equal(rule, FmsFormulaRuleEnum.CREDIT_AMOUNT.getRule())) {
+            return creditAmount.subtract(debitAmount);
+        }
+        return amount;
+    }
+
+    @Override
+    public BigDecimal calculateItemLineFormula(String formula, Map<Integer, FmsReportItemRespVO> lineMap,
+            boolean opening, boolean current) {
+        // 逐个匹配 L 行次引用，按运算符累加对应行次金额
+        String expression = CollUtil.getFirst(parseLineFormula(formula));
+        if (StrUtil.isEmpty(expression)) {
+            return BigDecimal.ZERO;
+        }
+        // 按 opening、current 选择行次的期初、本期、本年累计或期末金额，逐个累加
+        BigDecimal result = BigDecimal.ZERO;
+        Matcher matcher = LINE_FORMULA_PATTERN.matcher(expression);
+        while (matcher.find()) {
+            Integer rowNo = Integer.valueOf(matcher.group(2).substring(1));
+            FmsReportItemRespVO item = lineMap.get(rowNo);
+            BigDecimal amount = item == null ? BigDecimal.ZERO : opening
+                    ? NumberUtils.zeroIfNull(item.getOpeningAmount())
+                    : current ? NumberUtils.zeroIfNull(item.getCurrentAmount())
+                    : item.getYearAmount() != null ? NumberUtils.zeroIfNull(item.getYearAmount())
+                    : NumberUtils.zeroIfNull(item.getClosingAmount());
+            result = applyOperator(result, amount, matcher.group(1));
+        }
+        return result;
+    }
+
+    @Override
+    public List<String> parseLineFormula(String formula) {
+        if (StrUtil.isEmpty(formula)) {
+            return new ArrayList<>();
+        }
+        return JsonUtils.parseArray(formula, String.class);
+    }
+
+    @Override
+    public Integer parsePeriod(String month) {
+        return Integer.valueOf(LocalDateTimeUtils.parseYearMonth(month).format(DatePattern.SIMPLE_MONTH_FORMATTER));
+    }
+
+    @Override
+    public Integer getPeriodType(Integer fromPeriod, Integer toPeriod) {
+        if (fromPeriod > toPeriod) {
+            throw exception(LEDGER_PERIOD_INVALID);
+        }
+        return ObjUtil.equal(fromPeriod, toPeriod)
+                ? FmsReportPeriodTypeEnum.MONTH.getType() : FmsReportPeriodTypeEnum.QUARTER.getType();
+    }
+
+    private List<FmsLedgerSubjectBalanceRespVO> flattenBalances(List<FmsLedgerSubjectBalanceRespVO> balances) {
+        List<FmsLedgerSubjectBalanceRespVO> result = new ArrayList<>();
+        for (FmsLedgerSubjectBalanceRespVO balance : balances) {
+            result.add(balance);
+            result.addAll(flattenBalances(balance.getChildren()));
+        }
+        return result;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherService.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherService.java
new file mode 100644
index 0000000..a58b815
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherService.java
@@ -0,0 +1,253 @@
+package cn.iocoder.yudao.module.fms.service.voucher;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherAttachmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportTemplateVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherMoveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSubjectAmountVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherTidyReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+
+/**
+ * FMS 凭证 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface FmsVoucherService {
+
+    /**
+     * 创建凭证
+     *
+     * @param createReqVO 创建信息
+     * @param userId 用户编号
+     * @return 凭证编号
+     */
+    Long createVoucher(FmsVoucherSaveReqVO createReqVO, Long userId);
+
+    /**
+     * 更新凭证
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 用户编号
+     */
+    void updateVoucher(FmsVoucherSaveReqVO updateReqVO, Long userId);
+
+    /**
+     * 更新凭证附件
+     *
+     * @param updateReqVO 更新信息
+     * @param userId 用户编号
+     */
+    void updateVoucherAttachments(FmsVoucherAttachmentUpdateReqVO updateReqVO, Long userId);
+
+    /**
+     * 删除凭证
+     *
+     * @param accountSetId 账套编号
+     * @param ids 凭证编号数组
+     * @param userId 用户编号
+     */
+    void deleteVoucherList(Long accountSetId, List<Long> ids, Long userId);
+
+    /**
+     * 更新凭证审核状态
+     *
+     * @param accountSetId 账套编号
+     * @param ids 凭证编号数组
+     * @param status 审核状态
+     * @param userId 用户编号
+     */
+    void updateVoucherReviewStatus(Long accountSetId, List<Long> ids, Integer status, Long userId);
+
+    /**
+     * 整理凭证号
+     *
+     * @param tidyReqVO 整理信息
+     * @param userId 用户编号
+     */
+    void tidyVoucher(FmsVoucherTidyReqVO tidyReqVO, Long userId);
+
+    /**
+     * 移动凭证号
+     *
+     * @param moveReqVO 移动信息
+     * @param userId 用户编号
+     */
+    void moveVoucher(FmsVoucherMoveReqVO moveReqVO, Long userId);
+
+    /**
+     * 获得凭证
+     *
+     * @param accountSetId 账套编号
+     * @param id 凭证编号
+     * @param userId 用户编号
+     * @return 凭证
+     */
+    FmsVoucherDO getVoucher(Long accountSetId, Long id, Long userId);
+
+    /**
+     * 获得凭证分页
+     *
+     * @param pageReqVO 分页查询条件
+     * @param userId 用户编号
+     * @return 凭证分页
+     */
+    PageResult<FmsVoucherDO> getVoucherPage(FmsVoucherPageReqVO pageReqVO, Long userId);
+
+    /**
+     * 获得指定期间的凭证列表
+     *
+     * @param accountSetId 账套编号
+     * @param beginTime 开始时间
+     * @param endTime 结束时间，不包含
+     * @return 凭证列表
+     */
+    List<FmsVoucherDO> getVoucherListByPeriod(Long accountSetId, LocalDateTime beginTime, LocalDateTime endTime);
+
+    /**
+     * 获得凭证分录列表
+     *
+     * @param voucherIds 凭证编号数组
+     * @return 凭证分录列表
+     */
+    List<FmsVoucherEntryDO> getVoucherEntryList(Collection<Long> voucherIds);
+
+    /**
+     * 获得指定凭证的科目发生额
+     *
+     * @param voucherIds 凭证编号数组
+     * @return 科目发生额列表
+     */
+    List<FmsVoucherSubjectAmountVO> getVoucherSubjectAmountList(Collection<Long> voucherIds);
+
+    /**
+     * 获得凭证分录 Map
+     *
+     * @param voucherIds 凭证编号数组
+     * @return 凭证分录 Map
+     */
+    default Map<Long, List<FmsVoucherEntryDO>> getVoucherEntryMap(Collection<Long> voucherIds) {
+        return convertMultiMap(getVoucherEntryList(voucherIds), FmsVoucherEntryDO::getVoucherId);
+    }
+
+    /**
+     * 获得使用指定科目的凭证分录数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号数组
+     * @return 凭证分录数量
+     */
+    Long getVoucherEntryCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 获得指定科目包含数量数据的凭证分录数量
+     *
+     * @param accountSetId 账套编号
+     * @param subjectIds 科目编号数组
+     * @return 凭证分录数量
+     */
+    Long getVoucherEntryQuantityCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds);
+
+    /**
+     * 迁移科目的凭证分录
+     *
+     * @param accountSetId 账套编号
+     * @param subjectId 科目编号
+     * @param targetSubject 目标科目
+     */
+    void updateVoucherEntrySubject(Long accountSetId, Long subjectId, FmsSubjectDO targetSubject);
+
+    /**
+     * 迁移科目凭证分录的辅助核算
+     *
+     * @param accountSetId 账套编号
+     * @param subjectId 科目编号
+     * @param combination 辅助核算组合
+     */
+    void migrateVoucherEntryAuxiliaries(Long accountSetId, Long subjectId,
+                                        FmsAuxiliaryCombinationDO combination);
+
+    /**
+     * 获得使用指定辅助核算项目的凭证分录数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryItemIds 辅助核算项目编号数组
+     * @return 凭证分录数量
+     */
+    Long getVoucherEntryCountByAuxiliaryItemIds(Long accountSetId, Collection<Long> auxiliaryItemIds);
+
+    /**
+     * 获得使用指定辅助核算类别的凭证分录数量
+     *
+     * @param accountSetId 账套编号
+     * @param auxiliaryTypeId 辅助核算类别编号
+     * @return 凭证分录数量
+     */
+    Long getVoucherEntryCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId);
+
+    /**
+     * 获得使用指定凭证字的凭证数量
+     *
+     * @param accountSetId 账套编号
+     * @param voucherWordId 凭证字编号
+     * @return 凭证数量
+     */
+    Long getVoucherCountByVoucherWordId(Long accountSetId, Long voucherWordId);
+
+    /**
+     * 获得下一个凭证号
+     *
+     * @param accountSetId 账套编号
+     * @param voucherWordId 凭证字编号
+     * @param voucherTime 凭证日期
+     * @param userId 用户编号
+     * @return 下一个凭证号
+     */
+    Integer getNextVoucherNumber(Long accountSetId, Long voucherWordId, LocalDateTime voucherTime, Long userId);
+
+    /**
+     * 获得凭证导入模板数据
+     *
+     * @param accountSetId 账套编号
+     * @param userId 用户编号
+     * @return 导入模板数据
+     */
+    FmsVoucherImportTemplateVO getVoucherImportTemplateData(Long accountSetId, Long userId);
+
+    /**
+     * 导入凭证
+     *
+     * @param accountSetId 账套编号
+     * @param rows 导入分录数组
+     * @param userId 用户编号
+     * @return 导入结果
+     */
+    FmsVoucherImportRespVO importVoucher(Long accountSetId, List<FmsVoucherImportExcelVO> rows, Long userId);
+
+    /**
+     * 获得凭证汇总
+     *
+     * @param queryReqVO 查询条件
+     * @param userId 用户编号
+     * @return 凭证汇总
+     */
+    List<FmsVoucherStatisticsRespVO> getVoucherStatisticsList(
+            FmsVoucherStatisticsReqVO queryReqVO, Long userId);
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherServiceImpl.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherServiceImpl.java
new file mode 100644
index 0000000..344b0ef
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherServiceImpl.java
@@ -0,0 +1,1110 @@
+package cn.iocoder.yudao.module.fms.service.voucher;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.date.DatePattern;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.number.MoneyUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.framework.common.util.validation.ValidationUtils;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherAttachmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherEntrySaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportTemplateVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherMoveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSubjectAmountVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherTidyReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.voucher.FmsVoucherEntryMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.voucher.FmsVoucherMapper;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherStatusEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryCombinationService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryItemService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import jakarta.validation.ConstraintViolationException;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.dao.DuplicateKeyException;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.ArrayDeque;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Deque;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Predicate;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.count;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.diffList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sumBigDecimal;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static cn.iocoder.yudao.module.fms.enums.LogRecordConstants.*;
+import static java.util.Collections.singletonList;
+
+/**
+ * FMS 凭证 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class FmsVoucherServiceImpl implements FmsVoucherService {
+
+    @Resource
+    private FmsVoucherMapper voucherMapper;
+    @Resource
+    private FmsVoucherEntryMapper voucherEntryMapper;
+
+    @Resource
+    private FmsAccountSetService accountSetService;
+    @Resource
+    @Lazy // 延迟加载，避免与结账 Service 循环依赖
+    private FmsClosingPeriodService closingPeriodService;
+    @Resource
+    @Lazy // 延迟加载，避免与结转凭证 Service 循环依赖
+    private FmsClosingVoucherService closingVoucherService;
+    @Resource
+    private FmsVoucherWordService voucherWordService;
+    @Resource
+    private FmsSubjectService subjectService;
+    @Resource
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @Resource
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @Resource
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+
+    // ==================== 凭证写操作 ====================
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_TYPE, subType = FMS_VOUCHER_CREATE_SUB_TYPE,
+            bizNo = "{{#voucherId}}", success = FMS_VOUCHER_CREATE_SUCCESS)
+    public Long createVoucher(FmsVoucherSaveReqVO createReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(createReqVO.getAccountSetId(), userId);
+        // 1.2 串行化同一账套的凭证编号写操作
+        accountSetService.lockAccountSet(createReqVO.getAccountSetId());
+        // 1.3 校验会计期间
+        closingPeriodService.validatePeriodOpen(createReqVO.getAccountSetId(), createReqVO.getVoucherTime());
+        // 1.4 校验凭证字
+        voucherWordService.validateVoucherWordExists(createReqVO.getAccountSetId(), createReqVO.getVoucherWordId());
+        // 1.5 校验凭证号唯一
+        LocalDateTime voucherTime = normalizeVoucherTime(createReqVO.getVoucherTime());
+        validateVoucherNumberUnique(null, createReqVO.getAccountSetId(), createReqVO.getVoucherWordId(),
+                voucherTime, createReqVO.getVoucherNumber());
+
+        // 2. 校验并构造凭证分录
+        List<FmsVoucherEntryDO> entries = validateAndBuildEntries(createReqVO, userId);
+        BigDecimal debitAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getDebitAmount);
+        BigDecimal creditAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getCreditAmount);
+
+        // 3. 创建凭证和分录
+        // 3.1 创建凭证
+        FmsVoucherDO voucher = BeanUtils.toBean(createReqVO, FmsVoucherDO.class)
+                .setId(null).setVoucherTime(voucherTime).setAttachmentUrls(Collections.emptyList())
+                .setDebitAmount(debitAmount).setCreditAmount(creditAmount)
+                .setTotal(debitAmount)
+                .setStatus(FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        try {
+            voucherMapper.insert(voucher);
+        } catch (DuplicateKeyException ex) {
+            // 兼容尚未移除凭证业务唯一索引的存量数据库
+            throw exception(VOUCHER_NUMBER_DUPLICATE);
+        }
+        // 3.2 创建凭证分录
+        entries.forEach(entry -> entry.setId(null).setVoucherId(voucher.getId()));
+        entries.forEach(voucherEntryMapper::insert);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("voucherId", voucher.getId());
+        return voucher.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_TYPE, subType = FMS_VOUCHER_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_VOUCHER_UPDATE_SUCCESS)
+    public void updateVoucher(FmsVoucherSaveReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 串行化同一账套的凭证编号写操作
+        accountSetService.lockAccountSet(updateReqVO.getAccountSetId());
+        // 1.3 校验凭证可编辑
+        FmsVoucherDO voucher = validateVoucherExists(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        validateClosingVoucherEditable(updateReqVO.getAccountSetId(), singletonList(voucher.getId()));
+        validateVoucherEditable(voucher);
+        // 1.4 校验原会计期间和新会计期间
+        closingPeriodService.validatePeriodOpen(updateReqVO.getAccountSetId(), voucher.getVoucherTime());
+        closingPeriodService.validatePeriodOpen(updateReqVO.getAccountSetId(), updateReqVO.getVoucherTime());
+        // 1.5 校验凭证字
+        voucherWordService.validateVoucherWordExists(updateReqVO.getAccountSetId(), updateReqVO.getVoucherWordId());
+        // 1.6 校验凭证号唯一
+        LocalDateTime voucherTime = normalizeVoucherTime(updateReqVO.getVoucherTime());
+        validateVoucherNumberUnique(voucher.getId(), updateReqVO.getAccountSetId(),
+                updateReqVO.getVoucherWordId(), voucherTime, updateReqVO.getVoucherNumber());
+
+        // 2. 校验并构造凭证分录
+        List<FmsVoucherEntryDO> entries = validateAndBuildEntries(updateReqVO, userId);
+        BigDecimal debitAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getDebitAmount);
+        BigDecimal creditAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getCreditAmount);
+
+        // 3.1 更新凭证
+        FmsVoucherDO updateObj = BeanUtils.toBean(updateReqVO, FmsVoucherDO.class)
+                .setVoucherTime(voucherTime).setAttachmentUrls(null)
+                .setDebitAmount(debitAmount).setCreditAmount(creditAmount).setTotal(debitAmount);
+        voucherMapper.updateById(updateObj);
+
+        // 3.2 更新凭证分录
+        updateVoucherEntryList(voucher.getId(), entries);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_TYPE, subType = FMS_VOUCHER_ATTACHMENT_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = FMS_VOUCHER_ATTACHMENT_UPDATE_SUCCESS)
+    public void updateVoucherAttachments(FmsVoucherAttachmentUpdateReqVO updateReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(updateReqVO.getAccountSetId(), userId);
+        // 1.2 校验凭证可编辑
+        FmsVoucherDO voucher = validateVoucherExists(updateReqVO.getAccountSetId(), updateReqVO.getId());
+        validateClosingVoucherEditable(updateReqVO.getAccountSetId(), singletonList(voucher.getId()));
+        validateVoucherEditable(voucher);
+        // 1.3 校验会计期间
+        closingPeriodService.validatePeriodOpen(updateReqVO.getAccountSetId(), voucher.getVoucherTime());
+
+        // 2. 更新附件
+        List<String> attachmentUrls = ObjUtil.defaultIfNull(updateReqVO.getAttachmentUrls(), Collections.emptyList());
+        voucherMapper.updateById(new FmsVoucherDO().setId(voucher.getId())
+                .setAttachmentUrls(attachmentUrls));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_TYPE, subType = FMS_VOUCHER_DELETE_SUB_TYPE,
+            bizNo = "{{#accountSetId}}", success = FMS_VOUCHER_DELETE_SUCCESS)
+    public void deleteVoucherList(Long accountSetId, List<Long> ids, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 串行化同一账套的凭证编号写操作
+        accountSetService.lockAccountSet(accountSetId);
+        // 1.3 校验凭证可编辑
+        List<FmsVoucherDO> vouchers = validateVoucherList(accountSetId, ids);
+        validateClosingVoucherEditable(accountSetId, ids);
+        vouchers.forEach(this::validateVoucherEditable);
+        // 1.4 校验会计期间
+        vouchers.forEach(voucher -> closingPeriodService.validatePeriodOpen(accountSetId, voucher.getVoucherTime()));
+
+        // 2. 删除凭证和分录
+        voucherEntryMapper.deleteByVoucherIds(ids);
+        voucherMapper.deleteByIds(ids);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("voucher", CollUtil.getFirst(vouchers));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_TYPE, subType = FMS_VOUCHER_REVIEW_SUB_TYPE,
+            bizNo = "{{#accountSetId}}", success = FMS_VOUCHER_REVIEW_SUCCESS)
+    public void updateVoucherReviewStatus(
+            Long accountSetId, List<Long> ids, Integer status, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验目标状态
+        if (ObjectUtils.notEqualsAny(status, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus(),
+                FmsVoucherStatusEnum.APPROVED.getStatus())) {
+            throw exception(VOUCHER_STATUS_INVALID);
+        }
+        // 1.3 校验凭证可审核
+        List<FmsVoucherDO> vouchers = validateVoucherList(accountSetId, ids);
+        validateClosingVoucherEditable(accountSetId, ids);
+        // 1.4 校验会计期间
+        vouchers.forEach(voucher -> closingPeriodService.validatePeriodOpen(
+                accountSetId, voucher.getVoucherTime()));
+        // 1.5 校验审核状态流转
+        for (FmsVoucherDO voucher : vouchers) {
+            boolean canApprove = ObjUtil.equal(status, FmsVoucherStatusEnum.APPROVED.getStatus())
+                    && ObjUtil.equal(voucher.getStatus(), FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+            boolean canCancel = ObjUtil.equal(status, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                    && ObjUtil.equal(voucher.getStatus(), FmsVoucherStatusEnum.APPROVED.getStatus());
+            if (!canApprove && !canCancel) {
+                throw exception(VOUCHER_STATUS_INVALID);
+            }
+        }
+
+        // 2. 更新审核状态和审核人
+        Long reviewerUserId = ObjUtil.equal(status, FmsVoucherStatusEnum.APPROVED.getStatus()) ? userId : null;
+        vouchers.forEach(voucher -> voucherMapper.updateReviewStatusById(
+                voucher.getId(), status, reviewerUserId));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_TYPE, subType = FMS_VOUCHER_TIDY_SUB_TYPE,
+            bizNo = "{{#tidyReqVO.accountSetId}}", success = FMS_VOUCHER_TIDY_SUCCESS)
+    public void tidyVoucher(FmsVoucherTidyReqVO tidyReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(tidyReqVO.getAccountSetId(), userId);
+        // 1.2 串行化同一账套的凭证编号写操作
+        accountSetService.lockAccountSet(tidyReqVO.getAccountSetId());
+        // 1.3 校验会计期间
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(tidyReqVO.getMonth());
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        LocalDateTime nextMonthBeginTime = LocalDateTimeUtils.getNextMonthBeginTime(month);
+        closingPeriodService.validatePeriodOpen(tidyReqVO.getAccountSetId(), monthBeginTime);
+        // 1.4 校验凭证字
+        if (tidyReqVO.getVoucherWordId() != null) {
+            voucherWordService.validateVoucherWordExists(tidyReqVO.getAccountSetId(), tidyReqVO.getVoucherWordId());
+        }
+
+        // 2. 按凭证字和指定方式加载待整理凭证
+        List<FmsVoucherDO> vouchers = voucherMapper.selectListForTidy(
+                tidyReqVO.getAccountSetId(), monthBeginTime, nextMonthBeginTime, tidyReqVO.getVoucherWordId(),
+                tidyReqVO.getStartNumber(), tidyReqVO.getType());
+        if (CollUtil.isEmpty(vouchers)) {
+            return;
+        }
+        Map<Long, List<FmsVoucherDO>> voucherMap = convertMultiMap(vouchers, FmsVoucherDO::getVoucherWordId);
+
+        // 3. 按凭证字重新生成凭证号
+        List<FmsVoucherDO> temporaryVouchers = new ArrayList<>();
+        List<FmsVoucherDO> updateVouchers = new ArrayList<>();
+        for (List<FmsVoucherDO> wordVouchers : voucherMap.values()) {
+            for (int index = 0; index < wordVouchers.size(); index++) {
+                FmsVoucherDO voucher = wordVouchers.get(index);
+                temporaryVouchers.add(new FmsVoucherDO().setId(voucher.getId())
+                        .setVoucherNumber(-index - 1));
+                updateVouchers.add(new FmsVoucherDO().setId(voucher.getId())
+                        .setVoucherNumber(tidyReqVO.getStartNumber() + index));
+            }
+        }
+        // updateBatch 仍会逐条触发凭证号唯一键校验，直接写入最终号码可能与尚未更新的原号码冲突
+        // 临时负数不会占用正常凭证号，可在同一事务内安全完成号码交换和重新排序
+        voucherMapper.updateBatch(temporaryVouchers);
+        voucherMapper.updateBatch(updateVouchers);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = FMS_VOUCHER_TYPE, subType = FMS_VOUCHER_MOVE_SUB_TYPE,
+            bizNo = "{{#moveReqVO.accountSetId}}", success = FMS_VOUCHER_MOVE_SUCCESS)
+    public void moveVoucher(FmsVoucherMoveReqVO moveReqVO, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(moveReqVO.getAccountSetId(), userId);
+        // 1.2 串行化同一账套的凭证编号写操作
+        accountSetService.lockAccountSet(moveReqVO.getAccountSetId());
+        // 1.3 校验会计期间
+        YearMonth month = LocalDateTimeUtils.parseYearMonth(moveReqVO.getMonth());
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        LocalDateTime nextMonthBeginTime = LocalDateTimeUtils.getNextMonthBeginTime(month);
+        closingPeriodService.validatePeriodOpen(moveReqVO.getAccountSetId(), monthBeginTime);
+        // 1.4 校验凭证字
+        voucherWordService.validateVoucherWordExists(moveReqVO.getAccountSetId(), moveReqVO.getVoucherWordId());
+        // 1.5 校验凭证编号范围
+        if (moveReqVO.getTargetNumber() >= moveReqVO.getSourceNumber()) {
+            throw exception(VOUCHER_MOVE_RANGE_INVALID);
+        }
+
+        // 2. 加载移动区间并校验原凭证
+        List<FmsVoucherDO> vouchers = voucherMapper.selectListForMove(
+                moveReqVO.getAccountSetId(), moveReqVO.getVoucherWordId(),
+                monthBeginTime, nextMonthBeginTime,
+                moveReqVO.getTargetNumber(), moveReqVO.getSourceNumber());
+        FmsVoucherDO sourceVoucher = null;
+        for (FmsVoucherDO voucher : vouchers) {
+            if (ObjUtil.equal(voucher.getVoucherNumber(), moveReqVO.getSourceNumber())) {
+                if (sourceVoucher != null) {
+                    throw exception(VOUCHER_MOVE_SOURCE_NOT_EXISTS);
+                }
+                sourceVoucher = voucher;
+            }
+        }
+        if (sourceVoucher == null) {
+            throw exception(VOUCHER_MOVE_SOURCE_NOT_EXISTS);
+        }
+
+        // 3. 移动原凭证并顺延中间编号
+        List<FmsVoucherDO> temporaryVouchers = new ArrayList<>();
+        for (int index = 0; index < vouchers.size(); index++) {
+            temporaryVouchers.add(new FmsVoucherDO().setId(vouchers.get(index).getId()).setVoucherNumber(-index - 1));
+        }
+        Long sourceVoucherId = sourceVoucher.getId();
+        List<FmsVoucherDO> updateVouchers = convertList(vouchers, voucher -> new FmsVoucherDO().setId(voucher.getId())
+                .setVoucherNumber(ObjUtil.equal(voucher.getId(), sourceVoucherId) ? moveReqVO.getTargetNumber() : voucher.getVoucherNumber() + 1));
+        // updateBatch 仍会逐条触发凭证号唯一键校验，直接写入最终号码可能与尚未更新的原号码冲突
+        // 临时负数不会占用正常凭证号，可在同一事务内安全完成号码移动和中间号码顺延
+        voucherMapper.updateBatch(temporaryVouchers);
+        voucherMapper.updateBatch(updateVouchers);
+    }
+
+    // ==================== 凭证查询 ====================
+
+    @Override
+    public FmsVoucherDO getVoucher(Long accountSetId, Long id, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 查询并校验凭证
+        return validateVoucherExists(accountSetId, id);
+    }
+
+    @Override
+    public PageResult<FmsVoucherDO> getVoucherPage(FmsVoucherPageReqVO pageReqVO, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(pageReqVO.getAccountSetId(), userId);
+
+        // 2. 查询凭证分页
+        Collection<Long> voucherIds = null;
+        if (pageReqVO.getSubjectId() != null || StrUtil.isNotBlank(pageReqVO.getDigest())
+                || pageReqVO.getMinAmount() != null || pageReqVO.getMaxAmount() != null) {
+            List<Long> subjectIds = pageReqVO.getSubjectId() == null ? null
+                    : subjectService.getSubjectIdListWithChildren(pageReqVO.getAccountSetId(), pageReqVO.getSubjectId());
+            List<FmsVoucherEntryDO> matchedEntries = voucherEntryMapper.selectVoucherIdsByCondition(
+                    pageReqVO.getAccountSetId(), subjectIds, pageReqVO.getDigest(),
+                    pageReqVO.getMinAmount(), pageReqVO.getMaxAmount());
+            voucherIds = convertSet(matchedEntries, FmsVoucherEntryDO::getVoucherId);
+            if (CollUtil.isEmpty(voucherIds)) {
+                return PageResult.empty();
+            }
+        }
+        return voucherMapper.selectPage(pageReqVO, voucherIds);
+    }
+
+    @Override
+    public List<FmsVoucherDO> getVoucherListByPeriod(Long accountSetId,
+            LocalDateTime beginTime, LocalDateTime endTime) {
+        return voucherMapper.selectListByAccountSetIdAndVoucherTimeBetween(accountSetId, beginTime, endTime);
+    }
+
+    @Override
+    public List<FmsVoucherEntryDO> getVoucherEntryList(Collection<Long> voucherIds) {
+        if (CollUtil.isEmpty(voucherIds)) {
+            return Collections.emptyList();
+        }
+        return voucherEntryMapper.selectListByVoucherIds(voucherIds);
+    }
+
+    @Override
+    public List<FmsVoucherSubjectAmountVO> getVoucherSubjectAmountList(Collection<Long> voucherIds) {
+        if (CollUtil.isEmpty(voucherIds)) {
+            return Collections.emptyList();
+        }
+        return voucherEntryMapper.selectSubjectAmountListByVoucherIds(voucherIds);
+    }
+
+    @Override
+    public Long getVoucherEntryCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        return voucherEntryMapper.selectCountByAccountSetIdAndSubjectIds(accountSetId, subjectIds);
+    }
+
+    @Override
+    public Long getVoucherEntryQuantityCountBySubjectIds(Long accountSetId, Collection<Long> subjectIds) {
+        return voucherEntryMapper.selectQuantityCountByAccountSetIdAndSubjectIds(accountSetId, subjectIds);
+    }
+
+    @Override
+    public void updateVoucherEntrySubject(Long accountSetId, Long subjectId, FmsSubjectDO targetSubject) {
+        voucherEntryMapper.updateSubject(accountSetId, subjectId,
+                new FmsVoucherEntryDO().setSubjectId(targetSubject.getId())
+                        .setSubjectCode(targetSubject.getCode()).setSubjectName(targetSubject.getName()));
+    }
+
+    @Override
+    public void migrateVoucherEntryAuxiliaries(Long accountSetId, Long subjectId,
+            FmsAuxiliaryCombinationDO combination) {
+        // 1. 查询科目的凭证分录
+        List<FmsVoucherEntryDO> entries = voucherEntryMapper.selectListByAccountSetIdAndSubjectId(
+                accountSetId, subjectId);
+        if (CollUtil.isEmpty(entries)) {
+            return;
+        }
+
+        // 2. 将历史分录迁移到指定辅助核算组合
+        List<FmsVoucherEntryDO.AuxiliaryItem> auxiliaries = convertList(combination.getItems(), item ->
+                FmsVoucherEntryDO.AuxiliaryItem.builder().type(item.getType()).typeId(item.getTypeId())
+                        .itemId(item.getItemId()).name(item.getName()).build());
+        entries.forEach(entry -> entry.setAssistCombinationId(combination.getId()).setAuxiliaries(auxiliaries));
+        voucherEntryMapper.updateBatch(entries);
+    }
+
+    @Override
+    public Long getVoucherEntryCountByAuxiliaryItemIds(Long accountSetId, Collection<Long> auxiliaryItemIds) {
+        if (CollUtil.isEmpty(auxiliaryItemIds)) {
+            return 0L;
+        }
+        Set<Long> auxiliaryItemIdSet = new LinkedHashSet<>(auxiliaryItemIds);
+        return getVoucherEntryCountByAuxiliary(accountSetId,
+                item -> auxiliaryItemIdSet.contains(item.getItemId()));
+    }
+
+    @Override
+    public Long getVoucherEntryCountByAuxiliaryTypeId(Long accountSetId, Long auxiliaryTypeId) {
+        return getVoucherEntryCountByAuxiliary(accountSetId,
+                item -> ObjUtil.equal(item.getTypeId(), auxiliaryTypeId));
+    }
+
+    @Override
+    public Long getVoucherCountByVoucherWordId(Long accountSetId, Long voucherWordId) {
+        return voucherMapper.selectCountByAccountSetIdAndVoucherWordId(accountSetId, voucherWordId);
+    }
+
+    @Override
+    public Integer getNextVoucherNumber(Long accountSetId, Long voucherWordId,
+            LocalDateTime voucherTime, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+        // 1.2 校验凭证字
+        voucherWordService.validateVoucherWordExists(accountSetId, voucherWordId);
+
+        // 2. 计算下一个凭证号
+        return calculateNextVoucherNumber(accountSetId, voucherWordId, voucherTime);
+    }
+
+    // ==================== 凭证导入 ====================
+
+    @Override
+    public FmsVoucherImportTemplateVO getVoucherImportTemplateData(Long accountSetId, Long userId) {
+        // 1. 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(accountSetId, userId);
+
+        // 2. 加载导入模板依赖
+        List<FmsVoucherWordDO> voucherWords = voucherWordService.getVoucherWordList(accountSetId);
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        List<FmsAuxiliaryTypeDO> auxiliaryTypes = auxiliaryTypeService.getAuxiliaryTypeList(accountSetId, userId);
+        List<FmsAuxiliaryItemDO> auxiliaryItems = auxiliaryItemService.getAuxiliaryItemListByAccountSetId(accountSetId, userId);
+        return new FmsVoucherImportTemplateVO(voucherWords, subjects, auxiliaryTypes, auxiliaryItems);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public FmsVoucherImportRespVO importVoucher(Long accountSetId, List<FmsVoucherImportExcelVO> rows, Long userId) {
+        // 1.1 校验账套写权限
+        accountSetService.validateAccountSetWritePermission(accountSetId, userId);
+        // 1.2 校验导入数据非空
+        if (CollUtil.isEmpty(rows)) {
+            throw exception(VOUCHER_IMPORT_FILE_EMPTY);
+        }
+        // 1.3 加载导入依赖
+        Map<String, FmsVoucherWordDO> voucherWordMap = voucherWordService.getVoucherWordMapByName(accountSetId);
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(accountSetId, null, userId);
+        Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap = auxiliaryTypeService.getAuxiliaryTypeMap(accountSetId, userId);
+        Map<String, FmsAuxiliaryItemDO> auxiliaryItemMap = auxiliaryItemService.getAuxiliaryItemMapByTypeIdAndCode(accountSetId, userId);
+        Map<String, FmsSubjectDO> subjectMap = convertMap(subjects, FmsSubjectDO::getCode);
+        Set<Long> parentSubjectIds = convertSet(subjects, FmsSubjectDO::getParentId);
+
+        // 2. 按日期、凭证字和凭证号分组并校验每条分录
+        Map<String, List<FmsVoucherImportExcelVO>> groupMap = new LinkedHashMap<>();
+        for (FmsVoucherImportExcelVO row : rows) {
+            validateImportRow(row, voucherWordMap, subjectMap, parentSubjectIds, auxiliaryTypeMap, auxiliaryItemMap);
+            groupMap.computeIfAbsent(buildImportGroupKey(row), key -> new ArrayList<>()).add(row);
+        }
+
+        // 3. 校验凭证组摘要、期间、借贷平衡和业务键
+        Set<String> importBusinessKeys = new LinkedHashSet<>();
+        for (List<FmsVoucherImportExcelVO> groupRows : groupMap.values()) {
+            validateImportGroup(accountSetId, groupRows, voucherWordMap);
+            String businessKey = buildImportBusinessKey(CollUtil.getFirst(groupRows));
+            if (businessKey != null && !importBusinessKeys.add(businessKey)) {
+                addGroupError(groupRows, "同一会计期间、凭证字和凭证号重复");
+            }
+        }
+
+        // 4. 落库有效凭证组
+        int successVoucherCount = 0;
+        List<FmsVoucherImportExcelVO> errorRows = new ArrayList<>();
+        for (List<FmsVoucherImportExcelVO> groupRows : groupMap.values()) {
+            if (groupRows.stream().anyMatch(row -> CollUtil.isNotEmpty(row.getErrors()))) {
+                errorRows.addAll(groupRows);
+                continue;
+            }
+            insertImportVoucher(accountSetId, groupRows, voucherWordMap, subjectMap, auxiliaryTypeMap, auxiliaryItemMap);
+            successVoucherCount++;
+        }
+        return new FmsVoucherImportRespVO().setTotalRowCount(rows.size())
+                .setSuccessRowCount(rows.size() - errorRows.size()).setFailureRowCount(errorRows.size())
+                .setTotalVoucherCount(groupMap.size()).setSuccessVoucherCount(successVoucherCount)
+                .setFailureVoucherCount(groupMap.size() - successVoucherCount).setErrorRows(errorRows);
+    }
+
+    // ==================== 凭证汇总 ====================
+
+    @Override
+    public List<FmsVoucherStatisticsRespVO> getVoucherStatisticsList(
+            FmsVoucherStatisticsReqVO queryReqVO, Long userId) {
+        // 1.1 校验账套读权限
+        accountSetService.validateAccountSetReadPermission(queryReqVO.getAccountSetId(), userId);
+        // 1.2 校验会计期间
+        YearMonth startMonth = LocalDateTimeUtils.parseYearMonth(queryReqVO.getStartMonth());
+        YearMonth endMonth = LocalDateTimeUtils.parseYearMonth(queryReqVO.getEndMonth());
+        if (startMonth.isAfter(endMonth)) {
+            throw exception(LEDGER_PERIOD_INVALID);
+        }
+        // 1.3 校验科目层级和凭证号范围
+        int minLevel = ObjUtil.defaultIfNull(queryReqVO.getMinLevel(), 1);
+        int maxLevel = ObjUtil.defaultIfNull(queryReqVO.getMaxLevel(), 1);
+        if (minLevel > maxLevel || queryReqVO.getMinVoucherNumber() != null
+                && queryReqVO.getMaxVoucherNumber() != null
+                && queryReqVO.getMinVoucherNumber() > queryReqVO.getMaxVoucherNumber()) {
+            throw exception(VOUCHER_STATISTICS_RANGE_INVALID);
+        }
+        // 1.4 校验凭证字
+        if (queryReqVO.getVoucherWordId() != null) {
+            voucherWordService.validateVoucherWordExists(
+                    queryReqVO.getAccountSetId(), queryReqVO.getVoucherWordId());
+        }
+
+        // 2. 查询科目直接发生额
+        LocalDateTime beginTime = LocalDateTimeUtils.getMonthBeginTime(startMonth);
+        LocalDateTime endTime = LocalDateTimeUtils.getNextMonthBeginTime(endMonth);
+        List<FmsVoucherSubjectAmountVO> amounts = voucherEntryMapper.selectSubjectAmountList(
+                queryReqVO.getAccountSetId(), beginTime, endTime, queryReqVO.getVoucherWordId(),
+                queryReqVO.getMinVoucherNumber(), queryReqVO.getMaxVoucherNumber());
+        Map<Long, FmsVoucherSubjectAmountVO> amountMap = convertMap(
+                amounts, FmsVoucherSubjectAmountVO::getSubjectId);
+        if (CollUtil.isEmpty(amountMap)) {
+            return new ArrayList<>();
+        }
+
+        // 3. 按科目级次汇总自身和全部下级发生额
+        List<FmsSubjectDO> subjects = subjectService.getSubjectList(queryReqVO.getAccountSetId(), null, userId);
+        Map<Long, List<Long>> childMap = convertMultiMap(
+                filterList(subjects, subject -> subject.getParentId() != null),
+                FmsSubjectDO::getParentId, FmsSubjectDO::getId);
+        List<FmsVoucherStatisticsRespVO> result = new ArrayList<>();
+        for (FmsSubjectDO subject : subjects) {
+            if (subject.getLevel() < minLevel || subject.getLevel() > maxLevel) {
+                continue;
+            }
+            Set<Long> subjectIds = new LinkedHashSet<>();
+            Deque<Long> pendingSubjectIds = new ArrayDeque<>();
+            pendingSubjectIds.add(subject.getId());
+            while (CollUtil.isNotEmpty(pendingSubjectIds)) {
+                Long subjectId = pendingSubjectIds.removeFirst();
+                if (subjectIds.add(subjectId)) {
+                    pendingSubjectIds.addAll(CollUtil.emptyIfNull(childMap.get(subjectId)));
+                }
+            }
+            BigDecimal debitAmount = BigDecimal.ZERO;
+            BigDecimal creditAmount = BigDecimal.ZERO;
+            boolean hasAmount = false;
+            for (Long subjectId : subjectIds) {
+                FmsVoucherSubjectAmountVO amount = amountMap.get(subjectId);
+                if (amount != null) {
+                    debitAmount = debitAmount.add(amount.getDebitAmount());
+                    creditAmount = creditAmount.add(amount.getCreditAmount());
+                    hasAmount = true;
+                }
+            }
+            if (hasAmount) {
+                result.add(new FmsVoucherStatisticsRespVO().setSubjectId(subject.getId())
+                        .setSubjectCode(subject.getCode()).setSubjectName(subject.getName())
+                        .setLevel(subject.getLevel()).setDebitAmount(debitAmount).setCreditAmount(creditAmount));
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 校验凭证导入行
+     *
+     * @param row 导入行
+     * @param voucherWordMap 凭证字 Map
+     * @param subjectMap 科目 Map
+     * @param parentSubjectIds 非末级科目编号数组
+     * @param auxiliaryTypeMap 辅助核算类别 Map
+     * @param auxiliaryItemMap 辅助核算项目 Map
+     */
+    private void validateImportRow(FmsVoucherImportExcelVO row,
+                                   Map<String, FmsVoucherWordDO> voucherWordMap, Map<String, FmsSubjectDO> subjectMap,
+                                   Set<Long> parentSubjectIds, Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap,
+                                   Map<String, FmsAuxiliaryItemDO> auxiliaryItemMap) {
+        // 1. 校验 Excel 字段格式
+        try {
+            ValidationUtils.validate(row);
+        } catch (ConstraintViolationException exception) {
+            row.addError(exception.getMessage());
+        }
+
+        // 2. 校验凭证字和科目
+        if (StrUtil.isNotBlank(row.getVoucherWordName())
+                && !voucherWordMap.containsKey(row.getVoucherWordName())) {
+            row.addError("凭证字不存在");
+        }
+        FmsSubjectDO subject = subjectMap.get(row.getSubjectCode());
+        if (subject == null) {
+            row.addError("科目编码不存在");
+        } else if (ObjUtil.notEqual(subject.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+            row.addError("科目已停用");
+        } else if (parentSubjectIds.contains(subject.getId())) {
+            row.addError("只能导入末级科目");
+        }
+        // 3. 校验借贷金额、数量核算和辅助核算
+        BigDecimal debitAmount = normalizeAmount(row.getDebitAmount());
+        BigDecimal creditAmount = normalizeAmount(row.getCreditAmount());
+        if ((debitAmount.signum() != 0 && creditAmount.signum() != 0)
+                || (debitAmount.signum() == 0 && creditAmount.signum() == 0)) {
+            row.addError("借方金额和贷方金额只能填写一项且金额不能为 0");
+        }
+        if (subject != null) {
+            validateImportQuantity(row, subject, debitAmount.abs().max(creditAmount.abs()));
+            validateImportAuxiliaries(row, subject, auxiliaryTypeMap, auxiliaryItemMap);
+        }
+    }
+
+    private void validateImportQuantity(
+            FmsVoucherImportExcelVO row, FmsSubjectDO subject, BigDecimal amount) {
+        BigDecimal quantity = ObjUtil.defaultIfNull(row.getQuantity(), BigDecimal.ZERO);
+        BigDecimal unitPrice = ObjUtil.defaultIfNull(row.getUnitPrice(), BigDecimal.ZERO);
+        if (Boolean.FALSE.equals(subject.getQuantityAccounting())) {
+            if (quantity.signum() > 0 || unitPrice.signum() > 0) {
+                row.addError("该科目未启用数量核算，不能填写数量和单价");
+            }
+            return;
+        }
+        if (quantity.signum() == 0 && unitPrice.signum() == 0) {
+            return;
+        }
+        if (quantity.signum() <= 0 || unitPrice.signum() <= 0
+                || quantity.multiply(unitPrice).setScale(2, RoundingMode.FLOOR).compareTo(amount) != 0) {
+            row.addError("数量和单价需同时大于 0，且乘积应等于分录金额");
+        }
+    }
+
+    /**
+     * 校验凭证导入行的辅助核算项目
+     *
+     * @param row 导入行
+     * @param subject 科目
+     * @param auxiliaryTypeMap 辅助核算类别 Map
+     * @param auxiliaryItemMap 辅助核算项目 Map
+     */
+    private void validateImportAuxiliaries(FmsVoucherImportExcelVO row, FmsSubjectDO subject,
+                                           Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap,
+                                           Map<String, FmsAuxiliaryItemDO> auxiliaryItemMap) {
+        List<Long> auxiliaryTypeIds = ObjUtil.defaultIfNull(subject.getAuxiliaryTypeIds(), Collections.emptyList());
+        // 按科目要求的辅助核算类别逐项校验项目编码和启用状态
+        for (Long auxiliaryTypeId : auxiliaryTypeIds) {
+            String code = row.getAuxiliaryCodes().get(auxiliaryTypeId);
+            FmsAuxiliaryItemDO item = auxiliaryItemMap.get(buildAuxiliaryItemKey(auxiliaryTypeId, code));
+            String typeName = auxiliaryTypeMap.get(auxiliaryTypeId).getName();
+            if (StrUtil.isBlank(code) || item == null
+                    || ObjUtil.notEqual(item.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+                row.addError(typeName + "辅助核算项目不存在或未填写");
+            }
+        }
+    }
+
+    /**
+     * 校验同一凭证的导入分录
+     *
+     * @param accountSetId 账套编号
+     * @param groupRows 同一凭证的导入行数组
+     * @param voucherWordMap 凭证字 Map
+     */
+    private void validateImportGroup(Long accountSetId, List<FmsVoucherImportExcelVO> groupRows,
+                                     Map<String, FmsVoucherWordDO> voucherWordMap) {
+        FmsVoucherImportExcelVO firstRow = CollUtil.getFirst(groupRows);
+        // 1. 校验分录数量、摘要和借贷平衡
+        if (groupRows.size() < 2) {
+            addGroupError(groupRows, "凭证至少需要两条分录");
+        }
+        if (groupRows.stream().noneMatch(row -> StrUtil.isNotBlank(row.getDigest()))) {
+            addGroupError(groupRows, "同一凭证至少填写一条摘要");
+        }
+        BigDecimal debitAmount = sumBigDecimal(groupRows, row -> normalizeAmount(row.getDebitAmount()));
+        BigDecimal creditAmount = sumBigDecimal(groupRows, row -> normalizeAmount(row.getCreditAmount()));
+        if (debitAmount.compareTo(creditAmount) != 0) {
+            addGroupError(groupRows, "凭证借贷金额不平衡");
+        }
+        // 2. 校验会计期间和凭证号唯一
+        if (firstRow.getVoucherTime() == null) {
+            return;
+        }
+        if (closingPeriodService.isPeriodClosed(accountSetId, firstRow.getVoucherTime())) {
+            addGroupError(groupRows, "凭证所在会计期间已结账");
+        }
+        FmsVoucherWordDO voucherWord = voucherWordMap.get(firstRow.getVoucherWordName());
+        if (voucherWord != null && firstRow.getVoucherNumber() != null
+                && firstRow.getVoucherNumber() > 0) {
+            YearMonth month = YearMonth.from(firstRow.getVoucherTime());
+            LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+            LocalDateTime nextMonthBeginTime = LocalDateTimeUtils.getNextMonthBeginTime(month);
+            FmsVoucherDO voucher = voucherMapper.selectByAccountSetIdAndVoucherWordIdAndVoucherNumberAndVoucherTimeBetween(
+                    accountSetId, voucherWord.getId(), firstRow.getVoucherNumber(),
+                    monthBeginTime, nextMonthBeginTime);
+            if (voucher != null) {
+                addGroupError(groupRows, "同一会计期间、凭证字和凭证号已存在");
+            }
+        }
+    }
+
+    /**
+     * 创建导入凭证及其分录
+     *
+     * @param accountSetId 账套编号
+     * @param groupRows 同一凭证的导入行数组
+     * @param voucherWordMap 凭证字 Map
+     * @param subjectMap 科目 Map
+     * @param auxiliaryTypeMap 辅助核算类别 Map
+     * @param auxiliaryItemMap 辅助核算项目 Map
+     */
+    private void insertImportVoucher(Long accountSetId, List<FmsVoucherImportExcelVO> groupRows,
+                                     Map<String, FmsVoucherWordDO> voucherWordMap, Map<String, FmsSubjectDO> subjectMap,
+                                     Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap,
+                                     Map<String, FmsAuxiliaryItemDO> auxiliaryItemMap) {
+        FmsVoucherImportExcelVO firstRow = CollUtil.getFirst(groupRows);
+        // 1. 构造凭证分录和辅助核算快照
+        List<FmsVoucherEntryDO> entries = new ArrayList<>();
+        for (int index = 0; index < groupRows.size(); index++) {
+            FmsVoucherImportExcelVO row = groupRows.get(index);
+            FmsSubjectDO subject = subjectMap.get(row.getSubjectCode());
+            List<FmsVoucherEntryDO.AuxiliaryItem> auxiliaries = new ArrayList<>();
+            List<Long> auxiliaryTypeIds = ObjUtil.defaultIfNull(subject.getAuxiliaryTypeIds(), Collections.emptyList());
+            for (Long auxiliaryTypeId : auxiliaryTypeIds) {
+                FmsAuxiliaryItemDO item = auxiliaryItemMap.get(
+                        buildAuxiliaryItemKey(auxiliaryTypeId, row.getAuxiliaryCodes().get(auxiliaryTypeId)));
+                auxiliaries.add(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .type(auxiliaryTypeMap.get(auxiliaryTypeId).getType())
+                        .typeId(auxiliaryTypeId).itemId(item.getId())
+                        .name(item.getName()).build());
+            }
+            BigDecimal rowDebitAmount = normalizeAmount(row.getDebitAmount());
+            BigDecimal rowCreditAmount = normalizeAmount(row.getCreditAmount());
+            entries.add(new FmsVoucherEntryDO().setAccountSetId(accountSetId)
+                    .setDigest(row.getDigest()).setSubjectId(subject.getId())
+                    .setSubjectCode(subject.getCode()).setSubjectName(subject.getName())
+                    .setQuantity(ObjUtil.defaultIfNull(row.getQuantity(), BigDecimal.ZERO))
+                    .setUnitPrice(ObjUtil.defaultIfNull(row.getUnitPrice(), BigDecimal.ZERO))
+                    .setDebitAmount(rowDebitAmount).setCreditAmount(rowCreditAmount)
+                    .setSort(index + 1).setAuxiliaries(auxiliaries));
+        }
+        auxiliaryCombinationService.setAuxiliaryCombinationIds(accountSetId, entries);
+
+        // 2.1 创建凭证
+        BigDecimal debitAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getDebitAmount);
+        BigDecimal creditAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getCreditAmount);
+        FmsVoucherDO voucher = new FmsVoucherDO().setAccountSetId(accountSetId)
+                .setVoucherWordId(voucherWordMap.get(firstRow.getVoucherWordName()).getId())
+                .setVoucherNumber(firstRow.getVoucherNumber()).setVoucherTime(normalizeVoucherTime(firstRow.getVoucherTime()))
+                .setAttachmentUrls(new ArrayList<>())
+                .setAttachmentCount(ObjUtil.defaultIfNull(firstRow.getAttachmentCount(), 0))
+                .setDebitAmount(debitAmount).setCreditAmount(creditAmount)
+                .setTotal(debitAmount)
+                .setStatus(FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(voucher);
+
+        // 2.2 创建凭证分录
+        entries.forEach(entry -> entry.setVoucherId(voucher.getId()));
+        entries.forEach(voucherEntryMapper::insert);
+    }
+
+    private String buildImportGroupKey(FmsVoucherImportExcelVO row) {
+        if (row.getVoucherTime() == null || StrUtil.isBlank(row.getVoucherWordName())
+                || row.getVoucherNumber() == null) {
+            return "第" + row.getRowNumber() + "行";
+        }
+        return row.getVoucherTime() + "|" + row.getVoucherWordName() + "|" + row.getVoucherNumber();
+    }
+
+    private String buildImportBusinessKey(FmsVoucherImportExcelVO row) {
+        if (row.getVoucherTime() == null || StrUtil.isBlank(row.getVoucherWordName())
+                || row.getVoucherNumber() == null) {
+            return null;
+        }
+        return YearMonth.from(row.getVoucherTime()) + "|" + row.getVoucherWordName() + "|" + row.getVoucherNumber();
+    }
+
+    private String buildAuxiliaryItemKey(Long auxiliaryTypeId, String code) {
+        return auxiliaryTypeId + "|" + code;
+    }
+
+    private void addGroupError(List<FmsVoucherImportExcelVO> rows, String error) {
+        rows.forEach(row -> row.addError(error));
+    }
+
+    /**
+     * 计算指定会计期间和凭证字的下一个凭证号
+     *
+     * @param accountSetId 账套编号
+     * @param voucherWordId 凭证字编号
+     * @param voucherTime 凭证日期
+     * @return 下一个凭证号
+     */
+    private Integer calculateNextVoucherNumber(
+            Long accountSetId, Long voucherWordId, LocalDateTime voucherTime) {
+        YearMonth month = YearMonth.from(voucherTime);
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        LocalDateTime nextMonthBeginTime = LocalDateTimeUtils.getNextMonthBeginTime(month);
+        FmsVoucherDO lastVoucher = voucherMapper.selectLastByPeriod(
+                accountSetId, voucherWordId, monthBeginTime, nextMonthBeginTime);
+        return lastVoucher == null ? 1 : lastVoucher.getVoucherNumber() + 1;
+    }
+
+    /**
+     * 校验并构造凭证分录
+     *
+     * @param reqVO 凭证保存信息
+     * @param userId 用户编号
+     * @return 凭证分录数组
+     */
+    private List<FmsVoucherEntryDO> validateAndBuildEntries(FmsVoucherSaveReqVO reqVO, Long userId) {
+        if (CollUtil.size(reqVO.getEntries()) < 2) {
+            throw exception(VOUCHER_ENTRY_REQUIRED);
+        }
+
+        // 1. 批量加载科目和辅助核算项目
+        List<FmsSubjectDO> allSubjects = subjectService.getSubjectList(reqVO.getAccountSetId(), null, userId);
+        Map<Long, FmsSubjectDO> subjectMap = convertMap(allSubjects, FmsSubjectDO::getId);
+        Set<Long> parentIds = convertSet(allSubjects, FmsSubjectDO::getParentId);
+        Set<Long> auxiliaryTypeIds = convertSetByFlatMap(
+                allSubjects, FmsSubjectDO::getAuxiliaryTypeIds, Collection::stream);
+        List<FmsAuxiliaryTypeDO> auxiliaryTypes = auxiliaryTypeService.validateAuxiliaryTypeList(
+                reqVO.getAccountSetId(), auxiliaryTypeIds);
+        Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap = convertMap(auxiliaryTypes, FmsAuxiliaryTypeDO::getId);
+        Set<FmsVoucherEntrySaveReqVO.AuxiliaryItem> auxiliaryItems = convertSetByFlatMap(
+                reqVO.getEntries(), FmsVoucherEntrySaveReqVO::getAuxiliaries, Collection::stream);
+        Set<Long> auxiliaryItemIds = convertSet(auxiliaryItems, FmsVoucherEntrySaveReqVO.AuxiliaryItem::getItemId);
+        List<FmsAuxiliaryItemDO> auxiliaryItemList = auxiliaryItemService.validateAuxiliaryItemList(
+                reqVO.getAccountSetId(), auxiliaryItemIds);
+        Map<Long, FmsAuxiliaryItemDO> auxiliaryItemMap = convertMap(auxiliaryItemList, FmsAuxiliaryItemDO::getId);
+
+        // 2. 校验并构造每条分录
+        List<FmsVoucherEntryDO> entries = new ArrayList<>();
+        for (int index = 0; index < reqVO.getEntries().size(); index++) {
+            FmsVoucherEntrySaveReqVO entryReqVO = reqVO.getEntries().get(index);
+            FmsSubjectDO subject = subjectMap.get(entryReqVO.getSubjectId());
+            validateVoucherSubject(subject, parentIds);
+            BigDecimal debit = normalizeAmount(entryReqVO.getDebitAmount());
+            BigDecimal credit = normalizeAmount(entryReqVO.getCreditAmount());
+            if ((debit.signum() != 0 && credit.signum() != 0)
+                    || (debit.signum() == 0 && credit.signum() == 0)) {
+                throw exception(VOUCHER_ENTRY_AMOUNT_INVALID);
+            }
+            validateQuantity(entryReqVO, subject, debit.abs().max(credit.abs()));
+            List<FmsVoucherEntryDO.AuxiliaryItem> auxiliaries = buildAuxiliaries(
+                    entryReqVO, subject, auxiliaryTypeMap, auxiliaryItemMap);
+            // 数量和单价仅在科目启用数量核算且实际填写时必填，未启用时保持零值
+            entries.add(new FmsVoucherEntryDO().setAccountSetId(reqVO.getAccountSetId())
+                    .setId(entryReqVO.getId())
+                    .setDigest(entryReqVO.getDigest()).setSubjectId(subject.getId())
+                    .setSubjectCode(subject.getCode()).setSubjectName(subject.getName())
+                    .setQuantity(ObjUtil.defaultIfNull(entryReqVO.getQuantity(), BigDecimal.ZERO))
+                    .setUnitPrice(ObjUtil.defaultIfNull(entryReqVO.getUnitPrice(), BigDecimal.ZERO))
+                    .setDebitAmount(debit).setCreditAmount(credit).setSort(index + 1)
+                    .setAuxiliaries(auxiliaries));
+        }
+
+        // 3. 校验凭证借贷平衡并补充辅助核算组合编号
+        BigDecimal debitAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getDebitAmount);
+        BigDecimal creditAmount = sumBigDecimal(entries, FmsVoucherEntryDO::getCreditAmount);
+        if (debitAmount.compareTo(creditAmount) != 0) {
+            throw exception(VOUCHER_AMOUNT_UNBALANCED);
+        }
+        auxiliaryCombinationService.setAuxiliaryCombinationIds(reqVO.getAccountSetId(), entries);
+        return entries;
+    }
+
+    /**
+     * 差量更新凭证分录
+     *
+     * @param voucherId 凭证编号
+     * @param newEntries 新凭证分录数组
+     */
+    private void updateVoucherEntryList(Long voucherId, List<FmsVoucherEntryDO> newEntries) {
+        // 1. 对比新老分录，获得新增、修改、删除列表
+        List<FmsVoucherEntryDO> oldEntries = voucherEntryMapper.selectListByVoucherId(voucherId);
+        List<List<FmsVoucherEntryDO>> diffEntries = diffList(oldEntries, newEntries,
+                (oldEntry, newEntry) -> ObjUtil.equal(oldEntry.getId(), newEntry.getId()));
+
+        // 2. 新增、修改、删除分录
+        if (CollUtil.isNotEmpty(diffEntries.get(0))) {
+            diffEntries.get(0).forEach(entry -> entry.setId(null).setVoucherId(voucherId));
+            diffEntries.get(0).forEach(voucherEntryMapper::insert);
+        }
+        if (CollUtil.isNotEmpty(diffEntries.get(1))) {
+            diffEntries.get(1).forEach(entry -> entry.setVoucherId(voucherId));
+            voucherEntryMapper.updateBatch(diffEntries.get(1));
+        }
+        if (CollUtil.isNotEmpty(diffEntries.get(2))) {
+            voucherEntryMapper.deleteByIds(convertList(diffEntries.get(2), FmsVoucherEntryDO::getId));
+        }
+    }
+
+    private void validateVoucherSubject(FmsSubjectDO subject, Set<Long> parentIds) {
+        if (subject == null) {
+            throw exception(SUBJECT_NOT_EXISTS);
+        }
+        if (ObjUtil.notEqual(subject.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+            throw exception(VOUCHER_SUBJECT_DISABLED);
+        }
+        if (parentIds.contains(subject.getId())) {
+            throw exception(VOUCHER_SUBJECT_HAS_CHILDREN);
+        }
+    }
+
+    /**
+     * 校验分录数量和单价
+     *
+     * @param entryReqVO 分录保存信息
+     * @param subject 科目
+     * @param amount 分录金额
+     */
+    private void validateQuantity(FmsVoucherEntrySaveReqVO entryReqVO,
+            FmsSubjectDO subject, BigDecimal amount) {
+        BigDecimal quantity = entryReqVO.getQuantity();
+        BigDecimal unitPrice = entryReqVO.getUnitPrice();
+        // 未启用数量核算的科目不能填写数量和单价
+        if (Boolean.FALSE.equals(subject.getQuantityAccounting())) {
+            if (quantity != null && quantity.signum() > 0 || unitPrice != null && unitPrice.signum() > 0) {
+                throw exception(VOUCHER_QUANTITY_INVALID);
+            }
+            return;
+        }
+        // 数量和单价均未填写时，不进行数量金额校验
+        if ((quantity == null || quantity.signum() == 0)
+                && (unitPrice == null || unitPrice.signum() == 0)) {
+            return;
+        }
+        // 数量和单价需同时大于零，且乘积必须等于分录金额
+        if (quantity == null || quantity.signum() <= 0 || unitPrice == null || unitPrice.signum() <= 0
+                || quantity.multiply(unitPrice).setScale(2, RoundingMode.FLOOR).compareTo(amount) != 0) {
+            throw exception(VOUCHER_QUANTITY_INVALID);
+        }
+    }
+
+    /**
+     * 校验并构造分录辅助核算项目快照
+     *
+     * @param entryReqVO 分录保存信息
+     * @param subject 科目
+     * @param auxiliaryTypeMap 辅助核算类别 Map
+     * @param auxiliaryItemMap 辅助核算项目 Map
+     * @return 辅助核算项目快照数组
+     */
+    private List<FmsVoucherEntryDO.AuxiliaryItem> buildAuxiliaries(FmsVoucherEntrySaveReqVO entryReqVO, FmsSubjectDO subject,
+                                                                   Map<Long, FmsAuxiliaryTypeDO> auxiliaryTypeMap,
+                                                                   Map<Long, FmsAuxiliaryItemDO> auxiliaryItemMap) {
+        List<Long> auxiliaryTypeIds = ObjUtil.defaultIfNull(subject.getAuxiliaryTypeIds(), Collections.emptyList());
+        List<FmsVoucherEntrySaveReqVO.AuxiliaryItem> requested = ObjUtil.defaultIfNull(entryReqVO.getAuxiliaries(), Collections.emptyList());
+        Map<Long, FmsVoucherEntrySaveReqVO.AuxiliaryItem> requestedMap = convertMap(
+                requested, FmsVoucherEntrySaveReqVO.AuxiliaryItem::getTypeId);
+        if (auxiliaryTypeIds.size() != requested.size() || requestedMap.size() != requested.size()) {
+            throw exception(VOUCHER_AUXILIARY_REQUIRED);
+        }
+
+        // 按科目配置顺序校验项目归属和启用状态，并保存名称快照
+        List<FmsVoucherEntryDO.AuxiliaryItem> auxiliaries = new ArrayList<>();
+        for (Long auxiliaryTypeId : auxiliaryTypeIds) {
+            FmsVoucherEntrySaveReqVO.AuxiliaryItem requestItem = requestedMap.get(auxiliaryTypeId);
+            FmsAuxiliaryItemDO item = requestItem == null ? null
+                    : auxiliaryItemMap.get(requestItem.getItemId());
+            if (item == null || ObjUtil.notEqual(item.getAuxiliaryTypeId(), auxiliaryTypeId)
+                    || ObjUtil.notEqual(item.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+                throw exception(VOUCHER_AUXILIARY_REQUIRED);
+            }
+            auxiliaries.add(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                    .type(auxiliaryTypeMap.get(auxiliaryTypeId).getType())
+                    .typeId(auxiliaryTypeId).itemId(item.getId())
+                    .name(item.getName()).build());
+        }
+        return auxiliaries;
+    }
+
+    private List<FmsVoucherDO> validateVoucherList(Long accountSetId, List<Long> ids) {
+        List<FmsVoucherDO> vouchers = voucherMapper.selectListByIdsAndAccountSetId(ids, accountSetId);
+        if (vouchers.size() != ids.size()) {
+            throw exception(VOUCHER_NOT_EXISTS);
+        }
+        return vouchers;
+    }
+
+    private FmsVoucherDO validateVoucherExists(Long accountSetId, Long id) {
+        FmsVoucherDO voucher = voucherMapper.selectById(id);
+        if (voucher == null || ObjUtil.notEqual(voucher.getAccountSetId(), accountSetId)) {
+            throw exception(VOUCHER_NOT_EXISTS);
+        }
+        return voucher;
+    }
+
+    private Long getVoucherEntryCountByAuxiliary(Long accountSetId,
+                                                 Predicate<FmsVoucherEntryDO.AuxiliaryItem> predicate) {
+        List<FmsVoucherEntryDO> entries = voucherEntryMapper.selectListByAccountSetId(accountSetId);
+        return count(entries, entry -> CollUtil.isNotEmpty(entry.getAuxiliaries())
+                && entry.getAuxiliaries().stream().anyMatch(predicate));
+    }
+
+    private void validateVoucherEditable(FmsVoucherDO voucher) {
+        if (ObjUtil.equal(voucher.getStatus(), FmsVoucherStatusEnum.APPROVED.getStatus())) {
+            throw exception(VOUCHER_APPROVED_NOT_EDITABLE);
+        }
+    }
+
+    private void validateClosingVoucherEditable(Long accountSetId, Collection<Long> voucherIds) {
+        if (CollUtil.isNotEmpty(closingVoucherService.getClosingVoucherIdSet(accountSetId, voucherIds))) {
+            throw exception(VOUCHER_CLOSING_GENERATED_NOT_EDITABLE);
+        }
+    }
+
+    private void validateVoucherNumberUnique(Long id, Long accountSetId, Long voucherWordId,
+            LocalDateTime voucherTime, Integer voucherNumber) {
+        YearMonth month = YearMonth.from(voucherTime);
+        LocalDateTime monthBeginTime = LocalDateTimeUtils.getMonthBeginTime(month);
+        LocalDateTime nextMonthBeginTime = LocalDateTimeUtils.getNextMonthBeginTime(month);
+        FmsVoucherDO voucher = voucherMapper.selectByAccountSetIdAndVoucherWordIdAndVoucherNumberAndVoucherTimeBetween(
+                accountSetId, voucherWordId, voucherNumber,
+                monthBeginTime, nextMonthBeginTime);
+        if (voucher != null && ObjUtil.notEqual(voucher.getId(), id)) {
+            throw exception(VOUCHER_NUMBER_DUPLICATE);
+        }
+    }
+
+    private LocalDateTime normalizeVoucherTime(LocalDateTime voucherTime) {
+        return LocalDateTimeUtils.beginOfDay(voucherTime);
+    }
+
+    private BigDecimal normalizeAmount(BigDecimal amount) {
+        return MoneyUtils.priceScale(amount);
+    }
+
+}
diff --git a/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/util/FmsPeriodUtils.java b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/util/FmsPeriodUtils.java
new file mode 100644
index 0000000..68b1b30
--- /dev/null
+++ b/yudao-module-fms/src/main/java/cn/iocoder/yudao/module/fms/util/FmsPeriodUtils.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.fms.util;
+
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import lombok.experimental.UtilityClass;
+
+import java.time.YearMonth;
+
+/**
+ * FMS 会计期间工具类
+ *
+ * @author 芋道源码
+ */
+@UtilityClass
+public final class FmsPeriodUtils {
+
+    /**
+     * 获得报表和结账内部使用的本年起始期间。
+     *
+     * 年初取数仍然按自然年计算；账套启用当年从启用期间开始，避免内部查询落到账套启用前的期间。
+     *
+     * @param accountSet 账套
+     * @param endMonth 结束期间
+     * @return 有效的本年起始期间
+     */
+    public static YearMonth getYearStartMonth(FmsAccountSetDO accountSet, YearMonth endMonth) {
+        YearMonth yearStartMonth = YearMonth.of(endMonth.getYear(), 1);
+        if (accountSet == null || accountSet.getStartTime() == null) {
+            return yearStartMonth;
+        }
+        YearMonth accountStartMonth = YearMonth.from(accountSet.getStartTime());
+        return accountStartMonth.isAfter(yearStartMonth) ? accountStartMonth : yearStartMonth;
+    }
+
+}
diff --git a/yudao-module-fms/src/main/resources/fms/closing/closing-scheme-presets.json b/yudao-module-fms/src/main/resources/fms/closing/closing-scheme-presets.json
new file mode 100644
index 0000000..742dbc8
--- /dev/null
+++ b/yudao-module-fms/src/main/resources/fms/closing/closing-scheme-presets.json
@@ -0,0 +1,114 @@
+[
+  {
+    "code": "profit-loss",
+    "name": "结转损益",
+    "closingType": "PROFIT_LOSS",
+    "digest": "结转本期损益",
+    "periodEnd": true,
+    "closingDay": 31,
+    "voucherType": "COMBINED_GAIN_AND_LOSS",
+    "reverseBalance": true,
+    "priorYearAdjustmentSubject": "PRIOR_YEAR_ADJUSTMENT",
+    "adjustmentClosingSubject": "PRIOR_YEAR_ADJUSTMENT_CLOSING",
+    "otherClosingSubject": "CURRENT_YEAR_PROFIT",
+    "entries": []
+  },
+  {
+    "code": "unpaid-vat",
+    "name": "转出未交增值税",
+    "closingType": "UNPAID_VAT",
+    "digest": "转出未交增值税",
+    "periodEnd": true,
+    "closingDay": 31,
+    "calculationSubjects": [
+      "VAT_PAYABLE"
+    ],
+    "entries": [
+      {
+        "subject": "UNPAID_VAT",
+        "digest": "转出未交增值税",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subject": "OUTPUT_VAT",
+        "digest": "转出未交增值税",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "local-tax",
+    "name": "计提地税",
+    "closingType": "LOCAL_TAX",
+    "digest": "计提地税",
+    "periodEnd": true,
+    "closingDay": 31,
+    "calculationSubjects": [
+      "VAT_PAYABLE",
+      "CONSUMPTION_TAX"
+    ],
+    "entries": [
+      {
+        "subject": "EDUCATION_SURCHARGE",
+        "digest": "计提教育费附加",
+        "direction": "DEBIT",
+        "amountRatio": 3
+      },
+      {
+        "subject": "EDUCATION_SURCHARGE_PAYABLE",
+        "digest": "计提教育费附加",
+        "direction": "CREDIT",
+        "amountRatio": 3
+      },
+      {
+        "subject": "CITY_MAINTENANCE_TAX",
+        "digest": "计提城建费",
+        "direction": "DEBIT",
+        "amountRatio": 7
+      },
+      {
+        "subject": "CITY_MAINTENANCE_TAX_PAYABLE",
+        "digest": "计提城建费",
+        "direction": "CREDIT",
+        "amountRatio": 7
+      },
+      {
+        "subject": "LOCAL_EDUCATION_SURCHARGE",
+        "digest": "计提地方教育费附加",
+        "direction": "DEBIT",
+        "amountRatio": 2
+      },
+      {
+        "subject": "LOCAL_EDUCATION_SURCHARGE_PAYABLE",
+        "digest": "计提地方教育费附加",
+        "direction": "CREDIT",
+        "amountRatio": 2
+      }
+    ]
+  },
+  {
+    "code": "income-tax",
+    "name": "计提所得税",
+    "closingType": "INCOME_TAX",
+    "digest": "计提所得税",
+    "periodEnd": true,
+    "closingDay": 31,
+    "calculationSubjects": [],
+    "entries": [
+      {
+        "subject": "INCOME_TAX_EXPENSE",
+        "digest": "计提所得税",
+        "direction": "DEBIT",
+        "amountRatio": 25
+      },
+      {
+        "subject": "INCOME_TAX_PAYABLE",
+        "digest": "计提所得税",
+        "direction": "CREDIT",
+        "amountRatio": 25
+      }
+    ]
+  }
+]
diff --git a/yudao-module-fms/src/main/resources/fms/closing/closing-template-presets.json b/yudao-module-fms/src/main/resources/fms/closing/closing-template-presets.json
new file mode 100644
index 0000000..7e410c2
--- /dev/null
+++ b/yudao-module-fms/src/main/resources/fms/closing/closing-template-presets.json
@@ -0,0 +1,458 @@
+[
+  {
+    "code": "daily-travel-reimbursement",
+    "name": "报销差旅费",
+    "category": "DAILY_EXPENSE",
+    "sort": 10,
+    "entries": [
+      {
+        "subjectCode": "560107",
+        "digest": "报销差旅费",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1001",
+        "digest": "报销差旅费",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-telephone-expense",
+    "name": "报销电话费",
+    "category": "DAILY_EXPENSE",
+    "sort": 20,
+    "entries": [
+      {
+        "subjectCode": "560101",
+        "digest": "报销电话费",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1001",
+        "digest": "报销电话费",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-bank-fee",
+    "name": "支付银行手续费",
+    "category": "DAILY_EXPENSE",
+    "sort": 30,
+    "entries": [
+      {
+        "subjectCode": "560303",
+        "digest": "支付银行手续费",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1002",
+        "digest": "支付银行手续费",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-payroll",
+    "name": "支付工资",
+    "category": "DAILY_EXPENSE",
+    "sort": 40,
+    "entries": [
+      {
+        "subjectCode": "2211",
+        "digest": "支付工资",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1001",
+        "digest": "支付工资",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-rent-utilities",
+    "name": "支付房租水电费",
+    "category": "DAILY_EXPENSE",
+    "sort": 50,
+    "entries": [
+      {
+        "subjectCode": "560102",
+        "digest": "支付房租水电费",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1001",
+        "digest": "支付房租水电费",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-local-tax-payment",
+    "name": "缴纳地税款",
+    "category": "DAILY_EXPENSE",
+    "sort": 60,
+    "entries": [
+      {
+        "subjectCode": "222117",
+        "digest": "缴纳地税款",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1002",
+        "digest": "缴纳地税款",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-income-tax-payment",
+    "name": "缴纳所得税",
+    "category": "DAILY_EXPENSE",
+    "sort": 70,
+    "entries": [
+      {
+        "subjectCode": "222111",
+        "digest": "缴纳所得税",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1002",
+        "digest": "缴纳所得税",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-vat-payment",
+    "name": "缴纳增值税",
+    "category": "DAILY_EXPENSE",
+    "sort": 80,
+    "entries": [
+      {
+        "subjectCode": "222102",
+        "digest": "缴纳增值税",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1002",
+        "digest": "缴纳增值税",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-interest-income",
+    "name": "利息收入",
+    "category": "DAILY_EXPENSE",
+    "sort": 90,
+    "entries": [
+      {
+        "subjectCode": "1002",
+        "digest": "利息收入",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "560302",
+        "digest": "利息收入",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-cash-withdrawal",
+    "name": "提现金",
+    "category": "DAILY_EXPENSE",
+    "sort": 100,
+    "entries": [
+      {
+        "subjectCode": "1002",
+        "digest": "提现金",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "560302",
+        "digest": "提现金",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "daily-business-entertainment",
+    "name": "报销业务招待费用",
+    "category": "DAILY_EXPENSE",
+    "sort": 110,
+    "entries": [
+      {
+        "subjectCode": "1001",
+        "digest": "报销业务招待费用",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1002",
+        "digest": "报销业务招待费用",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "purchase-bank-payment",
+    "name": "采购商品（银行付款）",
+    "category": "PURCHASE_SALE",
+    "sort": 10,
+    "entries": [
+      {
+        "subjectCode": "1405",
+        "digest": "采购商品（银行付款）",
+        "direction": "DEBIT",
+        "amountRatio": 86
+      },
+      {
+        "subjectCode": "22210101",
+        "digest": "采购商品（银行付款）",
+        "direction": "DEBIT",
+        "amountRatio": 14
+      },
+      {
+        "subjectCode": "1002",
+        "digest": "采购商品（银行付款）",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "purchase-payable",
+    "name": "采购商品（应付款）",
+    "category": "PURCHASE_SALE",
+    "sort": 20,
+    "entries": [
+      {
+        "subjectCode": "1405",
+        "digest": "采购商品（应付款）",
+        "direction": "DEBIT",
+        "amountRatio": 86
+      },
+      {
+        "subjectCode": "22210101",
+        "digest": "采购商品（应付款）",
+        "direction": "DEBIT",
+        "amountRatio": 14
+      },
+      {
+        "subjectCode": "2202",
+        "digest": "采购商品（应付款）",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "sale-bank-receipt",
+    "name": "销售商品（银行收款）",
+    "category": "PURCHASE_SALE",
+    "sort": 30,
+    "entries": [
+      {
+        "subjectCode": "1002",
+        "digest": "销售商品（银行收款）",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "5001",
+        "digest": "销售商品（银行收款）",
+        "direction": "CREDIT",
+        "amountRatio": 86
+      },
+      {
+        "subjectCode": "22210107",
+        "digest": "销售商品（银行收款）",
+        "direction": "CREDIT",
+        "amountRatio": 14
+      }
+    ]
+  },
+  {
+    "code": "sale-cash-receipt",
+    "name": "销售商品（现金收款）",
+    "category": "PURCHASE_SALE",
+    "sort": 40,
+    "entries": [
+      {
+        "subjectCode": "1001",
+        "digest": "销售商品（现金收款）",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "5001",
+        "digest": "销售商品（现金收款）",
+        "direction": "CREDIT",
+        "amountRatio": 86
+      },
+      {
+        "subjectCode": "22210107",
+        "digest": "销售商品（现金收款）",
+        "direction": "CREDIT",
+        "amountRatio": 14
+      }
+    ]
+  },
+  {
+    "code": "sale-receivable",
+    "name": "销售商品（应收）",
+    "category": "PURCHASE_SALE",
+    "sort": 50,
+    "entries": [
+      {
+        "subjectCode": "1122",
+        "digest": "销售商品（应收）",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "5001",
+        "digest": "销售商品（应收）",
+        "direction": "CREDIT",
+        "amountRatio": 86
+      },
+      {
+        "subjectCode": "22210107",
+        "digest": "销售商品（应收）",
+        "direction": "CREDIT",
+        "amountRatio": 14
+      }
+    ]
+  },
+  {
+    "code": "current-personal-loan",
+    "name": "个人借款",
+    "category": "CURRENT_ACCOUNT",
+    "sort": 10,
+    "entries": [
+      {
+        "subjectCode": "1221",
+        "digest": "个人借款",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1001",
+        "digest": "个人借款",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "current-personal-repayment",
+    "name": "个人还款",
+    "category": "CURRENT_ACCOUNT",
+    "sort": 20,
+    "entries": [
+      {
+        "subjectCode": "1001",
+        "digest": "个人还款",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1221",
+        "digest": "个人还款",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "current-receive-payment",
+    "name": "收货款",
+    "category": "CURRENT_ACCOUNT",
+    "sort": 30,
+    "entries": [
+      {
+        "subjectCode": "1002",
+        "digest": "收货款",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1122",
+        "digest": "收货款",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "current-pay-supplier",
+    "name": "支付货款",
+    "category": "CURRENT_ACCOUNT",
+    "sort": 40,
+    "entries": [
+      {
+        "subjectCode": "2202",
+        "digest": "支付货款",
+        "direction": "DEBIT",
+        "amountRatio": 100
+      },
+      {
+        "subjectCode": "1002",
+        "digest": "支付货款",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  },
+  {
+    "code": "transfer-accrue-payroll",
+    "name": "计提工资",
+    "category": "TRANSFER_BUSINESS",
+    "sort": 10,
+    "entries": [
+      {
+        "subjectCode": "560110",
+        "digest": "计提工资",
+        "direction": "DEBIT",
+        "amountRatio": 15
+      },
+      {
+        "subjectCode": "560209",
+        "digest": "计提工资",
+        "direction": "DEBIT",
+        "amountRatio": 85
+      },
+      {
+        "subjectCode": "2211",
+        "digest": "计提工资",
+        "direction": "CREDIT",
+        "amountRatio": 100
+      }
+    ]
+  }
+]
diff --git a/yudao-module-fms/src/main/resources/fms/config/finance-indicator-presets.json b/yudao-module-fms/src/main/resources/fms/config/finance-indicator-presets.json
new file mode 100644
index 0000000..c5c63b3
--- /dev/null
+++ b/yudao-module-fms/src/main/resources/fms/config/finance-indicator-presets.json
@@ -0,0 +1,114 @@
+[
+  {
+    "code": "income",
+    "name": "收入",
+    "type": 2,
+    "formula": "L1",
+    "sort": 10
+  },
+  {
+    "code": "operatingCost",
+    "name": "成本",
+    "type": 2,
+    "formula": "L2+L3",
+    "sort": 20
+  },
+  {
+    "code": "profit",
+    "name": "利润",
+    "type": 2,
+    "formula": "L30",
+    "sort": 30
+  },
+  {
+    "code": "expense",
+    "name": "费用",
+    "type": 2,
+    "formula": "L11+L14+L18",
+    "sort": 40
+  },
+  {
+    "code": "other",
+    "name": "其他",
+    "type": 2,
+    "formula": "L30+L11+L14+L18+L2+L3-L1",
+    "sort": 50
+  },
+  {
+    "code": "cash",
+    "name": "现金",
+    "type": 1,
+    "formula": "[{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"1001\"},{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"1012\"}]",
+    "sort": 60
+  },
+  {
+    "code": "bank",
+    "name": "银行存款",
+    "type": 1,
+    "formula": "[{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"1002\"}]",
+    "sort": 70
+  },
+  {
+    "code": "inventory",
+    "name": "存货",
+    "type": 1,
+    "formula": "L9",
+    "sort": 80
+  },
+  {
+    "code": "liabilityTotal",
+    "name": "负债总额",
+    "type": 1,
+    "formula": "L47",
+    "sort": 90
+  },
+  {
+    "code": "loan",
+    "name": "贷款总额",
+    "type": 1,
+    "formula": "L31+L42",
+    "sort": 100
+  },
+  {
+    "code": "receivable",
+    "name": "应收账款",
+    "type": 1,
+    "formula": "[{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"1122\"}]",
+    "sort": 110
+  },
+  {
+    "code": "payable",
+    "name": "应付账款",
+    "type": 1,
+    "formula": "[{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"2202\"}]",
+    "sort": 120
+  },
+  {
+    "code": "taxPayable",
+    "name": "应交税费",
+    "type": 1,
+    "formula": "[{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"2221\"}]",
+    "sort": 130
+  },
+  {
+    "code": "mainIncome",
+    "name": "主营业务收入",
+    "type": 2,
+    "formula": "[{\"operator\":\"+\",\"rules\":6,\"subjectNumber\":\"5001\"}]",
+    "sort": 140
+  },
+  {
+    "code": "otherIncome",
+    "name": "营业外收入",
+    "type": 2,
+    "formula": "[{\"operator\":\"+\",\"rules\":6,\"subjectNumber\":\"5301\"}]",
+    "sort": 150
+  },
+  {
+    "code": "fixedAssets",
+    "name": "固定资产",
+    "type": 1,
+    "formula": "L20",
+    "sort": 160
+  }
+]
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerMultiColumnExcelHelperTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerMultiColumnExcelHelperTest.java
new file mode 100644
index 0000000..20bd945
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/controller/admin/ledger/FmsLedgerMultiColumnExcelHelperTest.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.fms.controller.admin.ledger;
+
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.multicolumn.FmsLedgerMultiColumnRespVO;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+public class FmsLedgerMultiColumnExcelHelperTest {
+
+    @Test
+    public void testBuildHeadAndData() {
+        // mock 数据
+        FmsLedgerMultiColumnRespVO.Column debitColumn = new FmsLedgerMultiColumnRespVO.Column()
+                .setSubjectId(101L).setSubjectCode("660201").setSubjectName("办公费")
+                .setBalanceDirection(FmsDebitCreditDirectionEnum.DEBIT.getType());
+        FmsLedgerMultiColumnRespVO.Column creditColumn = new FmsLedgerMultiColumnRespVO.Column()
+                .setSubjectId(102L).setSubjectCode("2202").setSubjectName("应付账款")
+                .setBalanceDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+        Map<Long, BigDecimal> columnAmounts = new LinkedHashMap<>();
+        columnAmounts.put(debitColumn.getSubjectId(), new BigDecimal("80.00"));
+        columnAmounts.put(creditColumn.getSubjectId(), new BigDecimal("30.00"));
+        FmsLedgerDetailRespVO row = new FmsLedgerDetailRespVO()
+                .setAccountDate(LocalDate.of(2026, 8, 31)).setVoucherNumber("记-1")
+                .setDigest("期末余额").setDebitAmount(BigDecimal.ZERO).setCreditAmount(BigDecimal.ZERO)
+                .setBalanceDirection("借").setBalance(new BigDecimal("50.00"))
+                .setColumnAmounts(columnAmounts);
+        FmsLedgerMultiColumnRespVO result = new FmsLedgerMultiColumnRespVO()
+                .setColumns(Arrays.asList(creditColumn, debitColumn))
+                .setRows(Collections.singletonList(row));
+
+        // 调用
+        List<List<String>> head = FmsLedgerMultiColumnExcelHelper.buildHead(result);
+        List<List<Object>> data = FmsLedgerMultiColumnExcelHelper.buildData(result);
+
+        // 断言
+        assertEquals(9, head.size());
+        assertEquals(Arrays.asList("借", "660201/办公费"), head.get(7));
+        assertEquals(Arrays.asList("贷", "2202/应付账款"), head.get(8));
+        assertEquals(1, data.size());
+        assertEquals(new BigDecimal("80.00"), data.get(0).get(7));
+        assertEquals(new BigDecimal("30.00"), data.get(0).get(8));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodServiceImplTest.java
new file mode 100644
index 0000000..0e1f653
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingPeriodServiceImplTest.java
@@ -0,0 +1,428 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingOverviewRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsTrialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.income.FmsIncomeStatementCheckRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingPeriodDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingPeriodMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherStatusEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.report.FmsBalanceSheetService;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collections;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.when;
+
+@Import(FmsClosingPeriodServiceImpl.class)
+public class FmsClosingPeriodServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsClosingPeriodServiceImpl closingPeriodService;
+    @Resource
+    private FmsClosingPeriodMapper closingPeriodMapper;
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+    @MockitoBean
+    private FmsClosingVoucherService closingVoucherService;
+    @MockitoBean
+    private FmsFinanceParameterService financeParameterService;
+    @MockitoBean
+    private FmsInitialBalanceService initialBalanceService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsLedgerService ledgerService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+    @MockitoBean
+    private FmsBalanceSheetService balanceSheetService;
+    @MockitoBean
+    private FmsIncomeStatementService incomeStatementService;
+
+    @Test
+    public void testGetCurrentMonth_noClosingPeriod() {
+        // 准备参数
+        LocalDateTime startTime = LocalDateTime.of(2026, 3, 1, 0, 0);
+
+        // 调用，并断言
+        assertEquals(YearMonth.of(2026, 3), closingPeriodService.getCurrentMonth(1L, startTime));
+    }
+
+    @Test
+    public void testGetCurrentMonth_hasClosingPeriod() {
+        // mock 数据
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 6, 30, 0, 0)).setAccountSetId(1L));
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 7, 31, 0, 0)).setAccountSetId(1L));
+
+        // 调用，并断言
+        assertEquals(YearMonth.of(2026, 8), closingPeriodService.getCurrentMonth(
+                1L, LocalDateTime.of(2026, 3, 1, 0, 0)));
+    }
+
+    @Test
+    public void testGetCurrentMonth() {
+        // mock 数据
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L)).thenReturn(
+                new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        closingPeriodMapper.insert(buildClosingPeriod(1L, YearMonth.of(2026, 8)));
+
+        // 调用，并断言
+        assertEquals("2026-08", closingPeriodService.getCurrentMonth(1L, 10L));
+    }
+
+    @Test
+    public void testGetClosingOverview_excludeClosingVoucherFromPendingCount() {
+        // mock 数据
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L)).thenReturn(
+                new FmsAccountSetDO().setId(1L).setInitialized(true));
+        when(voucherService.getVoucherListByPeriod(eq(1L), any(), any())).thenReturn(Arrays.asList(
+                new FmsVoucherDO().setId(11L).setVoucherWordId(1L).setVoucherNumber(1)
+                        .setStatus(FmsVoucherStatusEnum.PENDING_REVIEW.getStatus()),
+                new FmsVoucherDO().setId(12L).setVoucherWordId(1L).setVoucherNumber(2)
+                        .setStatus(FmsVoucherStatusEnum.PENDING_REVIEW.getStatus()),
+                new FmsVoucherDO().setId(13L).setVoucherWordId(1L).setVoucherNumber(3)
+                        .setStatus(FmsVoucherStatusEnum.APPROVED.getStatus())));
+        when(closingVoucherService.getClosingVoucherListByPeriod(eq(1L), any(), any()))
+                .thenReturn(Collections.singletonList(new FmsClosingVoucherDO().setVoucherId(12L)));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L))).thenReturn(Collections.emptyList());
+        when(balanceSheetService.getBalanceSheet(any(), eq(10L))).thenReturn(Collections.emptyList());
+        when(financeParameterService.getFinanceParameter(1L, 10L))
+                .thenReturn(new FmsFinanceParameterDO().setVoucherReviewRequired(true));
+
+        // 调用
+        FmsClosingOverviewRespVO overview = closingPeriodService.getClosingOverview(
+                buildClosingQueryReqVO(), 10L);
+
+        // 断言
+        assertEquals(1L, overview.getPendingVoucherCount());
+        assertEquals(3L, overview.getVoucherCount());
+    }
+
+    @Test
+    public void testGetClosingOverview_allChecksPassed() {
+        // mock 数据
+        mockClosePeriodChecks();
+
+        // 调用
+        FmsClosingOverviewRespVO overview = closingPeriodService.getClosingOverview(
+                buildClosingQueryReqVO(), 10L);
+
+        // 断言
+        assertEquals(true, overview.getInitialBalanceBalanced());
+        assertEquals(true, overview.getVoucherNumberContinuous());
+        assertEquals(true, overview.getProfitLossVoucherGenerated());
+        assertEquals(true, overview.getIncomeStatementBalanced());
+        assertEquals(0, overview.getIncomeStatementUnmappedSubjectCount());
+        assertEquals(true, overview.getBalanceSheetProfitLossTransferred());
+        assertEquals(true, overview.getBalanceSheetBalanced());
+        assertEquals(0, overview.getBalanceSheetUnmappedSubjectCount());
+        assertEquals(true, overview.getCanClose());
+    }
+
+    @Test
+    public void testClosePeriod_notCurrentPeriod() {
+        // mock 数据
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(
+                new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        closingPeriodMapper.insert(buildClosingPeriod(1L, YearMonth.of(2026, 8)));
+
+        // 准备参数
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-07");
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingPeriodService.closePeriod(reqVO, 10L),
+                CLOSING_NOT_CURRENT_PERIOD);
+    }
+
+    @Test
+    public void testClosePeriod() {
+        // mock 数据
+        mockClosePeriodChecks();
+
+        // 准备参数
+        FmsClosingQueryReqVO reqVO = buildClosingQueryReqVO();
+
+        // 调用
+        closingPeriodService.closePeriod(reqVO, 10L);
+
+        // 断言
+        assertNotNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTime.of(2026, 8, 31, 23, 59, 59)));
+        verify(closingVoucherService).updateClosingVoucherClosedByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 8, 1, 0, 0)), true);
+    }
+
+    @Test
+    public void testClosePeriod_toTargetMonth() {
+        // mock 数据
+        mockClosePeriodChecks();
+
+        // 准备参数：当前期间为 2026-08，结账目标为 2026-09
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO()
+                .setAccountSetId(1L).setMonth("2026-09");
+
+        // 调用
+        closingPeriodService.closePeriod(reqVO, 10L);
+
+        // 断言：目标期间之前的每个月都已登记结账
+        assertNotNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0), LocalDateTimeUtils.endOfMonth(
+                        LocalDateTime.of(2026, 8, 1, 0, 0))));
+        assertNotNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 9, 1, 0, 0), LocalDateTimeUtils.endOfMonth(
+                        LocalDateTime.of(2026, 9, 1, 0, 0))));
+        verify(closingVoucherService).updateClosingVoucherClosedByPeriod(1L,
+                LocalDateTime.of(2026, 9, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 9, 1, 0, 0)), true);
+    }
+
+    @Test
+    public void testClosePeriod_initialBalanceUnbalanced() {
+        // mock 数据
+        mockClosePeriodChecks();
+        when(initialBalanceService.getTrialBalance(1L, 10L))
+                .thenReturn(new FmsTrialBalanceRespVO().setBalanced(false));
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingPeriodService.closePeriod(buildClosingQueryReqVO(), 10L),
+                CLOSING_INITIAL_BALANCE_UNBALANCED);
+        assertPeriodNotClosed();
+    }
+
+    @Test
+    public void testClosePeriod_voucherNumberDiscontinuous() {
+        // mock 数据
+        mockClosePeriodChecks();
+        when(voucherService.getVoucherListByPeriod(eq(1L), any(), any())).thenReturn(java.util.Arrays.asList(
+                new FmsVoucherDO().setVoucherWordId(1L).setVoucherNumber(1),
+                new FmsVoucherDO().setVoucherWordId(1L).setVoucherNumber(3)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingPeriodService.closePeriod(buildClosingQueryReqVO(), 10L),
+                CLOSING_VOUCHER_NUMBER_DISCONTINUOUS);
+        assertPeriodNotClosed();
+    }
+
+    @Test
+    public void testClosePeriod_profitLossActivityWithoutClosingVoucher() {
+        // mock 数据
+        mockClosePeriodChecks();
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Collections.singletonList(
+                new FmsSubjectDO().setId(1L).setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType())));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L))).thenReturn(Collections.singletonList(
+                new FmsLedgerSubjectBalanceRespVO().setSubjectId(1L)
+                        .setPeriodDebitAmount(new BigDecimal("100.00"))
+                        .setPeriodCreditAmount(new BigDecimal("100.00"))));
+
+        // 调用，并断言异常：损益净额为零，也不能绕过结转凭证检查
+        assertServiceException(() -> closingPeriodService.closePeriod(buildClosingQueryReqVO(), 10L),
+                CLOSING_PROFIT_LOSS_VOUCHER_MISSING);
+        assertPeriodNotClosed();
+    }
+
+    @Test
+    public void testClosePeriod_incomeStatementUnmappedSubject() {
+        // mock 数据
+        mockClosePeriodChecks();
+        when(incomeStatementService.checkIncomeStatement(any(), eq(10L)))
+                .thenReturn(new FmsIncomeStatementCheckRespVO().setBalanced(true)
+                        .setUnmappedSubjects(Collections.singletonList(
+                                new FmsIncomeStatementCheckRespVO.UnmappedSubject().setId(1L))));
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingPeriodService.closePeriod(buildClosingQueryReqVO(), 10L),
+                CLOSING_REPORT_SUBJECT_UNMAPPED);
+        assertPeriodNotClosed();
+    }
+
+    @Test
+    public void testClosePeriod_balanceSheetUnbalanced() {
+        // mock 数据
+        mockClosePeriodChecks();
+        when(balanceSheetService.checkBalanceSheet(any(), eq(10L)))
+                .thenReturn(new FmsBalanceSheetCheckRespVO().setBalanced(false)
+                        .setInitialBalanceBalanced(true).setProfitLossTransferred(true)
+                        .setUnmappedSubjects(Collections.emptyList()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingPeriodService.closePeriod(buildClosingQueryReqVO(), 10L),
+                CLOSING_BALANCE_SHEET_UNBALANCED);
+        assertPeriodNotClosed();
+    }
+
+    @Test
+    public void testCancelClosePeriod() {
+        // mock 数据
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true));
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 7, 31, 0, 0)).setAccountSetId(1L));
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 8, 31, 0, 0)).setAccountSetId(1L));
+        // 准备参数
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        closingPeriodService.cancelClosePeriod(reqVO, 10L);
+
+        // 断言
+        assertNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTime.of(2026, 8, 31, 23, 59, 59)));
+        assertEquals(YearMonth.of(2026, 7), YearMonth.from(closingPeriodMapper
+                .selectLatestByAccountSetId(1L).getClosingTime()));
+        verify(closingVoucherService).updateClosingVoucherClosedByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 8, 1, 0, 0)), false);
+    }
+
+    @Test
+    public void testCancelClosePeriod_targetAfterLatestPeriod() {
+        // mock 数据
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true));
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 7, 31, 0, 0)).setAccountSetId(1L));
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 8, 31, 0, 0)).setAccountSetId(1L));
+
+        // 准备参数
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-09");
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingPeriodService.cancelClosePeriod(reqVO, 10L),
+                CLOSING_PERIOD_NOT_CLOSED);
+        assertNotNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 7, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 7, 1, 0, 0))));
+        assertNotNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 8, 1, 0, 0))));
+        verify(closingVoucherService, never()).updateClosingVoucherClosedByPeriod(
+                any(), any(), any(), eq(false));
+    }
+
+    @Test
+    public void testCancelClosePeriod_toTargetMonth() {
+        // mock 数据
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true)
+                        .setStartTime(LocalDateTime.of(2026, 7, 1, 0, 0)));
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 7, 31, 0, 0)).setAccountSetId(1L));
+        closingPeriodMapper.insert(new FmsClosingPeriodDO()
+                .setClosingTime(LocalDateTime.of(2026, 8, 31, 0, 0)).setAccountSetId(1L));
+
+        // 准备参数：从最近期间反结账到 2026-07
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO()
+                .setAccountSetId(1L).setMonth("2026-07");
+
+        // 调用
+        closingPeriodService.cancelClosePeriod(reqVO, 10L);
+
+        // 断言：目标期间及之后的结账均已撤销
+        assertNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 7, 1, 0, 0), LocalDateTimeUtils.endOfMonth(
+                        LocalDateTime.of(2026, 7, 1, 0, 0))));
+        assertNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0), LocalDateTimeUtils.endOfMonth(
+                        LocalDateTime.of(2026, 8, 1, 0, 0))));
+        verify(closingVoucherService).updateClosingVoucherClosedByPeriod(1L,
+                LocalDateTime.of(2026, 7, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 7, 1, 0, 0)), false);
+        verify(closingVoucherService).updateClosingVoucherClosedByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 8, 1, 0, 0)), false);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsClosingPeriodDO buildClosingPeriod(Long accountSetId, YearMonth currentMonth) {
+        YearMonth previousMonth = currentMonth.minusMonths(1);
+        return new FmsClosingPeriodDO().setAccountSetId(accountSetId)
+                .setClosingTime(previousMonth.atEndOfMonth().atStartOfDay());
+    }
+
+    private FmsClosingQueryReqVO buildClosingQueryReqVO() {
+        return new FmsClosingQueryReqVO().setAccountSetId(1L).setMonth("2026-08");
+    }
+
+    private void mockClosePeriodChecks() {
+        LocalDateTime startTime = LocalDateTime.of(2026, 8, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(new FmsAccountSetDO().setId(1L)
+                .setInitialized(true).setStartTime(startTime));
+        when(financeParameterService.getFinanceParameter(1L, 10L))
+                .thenReturn(new FmsFinanceParameterDO().setVoucherReviewRequired(false));
+        closingPeriodMapper.insert(buildClosingPeriod(1L, YearMonth.of(2026, 8)));
+        when(voucherService.getVoucherListByPeriod(eq(1L), any(), any())).thenReturn(Collections.emptyList());
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L))).thenReturn(Collections.emptyList());
+        when(balanceSheetService.getBalanceSheet(any(), eq(10L))).thenReturn(Collections.emptyList());
+        when(initialBalanceService.getTrialBalance(1L, 10L))
+                .thenReturn(new FmsTrialBalanceRespVO().setBalanced(true));
+        when(incomeStatementService.checkIncomeStatement(any(), eq(10L)))
+                .thenReturn(new FmsIncomeStatementCheckRespVO().setBalanced(true)
+                        .setUnmappedSubjects(Collections.emptyList()));
+        when(balanceSheetService.checkBalanceSheet(any(), eq(10L)))
+                .thenReturn(new FmsBalanceSheetCheckRespVO().setBalanced(true)
+                        .setInitialBalanceBalanced(true).setProfitLossTransferred(true)
+                        .setUnmappedSubjects(Collections.emptyList()));
+    }
+
+    private void assertPeriodNotClosed() {
+        assertNull(closingPeriodMapper.selectByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTimeUtils.endOfMonth(LocalDateTime.of(2026, 8, 1, 0, 0))));
+        verify(closingVoucherService, never()).updateClosingVoucherClosedByPeriod(any(), any(), any(), eq(true));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeServiceImplTest.java
new file mode 100644
index 0000000..86a24a0
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingSchemeServiceImplTest.java
@@ -0,0 +1,467 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingQueryReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossSettingsSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsSpecialClosingSettingsSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingSchemeMapper;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingVoucherTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.BeforeEach;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_SCHEME_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_SCHEME_RATIO_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsClosingSchemeServiceImpl.class)
+public class FmsClosingSchemeServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsClosingSchemeServiceImpl closingSchemeService;
+    @Resource
+    private FmsClosingSchemeMapper closingSchemeMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsClosingVoucherService closingVoucherService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsFinanceParameterService financeParameterService;
+    @MockitoBean
+    private FmsLedgerService ledgerService;
+    @MockitoBean
+    private FmsVoucherWordService voucherWordService;
+    @MockitoBean
+    private FmsIncomeStatementService incomeStatementService;
+
+    @BeforeEach
+    public void before() {
+        when(financeParameterService.getFinanceParameter(1L)).thenReturn(new FmsFinanceParameterDO()
+                .setSubjectCodeRule(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE));
+        when(financeParameterService.convertStandardSubjectCode(any(), any()))
+                .thenAnswer(invocation -> invocation.getArgument(0));
+    }
+
+    @Test
+    public void testGetClosingSchemeCountByVoucherWordId() {
+        // mock 数据
+        closingSchemeMapper.insert(new FmsClosingSchemeDO().setName("结转损益")
+                .setAccountSetId(1L).setVoucherWordId(11L));
+        closingSchemeMapper.insert(new FmsClosingSchemeDO().setName("结转损益")
+                .setAccountSetId(2L).setVoucherWordId(11L));
+
+        // 调用，并断言
+        assertEquals(1L, closingSchemeService.getClosingSchemeCountByVoucherWordId(1L, 11L));
+        assertEquals(0L, closingSchemeService.getClosingSchemeCountByVoucherWordId(1L, 12L));
+    }
+
+    @Test
+    public void testSaveProfitLossSettings() {
+        // mock 数据
+        FmsSubjectDO adjustmentSubject = new FmsSubjectDO().setId(101L).setCode("6000")
+                .setName("以前年度损益调整").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO adjustmentClosingSubject = new FmsSubjectDO().setId(102L).setCode("3104")
+                .setName("利润分配").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        FmsSubjectDO otherClosingSubject = new FmsSubjectDO().setId(103L).setCode("3103")
+                .setName("本年利润").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                adjustmentSubject, adjustmentClosingSubject, otherClosingSubject));
+
+        // 准备参数
+        FmsProfitLossSettingsSaveReqVO reqVO = new FmsProfitLossSettingsSaveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setVoucherWordId(11L);
+        reqVO.setDigest("期末结转损益");
+        reqVO.setVoucherType(FmsClosingVoucherTypeEnum.SEPARATE_GAIN_AND_LOSS.getType());
+        reqVO.setPriorYearAdjustmentSubjectId(101L);
+        reqVO.setAdjustmentClosingSubjectId(102L);
+        reqVO.setOtherClosingSubjectId(103L);
+        reqVO.setReverseBalance(true);
+        reqVO.setClosingDay(28);
+
+        // 调用
+        Long id = closingSchemeService.saveProfitLossSettings(reqVO, 10L);
+
+        // 断言
+        FmsClosingSchemeDO closing = closingSchemeMapper.selectById(id);
+        assertEquals("期末结转损益", closing.getDigest());
+        assertEquals(FmsClosingVoucherTypeEnum.SEPARATE_GAIN_AND_LOSS.getType(), closing.getVoucherType());
+        assertEquals(101L, closing.getPriorYearAdjustmentSubjectId());
+        assertEquals(102L, closing.getAdjustmentClosingSubjectId());
+        assertEquals(103L, closing.getOtherClosingSubjectId());
+        assertEquals(28, closing.getClosingDay());
+        verify(voucherWordService).validateVoucherWordExists(1L, 11L);
+    }
+
+    @Test
+    public void testCreateClosingScheme() {
+        // mock 数据
+        FmsSubjectDO sourceSubject = new FmsSubjectDO().setId(101L).setCode("6602")
+                .setName("管理费用");
+        FmsSubjectDO debitSubject = new FmsSubjectDO().setId(102L).setCode("660201")
+                .setName("房租");
+        FmsSubjectDO creditSubject = new FmsSubjectDO().setId(103L).setCode("2701")
+                .setName("长期待摊费用");
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Arrays.asList(sourceSubject, debitSubject, creditSubject));
+
+        // 准备参数
+        FmsClosingSchemeSaveReqVO reqVO = buildClosingSchemeSaveReqVO();
+
+        // 调用
+        Long id = closingSchemeService.createClosingScheme(reqVO, 10L);
+
+        // 断言
+        FmsClosingSchemeDO closing = closingSchemeMapper.selectById(id);
+        assertEquals("结转本月房租", closing.getName());
+        assertEquals(FmsClosingTypeEnum.REGULAR.getType(), closing.getType());
+        assertEquals(2, closing.getSubjectRules().size());
+        assertEquals("660201", closing.getSubjectRules().get(0).getSubjectCode());
+        assertEquals("2701", closing.getSubjectRules().get(1).getSubjectCode());
+    }
+
+    @Test
+    public void testUpdateClosingScheme_ratioInvalid() {
+        // mock 数据
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setName("原结转方案")
+                .setAccountSetId(1L).setType(FmsClosingTypeEnum.REGULAR.getType());
+        closingSchemeMapper.insert(closing);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setCode("6602"),
+                new FmsSubjectDO().setId(102L).setCode("660201"),
+                new FmsSubjectDO().setId(103L).setCode("2701")));
+
+        // 准备参数
+        FmsClosingSchemeSaveReqVO reqVO = buildClosingSchemeSaveReqVO();
+        reqVO.setId(closing.getId());
+        reqVO.setName("非法比例方案");
+        reqVO.getSubjects().get(0).setAmountRatio(new BigDecimal("99"));
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingSchemeService.updateClosingScheme(reqVO, 10L),
+                CLOSING_SCHEME_RATIO_INVALID);
+        assertEquals("原结转方案", closingSchemeMapper.selectById(closing.getId()).getName());
+    }
+
+    @Test
+    public void testDeleteClosingScheme_inUse() {
+        // mock 数据
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setName("已生成凭证方案")
+                .setAccountSetId(1L).setType(FmsClosingTypeEnum.REGULAR.getType());
+        closingSchemeMapper.insert(closing);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(closingVoucherService.getClosingVoucherCountByClosingId(closing.getId())).thenReturn(1L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingSchemeService.deleteClosingScheme(1L, closing.getId(), 10L),
+                CLOSING_SCHEME_IN_USE);
+        assertNotNull(closingSchemeMapper.selectById(closing.getId()));
+    }
+
+    @Test
+    public void testUpdateSpecialClosingSettings() {
+        // mock 数据
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setName("计提附加税")
+                .setAccountSetId(1L).setVoucherWordId(11L)
+                .setType(FmsClosingTypeEnum.LOCAL_TAX.getType());
+        closingSchemeMapper.insert(closing);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setCode("540303"),
+                new FmsSubjectDO().setId(102L).setCode("222113")));
+
+        // 准备参数
+        FmsSpecialClosingSettingsSaveReqVO reqVO = new FmsSpecialClosingSettingsSaveReqVO();
+        reqVO.setId(closing.getId());
+        reqVO.setAccountSetId(1L);
+        reqVO.setVoucherWordId(12L);
+        FmsSpecialClosingSettingsSaveReqVO.SubjectRule debitRule =
+                new FmsSpecialClosingSettingsSaveReqVO.SubjectRule();
+        debitRule.setSubjectId(101L);
+        debitRule.setDigest("计提附加税");
+        debitRule.setDirection(FmsDebitCreditDirectionEnum.DEBIT.getType());
+        debitRule.setAmountRatio(new BigDecimal("5"));
+        FmsSpecialClosingSettingsSaveReqVO.SubjectRule creditRule =
+                new FmsSpecialClosingSettingsSaveReqVO.SubjectRule();
+        creditRule.setSubjectId(102L);
+        creditRule.setDigest("计提附加税");
+        creditRule.setDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+        creditRule.setAmountRatio(new BigDecimal("5"));
+        reqVO.setSubjects(Arrays.asList(debitRule, creditRule));
+
+        // 调用
+        closingSchemeService.updateSpecialClosingSettings(reqVO, 10L);
+
+        // 断言
+        FmsClosingSchemeDO actual = closingSchemeMapper.selectById(closing.getId());
+        assertEquals(12L, actual.getVoucherWordId());
+        assertEquals("540303", actual.getSubjectRules().get(0).getSubjectCode());
+        assertEquals("222113", actual.getSubjectRules().get(1).getSubjectCode());
+        verify(voucherWordService).validateVoucherWordExists(1L, 12L);
+    }
+
+    @Test
+    public void testInitializeDefaultClosingSchemes() {
+        // mock 数据
+        List<FmsSubjectDO> subjects = buildSpecialClosingSubjects();
+        subjects.add(new FmsSubjectDO().setId(401L).setCode("6000"));
+        subjects.add(new FmsSubjectDO().setId(402L).setCode("310415"));
+        subjects.add(new FmsSubjectDO().setId(403L).setCode("3103"));
+        subjects.add(new FmsSubjectDO().setId(404L).setCode("222101"));
+        subjects.add(new FmsSubjectDO().setId(405L).setCode("222121"));
+        when(voucherWordService.getVoucherWordList(1L)).thenReturn(Collections.singletonList(
+                new FmsVoucherWordDO().setId(11L).setDefaultStatus(true)));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(subjects);
+
+        // 调用
+        closingSchemeService.initializeDefaultClosingSchemes(1L, 10L);
+        closingSchemeService.initializeDefaultClosingSchemes(1L, 10L);
+
+        // 断言
+        List<FmsClosingSchemeDO> closings = closingSchemeMapper.selectListByAccountSetId(1L);
+        assertEquals(4, closings.size());
+        FmsClosingSchemeDO profitLossClosing = CollUtil.findOne(closings,
+                item -> item.getType().equals(FmsClosingTypeEnum.PROFIT_LOSS.getType()));
+        assertNotNull(profitLossClosing);
+        assertEquals(11L, profitLossClosing.getVoucherWordId());
+        assertEquals(401L, profitLossClosing.getPriorYearAdjustmentSubjectId());
+        assertEquals(402L, profitLossClosing.getAdjustmentClosingSubjectId());
+        assertEquals(403L, profitLossClosing.getOtherClosingSubjectId());
+        assertEquals(FmsClosingTypeEnum.PROFIT_LOSS.getDigest(), profitLossClosing.getDigest());
+        assertEquals(FmsClosingVoucherTypeEnum.COMBINED_GAIN_AND_LOSS.getType(),
+                profitLossClosing.getVoucherType());
+        assertEquals(FmsClosingTypeEnum.UNPAID_VAT.getDigest(), CollUtil.findOne(closings,
+                item -> item.getType().equals(FmsClosingTypeEnum.UNPAID_VAT.getType())).getDigest());
+        assertEquals(FmsClosingTypeEnum.LOCAL_TAX.getDigest(), CollUtil.findOne(closings,
+                item -> item.getType().equals(FmsClosingTypeEnum.LOCAL_TAX.getType())).getDigest());
+        assertEquals(FmsClosingTypeEnum.INCOME_TAX.getDigest(), CollUtil.findOne(closings,
+                item -> item.getType().equals(FmsClosingTypeEnum.INCOME_TAX.getType())).getDigest());
+    }
+
+    @Test
+    public void testGetClosingSchemeList_notInitializeOnQuery() {
+        // mock 数据
+        List<FmsSubjectDO> subjects = buildSpecialClosingSubjects();
+        FmsSubjectDO vatSubject = new FmsSubjectDO().setId(201L).setCode("222101")
+                .setName("应交增值税");
+        FmsSubjectDO consumptionTaxSubject = new FmsSubjectDO().setId(202L).setCode("222121")
+                .setName("应交消费税");
+        subjects.add(vatSubject);
+        subjects.add(consumptionTaxSubject);
+        subjects.add(new FmsSubjectDO().setId(203L).setCode("6000"));
+        subjects.add(new FmsSubjectDO().setId(204L).setCode("310415"));
+        subjects.add(new FmsSubjectDO().setId(205L).setCode("3103"));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(voucherWordService.getVoucherWordList(1L)).thenReturn(Collections.singletonList(
+                new FmsVoucherWordDO().setId(11L).setDefaultStatus(true)));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(subjects);
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L))).thenReturn(Arrays.asList(
+                new FmsLedgerSubjectBalanceRespVO().setSubjectId(201L)
+                        .setEndingDebitAmount(BigDecimal.ZERO).setEndingCreditAmount(new BigDecimal("1000.00"))
+                        .setChildren(Collections.emptyList()),
+                new FmsLedgerSubjectBalanceRespVO().setSubjectId(202L)
+                        .setEndingDebitAmount(BigDecimal.ZERO).setEndingCreditAmount(new BigDecimal("500.00"))
+                        .setChildren(Collections.emptyList())));
+        when(incomeStatementService.getIncomeStatement(any(), eq(10L))).thenReturn(Arrays.asList(
+                new FmsReportItemRespVO().setRowNo(30).setYearAmount(new BigDecimal("10000.00")),
+                new FmsReportItemRespVO().setRowNo(30).setYearAmount(new BigDecimal("20000.00")),
+                new FmsReportItemRespVO().setRowNo(31).setYearAmount(new BigDecimal("1000.00"))));
+        closingSchemeService.initializeDefaultClosingSchemes(1L, 10L);
+        Long closingCount = closingSchemeMapper.selectCount();
+
+        // 准备参数
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        List<FmsClosingSchemeRespVO> results = closingSchemeService.getClosingSchemeList(reqVO, 10L);
+
+        // 断言
+        assertEquals(4, results.size());
+        FmsClosingSchemeRespVO unpaidVatClosing = CollUtil.findOne(results,
+                item -> item.getType().equals(FmsClosingTypeEnum.UNPAID_VAT.getType()));
+        FmsClosingSchemeRespVO localTaxClosing = CollUtil.findOne(results,
+                item -> item.getType().equals(FmsClosingTypeEnum.LOCAL_TAX.getType()));
+        FmsClosingSchemeRespVO incomeTaxClosing = CollUtil.findOne(results,
+                item -> item.getType().equals(FmsClosingTypeEnum.INCOME_TAX.getType()));
+        assertEquals(new BigDecimal("1000.00"), unpaidVatClosing.getBalance());
+        assertEquals(new BigDecimal("180.00"), localTaxClosing.getBalance());
+        assertEquals(new BigDecimal("1500.00"), incomeTaxClosing.getBalance());
+        assertEquals(6, localTaxClosing.getSubjects().size());
+        assertEquals(new BigDecimal("25"), incomeTaxClosing.getSubjects().get(0).getAmountRatio());
+        assertEquals(closingCount, closingSchemeMapper.selectCount());
+    }
+
+    @Test
+    public void testGetClosingSchemeList_yearBeginBalance() {
+        // mock 数据
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setName("年初余额结转")
+                .setAccountSetId(1L).setType(FmsClosingTypeEnum.REGULAR.getType()).setPeriodEnd(true)
+                .setSubjectId(101L).setFormulaRule(FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                .setTimeType(FmsClosingTimeTypeEnum.YEAR_BEGIN.getType());
+        closingSchemeMapper.insert(closing);
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Collections.singletonList(
+                new FmsSubjectDO().setId(101L).setCode("1001")));
+        FmsLedgerSubjectBalanceRespVO currentBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setOpeningDebitAmount(new BigDecimal("150.00")).setOpeningCreditAmount(BigDecimal.ZERO)
+                .setEndingDebitAmount(new BigDecimal("160.00")).setEndingCreditAmount(BigDecimal.ZERO)
+                .setChildren(Collections.emptyList());
+        FmsLedgerSubjectBalanceRespVO yearBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setOpeningDebitAmount(new BigDecimal("100.00")).setOpeningCreditAmount(BigDecimal.ZERO)
+                .setEndingDebitAmount(new BigDecimal("160.00")).setEndingCreditAmount(BigDecimal.ZERO)
+                .setChildren(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(currentBalance), Collections.singletonList(yearBalance));
+        when(closingVoucherService.getClosingVoucherListByPeriod(eq(1L), any(), any()))
+                .thenReturn(Collections.emptyList());
+
+        // 准备参数
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        List<FmsClosingSchemeRespVO> results = closingSchemeService.getClosingSchemeList(reqVO, 10L);
+
+        // 断言
+        assertEquals(1, results.size());
+        assertEquals(new BigDecimal("100.00"), results.get(0).getBalance());
+    }
+
+    @Test
+    public void testGetClosingSchemeList_sumGeneratedVoucherAmounts() {
+        // mock 数据
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setName("结转损益")
+                .setAccountSetId(1L).setType(FmsClosingTypeEnum.PROFIT_LOSS.getType()).setPeriodEnd(true);
+        closingSchemeMapper.insert(closing);
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L))).thenReturn(Collections.emptyList());
+        when(closingVoucherService.getClosingVoucherListByPeriod(eq(1L), any(), any()))
+                .thenReturn(Arrays.asList(
+                        new FmsClosingVoucherDO().setClosingId(closing.getId()).setVoucherId(801L)
+                                .setAmount(new BigDecimal("400.00")),
+                        new FmsClosingVoucherDO().setClosingId(closing.getId()).setVoucherId(802L)
+                                .setAmount(new BigDecimal("600.00"))));
+
+        // 调用
+        List<FmsClosingSchemeRespVO> results = closingSchemeService.getClosingSchemeList(
+                new FmsClosingQueryReqVO().setAccountSetId(1L).setMonth("2026-08"), 10L);
+
+        // 断言
+        assertEquals(1, results.size());
+        assertEquals(new BigDecimal("1000.00"), results.get(0).getBalance());
+        assertEquals(Arrays.asList(801L, 802L), results.get(0).getVoucherIds());
+    }
+
+    @Test
+    public void testGetClosingSchemeList_filterNonPeriodEndRegularScheme() {
+        // mock 数据
+        closingSchemeMapper.insert(new FmsClosingSchemeDO().setName("非期末自动结转方案")
+                .setAccountSetId(1L).setType(FmsClosingTypeEnum.REGULAR.getType()).setPeriodEnd(false));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        // 准备参数
+        FmsClosingQueryReqVO reqVO = new FmsClosingQueryReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        List<FmsClosingSchemeRespVO> results = closingSchemeService.getClosingSchemeList(reqVO, 10L);
+
+        // 断言
+        assertEquals(0, results.size());
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsClosingSchemeSaveReqVO buildClosingSchemeSaveReqVO() {
+        FmsClosingSchemeSaveReqVO reqVO = new FmsClosingSchemeSaveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setName("结转本月房租");
+        reqVO.setPeriodEnd(true);
+        reqVO.setSubjectId(101L);
+        reqVO.setFormulaRule(FmsFormulaRuleEnum.BALANCE.getRule());
+        reqVO.setTimeType(FmsClosingTimeTypeEnum.PERIOD_END.getType());
+        reqVO.setVoucherWordId(11L);
+        FmsClosingSchemeSaveReqVO.SubjectRule debitRule = new FmsClosingSchemeSaveReqVO.SubjectRule();
+        debitRule.setSubjectId(102L);
+        debitRule.setDigest("结转本月房租");
+        debitRule.setDirection(FmsDebitCreditDirectionEnum.DEBIT.getType());
+        debitRule.setAmountRatio(new BigDecimal("100"));
+        FmsClosingSchemeSaveReqVO.SubjectRule creditRule = new FmsClosingSchemeSaveReqVO.SubjectRule();
+        creditRule.setSubjectId(103L);
+        creditRule.setDigest("结转本月房租");
+        creditRule.setDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+        creditRule.setAmountRatio(new BigDecimal("100"));
+        reqVO.setSubjects(Arrays.asList(debitRule, creditRule));
+        return reqVO;
+    }
+
+    private List<FmsSubjectDO> buildSpecialClosingSubjects() {
+        return new ArrayList<>(Arrays.asList(
+                new FmsSubjectDO().setId(301L).setCode("22210104"),
+                new FmsSubjectDO().setId(302L).setCode("222102"),
+                new FmsSubjectDO().setId(303L).setCode("540310"),
+                new FmsSubjectDO().setId(304L).setCode("222113"),
+                new FmsSubjectDO().setId(305L).setCode("540303"),
+                new FmsSubjectDO().setId(306L).setCode("222117"),
+                new FmsSubjectDO().setId(307L).setCode("540313"),
+                new FmsSubjectDO().setId(308L).setCode("222114"),
+                new FmsSubjectDO().setId(309L).setCode("5801"),
+                new FmsSubjectDO().setId(310L).setCode("222111")));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateServiceImplTest.java
new file mode 100644
index 0000000..3ef759e
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingTemplateServiceImplTest.java
@@ -0,0 +1,259 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingTemplateSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingTemplateMapper;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTemplateCategoryEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_SCHEME_RATIO_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_TEMPLATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_TEMPLATE_PRESET_SUBJECT_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsClosingTemplateServiceImpl.class)
+public class FmsClosingTemplateServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsClosingTemplateServiceImpl closingTemplateService;
+    @Resource
+    private FmsClosingTemplateMapper closingTemplateMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsFinanceParameterService financeParameterService;
+
+    @BeforeEach
+    public void before() {
+        when(financeParameterService.getFinanceParameter(any())).thenReturn(new FmsFinanceParameterDO()
+                .setSubjectCodeRule(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE));
+        when(financeParameterService.convertStandardSubjectCode(any(), any()))
+                .thenAnswer(invocation -> invocation.getArgument(0));
+    }
+
+    @Test
+    public void testInitializeClosingTemplates() {
+        // mock 方法
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(buildPresetSubjects());
+
+        // 调用
+        closingTemplateService.initializeClosingTemplates(1L, 10L);
+        closingTemplateService.initializeClosingTemplates(1L, 10L);
+
+        // 断言
+        List<FmsClosingTemplateDO> templates = closingTemplateMapper.selectListByAccountSetId(1L);
+        assertEquals(21, templates.size());
+        assertEquals(4L, templates.stream().map(FmsClosingTemplateDO::getCategory).distinct().count());
+        assertEquals(21L, templates.stream().map(FmsClosingTemplateDO::getPresetCode).distinct().count());
+    }
+
+    @Test
+    public void testInitializeClosingTemplates_accountSetIsolation() {
+        // mock 方法
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(buildPresetSubjects());
+        when(subjectService.getSubjectList(2L, null, 10L)).thenReturn(buildPresetSubjects());
+
+        // 调用
+        closingTemplateService.initializeClosingTemplates(1L, 10L);
+        closingTemplateService.initializeClosingTemplates(2L, 10L);
+
+        // 断言
+        assertEquals(21, closingTemplateMapper.selectListByAccountSetId(1L).size());
+        assertEquals(21, closingTemplateMapper.selectListByAccountSetId(2L).size());
+    }
+
+    @Test
+    public void testInitializeClosingTemplates_subjectNotExists() {
+        // mock 方法
+        List<FmsSubjectDO> subjects = buildPresetSubjects();
+        subjects.remove(0);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(subjects);
+
+        // 调用，并断言
+        assertServiceException(() -> closingTemplateService.initializeClosingTemplates(1L, 10L),
+                CLOSING_TEMPLATE_PRESET_SUBJECT_NOT_EXISTS, "daily-travel-reimbursement", "1001");
+        assertEquals(0, closingTemplateMapper.selectCount());
+    }
+
+    @Test
+    public void testGetClosingTemplateList() {
+        // mock 数据
+        closingTemplateMapper.insert(new FmsClosingTemplateDO().setAccountSetId(1L)
+                .setName("账套一模板").setCategory(FmsClosingTemplateCategoryEnum.DAILY_EXPENSE.getCategory()));
+        closingTemplateMapper.insert(new FmsClosingTemplateDO().setAccountSetId(2L)
+                .setName("账套二模板").setCategory(FmsClosingTemplateCategoryEnum.DAILY_EXPENSE.getCategory()));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+
+        // 调用
+        List<?> templates = closingTemplateService.getClosingTemplateList(1L, 10L);
+
+        // 断言
+        assertEquals(1, templates.size());
+        verify(accountSetService).validateAccountSetReadPermission(1L, 10L);
+    }
+
+    @Test
+    public void testCreateClosingTemplate() {
+        // mock 数据
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(buildClosingTemplateSubjects());
+
+        // 准备参数
+        FmsClosingTemplateSaveReqVO reqVO = buildClosingTemplateSaveReqVO();
+
+        // 调用
+        Long id = closingTemplateService.createClosingTemplate(reqVO, 10L);
+
+        // 断言
+        FmsClosingTemplateDO template = closingTemplateMapper.selectById(id);
+        assertEquals("结转本月房租", template.getName());
+        assertEquals(2, template.getSubjectRules().size());
+        assertEquals("560102", template.getSubjectRules().get(0).getSubjectCode());
+        assertEquals("1001", template.getSubjectRules().get(1).getSubjectCode());
+        verify(accountSetService).validateAccountSetWritePermission(1L, 10L);
+    }
+
+    @Test
+    public void testCreateClosingTemplate_ratioInvalid() {
+        // mock 数据
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(buildClosingTemplateSubjects());
+
+        // 准备参数
+        FmsClosingTemplateSaveReqVO reqVO = buildClosingTemplateSaveReqVO();
+        reqVO.getSubjects().get(0).setAmountRatio(new BigDecimal("99"));
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingTemplateService.createClosingTemplate(reqVO, 10L),
+                CLOSING_SCHEME_RATIO_INVALID);
+        assertEquals(0, closingTemplateMapper.selectCount());
+    }
+
+    @Test
+    public void testUpdateClosingTemplate() {
+        // mock 数据
+        FmsClosingTemplateDO template = new FmsClosingTemplateDO().setAccountSetId(1L)
+                .setName("原模板").setCategory(FmsClosingTemplateCategoryEnum.DAILY_EXPENSE.getCategory());
+        closingTemplateMapper.insert(template);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(buildClosingTemplateSubjects());
+
+        // 准备参数
+        FmsClosingTemplateSaveReqVO reqVO = buildClosingTemplateSaveReqVO();
+        reqVO.setId(template.getId());
+        reqVO.setName("修改后模板");
+
+        // 调用
+        closingTemplateService.updateClosingTemplate(reqVO, 10L);
+
+        // 断言
+        assertEquals("修改后模板", closingTemplateMapper.selectById(template.getId()).getName());
+    }
+
+    @Test
+    public void testUpdateClosingTemplate_notExists() {
+        // mock 数据
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+
+        // 准备参数
+        FmsClosingTemplateSaveReqVO reqVO = buildClosingTemplateSaveReqVO();
+        reqVO.setId(999L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> closingTemplateService.updateClosingTemplate(reqVO, 10L),
+                CLOSING_TEMPLATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testDeleteClosingTemplate() {
+        // mock 数据
+        FmsClosingTemplateDO template = new FmsClosingTemplateDO().setAccountSetId(1L)
+                .setName("待删除模板").setCategory(FmsClosingTemplateCategoryEnum.DAILY_EXPENSE.getCategory());
+        closingTemplateMapper.insert(template);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+
+        // 调用
+        closingTemplateService.deleteClosingTemplate(1L, template.getId(), 10L);
+
+        // 断言
+        assertNull(closingTemplateMapper.selectById(template.getId()));
+        verify(accountSetService).validateAccountSetWritePermission(1L, 10L);
+    }
+
+    // ========== 随机对象 ==========
+
+    private List<FmsSubjectDO> buildPresetSubjects() {
+        List<String> subjectCodes = Arrays.asList("1001", "1002", "1122", "1221", "1405", "2202", "2211",
+                "22210101", "22210107", "222102", "222111", "222117", "5001", "560101", "560102",
+                "560107", "560110", "560209", "560302", "560303");
+        List<FmsSubjectDO> subjects = new ArrayList<>();
+        for (int index = 0; index < subjectCodes.size(); index++) {
+            subjects.add(new FmsSubjectDO().setId((long) index + 1).setCode(subjectCodes.get(index))
+                    .setName("科目" + index));
+        }
+        return subjects;
+    }
+
+    private List<FmsSubjectDO> buildClosingTemplateSubjects() {
+        return Arrays.asList(
+                new FmsSubjectDO().setId(101L).setCode("560102").setName("房租"),
+                new FmsSubjectDO().setId(102L).setCode("1001").setName("库存现金"));
+    }
+
+    private FmsClosingTemplateSaveReqVO buildClosingTemplateSaveReqVO() {
+        FmsClosingTemplateSaveReqVO reqVO = new FmsClosingTemplateSaveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setName("结转本月房租");
+        reqVO.setCategory(FmsClosingTemplateCategoryEnum.DAILY_EXPENSE.getCategory());
+        reqVO.setPeriodEnd(true);
+        reqVO.setFormulaRule(FmsFormulaRuleEnum.BALANCE.getRule());
+        reqVO.setTimeType(FmsClosingTimeTypeEnum.PERIOD_END.getType());
+        reqVO.setSort(10);
+        FmsClosingTemplateSaveReqVO.SubjectRule debitRule = new FmsClosingTemplateSaveReqVO.SubjectRule();
+        debitRule.setSubjectId(101L);
+        debitRule.setDigest("结转本月房租");
+        debitRule.setDirection(FmsDebitCreditDirectionEnum.DEBIT.getType());
+        debitRule.setAmountRatio(new BigDecimal("100"));
+        FmsClosingTemplateSaveReqVO.SubjectRule creditRule = new FmsClosingTemplateSaveReqVO.SubjectRule();
+        creditRule.setSubjectId(102L);
+        creditRule.setDigest("结转本月房租");
+        creditRule.setDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+        creditRule.setAmountRatio(new BigDecimal("100"));
+        reqVO.setSubjects(Arrays.asList(debitRule, creditRule));
+        return reqVO;
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherServiceImplTest.java
new file mode 100644
index 0000000..cd4053d
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/closing/FmsClosingVoucherServiceImplTest.java
@@ -0,0 +1,596 @@
+package cn.iocoder.yudao.module.fms.service.closing;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsProfitLossGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingSchemeGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingVoucherGenerateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerEntryVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherEntrySaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.closing.FmsClosingVoucherMapper;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTimeTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingVoucherTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_NOT_CURRENT_PERIOD;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CLOSING_SCHEME_NOT_PERIOD_END;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsClosingVoucherServiceImpl.class)
+public class FmsClosingVoucherServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsClosingVoucherServiceImpl closingVoucherService;
+    @Resource
+    private FmsClosingVoucherMapper closingVoucherMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsClosingPeriodService closingPeriodService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsLedgerService ledgerService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+    @MockitoBean
+    private FmsVoucherWordService voucherWordService;
+    @MockitoBean
+    private FmsIncomeStatementService incomeStatementService;
+
+    @Test
+    public void testGetClosingVoucherIdSet() {
+        // mock 数据
+        closingVoucherMapper.insert(new FmsClosingVoucherDO()
+                .setAccountSetId(1L).setClosingId(11L).setVoucherId(21L));
+        closingVoucherMapper.insert(new FmsClosingVoucherDO()
+                .setAccountSetId(2L).setClosingId(12L).setVoucherId(22L));
+
+        // 调用，并断言
+        assertEquals(Collections.singleton(21L), closingVoucherService.getClosingVoucherIdSet(
+                1L, Arrays.asList(21L, 22L, 23L)));
+    }
+
+    @Test
+    public void testGetClosingVoucherListByClosingIdAndPeriod() {
+        // mock 数据
+        closingVoucherMapper.insert(new FmsClosingVoucherDO().setAccountSetId(1L)
+                .setClosingId(11L).setVoucherId(21L)
+                .setVoucherTime(LocalDateTime.of(2026, 7, 31, 0, 0)));
+        closingVoucherMapper.insert(new FmsClosingVoucherDO().setAccountSetId(1L)
+                .setClosingId(11L).setVoucherId(22L)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 31, 0, 0)));
+        closingVoucherMapper.insert(new FmsClosingVoucherDO().setAccountSetId(1L)
+                .setClosingId(12L).setVoucherId(23L)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 31, 0, 0)));
+
+        // 调用
+        List<FmsClosingVoucherDO> result = closingVoucherService.getClosingVoucherListByClosingIdAndPeriod(
+                11L, LocalDateTime.of(2026, 8, 1, 0, 0), LocalDateTime.of(2026, 9, 1, 0, 0));
+
+        // 断言
+        assertEquals(1, result.size());
+        assertEquals(22L, result.get(0).getVoucherId());
+    }
+
+    @Test
+    public void testGenerateProfitLossVoucher() {
+        // mock 数据
+        FmsSubjectDO revenueSubject = new FmsSubjectDO().setId(101L).setCode("5001")
+                .setName("主营业务收入").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO expenseSubject = new FmsSubjectDO().setId(102L).setCode("5601")
+                .setName("销售费用").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO profitSubject = new FmsSubjectDO().setId(103L).setCode("3103")
+                .setName("本年利润").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        FmsSubjectDO adjustmentSubject = new FmsSubjectDO().setId(104L).setCode("6000")
+                .setName("以前年度损益调整").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO adjustmentClosingSubject = new FmsSubjectDO().setId(105L).setCode("3104")
+                .setName("利润分配").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        FmsLedgerSubjectBalanceRespVO revenueBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setPeriodDebitAmount(BigDecimal.ZERO).setPeriodCreditAmount(new BigDecimal("11300.00"))
+                .setChildren(Collections.emptyList());
+        FmsLedgerSubjectBalanceRespVO expenseBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(102L)
+                .setPeriodDebitAmount(new BigDecimal("2200.00")).setPeriodCreditAmount(BigDecimal.ZERO)
+                .setChildren(Collections.emptyList());
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Arrays.asList(revenueSubject, expenseSubject, profitSubject,
+                        adjustmentSubject, adjustmentClosingSubject));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Arrays.asList(revenueBalance, expenseBalance));
+        when(voucherService.getNextVoucherNumber(eq(1L), eq(11L), any(), eq(10L))).thenReturn(4);
+        when(voucherService.createVoucher(any(), eq(10L))).thenReturn(99L);
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setId(1L)
+                .setName("结转损益").setPeriodEnd(true)
+                .setVoucherWordId(11L).setDigest("期末结转损益")
+                .setVoucherType(FmsClosingVoucherTypeEnum.COMBINED_GAIN_AND_LOSS.getType())
+                .setPriorYearAdjustmentSubjectId(104L).setAdjustmentClosingSubjectId(105L)
+                .setOtherClosingSubjectId(103L).setReverseBalance(true)
+                .setType(FmsClosingTypeEnum.PROFIT_LOSS.getType())
+                .setAccountSetId(1L).setClosingDay(31);
+        when(closingSchemeService.getClosingSchemeByAccountSetIdAndType(
+                1L, FmsClosingTypeEnum.PROFIT_LOSS.getType())).thenReturn(closing);
+
+        // 准备参数
+        FmsProfitLossGenerateReqVO reqVO = new FmsProfitLossGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        Long voucherId = closingVoucherService.generateProfitLossVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(99L, voucherId);
+        ArgumentCaptor<FmsVoucherSaveReqVO> voucherCaptor = ArgumentCaptor.forClass(FmsVoucherSaveReqVO.class);
+        verify(voucherService).createVoucher(voucherCaptor.capture(), eq(10L));
+        List<FmsVoucherEntrySaveReqVO> entries = voucherCaptor.getValue().getEntries();
+        assertEquals(3, entries.size());
+        assertEquals(4, voucherCaptor.getValue().getVoucherNumber());
+        assertEquals(new BigDecimal("11300.00"), entries.get(0).getDebitAmount());
+        assertEquals(new BigDecimal("2200.00"), entries.get(1).getCreditAmount());
+        assertEquals(new BigDecimal("9100.00"), entries.get(2).getCreditAmount());
+        assertEquals("期末结转损益", entries.get(0).getDigest());
+        List<FmsClosingVoucherDO> closingVouchers = closingVoucherMapper.selectListByPeriod(1L,
+                java.time.LocalDateTime.of(2026, 8, 1, 0, 0),
+                java.time.LocalDateTime.of(2026, 8, 31, 23, 59, 59));
+        assertEquals(1, closingVouchers.size());
+        assertEquals(99L, closingVouchers.get(0).getVoucherId());
+    }
+
+    @Test
+    public void testGenerateProfitLossVoucher_withAuxiliary() {
+        // mock 数据
+        FmsSubjectDO expenseSubject = new FmsSubjectDO().setId(102L).setCode("5601")
+                .setName("销售费用").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType())
+                .setAuxiliaryTypeIds(Collections.singletonList(11L));
+        FmsSubjectDO profitSubject = new FmsSubjectDO().setId(103L).setCode("3103")
+                .setName("本年利润").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        FmsSubjectDO adjustmentSubject = new FmsSubjectDO().setId(104L).setCode("6000")
+                .setName("以前年度损益调整").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO adjustmentClosingSubject = new FmsSubjectDO().setId(105L).setCode("3104")
+                .setName("利润分配").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        FmsLedgerSubjectBalanceRespVO expenseBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(102L)
+                .setPeriodDebitAmount(new BigDecimal("200.00")).setPeriodCreditAmount(BigDecimal.ZERO)
+                .setChildren(Collections.emptyList());
+        FmsLedgerEntryVO ledgerEntry = new FmsLedgerEntryVO().setSubjectId(102L)
+                .setDebitAmount(new BigDecimal("200.00")).setCreditAmount(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .type(1).typeId(11L).itemId(21L).name("回归客户").build()));
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(
+                new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                expenseSubject, profitSubject, adjustmentSubject, adjustmentClosingSubject));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(expenseBalance));
+        when(ledgerService.getEntryList(1L, LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTime.of(2026, 9, 1, 0, 0), 10L)).thenReturn(Collections.singletonList(ledgerEntry));
+        when(voucherService.getNextVoucherNumber(eq(1L), eq(11L), any(), eq(10L))).thenReturn(4);
+        when(voucherService.createVoucher(any(), eq(10L))).thenReturn(99L);
+        when(closingSchemeService.getClosingSchemeByAccountSetIdAndType(
+                1L, FmsClosingTypeEnum.PROFIT_LOSS.getType())).thenReturn(new FmsClosingSchemeDO().setId(1L)
+                .setName("结转损益").setPeriodEnd(true).setVoucherWordId(11L).setDigest("期末结转损益")
+                .setVoucherType(FmsClosingVoucherTypeEnum.COMBINED_GAIN_AND_LOSS.getType())
+                .setPriorYearAdjustmentSubjectId(104L).setAdjustmentClosingSubjectId(105L)
+                .setOtherClosingSubjectId(103L).setReverseBalance(true)
+                .setType(FmsClosingTypeEnum.PROFIT_LOSS.getType()).setAccountSetId(1L).setClosingDay(31));
+
+        // 准备参数
+        FmsProfitLossGenerateReqVO reqVO = new FmsProfitLossGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        closingVoucherService.generateProfitLossVoucher(reqVO, 10L);
+
+        // 断言
+        ArgumentCaptor<FmsVoucherSaveReqVO> voucherCaptor = ArgumentCaptor.forClass(FmsVoucherSaveReqVO.class);
+        verify(voucherService).createVoucher(voucherCaptor.capture(), eq(10L));
+        List<FmsVoucherEntrySaveReqVO> entries = voucherCaptor.getValue().getEntries();
+        assertEquals(2, entries.size());
+        assertEquals(4, voucherCaptor.getValue().getVoucherNumber());
+        assertEquals(102L, entries.get(0).getSubjectId());
+        assertEquals(new BigDecimal("200.00"), entries.get(0).getCreditAmount());
+        assertEquals(1, entries.get(0).getAuxiliaries().size());
+        assertEquals(11L, entries.get(0).getAuxiliaries().get(0).getTypeId());
+        assertEquals(21L, entries.get(0).getAuxiliaries().get(0).getItemId());
+        assertEquals(103L, entries.get(1).getSubjectId());
+        assertEquals(new BigDecimal("200.00"), entries.get(1).getDebitAmount());
+    }
+
+    @Test
+    public void testGenerateProfitLossVoucher_separateGainAndLoss() {
+        // mock 数据
+        FmsSubjectDO revenueSubject = new FmsSubjectDO().setId(101L).setCode("5001")
+                .setName("主营业务收入").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO expenseSubject = new FmsSubjectDO().setId(102L).setCode("5601")
+                .setName("销售费用").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO profitSubject = new FmsSubjectDO().setId(103L).setCode("3103")
+                .setName("本年利润").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        FmsSubjectDO adjustmentSubject = new FmsSubjectDO().setId(104L).setCode("6000")
+                .setName("以前年度损益调整").setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO adjustmentClosingSubject = new FmsSubjectDO().setId(105L).setCode("3104")
+                .setName("利润分配").setType(FmsSubjectTypeEnum.EQUITY.getType());
+        FmsLedgerSubjectBalanceRespVO revenueBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setPeriodDebitAmount(BigDecimal.ZERO).setPeriodCreditAmount(new BigDecimal("11300.00"))
+                .setChildren(Collections.emptyList());
+        FmsLedgerSubjectBalanceRespVO expenseBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(102L)
+                .setPeriodDebitAmount(new BigDecimal("2200.00")).setPeriodCreditAmount(BigDecimal.ZERO)
+                .setChildren(Collections.emptyList());
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                revenueSubject, expenseSubject, profitSubject,
+                adjustmentSubject, adjustmentClosingSubject));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Arrays.asList(revenueBalance, expenseBalance));
+        when(voucherService.createVoucher(any(), eq(10L))).thenReturn(99L, 100L);
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setId(1L)
+                .setName("结转损益").setPeriodEnd(true)
+                .setVoucherWordId(11L).setDigest("结转损益")
+                .setVoucherType(FmsClosingVoucherTypeEnum.SEPARATE_GAIN_AND_LOSS.getType())
+                .setPriorYearAdjustmentSubjectId(104L).setAdjustmentClosingSubjectId(105L)
+                .setOtherClosingSubjectId(103L).setReverseBalance(true)
+                .setType(FmsClosingTypeEnum.PROFIT_LOSS.getType())
+                .setAccountSetId(1L).setClosingDay(30);
+        when(closingSchemeService.getClosingSchemeByAccountSetIdAndType(
+                1L, FmsClosingTypeEnum.PROFIT_LOSS.getType())).thenReturn(closing);
+
+        // 准备参数
+        FmsProfitLossGenerateReqVO reqVO = new FmsProfitLossGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        Long voucherId = closingVoucherService.generateProfitLossVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(99L, voucherId);
+        ArgumentCaptor<FmsVoucherSaveReqVO> voucherCaptor = ArgumentCaptor.forClass(FmsVoucherSaveReqVO.class);
+        verify(voucherService, times(2)).createVoucher(voucherCaptor.capture(), eq(10L));
+        List<FmsVoucherSaveReqVO> vouchers = voucherCaptor.getAllValues();
+        assertEquals(2, vouchers.size());
+        assertEquals(2, vouchers.get(0).getEntries().size());
+        assertEquals(new BigDecimal("11300.00"), vouchers.get(0).getEntries().get(0).getDebitAmount());
+        assertEquals(new BigDecimal("11300.00"), vouchers.get(0).getEntries().get(1).getCreditAmount());
+        assertEquals(2, vouchers.get(1).getEntries().size());
+        assertEquals(new BigDecimal("2200.00"), vouchers.get(1).getEntries().get(0).getCreditAmount());
+        assertEquals(new BigDecimal("2200.00"), vouchers.get(1).getEntries().get(1).getDebitAmount());
+        assertEquals(LocalDateTime.of(2026, 8, 30, 0, 0), vouchers.get(0).getVoucherTime());
+        assertEquals(2, closingVoucherMapper.selectListByPeriod(1L,
+                LocalDateTime.of(2026, 8, 1, 0, 0),
+                LocalDateTime.of(2026, 8, 31, 23, 59, 59)).size());
+    }
+
+    @Test
+    public void testGenerateClosingSchemeVoucher_yearBeginBalance() {
+        // mock 数据
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setId(1L)
+                .setName("结转本月房租").setPeriodEnd(true)
+                .setSubjectId(101L).setFormulaRule(FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                .setTimeType(FmsClosingTimeTypeEnum.YEAR_BEGIN.getType()).setVoucherWordId(11L)
+                .setType(FmsClosingTypeEnum.REGULAR.getType()).setAccountSetId(1L)
+                .setSubjectRules(Arrays.asList(
+                        FmsClosingSchemeDO.SubjectRule.builder().subjectId(102L).digest("结转本月房租")
+                                .direction(FmsDebitCreditDirectionEnum.DEBIT.getType())
+                                .amountRatio(new BigDecimal("100")).build(),
+                        FmsClosingSchemeDO.SubjectRule.builder().subjectId(103L).digest("结转本月房租")
+                                .direction(FmsDebitCreditDirectionEnum.CREDIT.getType())
+                                .amountRatio(new BigDecimal("100")).build()));
+        when(closingSchemeService.validateClosingSchemeExists(1L, closing.getId())).thenReturn(closing);
+        closingVoucherMapper.insert(new FmsClosingVoucherDO().setClosingId(closing.getId())
+                .setVoucherId(77L).setVoucherTime(LocalDateTime.of(2026, 8, 31, 0, 0))
+                .setAmount(new BigDecimal("1200.00")).setAccountSetId(1L));
+        FmsLedgerSubjectBalanceRespVO sourceBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setOpeningDebitAmount(new BigDecimal("100.00"))
+                .setOpeningCreditAmount(BigDecimal.ZERO)
+                .setEndingDebitAmount(new BigDecimal("1200.00"))
+                .setEndingCreditAmount(BigDecimal.ZERO).setChildren(Collections.emptyList());
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(sourceBalance));
+        when(voucherService.getNextVoucherNumber(eq(1L), eq(11L), any(), eq(10L))).thenReturn(4);
+        when(voucherService.createVoucher(any(), eq(10L))).thenReturn(88L);
+        doAnswer(invocation -> {
+            assertEquals(0, closingVoucherMapper.selectListByClosingId(closing.getId()).size());
+            return null;
+        }).when(voucherService).deleteVoucherList(1L, Collections.singletonList(77L), 10L);
+
+        // 准备参数
+        FmsClosingSchemeGenerateReqVO reqVO = new FmsClosingSchemeGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setId(closing.getId());
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        Long voucherId = closingVoucherService.generateClosingSchemeVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(88L, voucherId);
+        ArgumentCaptor<FmsVoucherSaveReqVO> voucherCaptor = ArgumentCaptor.forClass(FmsVoucherSaveReqVO.class);
+        verify(voucherService).createVoucher(voucherCaptor.capture(), eq(10L));
+        verify(voucherService).deleteVoucherList(1L, Collections.singletonList(77L), 10L);
+        assertEquals(4, voucherCaptor.getValue().getVoucherNumber());
+        assertEquals(new BigDecimal("100.00"),
+                voucherCaptor.getValue().getEntries().get(0).getDebitAmount());
+        assertEquals(new BigDecimal("100.00"),
+                voucherCaptor.getValue().getEntries().get(1).getCreditAmount());
+        List<FmsClosingVoucherDO> closingVouchers = closingVoucherMapper.selectListByClosingId(closing.getId());
+        assertEquals(1, closingVouchers.size());
+        assertEquals(88L, closingVouchers.get(0).getVoucherId());
+        assertEquals(0, new BigDecimal("100.00").compareTo(closingVouchers.get(0).getAmount()));
+    }
+
+    @Test
+    public void testGenerateClosingSchemeVoucher_nonPeriodEnd() {
+        // mock 数据
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(
+                new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setId(1L)
+                .setAccountSetId(1L).setType(FmsClosingTypeEnum.REGULAR.getType()).setPeriodEnd(false);
+        when(closingSchemeService.validateClosingSchemeExists(1L, closing.getId())).thenReturn(closing);
+        // 准备参数
+        FmsClosingSchemeGenerateReqVO reqVO = new FmsClosingSchemeGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setId(closing.getId());
+        reqVO.setMonth("2026-08");
+
+        // 调用，并断言
+        assertServiceException(() -> closingVoucherService.generateClosingSchemeVoucher(reqVO, 10L),
+                CLOSING_SCHEME_NOT_PERIOD_END);
+    }
+
+    @Test
+    public void testGenerateClosingSchemeVoucher_localTax() {
+        // mock 数据
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setId(1L)
+                .setName("计提地税").setPeriodEnd(true)
+                .setVoucherWordId(11L).setType(FmsClosingTypeEnum.LOCAL_TAX.getType())
+                .setAccountSetId(1L).setSubjectRules(Arrays.asList(
+                        buildSubjectRule(301L, "计提教育费附加", 1, "3"),
+                        buildSubjectRule(302L, "计提教育费附加", 2, "3"),
+                        buildSubjectRule(303L, "计提城建费", 1, "7"),
+                        buildSubjectRule(304L, "计提城建费", 2, "7"),
+                        buildSubjectRule(305L, "计提地方教育费附加", 1, "2"),
+                        buildSubjectRule(306L, "计提地方教育费附加", 2, "2")));
+        when(closingSchemeService.validateClosingSchemeExists(1L, closing.getId())).thenReturn(closing);
+        List<FmsSubjectDO> subjects = Arrays.asList(
+                new FmsSubjectDO().setId(201L).setCode("222101").setName("应交增值税"),
+                new FmsSubjectDO().setId(202L).setCode("222121").setName("应交消费税"));
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(subjects);
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L))).thenReturn(Arrays.asList(
+                new FmsLedgerSubjectBalanceRespVO().setSubjectId(201L)
+                        .setEndingDebitAmount(BigDecimal.ZERO).setEndingCreditAmount(new BigDecimal("1000.00"))
+                        .setChildren(Collections.emptyList()),
+                new FmsLedgerSubjectBalanceRespVO().setSubjectId(202L)
+                        .setEndingDebitAmount(BigDecimal.ZERO).setEndingCreditAmount(new BigDecimal("500.00"))
+                        .setChildren(Collections.emptyList())));
+        when(voucherService.createVoucher(any(), eq(10L))).thenReturn(88L);
+
+        // 准备参数
+        FmsClosingSchemeGenerateReqVO reqVO = new FmsClosingSchemeGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setId(closing.getId());
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        Long voucherId = closingVoucherService.generateClosingSchemeVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(88L, voucherId);
+        ArgumentCaptor<FmsVoucherSaveReqVO> voucherCaptor = ArgumentCaptor.forClass(FmsVoucherSaveReqVO.class);
+        verify(voucherService).createVoucher(voucherCaptor.capture(), eq(10L));
+        List<FmsVoucherEntrySaveReqVO> entries = voucherCaptor.getValue().getEntries();
+        assertEquals(new BigDecimal("45.00"), entries.get(0).getDebitAmount());
+        assertEquals(new BigDecimal("105.00"), entries.get(2).getDebitAmount());
+        assertEquals(new BigDecimal("30.00"), entries.get(4).getDebitAmount());
+        assertEquals(0, new BigDecimal("180.00").compareTo(
+                closingVoucherMapper.selectListByClosingId(closing.getId()).get(0).getAmount()));
+    }
+
+    @Test
+    public void testGenerateClosingVoucherList_skipSchemeWithoutBalance() {
+        // mock 数据
+        List<FmsClosingSchemeDO.SubjectRule> subjectRules = Arrays.asList(
+                FmsClosingSchemeDO.SubjectRule.builder().subjectId(102L).digest("期末结转")
+                        .direction(FmsDebitCreditDirectionEnum.DEBIT.getType())
+                        .amountRatio(new BigDecimal("100")).build(),
+                FmsClosingSchemeDO.SubjectRule.builder().subjectId(103L).digest("期末结转")
+                        .direction(FmsDebitCreditDirectionEnum.CREDIT.getType())
+                        .amountRatio(new BigDecimal("100")).build());
+        FmsClosingSchemeDO firstClosing = new FmsClosingSchemeDO().setId(1L)
+                .setName("结转本月房租").setPeriodEnd(true)
+                .setSubjectId(101L).setFormulaRule(FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                .setTimeType(FmsClosingTimeTypeEnum.PERIOD_END.getType()).setVoucherWordId(11L)
+                .setType(FmsClosingTypeEnum.REGULAR.getType()).setAccountSetId(1L)
+                .setSubjectRules(subjectRules);
+        FmsClosingSchemeDO secondClosing = new FmsClosingSchemeDO().setId(2L)
+                .setName("结转本月物业费").setPeriodEnd(true)
+                .setSubjectId(101L).setFormulaRule(FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                .setTimeType(FmsClosingTimeTypeEnum.PERIOD_END.getType()).setVoucherWordId(11L)
+                .setType(FmsClosingTypeEnum.REGULAR.getType()).setAccountSetId(1L)
+                .setSubjectRules(subjectRules);
+        when(closingSchemeService.validateClosingSchemeExists(1L, firstClosing.getId())).thenReturn(firstClosing);
+        when(closingSchemeService.validateClosingSchemeExists(1L, secondClosing.getId())).thenReturn(secondClosing);
+        FmsLedgerSubjectBalanceRespVO sourceBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setEndingDebitAmount(new BigDecimal("1200.00"))
+                .setEndingCreditAmount(BigDecimal.ZERO).setChildren(Collections.emptyList());
+        FmsLedgerSubjectBalanceRespVO zeroBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setEndingDebitAmount(BigDecimal.ZERO)
+                .setEndingCreditAmount(BigDecimal.ZERO).setChildren(Collections.emptyList());
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(
+                new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(sourceBalance), Collections.singletonList(zeroBalance));
+        when(voucherService.createVoucher(any(), eq(10L))).thenReturn(88L);
+        LocalDateTime voucherTime = LocalDateTime.of(2026, 8, 31, 0, 0);
+        closingVoucherMapper.insert(new FmsClosingVoucherDO().setClosingId(firstClosing.getId())
+                .setVoucherId(801L).setVoucherTime(voucherTime).setAmount(new BigDecimal("1200.00"))
+                .setClosed(false).setAccountSetId(1L));
+        closingVoucherMapper.insert(new FmsClosingVoucherDO().setClosingId(secondClosing.getId())
+                .setVoucherId(802L).setVoucherTime(voucherTime).setAmount(new BigDecimal("1200.00"))
+                .setClosed(false).setAccountSetId(1L));
+
+        // 准备参数
+        FmsClosingVoucherGenerateReqVO reqVO = new FmsClosingVoucherGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setIds(Arrays.asList(firstClosing.getId(), secondClosing.getId()));
+        reqVO.setMonth("2026-08");
+
+        // 调用
+        List<Long> voucherIds = closingVoucherService.generateClosingVoucherList(reqVO, 10L);
+
+        // 断言
+        assertEquals(Collections.singletonList(88L), voucherIds);
+        assertEquals(1, closingVoucherMapper.selectListByClosingId(firstClosing.getId()).size());
+        assertEquals(0, closingVoucherMapper.selectListByClosingId(secondClosing.getId()).size());
+        verify(voucherService).deleteVoucherList(1L, Arrays.asList(801L, 802L), 10L);
+        verify(voucherService, times(1)).createVoucher(any(), eq(10L));
+    }
+
+    @Test
+    public void testGenerateClosingVoucherList_nonPeriodEnd() {
+        // mock 数据
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(
+                new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        FmsClosingSchemeDO closing = new FmsClosingSchemeDO().setId(1L)
+                .setAccountSetId(1L).setType(FmsClosingTypeEnum.REGULAR.getType()).setPeriodEnd(false);
+        when(closingSchemeService.validateClosingSchemeExists(1L, closing.getId())).thenReturn(closing);
+        // 准备参数
+        FmsClosingVoucherGenerateReqVO reqVO = new FmsClosingVoucherGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setIds(Collections.singletonList(closing.getId()));
+        reqVO.setMonth("2026-08");
+
+        // 调用，并断言
+        assertServiceException(() -> closingVoucherService.generateClosingVoucherList(reqVO, 10L),
+                CLOSING_SCHEME_NOT_PERIOD_END);
+    }
+
+    @Test
+    public void testGenerateClosingVoucherList_rollbackWhenLaterSchemeFails() {
+        // mock 数据
+        List<FmsClosingSchemeDO.SubjectRule> subjectRules = Arrays.asList(
+                FmsClosingSchemeDO.SubjectRule.builder().subjectId(102L).digest("期末结转")
+                        .direction(FmsDebitCreditDirectionEnum.DEBIT.getType())
+                        .amountRatio(new BigDecimal("100")).build(),
+                FmsClosingSchemeDO.SubjectRule.builder().subjectId(103L).digest("期末结转")
+                        .direction(FmsDebitCreditDirectionEnum.CREDIT.getType())
+                        .amountRatio(new BigDecimal("100")).build());
+        FmsClosingSchemeDO firstClosing = new FmsClosingSchemeDO().setId(1L)
+                .setName("结转本月房租").setPeriodEnd(true)
+                .setSubjectId(101L).setFormulaRule(FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                .setTimeType(FmsClosingTimeTypeEnum.PERIOD_END.getType()).setVoucherWordId(11L)
+                .setType(FmsClosingTypeEnum.REGULAR.getType()).setAccountSetId(1L)
+                .setSubjectRules(subjectRules);
+        FmsClosingSchemeDO secondClosing = new FmsClosingSchemeDO().setId(2L)
+                .setName("结转本月物业费").setPeriodEnd(true)
+                .setSubjectId(101L).setFormulaRule(FmsFormulaRuleEnum.DEBIT_BALANCE.getRule())
+                .setTimeType(FmsClosingTimeTypeEnum.PERIOD_END.getType()).setVoucherWordId(11L)
+                .setType(FmsClosingTypeEnum.REGULAR.getType()).setAccountSetId(1L)
+                .setSubjectRules(subjectRules);
+        when(closingSchemeService.validateClosingSchemeExists(1L, firstClosing.getId())).thenReturn(firstClosing);
+        when(closingSchemeService.validateClosingSchemeExists(1L, secondClosing.getId())).thenReturn(secondClosing);
+        FmsLedgerSubjectBalanceRespVO sourceBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setEndingDebitAmount(new BigDecimal("1200.00"))
+                .setEndingCreditAmount(BigDecimal.ZERO).setChildren(Collections.emptyList());
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(sourceBalance));
+        when(voucherService.createVoucher(any(), eq(10L))).thenReturn(88L)
+                .thenThrow(new IllegalStateException("第二个方案生成失败"));
+
+        // 准备参数
+        FmsClosingVoucherGenerateReqVO reqVO = new FmsClosingVoucherGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setIds(Arrays.asList(firstClosing.getId(), secondClosing.getId()));
+        reqVO.setMonth("2026-08");
+
+        // 调用，并断言
+        assertThrows(IllegalStateException.class,
+                () -> closingVoucherService.generateClosingVoucherList(reqVO, 10L));
+        assertEquals(0, closingVoucherMapper.selectListByClosingId(firstClosing.getId()).size());
+        assertEquals(0, closingVoucherMapper.selectListByClosingId(secondClosing.getId()).size());
+    }
+
+    @Test
+    public void testGenerateProfitLossVoucher_notCurrentPeriod() {
+        // mock 数据
+        LocalDateTime startTime = LocalDateTime.of(2026, 7, 1, 0, 0);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(true).setStartTime(startTime));
+        when(closingPeriodService.getCurrentMonth(1L, startTime)).thenReturn(YearMonth.of(2026, 8));
+
+        // 准备参数
+        FmsProfitLossGenerateReqVO reqVO = new FmsProfitLossGenerateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-09");
+
+        // 调用，并断言
+        assertServiceException(() -> closingVoucherService.generateProfitLossVoucher(reqVO, 10L),
+                CLOSING_NOT_CURRENT_PERIOD);
+    }
+
+    private FmsClosingSchemeDO.SubjectRule buildSubjectRule(
+            Long subjectId, String digest, Integer direction, String amountRatio) {
+        return FmsClosingSchemeDO.SubjectRule.builder().subjectId(subjectId).digest(digest)
+                .direction(direction).amountRatio(new BigDecimal(amountRatio)).build();
+    }
+
+    // ========== 随机对象 ==========
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetServiceImplTest.java
new file mode 100644
index 0000000..f291cb7
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountSetServiceImplTest.java
@@ -0,0 +1,292 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetInitializeReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAccountSetMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountUserLevelEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountingStandardEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsCurrencyPresetEnum;
+import cn.iocoder.yudao.module.fms.enums.ledger.FmsLedgerBalanceModeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingTemplateService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import cn.iocoder.yudao.module.fms.service.config.FmsCurrencyService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_ACCESS_DENIED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_ALREADY_INITIALIZED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_CODE_DUPLICATE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+import static org.mockito.Mockito.when;
+
+@Import(FmsAccountSetServiceImpl.class)
+public class FmsAccountSetServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsAccountSetServiceImpl accountSetService;
+    @Resource
+    private FmsAccountSetMapper accountSetMapper;
+
+    @MockitoBean
+    private FmsAccountUserService accountUserService;
+    @MockitoBean
+    private FmsCurrencyService currencyService;
+    @MockitoBean
+    private FmsFinanceParameterService financeParameterService;
+    @MockitoBean
+    private FmsVoucherWordService voucherWordService;
+    @MockitoBean
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+    @MockitoBean
+    private FmsClosingTemplateService closingTemplateService;
+
+    @Test
+    public void testCreateAccountSet_success() {
+        // 准备参数
+        Long userId = randomLongId();
+        FmsAccountSetSaveReqVO reqVO = buildAccountSetSaveReqVO("TEST001", "测试科技有限公司");
+
+        // 调用
+        Long accountSetId = accountSetService.createAccountSet(reqVO, userId);
+
+        // 断言
+        FmsAccountSetDO accountSet = accountSetMapper.selectById(accountSetId);
+        assertPojoEquals(reqVO, accountSet, "id");
+        assertFalse(accountSet.getInitialized());
+        verify(accountUserService).createAccountOwner(accountSetId, userId);
+    }
+
+    @Test
+    public void testCreateAccountSet_codeDuplicate() {
+        // mock 数据
+        accountSetMapper.insert(buildAccountSetDO("WK001", false));
+        // 准备参数
+        FmsAccountSetSaveReqVO reqVO = buildAccountSetSaveReqVO("WK001", "芋道科技有限公司");
+
+        // 调用，并断言异常
+        assertServiceException(() -> accountSetService.createAccountSet(reqVO, randomLongId()),
+                ACCOUNT_SET_CODE_DUPLICATE);
+    }
+
+    @Test
+    public void testGetAccountSet_success() {
+        // mock 数据
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", false);
+        accountSetMapper.insert(accountSet);
+
+        // 调用
+        FmsAccountSetDO result = accountSetService.getAccountSet(accountSet.getId());
+
+        // 断言
+        assertPojoEquals(accountSet, result, "deleted");
+        verifyNoInteractions(accountUserService);
+    }
+
+    @Test
+    public void testValidateAccountSetReadPermission_notMemberDenied() {
+        // mock 数据
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", false);
+        accountSetMapper.insert(accountSet);
+        Long userId = randomLongId();
+        // 调用，并断言异常
+        assertServiceException(() -> accountSetService.validateAccountSetReadPermission(accountSet.getId(), userId),
+                ACCOUNT_SET_ACCESS_DENIED);
+    }
+
+    @Test
+    public void testValidateAccountSetReadPermission_invalidLevelDenied() {
+        // mock 数据
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", false);
+        accountSetMapper.insert(accountSet);
+        Long userId = randomLongId();
+        when(accountUserService.getAccountUser(accountSet.getId(), userId))
+                .thenReturn(new FmsAccountUserDO().setLevel(99));
+
+        // 调用，并断言异常
+        assertServiceException(() -> accountSetService.validateAccountSetReadPermission(accountSet.getId(), userId),
+                ACCOUNT_SET_ACCESS_DENIED);
+    }
+
+    @Test
+    public void testValidateAccountSetWritePermission_readDenied() {
+        // mock 数据
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", false);
+        accountSetMapper.insert(accountSet);
+        Long userId = randomLongId();
+        when(accountUserService.getAccountUser(accountSet.getId(), userId)).thenReturn(new FmsAccountUserDO()
+                .setLevel(FmsAccountUserLevelEnum.READ.getLevel()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> accountSetService.validateAccountSetWritePermission(accountSet.getId(), userId),
+                ACCOUNT_SET_ACCESS_DENIED);
+    }
+
+    @Test
+    public void testValidateAccountSetWritePermission_writeSuccess() {
+        // mock 数据
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", false);
+        accountSetMapper.insert(accountSet);
+        Long userId = randomLongId();
+        when(accountUserService.getAccountUser(accountSet.getId(), userId)).thenReturn(new FmsAccountUserDO()
+                .setLevel(FmsAccountUserLevelEnum.WRITE.getLevel()));
+
+        // 调用
+        FmsAccountSetDO result = accountSetService.validateAccountSetWritePermission(accountSet.getId(), userId);
+
+        // 断言
+        assertEquals(accountSet.getId(), result.getId());
+    }
+
+    @Test
+    public void testValidateAccountSetOwnerPermission_writeDenied() {
+        // mock 数据
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", false);
+        accountSetMapper.insert(accountSet);
+        Long userId = randomLongId();
+        when(accountUserService.getAccountUser(accountSet.getId(), userId)).thenReturn(new FmsAccountUserDO()
+                .setLevel(FmsAccountUserLevelEnum.WRITE.getLevel()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> accountSetService.validateAccountSetOwnerPermission(accountSet.getId(), userId),
+                ACCOUNT_SET_ACCESS_DENIED);
+    }
+
+    @Test
+    public void testGetAccountSetList() {
+        // mock 数据
+        FmsAccountSetDO firstAccountSet = buildAccountSetDO("WK001", true);
+        accountSetMapper.insert(firstAccountSet);
+        FmsAccountSetDO secondAccountSet = buildAccountSetDO("WK002", false);
+        accountSetMapper.insert(secondAccountSet);
+
+        // 调用
+        List<FmsAccountSetDO> accountSets = accountSetService.getAccountSetList(
+                Arrays.asList(firstAccountSet.getId(), secondAccountSet.getId()));
+
+        // 断言
+        assertEquals(2, accountSets.size());
+    }
+
+    @Test
+    public void testLockAccountSet_success() {
+        // mock 数据
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", true);
+        accountSetMapper.insert(accountSet);
+
+        // 调用
+        accountSetService.lockAccountSet(accountSet.getId());
+
+        // 断言
+        assertEquals(accountSet.getId(), accountSetMapper.selectById(accountSet.getId()).getId());
+    }
+
+    @Test
+    public void testLockAccountSet_notExists() {
+        // 调用，并断言异常
+        assertServiceException(() -> accountSetService.lockAccountSet(randomLongId()),
+                ACCOUNT_SET_NOT_EXISTS);
+    }
+
+    @Test
+    public void testInitializeAccountSet_success() {
+        // mock 数据
+        Long userId = randomLongId();
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", false);
+        accountSetMapper.insert(accountSet);
+        when(accountUserService.getAccountUser(accountSet.getId(), userId)).thenReturn(new FmsAccountUserDO()
+                .setLevel(FmsAccountUserLevelEnum.WRITE.getLevel()));
+        when(currencyService.initializeStandardCurrency(accountSet.getId(), FmsCurrencyPresetEnum.RMB))
+                .thenReturn(new FmsCurrencyDO().setId(100L));
+        // 准备参数
+        FmsAccountSetInitializeReqVO reqVO = buildInitializeReqVO(accountSet.getId());
+
+        // 调用
+        accountSetService.initializeAccountSet(reqVO, userId);
+
+        // 断言
+        FmsAccountSetDO dbAccountSet = accountSetMapper.selectById(accountSet.getId());
+        assertTrue(dbAccountSet.getInitialized());
+        assertEquals(LocalDateTime.of(2026, 8, 1, 0, 0), dbAccountSet.getStartTime());
+        assertEquals(reqVO.getStandard(), dbAccountSet.getStandard());
+        assertEquals(100L, dbAccountSet.getCurrencyId());
+        verify(accountUserService).getAccountUser(accountSet.getId(), userId);
+        verify(financeParameterService).initializeFinanceParameter(accountSet.getId(), reqVO);
+        verify(voucherWordService).initializeDefaultVoucherWords(accountSet.getId());
+        verify(auxiliaryTypeService).initializeDefaultTypes(accountSet.getId());
+        verify(subjectService).initializeDefaultSubjects(accountSet.getId());
+        verify(closingTemplateService).initializeClosingTemplates(accountSet.getId(), userId);
+        verify(closingSchemeService).initializeDefaultClosingSchemes(accountSet.getId(), userId);
+    }
+
+    @Test
+    public void testInitializeAccountSet_alreadyInitialized() {
+        // mock 数据
+        Long userId = randomLongId();
+        FmsAccountSetDO accountSet = buildAccountSetDO("WK001", true);
+        accountSetMapper.insert(accountSet);
+        when(accountUserService.getAccountUser(accountSet.getId(), userId)).thenReturn(new FmsAccountUserDO()
+                .setLevel(FmsAccountUserLevelEnum.OWNER.getLevel()));
+        // 准备参数
+        FmsAccountSetInitializeReqVO reqVO = buildInitializeReqVO(accountSet.getId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> accountSetService.initializeAccountSet(reqVO, userId),
+                ACCOUNT_SET_ALREADY_INITIALIZED);
+        verifyNoInteractions(currencyService, financeParameterService,
+                voucherWordService, auxiliaryTypeService, subjectService,
+                closingTemplateService, closingSchemeService);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsAccountSetInitializeReqVO buildInitializeReqVO(Long accountSetId) {
+        return new FmsAccountSetInitializeReqVO().setAccountSetId(accountSetId)
+                .setCurrencyCode(FmsCurrencyPresetEnum.RMB.getCode())
+                .setStartTime(LocalDateTime.of(2026, 8, 23, 12, 30))
+                .setStandard(FmsAccountingStandardEnum.SMALL_BUSINESS_2013.getStandard())
+                .setLevel(FmsFinanceParameterDO.DEFAULT_LEVEL)
+                .setSubjectCodeRule(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE)
+                .setLedgerBalanceMode(FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode());
+    }
+
+    private FmsAccountSetSaveReqVO buildAccountSetSaveReqVO(String code, String companyName) {
+        return randomPojo(FmsAccountSetSaveReqVO.class, reqVO -> reqVO
+                .setCompanyCode(code).setCompanyName(companyName)
+                .setCompanyProfile("企业数字化服务").setIndustry("软件和信息技术服务业")
+                .setContactName("张三").setMobile("15601691399").setEmail("finance@example.com"));
+    }
+
+    private FmsAccountSetDO buildAccountSetDO(String code, Boolean initialized) {
+        return randomPojo(FmsAccountSetDO.class, accountSet -> accountSet.setId(null)
+                .setCompanyCode(code).setCompanyName(code + " 有限公司").setInitialized(initialized));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserServiceImplTest.java
new file mode 100644
index 0000000..6614436
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAccountUserServiceImplTest.java
@@ -0,0 +1,149 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountuser.FmsAccountUserUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAccountUserMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAccountUserLevelEnum;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsAccountUserServiceImpl.class)
+public class FmsAccountUserServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsAccountUserServiceImpl accountUserService;
+    @Resource
+    private FmsAccountUserMapper accountUserMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private AdminUserApi adminUserApi;
+
+    @Test
+    public void testCreateAccountOwner_firstAccountSet() {
+        // 准备参数
+        Long accountSetId = randomLongId();
+        Long userId = randomLongId();
+
+        // 调用
+        accountUserService.createAccountOwner(accountSetId, userId);
+
+        // 断言
+        FmsAccountUserDO accountUser = accountUserMapper.selectByAccountSetIdAndUserId(accountSetId, userId);
+        assertTrue(accountUser.getDefaultStatus());
+        assertTrue(accountUser.getFounder());
+        assertEquals(FmsAccountUserLevelEnum.OWNER.getLevel(), accountUser.getLevel());
+    }
+
+    @Test
+    public void testGetAccountUserList_founderFirst() {
+        // mock 数据
+        Long accountSetId = randomLongId();
+        Long userId = randomLongId();
+        Long founderUserId = randomLongId();
+        accountUserMapper.insert(new FmsAccountUserDO().setAccountSetId(accountSetId).setUserId(userId)
+                .setDefaultStatus(false).setFounder(false)
+                .setLevel(FmsAccountUserLevelEnum.READ.getLevel()));
+        accountUserMapper.insert(new FmsAccountUserDO().setAccountSetId(accountSetId).setUserId(founderUserId)
+                .setDefaultStatus(true).setFounder(true)
+                .setLevel(FmsAccountUserLevelEnum.OWNER.getLevel()));
+
+        // 调用
+        List<FmsAccountUserDO> accountUsers = accountUserService.getAccountUserList(accountSetId, userId);
+
+        // 断言
+        assertEquals(2, accountUsers.size());
+        assertEquals(founderUserId, accountUsers.get(0).getUserId());
+        assertTrue(accountUsers.get(0).getFounder());
+        verify(accountSetService).validateAccountSetReadPermission(accountSetId, userId);
+    }
+
+    @Test
+    public void testGetAccountUser_notExists() {
+        // 调用，并断言
+        assertNull(accountUserService.getAccountUser(randomLongId(), randomLongId()));
+    }
+
+    @Test
+    public void testUpdateAccountUserList_replaceAndRejoin() {
+        // mock 数据
+        Long accountSetId = randomLongId();
+        Long founderUserId = randomLongId();
+        Long oldMemberUserId = randomLongId();
+        Long newMemberUserId = randomLongId();
+        when(accountSetService.validateAccountSetOwnerPermission(accountSetId, founderUserId))
+                .thenReturn(new FmsAccountSetDO().setId(accountSetId));
+        accountUserMapper.insert(new FmsAccountUserDO().setAccountSetId(accountSetId)
+                .setUserId(founderUserId).setDefaultStatus(true).setFounder(true)
+                .setLevel(FmsAccountUserLevelEnum.OWNER.getLevel()));
+        accountUserMapper.insert(new FmsAccountUserDO().setAccountSetId(accountSetId)
+                .setUserId(oldMemberUserId).setDefaultStatus(false).setFounder(false)
+                .setLevel(FmsAccountUserLevelEnum.READ.getLevel()));
+        // 准备参数
+        FmsAccountUserUpdateReqVO reqVO = new FmsAccountUserUpdateReqVO().setAccountSetId(accountSetId)
+                .setMembers(Arrays.asList(
+                        buildAccountUserMember(founderUserId, FmsAccountUserLevelEnum.OWNER),
+                        buildAccountUserMember(oldMemberUserId, FmsAccountUserLevelEnum.WRITE),
+                        buildAccountUserMember(newMemberUserId, FmsAccountUserLevelEnum.READ)));
+
+        // 调用
+        accountUserService.updateAccountUserList(reqVO, founderUserId);
+
+        // 断言首次替换
+        assertEquals(FmsAccountUserLevelEnum.WRITE.getLevel(), accountUserMapper
+                .selectByAccountSetIdAndUserId(accountSetId, oldMemberUserId).getLevel());
+        FmsAccountUserDO newMember = accountUserMapper.selectByAccountSetIdAndUserId(
+                accountSetId, newMemberUserId);
+        assertNotNull(newMember);
+        assertFalse(newMember.getDefaultStatus());
+        assertFalse(newMember.getFounder());
+        assertEquals(FmsAccountUserLevelEnum.READ.getLevel(), newMember.getLevel());
+        verify(accountSetService).validateAccountSetOwnerPermission(accountSetId, founderUserId);
+        verify(adminUserApi).validateUserList(new HashSet<>(Arrays.asList(oldMemberUserId, newMemberUserId)));
+
+        // 调用，并断言被移出的成员可以再次加入
+        reqVO.setMembers(Arrays.asList(
+                buildAccountUserMember(founderUserId, FmsAccountUserLevelEnum.OWNER),
+                buildAccountUserMember(oldMemberUserId, FmsAccountUserLevelEnum.READ)));
+        accountUserService.updateAccountUserList(reqVO, founderUserId);
+        assertEquals(FmsAccountUserLevelEnum.READ.getLevel(), accountUserMapper
+                .selectByAccountSetIdAndUserId(accountSetId, oldMemberUserId).getLevel());
+        assertNull(accountUserMapper.selectByAccountSetIdAndUserId(accountSetId, newMemberUserId));
+
+        // 调用，并断言逻辑删除的成员可以再次加入
+        reqVO.setMembers(Arrays.asList(
+                buildAccountUserMember(founderUserId, FmsAccountUserLevelEnum.OWNER),
+                buildAccountUserMember(oldMemberUserId, FmsAccountUserLevelEnum.READ),
+                buildAccountUserMember(newMemberUserId, FmsAccountUserLevelEnum.WRITE)));
+        accountUserService.updateAccountUserList(reqVO, founderUserId);
+        assertEquals(FmsAccountUserLevelEnum.WRITE.getLevel(), accountUserMapper
+                .selectByAccountSetIdAndUserId(accountSetId, newMemberUserId).getLevel());
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsAccountUserUpdateReqVO.Member buildAccountUserMember(
+            Long userId, FmsAccountUserLevelEnum level) {
+        return new FmsAccountUserUpdateReqVO.Member().setUserId(userId).setLevel(level.getLevel());
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationServiceImplTest.java
new file mode 100644
index 0000000..3b9859b
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryCombinationServiceImplTest.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAuxiliaryCombinationMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.util.Collections;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+@Import(FmsAuxiliaryCombinationServiceImpl.class)
+public class FmsAuxiliaryCombinationServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsAuxiliaryCombinationServiceImpl auxiliaryCombinationService;
+    @Resource
+    private FmsAuxiliaryCombinationMapper auxiliaryCombinationMapper;
+
+    @Test
+    public void testDeleteAuxiliaryCombinationByAuxiliaryItemIds() {
+        // mock 数据
+        FmsAuxiliaryCombinationDO.AuxiliaryItem deletedItem = FmsAuxiliaryCombinationDO.AuxiliaryItem.builder()
+                .typeId(31L).itemId(41L).build();
+        FmsAuxiliaryCombinationDO deletedCombination = new FmsAuxiliaryCombinationDO().setAccountSetId(1L)
+                .setSubjectId(101L).setItems(Collections.singletonList(deletedItem));
+        auxiliaryCombinationMapper.insert(deletedCombination);
+        FmsAuxiliaryCombinationDO retainedCombination = new FmsAuxiliaryCombinationDO().setAccountSetId(1L)
+                .setSubjectId(101L).setItems(Collections.singletonList(
+                        FmsAuxiliaryCombinationDO.AuxiliaryItem.builder().typeId(31L).itemId(42L).build()));
+        auxiliaryCombinationMapper.insert(retainedCombination);
+
+        // 调用
+        auxiliaryCombinationService.deleteAuxiliaryCombinationByAuxiliaryItemIds(
+                1L, Collections.singletonList(41L));
+
+        // 断言
+        assertNull(auxiliaryCombinationMapper.selectById(deletedCombination.getId()));
+        assertPojoEquals(retainedCombination,
+                auxiliaryCombinationMapper.selectById(retainedCombination.getId()), "deleted");
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemServiceImplTest.java
new file mode 100644
index 0000000..9e6b702
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryItemServiceImplTest.java
@@ -0,0 +1,265 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliaryitem.FmsAuxiliaryItemSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAuxiliaryItemMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherTemplateService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsAuxiliaryItemServiceImpl.class)
+public class FmsAuxiliaryItemServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsAuxiliaryItemServiceImpl auxiliaryItemService;
+    @Resource
+    private FmsAuxiliaryItemMapper auxiliaryItemMapper;
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @MockitoBean
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+    @MockitoBean
+    private FmsVoucherTemplateService voucherTemplateService;
+    @MockitoBean
+    private FmsInitialBalanceService initialBalanceService;
+
+    @Test
+    public void testCreateAuxiliaryItem_success() {
+        // mock 方法
+        mockAuxiliaryType(1L, 11L);
+        // 准备参数
+        FmsAuxiliaryItemSaveReqVO reqVO = buildSaveReqVO(1L, 11L, "KH001", "测试客户");
+
+        // 调用
+        Long auxiliaryItemId = auxiliaryItemService.createAuxiliaryItem(reqVO, 10L);
+
+        // 断言
+        FmsAuxiliaryItemDO auxiliaryItem = auxiliaryItemMapper.selectById(auxiliaryItemId);
+        assertEquals("KH001", auxiliaryItem.getCode());
+        assertEquals("测试客户", auxiliaryItem.getName());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), auxiliaryItem.getStatus());
+        assertEquals(11L, auxiliaryItem.getAuxiliaryTypeId());
+        verify(accountSetService).validateAccountSetWritePermission(1L, 10L);
+    }
+
+    @Test
+    public void testCreateAuxiliaryItem_codeDuplicate() {
+        // mock 数据
+        mockAuxiliaryType(1L, 11L);
+        auxiliaryItemMapper.insert(buildAuxiliaryItem(1L, 11L, "KH001", "原客户"));
+        // 准备参数
+        FmsAuxiliaryItemSaveReqVO reqVO = buildSaveReqVO(1L, 11L, "KH001", "新客户");
+
+        // 调用，并断言
+        assertServiceException(() -> auxiliaryItemService.createAuxiliaryItem(reqVO, 10L),
+                AUXILIARY_ITEM_CODE_DUPLICATE);
+    }
+
+    @Test
+    public void testDeleteAuxiliaryItemList_success() {
+        // mock 数据
+        FmsAuxiliaryItemDO auxiliaryItem = buildAuxiliaryItem(1L, 11L, "KH001", "测试客户");
+        auxiliaryItemMapper.insert(auxiliaryItem);
+
+        // 调用
+        auxiliaryItemService.deleteAuxiliaryItemList(
+                1L, Collections.singletonList(auxiliaryItem.getId()), 10L);
+
+        // 断言
+        assertNull(auxiliaryItemMapper.selectById(auxiliaryItem.getId()));
+        verify(auxiliaryCombinationService).deleteAuxiliaryCombinationByAuxiliaryItemIds(
+                eq(1L), anyCollection());
+    }
+
+    @Test
+    public void testDeleteAuxiliaryItemList_voucherTemplateInUse() {
+        // mock 数据
+        FmsAuxiliaryItemDO auxiliaryItem = buildAuxiliaryItem(1L, 11L, "KH001", "测试客户");
+        auxiliaryItemMapper.insert(auxiliaryItem);
+        // mock 方法
+        when(voucherTemplateService.getVoucherTemplateCountByAuxiliaryItemIds(
+                eq(1L), anyCollection())).thenReturn(1L);
+
+        // 调用，并断言
+        assertServiceException(() -> auxiliaryItemService.deleteAuxiliaryItemList(
+                1L, Collections.singletonList(auxiliaryItem.getId()), 10L),
+                AUXILIARY_ITEM_VOUCHER_TEMPLATE_IN_USE, 1L);
+    }
+
+    @Test
+    public void testUpdateAuxiliaryItemStatus_success() {
+        // mock 数据
+        FmsAuxiliaryItemDO auxiliaryItem = buildAuxiliaryItem(1L, 11L, "KH001", "测试客户");
+        auxiliaryItemMapper.insert(auxiliaryItem);
+
+        // 调用
+        auxiliaryItemService.updateAuxiliaryItemStatus(1L, auxiliaryItem.getId(),
+                CommonStatusEnum.DISABLE.getStatus(), 10L);
+
+        // 断言
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(),
+                auxiliaryItemMapper.selectById(auxiliaryItem.getId()).getStatus());
+        verify(accountSetService).validateAccountSetWritePermission(1L, 10L);
+    }
+
+    @Test
+    public void testGetAuxiliaryItemPage_search() {
+        // mock 数据
+        mockAuxiliaryType(1L, 11L);
+        auxiliaryItemMapper.insert(buildAuxiliaryItem(1L, 11L, "KH001", "上海测试"));
+        auxiliaryItemMapper.insert(buildAuxiliaryItem(1L, 11L, "KH002", "北京云财务"));
+        // 准备参数
+        FmsAuxiliaryItemPageReqVO reqVO = new FmsAuxiliaryItemPageReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setAuxiliaryTypeId(11L);
+        reqVO.setSearch("测试");
+
+        // 调用
+        PageResult<FmsAuxiliaryItemDO> pageResult = auxiliaryItemService
+                .getAuxiliaryItemPage(reqVO, 10L);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals("KH001", CollUtil.getFirst(pageResult.getList()).getCode());
+    }
+
+    @Test
+    public void testGetAuxiliaryItemListByAccountSetIdAndAuxiliaryTypeIdAndStatus() {
+        // mock 数据
+        mockAuxiliaryType(1L, 11L);
+        auxiliaryItemMapper.insert(buildAuxiliaryItem(1L, 11L, "KH002", "北京客户"));
+        auxiliaryItemMapper.insert(buildAuxiliaryItem(1L, 11L, "KH001", "上海客户"));
+        auxiliaryItemMapper.insert(buildAuxiliaryItem(1L, 11L, "KH003", "停用客户")
+                .setStatus(CommonStatusEnum.DISABLE.getStatus()));
+
+        // 调用
+        List<FmsAuxiliaryItemDO> result = auxiliaryItemService
+                .getAuxiliaryItemListByAccountSetIdAndAuxiliaryTypeIdAndStatus(
+                        1L, 11L, CommonStatusEnum.ENABLE.getStatus(), 10L);
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals("KH001", result.get(0).getCode());
+        assertEquals("KH002", result.get(1).getCode());
+    }
+
+    @Test
+    public void testImportAuxiliaryItemList_empty() {
+        // 调用，并断言
+        assertServiceException(() -> auxiliaryItemService.importAuxiliaryItemList(
+                1L, 11L, Collections.emptyList(), 10L), AUXILIARY_ITEM_IMPORT_LIST_IS_EMPTY);
+    }
+
+    @Test
+    public void testImportAuxiliaryItemList_partialSuccess() {
+        // mock 数据
+        mockAuxiliaryType(1L, 11L);
+        auxiliaryItemMapper.insert(buildAuxiliaryItem(1L, 11L, "KH001", "原客户"));
+        FmsAuxiliaryItemImportExcelVO successRow = buildImportRow("KH002", "新客户");
+        successRow.setRemark("重点客户");
+        FmsAuxiliaryItemImportExcelVO existRow = buildImportRow("KH001", "重复客户");
+        FmsAuxiliaryItemImportExcelVO duplicateRow = buildImportRow("KH002", "文件内重复");
+
+        // 调用
+        FmsAuxiliaryItemImportRespVO result = auxiliaryItemService.importAuxiliaryItemList(
+                1L, 11L, Arrays.asList(successRow, existRow, duplicateRow), 10L);
+
+        // 断言
+        assertEquals(3, result.getTotalCount());
+        assertEquals(Collections.singletonList("KH002"), result.getSuccessItemCodes());
+        assertEquals(2, result.getFailureReasons().size());
+        FmsAuxiliaryItemDO item = auxiliaryItemMapper.selectByTypeIdAndCode(1L, 11L, "KH002");
+        assertEquals("新客户", item.getName());
+        assertEquals("重点客户", item.getRemark());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), item.getStatus());
+    }
+
+    @Test
+    public void testImportAuxiliaryItemList_inventory() {
+        // mock 数据
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(eq(1L), anyCollection()))
+                .thenReturn(Collections.singletonList(new FmsAuxiliaryTypeDO()
+                        .setId(16L).setAccountSetId(1L).setName("存货").setSystemPreset(true)
+                        .setType(FmsAuxiliaryTypeEnum.INVENTORY.getType())));
+        FmsAuxiliaryItemImportExcelVO row = buildImportRow("SP001", "测试商品");
+        row.setRemark("库存备注");
+        row.setSpecification("标准版");
+        row.setUnit("台");
+
+        // 调用
+        auxiliaryItemService.importAuxiliaryItemList(
+                1L, 16L, Collections.singletonList(row), 10L);
+
+        // 断言
+        FmsAuxiliaryItemDO item = auxiliaryItemMapper.selectByTypeIdAndCode(1L, 16L, "SP001");
+        assertEquals("库存备注", item.getRemark());
+        assertEquals("标准版", item.getSpecification());
+        assertEquals("台", item.getUnit());
+    }
+
+    // ========== 随机对象 ==========
+
+    private void mockAuxiliaryType(Long accountSetId, Long auxiliaryTypeId) {
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(eq(accountSetId), anyCollection()))
+                .thenReturn(Collections.singletonList(new FmsAuxiliaryTypeDO()
+                        .setId(auxiliaryTypeId).setAccountSetId(accountSetId)
+                        .setName("客户").setSystemPreset(true)
+                        .setType(FmsAuxiliaryTypeEnum.CUSTOMER.getType())));
+    }
+
+    private FmsAuxiliaryItemSaveReqVO buildSaveReqVO(
+            Long accountSetId, Long auxiliaryTypeId, String code, String name) {
+        FmsAuxiliaryItemSaveReqVO reqVO = new FmsAuxiliaryItemSaveReqVO();
+        reqVO.setAccountSetId(accountSetId);
+        reqVO.setAuxiliaryTypeId(auxiliaryTypeId);
+        reqVO.setCode(code);
+        reqVO.setName(name);
+        return reqVO;
+    }
+
+    private FmsAuxiliaryItemImportExcelVO buildImportRow(String code, String name) {
+        FmsAuxiliaryItemImportExcelVO row = new FmsAuxiliaryItemImportExcelVO();
+        row.setCode(code);
+        row.setName(name);
+        return row;
+    }
+
+    private FmsAuxiliaryItemDO buildAuxiliaryItem(
+            Long accountSetId, Long auxiliaryTypeId, String code, String name) {
+        return randomPojo(FmsAuxiliaryItemDO.class, auxiliaryItem -> auxiliaryItem.setId(null)
+                .setAccountSetId(accountSetId).setAuxiliaryTypeId(auxiliaryTypeId)
+                .setCode(code).setName(name).setStatus(CommonStatusEnum.ENABLE.getStatus()));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeServiceImplTest.java
new file mode 100644
index 0000000..76a92c4
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsAuxiliaryTypeServiceImplTest.java
@@ -0,0 +1,170 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.auxiliarytype.FmsAuxiliaryTypeSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsAuxiliaryTypeMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherTemplateService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsAuxiliaryTypeServiceImpl.class)
+public class FmsAuxiliaryTypeServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsAuxiliaryTypeServiceImpl auxiliaryTypeService;
+    @Resource
+    private FmsAuxiliaryTypeMapper auxiliaryTypeMapper;
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+    @MockitoBean
+    private FmsVoucherTemplateService voucherTemplateService;
+    @MockitoBean
+    private FmsInitialBalanceService initialBalanceService;
+
+    @Test
+    public void testInitializeDefaultTypes_success() {
+        // 准备参数
+        Long accountSetId = 1L;
+
+        // 调用
+        auxiliaryTypeService.initializeDefaultTypes(accountSetId);
+
+        // 断言
+        List<FmsAuxiliaryTypeDO> types = auxiliaryTypeMapper.selectListByAccountSetId(accountSetId);
+        assertEquals(6, types.size());
+        assertEquals(FmsAuxiliaryTypeEnum.CUSTOMER.getName(), types.get(0).getName());
+        assertEquals(FmsAuxiliaryTypeEnum.INVENTORY.getName(), types.get(5).getName());
+        assertTrue(types.stream().allMatch(FmsAuxiliaryTypeDO::getSystemPreset));
+        assertTrue(types.stream().allMatch(type -> accountSetId.equals(type.getAccountSetId())));
+        assertFalse(types.stream().anyMatch(
+                type -> FmsAuxiliaryTypeEnum.CUSTOM.getType().equals(type.getType())));
+    }
+
+    @Test
+    public void testGetAuxiliaryTypeIdMap() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsAuxiliaryTypeDO customer = buildAuxiliaryType(accountSetId, "客户", true);
+        FmsAuxiliaryTypeDO store = buildAuxiliaryType(accountSetId, "门店", false);
+        auxiliaryTypeMapper.insert(customer);
+        auxiliaryTypeMapper.insert(store);
+
+        // 调用
+        Map<String, Long> auxiliaryTypeIdMap = auxiliaryTypeService.getAuxiliaryTypeIdMap(accountSetId);
+
+        // 断言
+        assertEquals(2, auxiliaryTypeIdMap.size());
+        assertEquals(customer.getId(), auxiliaryTypeIdMap.get("客户"));
+        assertEquals(store.getId(), auxiliaryTypeIdMap.get("门店"));
+    }
+
+    @Test
+    public void testCreateAuxiliaryType_success() {
+        // 准备参数
+        FmsAuxiliaryTypeSaveReqVO reqVO = new FmsAuxiliaryTypeSaveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setName("门店");
+
+        // 调用
+        Long auxiliaryTypeId = auxiliaryTypeService.createAuxiliaryType(reqVO, 10L);
+
+        // 断言
+        FmsAuxiliaryTypeDO auxiliaryType = auxiliaryTypeMapper.selectById(auxiliaryTypeId);
+        assertEquals("门店", auxiliaryType.getName());
+        assertEquals(FmsAuxiliaryTypeEnum.CUSTOM.getType(), auxiliaryType.getType());
+        assertFalse(auxiliaryType.getSystemPreset());
+        assertEquals(1L, auxiliaryType.getAccountSetId());
+        verify(accountSetService).validateAccountSetWritePermission(1L, 10L);
+    }
+
+    @Test
+    public void testCreateAuxiliaryType_nameDuplicate() {
+        // mock 数据
+        auxiliaryTypeMapper.insert(buildAuxiliaryType(1L, "门店", false));
+        // 准备参数
+        FmsAuxiliaryTypeSaveReqVO reqVO = new FmsAuxiliaryTypeSaveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setName("门店");
+
+        // 调用，并断言
+        assertServiceException(() -> auxiliaryTypeService.createAuxiliaryType(reqVO, 10L),
+                AUXILIARY_TYPE_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateAuxiliaryType_systemPreset() {
+        // mock 数据
+        FmsAuxiliaryTypeDO auxiliaryType = buildAuxiliaryType(1L, "客户", true);
+        auxiliaryTypeMapper.insert(auxiliaryType);
+        // 准备参数
+        FmsAuxiliaryTypeSaveReqVO reqVO = new FmsAuxiliaryTypeSaveReqVO();
+        reqVO.setId(auxiliaryType.getId());
+        reqVO.setAccountSetId(1L);
+        reqVO.setName("客户资料");
+
+        // 调用，并断言
+        assertServiceException(() -> auxiliaryTypeService.updateAuxiliaryType(reqVO, 10L),
+                AUXILIARY_TYPE_SYSTEM_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testDeleteAuxiliaryType_hasItem() {
+        // mock 数据
+        FmsAuxiliaryTypeDO auxiliaryType = buildAuxiliaryType(1L, "门店", false);
+        auxiliaryTypeMapper.insert(auxiliaryType);
+        // mock 方法
+        when(auxiliaryItemService.getAuxiliaryItemCountByAuxiliaryTypeId(
+                1L, auxiliaryType.getId())).thenReturn(1L);
+
+        // 调用，并断言
+        assertServiceException(() -> auxiliaryTypeService.deleteAuxiliaryType(
+                1L, auxiliaryType.getId(), 10L), AUXILIARY_TYPE_HAS_ITEM, 1L);
+    }
+
+    @Test
+    public void testDeleteAuxiliaryType_inUse() {
+        // mock 数据
+        FmsAuxiliaryTypeDO auxiliaryType = buildAuxiliaryType(1L, "门店", false);
+        auxiliaryTypeMapper.insert(auxiliaryType);
+        when(subjectService.getSubjectCountByAuxiliaryTypeId(1L, auxiliaryType.getId()))
+                .thenReturn(1L);
+
+        // 调用，并断言
+        assertServiceException(() -> auxiliaryTypeService.deleteAuxiliaryType(
+                1L, auxiliaryType.getId(), 10L), AUXILIARY_TYPE_SUBJECT_IN_USE, 1L);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsAuxiliaryTypeDO buildAuxiliaryType(Long accountSetId, String name, boolean systemPreset) {
+        return randomPojo(FmsAuxiliaryTypeDO.class, auxiliaryType -> auxiliaryType.setId(null)
+                .setName(name).setSystemPreset(systemPreset).setAccountSetId(accountSetId)
+                .setType(systemPreset
+                        ? FmsAuxiliaryTypeEnum.CUSTOMER.getType() : FmsAuxiliaryTypeEnum.CUSTOM.getType()));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyServiceImplTest.java
new file mode 100644
index 0000000..10b6b48
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsCurrencyServiceImplTest.java
@@ -0,0 +1,232 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.currency.FmsCurrencySaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountUserDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsCurrencyMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsCurrencyPresetEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_CODE_DUPLICATE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_IN_USE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_NOT_EXISTS;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.CURRENCY_STANDARD_NOT_DELETABLE;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.when;
+
+@Import(FmsCurrencyServiceImpl.class)
+public class FmsCurrencyServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsCurrencyServiceImpl currencyService;
+    @Resource
+    private FmsCurrencyMapper currencyMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+
+    @Test
+    public void testInitializeStandardCurrency_success() {
+        // 准备参数
+        Long accountSetId = 1L;
+
+        // 调用
+        FmsCurrencyDO currency = currencyService.initializeStandardCurrency(
+                accountSetId, FmsCurrencyPresetEnum.RMB);
+
+        // 断言
+        FmsCurrencyDO dbCurrency = currencyMapper.selectById(currency.getId());
+        assertEquals(accountSetId, dbCurrency.getAccountSetId());
+        assertEquals(FmsCurrencyPresetEnum.RMB.getCode(), dbCurrency.getCode());
+        assertEquals(FmsCurrencyPresetEnum.RMB.getName(), dbCurrency.getName());
+        assertEquals(0, BigDecimal.ONE.compareTo(dbCurrency.getExchangeRate()));
+        assertTrue(dbCurrency.getStandard());
+    }
+
+    @Test
+    public void testCreateCurrency_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        // 准备参数
+        FmsCurrencySaveReqVO reqVO = buildSaveReqVO(null, accountSetId,
+                "USD", "美元", new BigDecimal("7.120000"));
+
+        // 调用
+        Long currencyId = currencyService.createCurrency(reqVO, 10L);
+
+        // 断言
+        FmsCurrencyDO currency = currencyMapper.selectById(currencyId);
+        assertEquals("USD", currency.getCode());
+        assertEquals("美元", currency.getName());
+        assertEquals(0, new BigDecimal("7.120000").compareTo(currency.getExchangeRate()));
+        assertEquals(Boolean.FALSE, currency.getStandard());
+    }
+
+    @Test
+    public void testCreateCurrency_codeDuplicate() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        currencyMapper.insert(buildCurrencyDO(accountSetId, "USD", "美元", false));
+        // 准备参数
+        FmsCurrencySaveReqVO reqVO = buildSaveReqVO(null, accountSetId,
+                "USD", "美金", new BigDecimal("7.100000"));
+
+        // 调用，并断言
+        assertServiceException(() -> currencyService.createCurrency(reqVO, 10L), CURRENCY_CODE_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateCurrency_standardFieldsProtected() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsCurrencyDO currency = buildCurrencyDO(accountSetId, "RMB", "人民币", true);
+        currency.setExchangeRate(BigDecimal.ONE);
+        currencyMapper.insert(currency);
+        // 准备参数
+        FmsCurrencySaveReqVO reqVO = buildSaveReqVO(currency.getId(), accountSetId,
+                "CNY", "人民币本位币", new BigDecimal("2.000000"));
+
+        // 调用
+        currencyService.updateCurrency(reqVO, 10L);
+
+        // 断言
+        FmsCurrencyDO updateCurrency = currencyMapper.selectById(currency.getId());
+        assertEquals("RMB", updateCurrency.getCode());
+        assertEquals("人民币本位币", updateCurrency.getName());
+        assertEquals(0, BigDecimal.ONE.compareTo(updateCurrency.getExchangeRate()));
+        assertTrue(updateCurrency.getStandard());
+    }
+
+    @Test
+    public void testDeleteCurrency_standardNotDeletable() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsCurrencyDO currency = buildCurrencyDO(accountSetId, "RMB", "人民币", true);
+        currencyMapper.insert(currency);
+
+        // 调用，并断言
+        assertServiceException(() -> currencyService.deleteCurrency(
+                accountSetId, currency.getId(), 10L), CURRENCY_STANDARD_NOT_DELETABLE);
+    }
+
+    @Test
+    public void testDeleteCurrency_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsCurrencyDO currency = buildCurrencyDO(accountSetId, "USD", "美元", false);
+        currencyMapper.insert(currency);
+
+        // 调用
+        currencyService.deleteCurrency(accountSetId, currency.getId(), 10L);
+
+        // 断言
+        assertNull(currencyMapper.selectById(currency.getId()));
+    }
+
+    @Test
+    public void testDeleteCurrency_inUse() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsCurrencyDO currency = buildCurrencyDO(accountSetId, "USD", "美元", false);
+        currencyMapper.insert(currency);
+        when(subjectService.getSubjectCountByCurrencyId(accountSetId, currency.getId())).thenReturn(1L);
+
+        // 调用，并断言
+        assertServiceException(() -> currencyService.deleteCurrency(
+                accountSetId, currency.getId(), 10L), CURRENCY_IN_USE);
+    }
+
+    @Test
+    public void testGetCurrencyList_standardFirst() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        currencyMapper.insert(buildCurrencyDO(accountSetId, "USD", "美元", false));
+        currencyMapper.insert(buildCurrencyDO(accountSetId, "RMB", "人民币", true));
+
+        // 调用
+        List<FmsCurrencyDO> currencies = currencyService.getCurrencyList(accountSetId, 10L);
+
+        // 断言
+        assertEquals(2, currencies.size());
+        assertEquals("RMB", currencies.get(0).getCode());
+        assertEquals("USD", currencies.get(1).getCode());
+    }
+
+    @Test
+    public void testValidateCurrencyList_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsCurrencyDO usd = buildCurrencyDO(accountSetId, "USD", "美元", false);
+        FmsCurrencyDO eur = buildCurrencyDO(accountSetId, "EUR", "欧元", false);
+        currencyMapper.insert(usd);
+        currencyMapper.insert(eur);
+
+        // 调用
+        List<FmsCurrencyDO> currencies = currencyService.validateCurrencyList(
+                accountSetId, Arrays.asList(eur.getId(), usd.getId()));
+
+        // 断言
+        assertEquals(2, currencies.size());
+        assertEquals(new HashSet<>(Arrays.asList(eur.getId(), usd.getId())),
+                new HashSet<>(Arrays.asList(currencies.get(0).getId(), currencies.get(1).getId())));
+    }
+
+    @Test
+    public void testValidateCurrencyList_duplicateId() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsCurrencyDO currency = buildCurrencyDO(accountSetId, "USD", "美元", false);
+        currencyMapper.insert(currency);
+
+        // 调用，并断言
+        assertServiceException(() -> currencyService.validateCurrencyList(
+                accountSetId, Arrays.asList(currency.getId(), currency.getId())), CURRENCY_NOT_EXISTS);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsCurrencyDO buildCurrencyDO(Long accountSetId, String code, String name, boolean standard) {
+        return randomPojo(FmsCurrencyDO.class, currency -> currency.setId(null)
+                .setAccountSetId(accountSetId).setCode(code).setName(name)
+                .setExchangeRate(new BigDecimal("7.120000")).setStandard(standard));
+    }
+
+    private FmsCurrencySaveReqVO buildSaveReqVO(Long id, Long accountSetId, String code,
+            String name, BigDecimal exchangeRate) {
+        return randomPojo(FmsCurrencySaveReqVO.class, reqVO -> reqVO.setId(id)
+                .setAccountSetId(accountSetId).setCode(code).setName(name).setExchangeRate(exchangeRate));
+    }
+
+    private void mockAccountSetAccess(Long accountSetId) {
+        when(accountSetService.validateAccountSetReadPermission(accountSetId, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(accountSetId));
+        when(accountSetService.validateAccountSetWritePermission(accountSetId, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(accountSetId));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestServiceImplTest.java
new file mode 100644
index 0000000..96ad9c5
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsDigestServiceImplTest.java
@@ -0,0 +1,120 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.digest.FmsDigestSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsDigestDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsDigestMapper;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.DIGEST_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.Mockito.verify;
+
+@Import(FmsDigestServiceImpl.class)
+public class FmsDigestServiceImplTest extends BaseDbUnitTest {
+
+    private static final Long USER_ID = 10L;
+
+    @Resource
+    private FmsDigestServiceImpl digestService;
+    @Resource
+    private FmsDigestMapper digestMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+
+    @Test
+    public void testCreateDigest_success() {
+        // 准备参数
+        FmsDigestSaveReqVO reqVO = buildSaveReqVO(null, 1L, "购买办公用品");
+
+        // 调用
+        Long digestId = digestService.createDigest(reqVO, USER_ID);
+
+        // 断言
+        FmsDigestDO digest = digestMapper.selectById(digestId);
+        assertEquals("购买办公用品", digest.getContent());
+        assertEquals(1L, digest.getAccountSetId());
+        verify(accountSetService).validateAccountSetWritePermission(1L, USER_ID);
+    }
+
+    @Test
+    public void testUpdateDigest_success() {
+        // mock 数据
+        FmsDigestDO digest = new FmsDigestDO().setAccountSetId(1L).setContent("购买办公用品");
+        digestMapper.insert(digest);
+        // 准备参数
+        FmsDigestSaveReqVO reqVO = buildSaveReqVO(digest.getId(), 1L, "支付办公用品款");
+
+        // 调用
+        digestService.updateDigest(reqVO, USER_ID);
+
+        // 断言
+        assertEquals("支付办公用品款", digestMapper.selectById(digest.getId()).getContent());
+        verify(accountSetService).validateAccountSetWritePermission(1L, USER_ID);
+    }
+
+    @Test
+    public void testUpdateDigest_wrongAccountSet() {
+        // mock 数据
+        FmsDigestDO digest = new FmsDigestDO().setAccountSetId(1L).setContent("购买办公用品");
+        digestMapper.insert(digest);
+        // 准备参数
+        FmsDigestSaveReqVO reqVO = buildSaveReqVO(digest.getId(), 2L, "支付办公用品款");
+
+        // 调用，并断言
+        assertServiceException(() -> digestService.updateDigest(reqVO, USER_ID), DIGEST_NOT_EXISTS);
+        verify(accountSetService).validateAccountSetWritePermission(2L, USER_ID);
+    }
+
+    @Test
+    public void testDeleteDigest_success() {
+        // mock 数据
+        FmsDigestDO digest = new FmsDigestDO().setAccountSetId(1L).setContent("购买办公用品");
+        digestMapper.insert(digest);
+
+        // 调用
+        digestService.deleteDigest(1L, digest.getId(), USER_ID);
+
+        // 断言
+        assertNull(digestMapper.selectById(digest.getId()));
+        verify(accountSetService).validateAccountSetWritePermission(1L, USER_ID);
+    }
+
+    @Test
+    public void testGetDigestList_accountSetAndSort() {
+        // mock 数据
+        FmsDigestDO first = new FmsDigestDO().setAccountSetId(1L).setContent("购买办公用品");
+        digestMapper.insert(first);
+        FmsDigestDO second = new FmsDigestDO().setAccountSetId(1L).setContent("支付员工报销款");
+        digestMapper.insert(second);
+        digestMapper.insert(new FmsDigestDO().setAccountSetId(2L).setContent("其他账套摘要"));
+
+        // 调用
+        List<FmsDigestDO> list = digestService.getDigestList(1L, USER_ID);
+
+        // 断言
+        assertEquals(2, list.size());
+        assertEquals(second.getId(), CollUtil.getFirst(list).getId());
+        verify(accountSetService).validateAccountSetReadPermission(1L, USER_ID);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsDigestSaveReqVO buildSaveReqVO(Long id, Long accountSetId, String content) {
+        FmsDigestSaveReqVO reqVO = new FmsDigestSaveReqVO();
+        reqVO.setId(id);
+        reqVO.setAccountSetId(accountSetId);
+        reqVO.setContent(content);
+        return reqVO;
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterServiceImplTest.java
new file mode 100644
index 0000000..d02ab09
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsFinanceParameterServiceImplTest.java
@@ -0,0 +1,155 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.accountset.FmsAccountSetInitializeReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.financeparameter.FmsFinanceParameterUpdateReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsFinanceParameterMapper;
+import cn.iocoder.yudao.module.fms.enums.ledger.FmsLedgerBalanceModeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_SETTINGS_RULE_INVALID;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_SETTINGS_RULE_SHRINK;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+import static org.mockito.Mockito.when;
+
+@Import(FmsFinanceParameterServiceImpl.class)
+public class FmsFinanceParameterServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsFinanceParameterServiceImpl financeParameterService;
+    @Resource
+    private FmsFinanceParameterMapper financeParameterMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+
+    @Test
+    public void testInitializeFinanceParameter_success() {
+        // 准备参数
+        Long accountSetId = randomLongId();
+        FmsAccountSetInitializeReqVO reqVO = new FmsAccountSetInitializeReqVO()
+                .setLevel(4).setSubjectCodeRule("4-2-2-2")
+                .setLedgerBalanceMode(FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode());
+
+        // 调用
+        financeParameterService.initializeFinanceParameter(accountSetId, reqVO);
+
+        // 断言
+        FmsFinanceParameterDO financeParameter = financeParameterMapper.selectByAccountSetId(accountSetId);
+        assertEquals(reqVO.getLevel(), financeParameter.getLevel());
+        assertEquals(reqVO.getSubjectCodeRule(), financeParameter.getSubjectCodeRule());
+        assertEquals(reqVO.getLedgerBalanceMode(), financeParameter.getLedgerBalanceMode());
+        assertFalse(financeParameter.getVoucherReviewRequired());
+        assertEquals(FmsFinanceParameterDO.DEFAULT_DEFICIT_CHECK, financeParameter.getDeficitCheck());
+        assertEquals(FmsFinanceParameterDO.DEFAULT_ASSET_PERIOD_LOCKED,
+                financeParameter.getAssetPeriodLocked());
+    }
+
+    @Test
+    public void testInitializeFinanceParameter_ruleInvalid() {
+        // 准备参数
+        FmsAccountSetInitializeReqVO reqVO = new FmsAccountSetInitializeReqVO()
+                .setLevel(2).setSubjectCodeRule("4-1")
+                .setLedgerBalanceMode(FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode());
+
+        // 调用，并断言异常
+        assertServiceException(() -> financeParameterService.initializeFinanceParameter(
+                randomLongId(), reqVO), ACCOUNT_SET_SETTINGS_RULE_INVALID);
+    }
+
+    @Test
+    public void testGetFinanceParameter_notInitialized() {
+        // mock 方法
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L).setInitialized(false));
+
+        // 调用，并断言未初始化账套没有财务参数
+        assertNull(financeParameterService.getFinanceParameter(1L, 10L));
+        verify(accountSetService).validateAccountSetReadPermission(1L, 10L);
+    }
+
+    @Test
+    public void testConvertStandardSubjectCode() {
+        // 调用，并断言
+        assertEquals("40404", financeParameterService.convertStandardSubjectCode("4404", "5-3-2-2"));
+        assertEquals("10001001", financeParameterService.convertStandardSubjectCode("100101", "5-3-2-2"));
+    }
+
+    @Test
+    public void testUpdateFinanceParameter_success() {
+        // mock 数据
+        Long accountSetId = randomLongId();
+        FmsFinanceParameterDO financeParameter = buildFinanceParameter(accountSetId);
+        financeParameterMapper.insert(financeParameter);
+        when(accountSetService.validateAccountSetWritePermission(accountSetId, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(accountSetId).setInitialized(true));
+        // 准备参数
+        FmsFinanceParameterUpdateReqVO reqVO = new FmsFinanceParameterUpdateReqVO()
+                .setAccountSetId(accountSetId).setStandard(1).setLevel(5).setSubjectCodeRule("5-3-2-2-2")
+                .setLedgerBalanceMode(FmsLedgerBalanceModeEnum.OPPOSITE_TO_SUBJECT.getMode())
+                .setVoucherReviewRequired(false);
+
+        // 调用
+        financeParameterService.updateFinanceParameter(reqVO, 10L);
+
+        // 断言
+        FmsFinanceParameterDO dbParameter = financeParameterMapper.selectById(financeParameter.getId());
+        assertEquals(reqVO.getLevel(), dbParameter.getLevel());
+        assertEquals(reqVO.getSubjectCodeRule(), dbParameter.getSubjectCodeRule());
+        assertEquals(FmsFinanceParameterDO.DEFAULT_DEFICIT_CHECK, dbParameter.getDeficitCheck());
+        verify(subjectService).expandSubjectCodes(accountSetId,
+                Arrays.asList(4, 2, 2, 2), Arrays.asList(5, 3, 2, 2, 2));
+        verify(accountSetService).updateAccountSetStandard(accountSetId, reqVO.getStandard(), 10L);
+    }
+
+    @Test
+    public void testUpdateFinanceParameter_ruleShrink() {
+        // mock 数据
+        Long accountSetId = randomLongId();
+        financeParameterMapper.insert(buildFinanceParameter(accountSetId));
+        when(accountSetService.validateAccountSetWritePermission(accountSetId, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(accountSetId).setInitialized(true));
+        // 准备参数
+        FmsFinanceParameterUpdateReqVO reqVO = new FmsFinanceParameterUpdateReqVO()
+                .setAccountSetId(accountSetId).setStandard(1).setLevel(4).setSubjectCodeRule("3-2-2-2")
+                .setLedgerBalanceMode(FmsLedgerBalanceModeEnum.SAME_AS_SUBJECT.getMode())
+                .setVoucherReviewRequired(true);
+
+        // 调用，并断言异常
+        assertServiceException(() -> financeParameterService.updateFinanceParameter(reqVO, 10L),
+                ACCOUNT_SET_SETTINGS_RULE_SHRINK);
+        verifyNoInteractions(subjectService);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsFinanceParameterDO buildFinanceParameter(Long accountSetId) {
+        return randomPojo(FmsFinanceParameterDO.class, financeParameter -> financeParameter.setId(null)
+                .setAccountSetId(accountSetId)
+                .setLevel(FmsFinanceParameterDO.DEFAULT_LEVEL)
+                .setSubjectCodeRule(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE)
+                .setLedgerBalanceMode(FmsFinanceParameterDO.DEFAULT_LEDGER_BALANCE_MODE)
+                .setVoucherReviewRequired(FmsFinanceParameterDO.DEFAULT_VOUCHER_REVIEW_REQUIRED)
+                .setDeficitCheck(FmsFinanceParameterDO.DEFAULT_DEFICIT_CHECK)
+                .setAssetPeriodLocked(FmsFinanceParameterDO.DEFAULT_ASSET_PERIOD_LOCKED));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceServiceImplTest.java
new file mode 100644
index 0000000..9164ea4
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsInitialBalanceServiceImplTest.java
@@ -0,0 +1,338 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsTrialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsInitialBalanceSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsInitialBalanceDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsInitialBalanceMapper;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsAuxiliaryTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryCombinationService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryItemService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_PERIOD_CLOSED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.INITIAL_BALANCE_SUBJECT_NOT_LEAF;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.ArgumentMatchers.anyList;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsInitialBalanceServiceImpl.class)
+public class FmsInitialBalanceServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsInitialBalanceServiceImpl initialBalanceService;
+    @Resource
+    private FmsInitialBalanceMapper initialBalanceMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @MockitoBean
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @MockitoBean
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+    @MockitoBean
+    private FmsClosingPeriodService closingPeriodService;
+
+    @Test
+    public void testGetInitialBalanceList_aggregateParent() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsSubjectDO parent = buildSubject(10L, null, FmsDebitCreditDirectionEnum.DEBIT.getType());
+        FmsSubjectDO child = buildSubject(11L, parent.getId(), FmsDebitCreditDirectionEnum.DEBIT.getType());
+        mockAccountSetAndSubjects(accountSetId, Arrays.asList(parent, child));
+        initialBalanceMapper.insert(buildBalance(accountSetId, child.getId(), "120.00"));
+
+        // 调用
+        List<FmsInitialBalanceRespVO> result = initialBalanceService.getInitialBalanceList(
+                accountSetId, FmsSubjectTypeEnum.ASSET.getType(), 10L);
+
+        // 断言：平铺列表父级在前，父级余额由末级科目汇总
+        assertEquals(2, result.size());
+        assertEquals(parent.getId(), result.get(0).getSubjectId());
+        assertEquals(new BigDecimal("120.00"), result.get(0).getOpeningAmount());
+        assertEquals(child.getId(), result.get(1).getSubjectId());
+        assertEquals(new BigDecimal("120.00"), result.get(1).getOpeningAmount());
+    }
+
+    @Test
+    public void testSaveInitialBalance_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsSubjectDO subject = buildSubject(11L, null, FmsDebitCreditDirectionEnum.DEBIT.getType());
+        mockAccountSetAndSubjects(accountSetId, Collections.singletonList(subject));
+        when(closingPeriodService.getCurrentMonth(eq(accountSetId), any(LocalDateTime.class)))
+                .thenReturn(YearMonth.of(2026, 3));
+        // 准备参数
+        FmsInitialBalanceSaveReqVO reqVO = new FmsInitialBalanceSaveReqVO();
+        reqVO.setAccountSetId(accountSetId).setBalances(Collections.singletonList(
+                buildSaveBalance(subject.getId(), "1000.00", "200.00", "100.00", "900.00")));
+
+        // 调用
+        initialBalanceService.saveInitialBalance(reqVO, 10L);
+
+        // 断言
+        FmsInitialBalanceDO balance = initialBalanceMapper.selectByAccountSetIdAndSubjectId(
+                accountSetId, subject.getId());
+        assertEquals(new BigDecimal("1000.00"), balance.getOpeningAmount());
+        assertEquals(new BigDecimal("200.00"), balance.getYearDebitAmount());
+        assertEquals(new BigDecimal("100.00"), balance.getYearCreditAmount());
+        assertEquals(new BigDecimal("900.00"), balance.getYearOpeningAmount());
+        verify(accountSetService).validateAccountSetWritePermission(accountSetId, 10L);
+    }
+
+    @Test
+    public void testSaveInitialBalance_subjectNotLeaf() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsSubjectDO parent = buildSubject(10L, null, FmsDebitCreditDirectionEnum.DEBIT.getType());
+        FmsSubjectDO child = buildSubject(11L, parent.getId(), FmsDebitCreditDirectionEnum.DEBIT.getType());
+        mockAccountSetAndSubjects(accountSetId, Arrays.asList(parent, child));
+        when(closingPeriodService.getCurrentMonth(eq(accountSetId), any(LocalDateTime.class)))
+                .thenReturn(YearMonth.of(2026, 3));
+        // 准备参数
+        FmsInitialBalanceSaveReqVO reqVO = new FmsInitialBalanceSaveReqVO();
+        reqVO.setAccountSetId(accountSetId).setBalances(Collections.singletonList(
+                buildSaveBalance(parent.getId(), "100.00", "0", "0", "100.00")));
+
+        // 调用，并断言
+        assertServiceException(() -> initialBalanceService.saveInitialBalance(reqVO, 10L),
+                INITIAL_BALANCE_SUBJECT_NOT_LEAF);
+    }
+
+    @Test
+    public void testSaveInitialBalance_periodClosed() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsSubjectDO subject = buildSubject(11L, null, FmsDebitCreditDirectionEnum.DEBIT.getType());
+        mockAccountSetAndSubjects(accountSetId, Collections.singletonList(subject));
+        // 账套已结账，当前期间晚于启用期间
+        when(closingPeriodService.getCurrentMonth(eq(accountSetId), any(LocalDateTime.class)))
+                .thenReturn(YearMonth.of(2026, 4));
+        // 准备参数
+        FmsInitialBalanceSaveReqVO reqVO = new FmsInitialBalanceSaveReqVO();
+        reqVO.setAccountSetId(accountSetId).setBalances(Collections.singletonList(
+                buildSaveBalance(subject.getId(), "100.00", "0", "0", "100.00")));
+
+        // 调用，并断言
+        assertServiceException(() -> initialBalanceService.saveInitialBalance(reqVO, 10L),
+                INITIAL_BALANCE_PERIOD_CLOSED);
+    }
+
+    @Test
+    public void testGetTrialBalance_balanced() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsSubjectDO debit = buildSubject(10L, null, FmsDebitCreditDirectionEnum.DEBIT.getType());
+        FmsSubjectDO credit = buildSubject(20L, null, FmsDebitCreditDirectionEnum.CREDIT.getType());
+        mockAccountSetAndSubjects(accountSetId, Arrays.asList(debit, credit));
+        initialBalanceMapper.insert(buildBalance(accountSetId, debit.getId(), "1000.00"));
+        initialBalanceMapper.insert(buildBalance(accountSetId, credit.getId(), "1000.00"));
+
+        // 调用
+        FmsTrialBalanceRespVO result = initialBalanceService.getTrialBalance(accountSetId, 10L);
+
+        // 断言
+        assertTrue(result.getBalanced());
+        assertEquals(new BigDecimal("1000.00"), result.getOpeningDebitAmount());
+        assertEquals(new BigDecimal("1000.00"), result.getOpeningCreditAmount());
+        assertEquals(BigDecimal.ZERO.setScale(2), result.getOpeningDifferenceAmount());
+    }
+
+    @Test
+    public void testImportInitialBalance_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsSubjectDO subject = buildSubject(11L, null, FmsDebitCreditDirectionEnum.DEBIT.getType());
+        mockAccountSetAndSubjects(accountSetId, Collections.singletonList(subject));
+        when(closingPeriodService.getCurrentMonth(eq(accountSetId), any(LocalDateTime.class)))
+                .thenReturn(YearMonth.of(2026, 3));
+        when(auxiliaryTypeService.getAuxiliaryTypeList(accountSetId, 10L))
+                .thenReturn(Collections.emptyList());
+        when(auxiliaryItemService.getAuxiliaryItemListByAccountSetId(accountSetId, 10L))
+                .thenReturn(Collections.emptyList());
+        // 准备参数
+        FmsInitialBalanceExcelVO row = new FmsInitialBalanceExcelVO().setRowNumber(3)
+                .setSubjectCode(subject.getCode()).setDirectionName("借")
+                .setOpeningAmount(new BigDecimal("1000.00"))
+                .setOpeningQuantity(new BigDecimal("10.0000"))
+                .setYearDebitAmount(new BigDecimal("200.00"))
+                .setYearDebitQuantity(new BigDecimal("2.0000"))
+                .setYearCreditAmount(new BigDecimal("100.00"))
+                .setYearCreditQuantity(new BigDecimal("1.0000"));
+
+        // 调用
+        int count = initialBalanceService.importInitialBalance(
+                accountSetId, Collections.singletonList(row), 10L);
+
+        // 断言
+        assertEquals(1, count);
+        FmsInitialBalanceDO balance = initialBalanceMapper.selectByAccountSetIdAndSubjectId(
+                accountSetId, subject.getId());
+        assertEquals(new BigDecimal("900.00"), balance.getYearOpeningAmount());
+        assertEquals(new BigDecimal("9.0000"), balance.getYearOpeningQuantity());
+        verify(accountSetService).validateAccountSetWritePermission(accountSetId, 10L);
+    }
+
+    @Test
+    public void testImportInitialBalance_auxiliaryEmbeddedJson() {
+        // mock 数据
+        Long accountSetId = 1L;
+        Long auxiliaryTypeId = 21L;
+        FmsSubjectDO subject = buildSubject(11L, null, FmsDebitCreditDirectionEnum.DEBIT.getType())
+                .setAuxiliaryTypeIds(Collections.singletonList(auxiliaryTypeId));
+        mockAccountSetAndSubjects(accountSetId, Collections.singletonList(subject));
+        when(closingPeriodService.getCurrentMonth(eq(accountSetId), any(LocalDateTime.class)))
+                .thenReturn(YearMonth.of(2026, 3));
+        FmsAuxiliaryTypeDO type = new FmsAuxiliaryTypeDO().setId(auxiliaryTypeId)
+                .setName("客户").setAccountSetId(accountSetId)
+                .setType(FmsAuxiliaryTypeEnum.CUSTOMER.getType());
+        FmsAuxiliaryItemDO item = new FmsAuxiliaryItemDO().setId(31L).setCode("C001")
+                .setName("北京客户").setAuxiliaryTypeId(auxiliaryTypeId)
+                .setAccountSetId(accountSetId);
+        when(auxiliaryTypeService.getAuxiliaryTypeList(accountSetId, 10L))
+                .thenReturn(Collections.singletonList(type));
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(eq(accountSetId), anyCollection()))
+                .thenReturn(Collections.singletonList(type));
+        when(auxiliaryItemService.getAuxiliaryItemListByAccountSetId(accountSetId, 10L))
+                .thenReturn(Collections.singletonList(item));
+        when(auxiliaryItemService.validateAuxiliaryItemList(eq(accountSetId), anyList()))
+                .thenReturn(Collections.singletonList(item));
+        when(auxiliaryCombinationService.saveAuxiliaryCombination(
+                eq(accountSetId), eq(subject.getId()), anyList()))
+                .thenReturn(new FmsAuxiliaryCombinationDO().setId(41L));
+        // 准备参数
+        FmsInitialBalanceExcelVO row = new FmsInitialBalanceExcelVO().setRowNumber(3)
+                .setSubjectCode(subject.getCode()).setDirectionName("借")
+                .setAuxiliaryItems("客户:北京客户").setOpeningAmount(new BigDecimal("500.00"));
+
+        // 调用
+        int count = initialBalanceService.importInitialBalance(
+                accountSetId, Collections.singletonList(row), 10L);
+
+        // 断言
+        assertEquals(1, count);
+        FmsInitialBalanceDO balance = initialBalanceMapper.selectByAccountSetIdAndSubjectId(
+                accountSetId, subject.getId());
+        assertEquals(1, balance.getAssistBalances().size());
+        assertEquals(item.getId(), balance.getAssistBalances().get(0)
+                .getAuxiliaries().get(0).getItemId());
+        assertEquals("北京客户", balance.getAssistBalances().get(0)
+                .getAuxiliaries().get(0).getName());
+        assertEquals(new BigDecimal("500.00"), balance.getOpeningAmount());
+    }
+
+    @Test
+    public void testGetInitialBalanceCountByAuxiliaryItemIds_embeddedJson() {
+        // mock 数据
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setAccountSetId(1L)
+                .setAssistBalances(Collections.singletonList(
+                        FmsInitialBalanceDO.AssistBalance.builder()
+                                .auxiliaries(Collections.singletonList(
+                                        FmsInitialBalanceDO.AuxiliaryItem.builder()
+                                                .typeId(31L).itemId(41L).build()))
+                                .build())));
+
+        // 调用，并断言
+        assertEquals(1L, initialBalanceService.getInitialBalanceCountByAuxiliaryItemIds(
+                1L, Collections.singletonList(41L)));
+        assertEquals(1L, initialBalanceService.getInitialBalanceCountByAuxiliaryTypeId(1L, 31L));
+        assertEquals(0L, initialBalanceService.getInitialBalanceCountByAuxiliaryItemIds(
+                1L, Collections.singletonList(42L)));
+    }
+
+    @Test
+    public void testGetInitialBalanceQuantityCountBySubjectIds() {
+        // mock 数据
+        initialBalanceMapper.insert(buildBalance(1L, 101L, "100.00")
+                .setOpeningQuantity(new BigDecimal("2.00")));
+        initialBalanceMapper.insert(buildBalance(1L, 102L, "200.00"));
+        initialBalanceMapper.insert(buildBalance(1L, 103L, "300.00")
+                .setAssistBalances(Collections.singletonList(FmsInitialBalanceDO.AssistBalance.builder()
+                        .yearDebitQuantity(new BigDecimal("3.00")).build())));
+
+        // 调用，并断言
+        assertEquals(1L, initialBalanceService.getInitialBalanceQuantityCountBySubjectIds(
+                1L, Arrays.asList(101L, 102L)));
+        assertEquals(2L, initialBalanceService.getInitialBalanceQuantityCountBySubjectIds(
+                1L, Arrays.asList(101L, 102L, 103L)));
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsSubjectDO buildSubject(Long id, Long parentId, Integer direction) {
+        return randomPojo(FmsSubjectDO.class, subject -> subject.setId(id)
+                .setCode(String.valueOf(id)).setName("测试科目")
+                .setParentId(parentId).setType(FmsSubjectTypeEnum.ASSET.getType()).setCategory(1)
+                .setBalanceDirection(direction).setQuantityAccounting(false)
+                .setAuxiliaryTypeIds(Collections.emptyList()).setCurrencyIds(Collections.emptyList()));
+    }
+
+    private FmsInitialBalanceDO buildBalance(Long accountSetId, Long subjectId, String amount) {
+        return randomPojo(FmsInitialBalanceDO.class, balance -> balance.setId(null)
+                .setAccountSetId(accountSetId).setSubjectId(subjectId)
+                .setAuxiliaryAccounting(false).setOpeningAmount(new BigDecimal(amount))
+                .setOpeningQuantity(BigDecimal.ZERO).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearDebitQuantity(BigDecimal.ZERO).setYearCreditAmount(BigDecimal.ZERO)
+                .setYearCreditQuantity(BigDecimal.ZERO).setYearOpeningAmount(new BigDecimal(amount))
+                .setYearOpeningQuantity(BigDecimal.ZERO).setProfitLossAmount(BigDecimal.ZERO)
+                .setProfitLossQuantity(BigDecimal.ZERO)
+                .setAssistBalances(Collections.emptyList()));
+    }
+
+    private FmsInitialBalanceSaveReqVO.Balance buildSaveBalance(Long subjectId,
+            String openingAmount, String yearDebitAmount, String yearCreditAmount,
+            String yearOpeningAmount) {
+        FmsInitialBalanceSaveReqVO.Balance balance = new FmsInitialBalanceSaveReqVO.Balance();
+        balance.setSubjectId(subjectId).setAssistBalances(Collections.emptyList());
+        balance.setOpeningAmount(new BigDecimal(openingAmount)).setOpeningQuantity(BigDecimal.ZERO)
+                .setYearDebitAmount(new BigDecimal(yearDebitAmount)).setYearDebitQuantity(BigDecimal.ZERO)
+                .setYearCreditAmount(new BigDecimal(yearCreditAmount)).setYearCreditQuantity(BigDecimal.ZERO)
+                .setYearOpeningAmount(new BigDecimal(yearOpeningAmount)).setYearOpeningQuantity(BigDecimal.ZERO)
+                .setProfitLossAmount(BigDecimal.ZERO).setProfitLossQuantity(BigDecimal.ZERO);
+        return balance;
+    }
+
+    private void mockAccountSetAndSubjects(Long accountSetId, List<FmsSubjectDO> subjects) {
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(accountSetId)
+                .setStartTime(LocalDateTime.of(2026, 3, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(accountSetId, 10L))
+                .thenReturn(accountSet);
+        when(accountSetService.validateAccountSetWritePermission(accountSetId, 10L))
+                .thenReturn(accountSet);
+        when(subjectService.getSubjectList(eq(accountSetId), any(), eq(10L))).thenReturn(subjects);
+    }
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectServiceImplTest.java
new file mode 100644
index 0000000..410f0dc
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsSubjectServiceImplTest.java
@@ -0,0 +1,823 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectDeleteReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportExcelVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectStatusReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.subject.FmsSubjectUsageRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsCurrencyDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsSubjectMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsSubjectTemplateMapper;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingTemplateService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryCombinationService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import cn.iocoder.yudao.module.fms.service.config.FmsCurrencyService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherTemplateService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.ArgumentMatchers.anyList;
+import static org.mockito.ArgumentMatchers.anyString;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.doThrow;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsSubjectServiceImpl.class)
+public class FmsSubjectServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsSubjectServiceImpl subjectService;
+    @Resource
+    private FmsSubjectMapper subjectMapper;
+    @Resource
+    private FmsSubjectTemplateMapper subjectTemplateMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsFinanceParameterService financeParameterService;
+    @MockitoBean
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @MockitoBean
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @MockitoBean
+    private FmsCurrencyService currencyService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+    @MockitoBean
+    private FmsVoucherTemplateService voucherTemplateService;
+    @MockitoBean
+    private FmsInitialBalanceService initialBalanceService;
+    @MockitoBean
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+    @MockitoBean
+    private FmsClosingTemplateService closingTemplateService;
+
+    @Test
+    public void testInitializeDefaultSubjects_success() {
+        // mock 数据
+        when(financeParameterService.getFinanceParameter(10L)).thenReturn(new FmsFinanceParameterDO()
+                .setSubjectCodeRule(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE));
+        when(financeParameterService.convertStandardSubjectCode(anyString(), anyString()))
+                .thenAnswer(invocation -> invocation.getArgument(0));
+        FmsSubjectTemplateDO parent = buildSubjectTemplate(
+                "1001", "库存现金", FmsSubjectTemplateDO.PARENT_ID_ROOT, 1);
+        subjectTemplateMapper.insert(parent);
+        FmsSubjectTemplateDO child = buildSubjectTemplate("100101", "人民币现金", parent.getId(), 2);
+        subjectTemplateMapper.insert(child);
+        // 准备参数
+        Long accountSetId = 10L;
+
+        // 调用
+        subjectService.initializeDefaultSubjects(accountSetId);
+
+        // 断言
+        List<FmsSubjectDO> subjects = subjectMapper.selectListByAccountSetIdAndType(
+                accountSetId, FmsSubjectTypeEnum.ASSET.getType());
+        assertEquals(2, subjects.size());
+        assertEquals(FmsSubjectDO.PARENT_ID_ROOT, subjects.get(0).getParentId());
+        assertEquals(subjects.get(0).getId(), subjects.get(1).getParentId());
+        assertEquals("100101", subjects.get(1).getCode());
+        assertTrue(subjects.get(1).getAuxiliaryTypeIds().isEmpty());
+    }
+
+    @Test
+    public void testCreateSubject_success() {
+        // 准备参数
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "1001", "库存现金");
+
+        // 调用
+        Long subjectId = subjectService.createSubject(reqVO, 10L);
+
+        // 断言
+        FmsSubjectDO subject = subjectMapper.selectById(subjectId);
+        assertEquals(accountSetId, subject.getAccountSetId());
+        assertEquals(reqVO.getCode(), subject.getCode());
+        assertEquals(reqVO.getName(), subject.getName());
+        assertEquals(1, subject.getLevel());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), subject.getStatus());
+        assertTrue(subject.getAuxiliaryTypeIds().isEmpty());
+        assertTrue(subject.getCurrencyIds().isEmpty());
+    }
+
+    @Test
+    public void testCreateSubject_withCurrency() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsCurrencyDO currency = new FmsCurrencyDO().setId(20L).setAccountSetId(accountSetId)
+                .setCode("USD").setName("美元").setStandard(false);
+        when(currencyService.validateCurrencyList(accountSetId, Arrays.asList(currency.getId(), currency.getId())))
+                .thenReturn(Collections.singletonList(currency));
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "1001", "库存现金");
+        reqVO.setCurrencyIds(Arrays.asList(currency.getId(), currency.getId()));
+
+        // 调用
+        Long subjectId = subjectService.createSubject(reqVO, 10L);
+
+        // 断言
+        assertEquals(Arrays.asList(currency.getId(), currency.getId()),
+                subjectMapper.selectById(subjectId).getCurrencyIds());
+    }
+
+    @Test
+    public void testCreateSubject_auxiliaryTypeNotExistsInAccountSet() {
+        // mock 数据
+        Long accountSetId = 1L;
+        Long auxiliaryTypeId = 20L;
+        mockAccountSetAccess(accountSetId);
+        doThrow(exception(AUXILIARY_TYPE_NOT_EXISTS)).when(auxiliaryTypeService)
+                .validateAuxiliaryTypeList(accountSetId, Collections.singletonList(auxiliaryTypeId));
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "1001", "库存现金")
+                .setAuxiliaryTypeIds(Collections.singletonList(auxiliaryTypeId));
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.createSubject(reqVO, 10L), AUXILIARY_TYPE_NOT_EXISTS);
+        assertNull(subjectMapper.selectByAccountSetIdAndCode(accountSetId, reqVO.getCode()));
+    }
+
+    @Test
+    public void testCreateSubject_standardCurrencyInvalid() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsCurrencyDO currency = new FmsCurrencyDO().setId(20L).setAccountSetId(accountSetId)
+                .setCode("RMB").setName("人民币").setStandard(true);
+        when(currencyService.validateCurrencyList(accountSetId, Collections.singletonList(currency.getId())))
+                .thenReturn(Collections.singletonList(currency));
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "1001", "库存现金");
+        reqVO.setCurrencyIds(Collections.singletonList(currency.getId()));
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.createSubject(reqVO, 10L), SUBJECT_CURRENCY_INVALID);
+    }
+
+    @Test
+    public void testCreateSubject_codeDuplicate() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        subjectMapper.insert(buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1));
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "1001", "库存现金");
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.createSubject(reqVO, 10L), SUBJECT_CODE_DUPLICATE);
+    }
+
+    @Test
+    public void testCreateSubject_childCodeRuleInvalid() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "10010101", "人民币现金");
+        reqVO.setParentId(parent.getId());
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.createSubject(reqVO, 10L), SUBJECT_CODE_RULE_INVALID);
+    }
+
+    @Test
+    public void testCreateSubject_parentCategoryInvalid() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "100101", "人民币现金")
+                .setParentId(parent.getId()).setCategory(2);
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.createSubject(reqVO, 10L), SUBJECT_PARENT_INVALID);
+    }
+
+    @Test
+    public void testCreateSubject_clearParentAuxiliaryTypeIds() {
+        // mock 数据
+        Long accountSetId = 1L;
+        Long auxiliaryTypeId = 20L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1)
+                .setAuxiliaryTypeIds(Collections.singletonList(auxiliaryTypeId));
+        subjectMapper.insert(parent);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "100101", "人民币现金")
+                .setParentId(parent.getId())
+                .setAuxiliaryTypeIds(Collections.singletonList(auxiliaryTypeId));
+
+        // 调用
+        Long subjectId = subjectService.createSubject(reqVO, 10L);
+
+        // 断言
+        assertTrue(subjectMapper.selectById(parent.getId()).getAuxiliaryTypeIds().isEmpty());
+        assertEquals(Collections.singletonList(auxiliaryTypeId),
+                subjectMapper.selectById(subjectId).getAuxiliaryTypeIds());
+    }
+
+    @Test
+    public void testCreateSubject_parentInUse() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(parent.getId()))).thenReturn(1L);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "100101", "人民币现金")
+                .setParentId(parent.getId());
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.createSubject(reqVO, 10L), SUBJECT_PARENT_IN_USE);
+    }
+
+    @Test
+    public void testCreateSubject_migrateParentDataSuccess() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(parent.getId()))).thenReturn(2L);
+        when(initialBalanceService.getInitialBalanceCountBySubjectIds(
+                accountSetId, Collections.singletonList(parent.getId()))).thenReturn(1L);
+        when(auxiliaryCombinationService.getAuxiliaryCombinationCountBySubjectIds(
+                accountSetId, Collections.singletonList(parent.getId()))).thenReturn(1L);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "100101", "人民币现金")
+                .setParentId(parent.getId()).setMigrateParentData(true);
+
+        // 调用
+        Long subjectId = subjectService.createSubject(reqVO, 10L);
+
+        // 断言
+        FmsSubjectDO subject = subjectMapper.selectById(subjectId);
+        verify(voucherService).updateVoucherEntrySubject(eq(accountSetId), eq(parent.getId()),
+                argThat(target -> target.getId().equals(subjectId)
+                        && target.getCode().equals(subject.getCode())
+                        && target.getParentId().equals(parent.getId())));
+        verify(initialBalanceService).updateInitialBalanceSubject(accountSetId, parent.getId(), subjectId);
+        verify(auxiliaryCombinationService).updateAuxiliaryCombinationSubject(
+                accountSetId, parent.getId(), subjectId);
+    }
+
+    @Test
+    public void testCreateSubject_migrateParentDataConfigIncompatible() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(parent.getId()))).thenReturn(1L);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "100101", "人民币现金")
+                .setParentId(parent.getId()).setMigrateParentData(true)
+                .setBalanceDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.createSubject(reqVO, 10L),
+                SUBJECT_PARENT_CONFIG_INCOMPATIBLE);
+        assertNull(subjectMapper.selectByAccountSetIdAndCode(accountSetId, reqVO.getCode()));
+    }
+
+    @Test
+    public void testCreateSubject_migrateParentDataRollback() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(parent.getId()))).thenReturn(1L);
+        doThrow(new IllegalStateException("迁移失败")).when(initialBalanceService)
+                .updateInitialBalanceSubject(eq(accountSetId), eq(parent.getId()), anyLong());
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, "100101", "人民币现金")
+                .setParentId(parent.getId()).setMigrateParentData(true);
+
+        // 调用，并断言
+        assertThrows(IllegalStateException.class, () -> subjectService.createSubject(reqVO, 10L));
+        assertNull(subjectMapper.selectByAccountSetIdAndCode(accountSetId, reqVO.getCode()));
+    }
+
+    @Test
+    public void testUpdateSubject_usedBalanceDirectionImmutable() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(subject);
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, subject.getCode(), subject.getName())
+                .setId(subject.getId()).setBalanceDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.updateSubject(reqVO, 10L),
+                SUBJECT_USED_BALANCE_DIRECTION_IMMUTABLE);
+        assertEquals(subject.getBalanceDirection(), subjectMapper.selectById(subject.getId()).getBalanceDirection());
+    }
+
+    @Test
+    public void testUpdateSubject_usedAuxiliaryImmutable() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1)
+                .setAuxiliaryTypeIds(Collections.singletonList(20L));
+        subjectMapper.insert(subject);
+        when(initialBalanceService.getInitialBalanceCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, subject.getCode(), subject.getName())
+                .setId(subject.getId()).setAuxiliaryTypeIds(Collections.singletonList(30L));
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.updateSubject(reqVO, 10L),
+                SUBJECT_USED_AUXILIARY_IMMUTABLE);
+        assertEquals(Collections.singletonList(20L),
+                subjectMapper.selectById(subject.getId()).getAuxiliaryTypeIds());
+    }
+
+    @Test
+    public void testUpdateSubject_migrateAuxiliarySuccess() {
+        // mock 数据
+        Long accountSetId = 1L;
+        Long typeId = 20L;
+        Long itemId = 30L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(subject);
+        FmsAuxiliaryTypeDO auxiliaryType = new FmsAuxiliaryTypeDO().setId(typeId)
+                .setAccountSetId(accountSetId).setType(1).setName("客户");
+        FmsAuxiliaryItemDO auxiliaryItem = new FmsAuxiliaryItemDO().setId(itemId)
+                .setAccountSetId(accountSetId).setAuxiliaryTypeId(typeId).setName("测试客户")
+                .setStatus(CommonStatusEnum.ENABLE.getStatus());
+        FmsAuxiliaryCombinationDO combination = new FmsAuxiliaryCombinationDO().setId(40L)
+                .setAccountSetId(accountSetId).setSubjectId(subject.getId());
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(accountSetId, Collections.singletonList(typeId)))
+                .thenReturn(Collections.singletonList(auxiliaryType));
+        when(auxiliaryItemService.validateAuxiliaryItemList(eq(accountSetId), anyCollection()))
+                .thenReturn(Collections.singletonList(auxiliaryItem));
+        when(auxiliaryCombinationService.saveAuxiliaryCombination(
+                anyLong(), anyLong(), anyList())).thenReturn(combination);
+        // 准备参数
+        FmsSubjectSaveReqVO.AuxiliaryMapping mapping = new FmsSubjectSaveReqVO.AuxiliaryMapping()
+                .setTypeId(typeId).setItemId(itemId);
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, subject.getCode(), subject.getName())
+                .setId(subject.getId()).setAuxiliaryTypeIds(Collections.singletonList(typeId))
+                .setAuxiliaryMappings(Collections.singletonList(mapping));
+
+        // 调用
+        subjectService.updateSubject(reqVO, 10L);
+
+        // 断言
+        assertEquals(Collections.singletonList(typeId),
+                subjectMapper.selectById(subject.getId()).getAuxiliaryTypeIds());
+        verify(voucherService).migrateVoucherEntryAuxiliaries(accountSetId, subject.getId(), combination);
+    }
+
+    @Test
+    public void testUpdateSubject_migrateAuxiliaryMissingMapping() {
+        // mock 数据
+        Long accountSetId = 1L;
+        Long typeId = 20L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(subject);
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(accountSetId, Collections.singletonList(typeId)))
+                .thenReturn(Collections.singletonList(new FmsAuxiliaryTypeDO().setId(typeId)));
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, subject.getCode(), subject.getName())
+                .setId(subject.getId()).setAuxiliaryTypeIds(Collections.singletonList(typeId));
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.updateSubject(reqVO, 10L),
+                SUBJECT_AUXILIARY_MIGRATION_INVALID);
+        assertTrue(subjectMapper.selectById(subject.getId()).getAuxiliaryTypeIds().isEmpty());
+    }
+
+    @Test
+    public void testUpdateSubject_nonLeafConfigImmutable() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        subjectMapper.insert(buildSubjectDO(accountSetId, "100101", parent.getId(), 2));
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, parent.getCode(), parent.getName())
+                .setId(parent.getId()).setCategory(2);
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.updateSubject(reqVO, 10L),
+                SUBJECT_NON_LEAF_CONFIG_IMMUTABLE);
+    }
+
+    @Test
+    public void testUpdateSubject_quantityAccountingInUse() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1)
+                .setQuantityAccounting(true).setQuantityUnit("件");
+        subjectMapper.insert(subject);
+        when(voucherService.getVoucherEntryQuantityCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        // 准备参数
+        FmsSubjectSaveReqVO reqVO = buildSubjectSaveReqVO(accountSetId, subject.getCode(), subject.getName())
+                .setId(subject.getId()).setQuantityAccounting(false);
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.updateSubject(reqVO, 10L),
+                SUBJECT_QUANTITY_ACCOUNTING_IN_USE);
+    }
+
+    @Test
+    public void testGetSubjectUsage() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(subject);
+        subjectMapper.insert(buildSubjectDO(accountSetId, "100101", subject.getId(), 2));
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(2L);
+        when(initialBalanceService.getInitialBalanceCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        when(auxiliaryCombinationService.getAuxiliaryCombinationCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(3L);
+        when(voucherService.getVoucherEntryQuantityCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        when(initialBalanceService.getInitialBalanceQuantityCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(2L);
+
+        // 调用
+        FmsSubjectUsageRespVO usage = subjectService.getSubjectUsage(accountSetId, subject.getId(), 10L);
+
+        // 断言
+        assertEquals(1L, usage.getChildCount());
+        assertEquals(2L, usage.getVoucherEntryCount());
+        assertEquals(1L, usage.getInitialBalanceCount());
+        assertEquals(3L, usage.getAuxiliaryCombinationCount());
+        assertEquals(3L, usage.getQuantityDataCount());
+        assertTrue(usage.getUsed());
+    }
+
+    @Test
+    public void testDeleteSubjectList_hasChildren() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        subjectMapper.insert(buildSubjectDO(accountSetId, "100101", parent.getId(), 2));
+        // 准备参数
+        FmsSubjectDeleteReqVO deleteReqVO = new FmsSubjectDeleteReqVO()
+                .setAccountSetId(accountSetId).setIds(Collections.singletonList(parent.getId()));
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.deleteSubjectList(deleteReqVO, 10L), SUBJECT_HAS_CHILDREN);
+    }
+
+    @Test
+    public void testDeleteSubjectList_inUse() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(subject);
+        when(voucherService.getVoucherEntryCountBySubjectIds(
+                accountSetId, Collections.singletonList(subject.getId()))).thenReturn(1L);
+        // 准备参数
+        FmsSubjectDeleteReqVO deleteReqVO = new FmsSubjectDeleteReqVO()
+                .setAccountSetId(accountSetId).setIds(Collections.singletonList(subject.getId()));
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.deleteSubjectList(deleteReqVO, 10L),
+                SUBJECT_VOUCHER_ENTRY_IN_USE, 1L);
+        assertNotNull(subjectMapper.selectById(subject.getId()));
+    }
+
+    @Test
+    public void testDeleteSubjectList_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO subject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(subject);
+        // 准备参数
+        FmsSubjectDeleteReqVO deleteReqVO = new FmsSubjectDeleteReqVO()
+                .setAccountSetId(accountSetId).setIds(Collections.singletonList(subject.getId()));
+
+        // 调用
+        subjectService.deleteSubjectList(deleteReqVO, 10L);
+
+        // 断言
+        assertNull(subjectMapper.selectById(subject.getId()));
+    }
+
+    @Test
+    public void testDeleteSubjectList_recreatedSameCode() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO firstSubject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(firstSubject);
+        // 准备参数
+        FmsSubjectDeleteReqVO firstDeleteReqVO = new FmsSubjectDeleteReqVO()
+                .setAccountSetId(accountSetId).setIds(Collections.singletonList(firstSubject.getId()));
+
+        // 删除后使用相同编码重新创建
+        subjectService.deleteSubjectList(firstDeleteReqVO, 10L);
+        FmsSubjectDO secondSubject = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(secondSubject);
+        FmsSubjectDeleteReqVO secondDeleteReqVO = new FmsSubjectDeleteReqVO()
+                .setAccountSetId(accountSetId).setIds(Collections.singletonList(secondSubject.getId()));
+        subjectService.deleteSubjectList(secondDeleteReqVO, 10L);
+
+        // 断言
+        assertNull(subjectMapper.selectById(firstSubject.getId()));
+        assertNull(subjectMapper.selectById(secondSubject.getId()));
+    }
+
+    @Test
+    public void testUpdateSubjectStatus_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO first = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        FmsSubjectDO second = buildSubjectDO(accountSetId, "1002", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(first);
+        subjectMapper.insert(second);
+        FmsSubjectDO child = buildSubjectDO(accountSetId, "100101", first.getId(), 2);
+        subjectMapper.insert(child);
+        FmsSubjectDO grandchild = buildSubjectDO(accountSetId, "10010101", child.getId(), 3);
+        subjectMapper.insert(grandchild);
+        // 准备参数
+        FmsSubjectStatusReqVO statusReqVO = new FmsSubjectStatusReqVO().setAccountSetId(accountSetId)
+                .setIds(Arrays.asList(first.getId(), second.getId()))
+                .setStatus(CommonStatusEnum.DISABLE.getStatus());
+
+        // 调用
+        subjectService.updateSubjectStatus(statusReqVO, 10L);
+
+        // 断言
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(),
+                subjectMapper.selectById(first.getId()).getStatus());
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(),
+                subjectMapper.selectById(second.getId()).getStatus());
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(),
+                subjectMapper.selectById(child.getId()).getStatus());
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(),
+                subjectMapper.selectById(grandchild.getId()).getStatus());
+    }
+
+    @Test
+    public void testGetSubjectIdListWithChildren_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        FmsSubjectDO parent = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(parent);
+        FmsSubjectDO child = buildSubjectDO(accountSetId, "100101", parent.getId(), 2)
+                .setStatus(CommonStatusEnum.DISABLE.getStatus());
+        subjectMapper.insert(child);
+        FmsSubjectDO grandchild = buildSubjectDO(accountSetId, "10010101", child.getId(), 3);
+        subjectMapper.insert(grandchild);
+        subjectMapper.insert(buildSubjectDO(accountSetId, "1002", FmsSubjectDO.PARENT_ID_ROOT, 1));
+
+        // 调用
+        List<Long> subjectIds = subjectService.getSubjectIdListWithChildren(accountSetId, parent.getId());
+
+        // 断言
+        assertEquals(Arrays.asList(parent.getId(), child.getId(), grandchild.getId()), subjectIds);
+    }
+
+    @Test
+    public void testGetSubjectCountByAuxiliaryTypeId() {
+        // mock 数据
+        subjectMapper.insert(buildSubjectDO(1L, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1)
+                .setAuxiliaryTypeIds(Collections.singletonList(20L)));
+        subjectMapper.insert(buildSubjectDO(2L, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1)
+                .setAuxiliaryTypeIds(Collections.singletonList(30L)));
+
+        // 调用，并断言
+        assertEquals(1L, subjectService.getSubjectCountByAuxiliaryTypeId(1L, 20L));
+        assertEquals(0L, subjectService.getSubjectCountByAuxiliaryTypeId(1L, 30L));
+        assertEquals(0L, subjectService.getSubjectCountByAuxiliaryTypeId(2L, 20L));
+    }
+
+    @Test
+    public void testGetSubjectCountByCurrencyId() {
+        // mock 数据
+        subjectMapper.insert(buildSubjectDO(1L, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1)
+                .setCurrencyIds(Collections.singletonList(20L)));
+        subjectMapper.insert(buildSubjectDO(2L, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1)
+                .setCurrencyIds(Collections.singletonList(30L)));
+
+        // 调用，并断言
+        assertEquals(1L, subjectService.getSubjectCountByCurrencyId(1L, 20L));
+        assertEquals(0L, subjectService.getSubjectCountByCurrencyId(1L, 30L));
+        assertEquals(0L, subjectService.getSubjectCountByCurrencyId(2L, 20L));
+    }
+
+    @Test
+    public void testExpandSubjectCodes() {
+        // mock 数据
+        Long accountSetId = 1L;
+        FmsSubjectDO levelOne = buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1);
+        subjectMapper.insert(levelOne);
+        FmsSubjectDO levelTwo = buildSubjectDO(accountSetId, "100101", levelOne.getId(), 2);
+        subjectMapper.insert(levelTwo);
+        FmsSubjectDO levelThree = buildSubjectDO(accountSetId, "10010101", levelTwo.getId(), 3);
+        subjectMapper.insert(levelThree);
+
+        // 调用
+        subjectService.expandSubjectCodes(accountSetId,
+                Arrays.asList(4, 2, 2, 2), Arrays.asList(5, 3, 2, 2));
+
+        // 断言
+        assertEquals("10001", subjectMapper.selectById(levelOne.getId()).getCode());
+        assertEquals("10001001", subjectMapper.selectById(levelTwo.getId()).getCode());
+        assertEquals("1000100101", subjectMapper.selectById(levelThree.getId()).getCode());
+    }
+
+    @Test
+    public void testImportSubjectList_success() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        // 准备参数
+        List<FmsSubjectImportExcelVO> importSubjects = Arrays.asList(
+                FmsSubjectImportExcelVO.builder().code("100101").name("人民币现金")
+                        .parentSubjectCode("1001").balanceDirection("借").categoryName("流动资产").build(),
+                FmsSubjectImportExcelVO.builder().code("1001").name("库存现金")
+                        .parentSubjectCode("0").balanceDirection("借").categoryName("流动资产").build());
+
+        // 调用
+        FmsSubjectImportRespVO result = subjectService.importSubjectList(accountSetId, importSubjects, 10L);
+
+        // 断言
+        assertEquals(2, result.getTotalCount());
+        assertEquals(Arrays.asList("1001", "100101"), result.getSuccessSubjectCodes());
+        assertTrue(result.getFailureReasons().isEmpty());
+        FmsSubjectDO parent = subjectMapper.selectByAccountSetIdAndCode(accountSetId, "1001");
+        FmsSubjectDO child = subjectMapper.selectByAccountSetIdAndCode(accountSetId, "100101");
+        assertEquals(parent.getId(), child.getParentId());
+        assertEquals(2, child.getLevel());
+    }
+
+    @Test
+    public void testImportSubjectList_empty() {
+        // 准备参数
+        Long accountSetId = 1L;
+
+        // 调用，并断言
+        assertServiceException(() -> subjectService.importSubjectList(
+                accountSetId, Collections.emptyList(), 10L), SUBJECT_IMPORT_LIST_IS_EMPTY);
+    }
+
+    @Test
+    public void testImportSubjectList_requiredFieldInvalid() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        // 准备参数
+        FmsSubjectImportExcelVO importSubject = FmsSubjectImportExcelVO.builder()
+                .code(" ").name("测试科目").parentSubjectCode("0")
+                .balanceDirection("借").categoryName("流动资产").build();
+
+        // 调用
+        FmsSubjectImportRespVO result = subjectService.importSubjectList(
+                accountSetId, Collections.singletonList(importSubject), 10L);
+
+        // 断言
+        assertTrue(result.getSuccessSubjectCodes().isEmpty());
+        assertEquals(1, result.getFailureReasons().size());
+        assertTrue(CollUtil.getFirst(result.getFailureReasons().values()).contains("科目编码不能为空"));
+    }
+
+    @Test
+    public void testImportSubjectList_partialFailure() {
+        // mock 数据
+        Long accountSetId = 1L;
+        mockAccountSetAccess(accountSetId);
+        subjectMapper.insert(buildSubjectDO(accountSetId, "1001", FmsSubjectDO.PARENT_ID_ROOT, 1));
+        // 准备参数
+        List<FmsSubjectImportExcelVO> importSubjects = Arrays.asList(
+                FmsSubjectImportExcelVO.builder().code("1001").name("重复科目")
+                        .parentSubjectCode("0").balanceDirection("借").categoryName("流动资产").build(),
+                FmsSubjectImportExcelVO.builder().code("1002").name("银行存款")
+                        .parentSubjectCode("0").balanceDirection("错误方向").categoryName("流动资产").build(),
+                FmsSubjectImportExcelVO.builder().code("1003").name("其他货币资金")
+                        .parentSubjectCode("0").balanceDirection("借").categoryName("流动资产").build());
+
+        // 调用
+        FmsSubjectImportRespVO result = subjectService.importSubjectList(accountSetId, importSubjects, 10L);
+
+        // 断言
+        assertEquals(Arrays.asList("1001", "1003"), result.getSuccessSubjectCodes());
+        assertEquals(1, result.getFailureReasons().size());
+        assertTrue(result.getFailureReasons().values().contains("余额方向只能填写借或贷"));
+        assertEquals("重复科目", subjectMapper.selectByAccountSetIdAndCode(accountSetId, "1001").getName());
+        assertNotNull(subjectMapper.selectByAccountSetIdAndCode(accountSetId, "1003"));
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsSubjectSaveReqVO buildSubjectSaveReqVO(Long accountSetId, String subjectCode, String name) {
+        FmsSubjectSaveReqVO reqVO = new FmsSubjectSaveReqVO();
+        reqVO.setAccountSetId(accountSetId).setCode(subjectCode).setName(name)
+                .setParentId(FmsSubjectDO.PARENT_ID_ROOT)
+                .setType(FmsSubjectTypeEnum.ASSET.getType()).setCategory(1)
+                .setBalanceDirection(FmsDebitCreditDirectionEnum.DEBIT.getType())
+                .setAuxiliaryTypeIds(Collections.emptyList()).setCurrencyIds(Collections.emptyList())
+                .setQuantityAccounting(false).setCash(false);
+        return reqVO;
+    }
+
+    private FmsSubjectDO buildSubjectDO(Long accountSetId, String subjectCode, Long parentId, int level) {
+        return randomPojo(FmsSubjectDO.class, subject -> subject.setId(null)
+                .setCode(subjectCode).setName("测试科目").setParentId(parentId)
+                .setType(FmsSubjectTypeEnum.ASSET.getType()).setCategory(1)
+                .setBalanceDirection(FmsDebitCreditDirectionEnum.DEBIT.getType())
+                .setCash(false).setStatus(CommonStatusEnum.ENABLE.getStatus()).setLevel(level)
+                .setQuantityAccounting(false).setAccountSetId(accountSetId)
+                .setAuxiliaryTypeIds(Collections.emptyList()).setCurrencyIds(Collections.emptyList()));
+    }
+
+    private FmsSubjectTemplateDO buildSubjectTemplate(
+            String subjectCode, String name, Long parentId, int level) {
+        return randomPojo(FmsSubjectTemplateDO.class, subject -> subject.setId(null)
+                .setCode(subjectCode).setName(name).setParentId(parentId)
+                .setType(FmsSubjectTypeEnum.ASSET.getType()).setCategory(1)
+                .setBalanceDirection(FmsDebitCreditDirectionEnum.DEBIT.getType())
+                .setCash(true).setStatus(CommonStatusEnum.ENABLE.getStatus()).setLevel(level)
+                .setQuantityAccounting(false));
+    }
+
+    private void mockAccountSetAccess(Long accountSetId) {
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(accountSetId);
+        when(accountSetService.validateAccountSetReadPermission(accountSetId, 10L))
+                .thenReturn(accountSet);
+        when(accountSetService.validateAccountSetWritePermission(accountSetId, 10L))
+                .thenReturn(accountSet);
+        when(financeParameterService.getFinanceParameter(accountSetId))
+                .thenReturn(new FmsFinanceParameterDO()
+                        .setLevel(FmsFinanceParameterDO.DEFAULT_LEVEL)
+                        .setSubjectCodeRule(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateServiceImplTest.java
new file mode 100644
index 0000000..5e0b31d
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherTemplateServiceImplTest.java
@@ -0,0 +1,356 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplatecategory.FmsVoucherTemplateCategorySaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate.FmsVoucherTemplateEntryVO;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.vouchertemplate.FmsVoucherTemplateSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateCategoryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsVoucherTemplateCategoryMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsVoucherTemplateMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+import java.util.Collections;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.when;
+
+@Import(FmsVoucherTemplateServiceImpl.class)
+public class FmsVoucherTemplateServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsVoucherTemplateServiceImpl voucherTemplateService;
+    @Resource
+    private FmsVoucherTemplateCategoryMapper templateCategoryMapper;
+    @Resource
+    private FmsVoucherTemplateMapper templateMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @MockitoBean
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+
+    @Test
+    public void testCreateTemplateCategory_success() {
+        // 准备参数
+        FmsVoucherTemplateCategorySaveReqVO reqVO = buildCategorySaveReqVO(null, 1L, "日常收支");
+
+        // 调用
+        Long categoryId = voucherTemplateService.createTemplateCategory(reqVO, 10L);
+
+        // 断言
+        FmsVoucherTemplateCategoryDO category = templateCategoryMapper.selectById(categoryId);
+        assertEquals("日常收支", category.getName());
+        assertEquals(1L, category.getAccountSetId());
+    }
+
+    @Test
+    public void testCreateTemplateCategory_nameDuplicate() {
+        // mock 数据
+        templateCategoryMapper.insert(buildCategory(1L, "日常收支"));
+        // 准备参数
+        FmsVoucherTemplateCategorySaveReqVO reqVO = buildCategorySaveReqVO(null, 1L, "日常收支");
+
+        // 调用，并断言
+        assertServiceException(() -> voucherTemplateService.createTemplateCategory(reqVO, 10L),
+                VOUCHER_TEMPLATE_CATEGORY_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testDeleteTemplateCategory_inUse() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        templateMapper.insert(new FmsVoucherTemplateDO().setAccountSetId(1L)
+                .setCategoryId(category.getId()).setName("办公用品采购")
+                .setEntries(Collections.emptyList()));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherTemplateService.deleteTemplateCategory(
+                1L, category.getId(), 10L), VOUCHER_TEMPLATE_CATEGORY_IN_USE);
+    }
+
+    @Test
+    public void testCreateVoucherTemplate_jsonContent() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.singletonList(31L)),
+                new FmsSubjectDO().setId(201L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList())));
+        when(auxiliaryItemService.validateAuxiliaryItemList(eq(1L), anyCollection()))
+                .thenReturn(Collections.singletonList(new FmsAuxiliaryItemDO().setId(41L)
+                        .setAuxiliaryTypeId(31L).setName("上海客户")
+                        .setStatus(CommonStatusEnum.ENABLE.getStatus())));
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(eq(1L), anyCollection()))
+                .thenReturn(Collections.singletonList(new FmsAuxiliaryTypeDO().setId(31L).setType(1)));
+        // 准备参数
+        FmsVoucherTemplateSaveReqVO reqVO = buildTemplateSaveReqVO(category.getId());
+        FmsVoucherTemplateEntryVO.AuxiliaryItem auxiliary = new FmsVoucherTemplateEntryVO.AuxiliaryItem();
+        auxiliary.setTypeId(31L);
+        auxiliary.setItemId(41L);
+        CollUtil.getFirst(reqVO.getEntries()).setAuxiliaries(Collections.singletonList(auxiliary));
+
+        // 调用
+        Long templateId = voucherTemplateService.createVoucherTemplate(reqVO, 10L);
+
+        // 断言
+        FmsVoucherTemplateDO template = templateMapper.selectById(templateId);
+        assertEquals("办公用品采购", template.getName());
+        assertEquals(2, template.getEntries().size());
+        assertEquals(new BigDecimal("100.00"), CollUtil.getFirst(template.getEntries()).getDebitAmount());
+        FmsVoucherEntryDO.AuxiliaryItem auxiliaryItem = CollUtil.getFirst(
+                CollUtil.getFirst(template.getEntries()).getAuxiliaries());
+        assertEquals(1, auxiliaryItem.getType());
+        assertEquals(31L, auxiliaryItem.getTypeId());
+        assertEquals(41L, auxiliaryItem.getItemId());
+        assertEquals("上海客户", auxiliaryItem.getName());
+    }
+
+    @Test
+    public void testCreateVoucherTemplate_negativeAmount() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList()),
+                new FmsSubjectDO().setId(201L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList())));
+        // 准备参数
+        FmsVoucherTemplateSaveReqVO reqVO = buildTemplateSaveReqVO(category.getId());
+        reqVO.getEntries().get(0).setDebitAmount(new BigDecimal("-20.00"));
+        reqVO.getEntries().get(1).setCreditAmount(new BigDecimal("-20.00"));
+
+        // 调用
+        Long templateId = voucherTemplateService.createVoucherTemplate(reqVO, 10L);
+
+        // 断言
+        FmsVoucherTemplateDO template = templateMapper.selectById(templateId);
+        assertEquals(new BigDecimal("-20.00"), CollUtil.getFirst(template.getEntries()).getDebitAmount());
+    }
+
+    @Test
+    public void testCreateVoucherTemplate_amountUnbalanced() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList()),
+                new FmsSubjectDO().setId(201L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList())));
+        // 准备参数
+        FmsVoucherTemplateSaveReqVO reqVO = buildTemplateSaveReqVO(category.getId());
+        reqVO.getEntries().get(1).setCreditAmount(new BigDecimal("90.00"));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherTemplateService.createVoucherTemplate(reqVO, 10L),
+                VOUCHER_AMOUNT_UNBALANCED);
+    }
+
+    @Test
+    public void testCreateVoucherTemplate_quantityAmountFloor() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setQuantityAccounting(true).setAuxiliaryTypeIds(Collections.emptyList()),
+                new FmsSubjectDO().setId(201L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList())));
+        // 准备参数
+        FmsVoucherTemplateSaveReqVO reqVO = buildTemplateSaveReqVO(category.getId());
+        CollUtil.getFirst(reqVO.getEntries()).setDebitAmount(new BigDecimal("1.99"));
+        CollUtil.getFirst(reqVO.getEntries()).setQuantity(new BigDecimal("1"));
+        CollUtil.getFirst(reqVO.getEntries()).setUnitPrice(new BigDecimal("1.999"));
+        reqVO.getEntries().get(1).setCreditAmount(new BigDecimal("1.99"));
+
+        // 调用
+        Long templateId = voucherTemplateService.createVoucherTemplate(reqVO, 10L);
+
+        // 断言
+        FmsVoucherTemplateDO template = templateMapper.selectById(templateId);
+        assertEquals(new BigDecimal("1.99"), CollUtil.getFirst(template.getEntries()).getDebitAmount());
+    }
+
+    @Test
+    public void testCreateVoucherTemplate_subjectDisabled() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setStatus(CommonStatusEnum.DISABLE.getStatus()),
+                new FmsSubjectDO().setId(201L).setStatus(CommonStatusEnum.ENABLE.getStatus())));
+        // 准备参数
+        FmsVoucherTemplateSaveReqVO reqVO = buildTemplateSaveReqVO(category.getId());
+
+        // 调用，并断言
+        assertServiceException(() -> voucherTemplateService.createVoucherTemplate(reqVO, 10L),
+                VOUCHER_SUBJECT_DISABLED);
+    }
+
+    @Test
+    public void testCreateVoucherTemplate_auxiliaryItemDisabled() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.singletonList(31L)),
+                new FmsSubjectDO().setId(201L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList())));
+        when(auxiliaryItemService.validateAuxiliaryItemList(eq(1L), anyCollection()))
+                .thenReturn(Collections.singletonList(new FmsAuxiliaryItemDO().setId(41L)
+                        .setAuxiliaryTypeId(31L).setName("上海客户")
+                        .setStatus(CommonStatusEnum.DISABLE.getStatus())));
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(eq(1L), anyCollection()))
+                .thenReturn(Collections.singletonList(new FmsAuxiliaryTypeDO().setId(31L).setType(1)));
+        // 准备参数
+        FmsVoucherTemplateSaveReqVO reqVO = buildTemplateSaveReqVO(category.getId());
+        FmsVoucherTemplateEntryVO.AuxiliaryItem auxiliary = new FmsVoucherTemplateEntryVO.AuxiliaryItem();
+        auxiliary.setTypeId(31L);
+        auxiliary.setItemId(41L);
+        CollUtil.getFirst(reqVO.getEntries()).setAuxiliaries(Collections.singletonList(auxiliary));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherTemplateService.createVoucherTemplate(reqVO, 10L),
+                VOUCHER_AUXILIARY_REQUIRED);
+    }
+
+    @Test
+    public void testUpdateVoucherTemplate_success() {
+        // mock 数据
+        FmsVoucherTemplateCategoryDO category = buildCategory(1L, "日常收支");
+        templateCategoryMapper.insert(category);
+        FmsVoucherTemplateDO template = new FmsVoucherTemplateDO().setAccountSetId(1L)
+                .setCategoryId(category.getId()).setName("办公用品采购")
+                .setEntries(Collections.emptyList());
+        templateMapper.insert(template);
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(Arrays.asList(
+                new FmsSubjectDO().setId(101L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList()),
+                new FmsSubjectDO().setId(201L).setStatus(CommonStatusEnum.ENABLE.getStatus())
+                        .setAuxiliaryTypeIds(Collections.emptyList())));
+        // 准备参数
+        FmsVoucherTemplateSaveReqVO reqVO = buildTemplateSaveReqVO(category.getId());
+        reqVO.setId(template.getId());
+        reqVO.setName("办公用品采购（已修改）");
+
+        // 调用
+        voucherTemplateService.updateVoucherTemplate(reqVO, 10L);
+
+        // 断言
+        FmsVoucherTemplateDO dbTemplate = templateMapper.selectById(template.getId());
+        assertEquals("办公用品采购（已修改）", dbTemplate.getName());
+        assertEquals(category.getId(), dbTemplate.getCategoryId());
+        assertEquals(2, dbTemplate.getEntries().size());
+    }
+
+    @Test
+    public void testDeleteVoucherTemplate_success() {
+        // mock 数据
+        FmsVoucherTemplateDO template = new FmsVoucherTemplateDO().setAccountSetId(1L)
+                .setCategoryId(11L).setName("办公用品采购").setEntries(Collections.emptyList());
+        templateMapper.insert(template);
+
+        // 调用
+        voucherTemplateService.deleteVoucherTemplate(1L, template.getId(), 10L);
+
+        // 断言
+        assertNull(templateMapper.selectById(template.getId()));
+    }
+
+    @Test
+    public void testDeleteVoucherTemplate_wrongAccountSet() {
+        // mock 数据
+        FmsVoucherTemplateDO template = new FmsVoucherTemplateDO().setAccountSetId(1L)
+                .setCategoryId(11L).setName("办公用品采购").setEntries(Collections.emptyList());
+        templateMapper.insert(template);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherTemplateService.deleteVoucherTemplate(
+                2L, template.getId(), 10L), VOUCHER_TEMPLATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetVoucherTemplateCountByAuxiliary() {
+        // mock 数据
+        FmsVoucherTemplateDO.Entry entry = new FmsVoucherTemplateDO.Entry().setAuxiliaries(
+                Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .typeId(31L).itemId(41L).build()));
+        templateMapper.insert(new FmsVoucherTemplateDO().setName("收款模板")
+                .setCategoryId(1L).setAccountSetId(1L)
+                .setEntries(Collections.singletonList(entry)));
+        templateMapper.insert(new FmsVoucherTemplateDO().setName("其他账套模板")
+                .setCategoryId(1L).setAccountSetId(2L)
+                .setEntries(Collections.singletonList(entry)));
+
+        // 调用，并断言
+        assertEquals(1L, voucherTemplateService.getVoucherTemplateCountByAuxiliaryItemIds(
+                1L, Collections.singletonList(41L)));
+        assertEquals(1L, voucherTemplateService.getVoucherTemplateCountByAuxiliaryTypeId(1L, 31L));
+        assertEquals(0L, voucherTemplateService.getVoucherTemplateCountByAuxiliaryItemIds(
+                1L, Collections.singletonList(42L)));
+        assertEquals(0L, voucherTemplateService.getVoucherTemplateCountByAuxiliaryItemIds(
+                1L, Collections.emptyList()));
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsVoucherTemplateCategorySaveReqVO buildCategorySaveReqVO(
+            Long id, Long accountSetId, String name) {
+        FmsVoucherTemplateCategorySaveReqVO reqVO = new FmsVoucherTemplateCategorySaveReqVO();
+        reqVO.setId(id);
+        reqVO.setAccountSetId(accountSetId);
+        reqVO.setName(name);
+        return reqVO;
+    }
+
+    private FmsVoucherTemplateCategoryDO buildCategory(Long accountSetId, String name) {
+        return randomPojo(FmsVoucherTemplateCategoryDO.class, category -> category.setId(null)
+                .setAccountSetId(accountSetId).setName(name));
+    }
+
+    private FmsVoucherTemplateSaveReqVO buildTemplateSaveReqVO(Long categoryId) {
+        FmsVoucherTemplateEntryVO debitEntry = new FmsVoucherTemplateEntryVO();
+        debitEntry.setDigest("购买办公用品");
+        debitEntry.setSubjectId(101L);
+        debitEntry.setDebitAmount(new BigDecimal("100.00"));
+        debitEntry.setAuxiliaries(Collections.emptyList());
+        FmsVoucherTemplateEntryVO creditEntry = new FmsVoucherTemplateEntryVO();
+        creditEntry.setDigest("购买办公用品");
+        creditEntry.setSubjectId(201L);
+        creditEntry.setCreditAmount(new BigDecimal("100.00"));
+        creditEntry.setAuxiliaries(Collections.emptyList());
+        FmsVoucherTemplateSaveReqVO reqVO = new FmsVoucherTemplateSaveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setCategoryId(categoryId);
+        reqVO.setName("办公用品采购");
+        reqVO.setEntries(Arrays.asList(debitEntry, creditEntry));
+        return reqVO;
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordServiceImplTest.java
new file mode 100644
index 0000000..44baf3a
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/config/FmsVoucherWordServiceImplTest.java
@@ -0,0 +1,224 @@
+package cn.iocoder.yudao.module.fms.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.voucherword.FmsVoucherWordSaveReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsVoucherWordMapper;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.Mockito.when;
+
+@Import(FmsVoucherWordServiceImpl.class)
+public class FmsVoucherWordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsVoucherWordServiceImpl voucherWordService;
+    @Resource
+    private FmsVoucherWordMapper voucherWordMapper;
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+
+    @Test
+    public void testCreateVoucherWord_success() {
+        // mock 数据
+        voucherWordMapper.insert(buildVoucherWord(1L, "记", true, 1));
+        // 准备参数
+        FmsVoucherWordSaveReqVO reqVO = buildSaveReqVO(null, 1L, "转", "转账凭证", false);
+
+        // 调用
+        Long voucherWordId = voucherWordService.createVoucherWord(reqVO, 10L);
+
+        // 断言
+        FmsVoucherWordDO voucherWord = voucherWordMapper.selectById(voucherWordId);
+        assertEquals("转", voucherWord.getName());
+        assertEquals("转账凭证", voucherWord.getPrintTitle());
+        assertFalse(voucherWord.getDefaultStatus());
+        assertEquals(2, voucherWord.getSort());
+    }
+
+    @Test
+    public void testCreateVoucherWord_firstWordDefault() {
+        // 准备参数
+        FmsVoucherWordSaveReqVO reqVO = buildSaveReqVO(null, 1L, "记", "记账凭证", false);
+
+        // 调用
+        Long voucherWordId = voucherWordService.createVoucherWord(reqVO, 10L);
+
+        // 断言
+        assertTrue(voucherWordMapper.selectById(voucherWordId).getDefaultStatus());
+    }
+
+    @Test
+    public void testCreateVoucherWord_nameDuplicate() {
+        // mock 数据
+        voucherWordMapper.insert(buildVoucherWord(1L, "记", true, 1));
+        // 准备参数
+        FmsVoucherWordSaveReqVO reqVO = buildSaveReqVO(null, 1L, "记", "记账凭证", false);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherWordService.createVoucherWord(reqVO, 10L),
+                VOUCHER_WORD_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateVoucherWord_switchDefault() {
+        // mock 数据
+        FmsVoucherWordDO first = buildVoucherWord(1L, "记", true, 1);
+        voucherWordMapper.insert(first);
+        FmsVoucherWordDO second = buildVoucherWord(1L, "收", false, 2);
+        voucherWordMapper.insert(second);
+        // 准备参数
+        FmsVoucherWordSaveReqVO reqVO = buildSaveReqVO(
+                second.getId(), 1L, "收", "收款凭证", true);
+
+        // 调用
+        voucherWordService.updateVoucherWord(reqVO, 10L);
+
+        // 断言
+        assertFalse(voucherWordMapper.selectById(first.getId()).getDefaultStatus());
+        assertTrue(voucherWordMapper.selectById(second.getId()).getDefaultStatus());
+    }
+
+    @Test
+    public void testUpdateVoucherWord_defaultRequired() {
+        // mock 数据
+        FmsVoucherWordDO voucherWord = buildVoucherWord(1L, "记", true, 1);
+        voucherWordMapper.insert(voucherWord);
+        // 准备参数
+        FmsVoucherWordSaveReqVO reqVO = buildSaveReqVO(
+                voucherWord.getId(), 1L, "记", "记账凭证", false);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherWordService.updateVoucherWord(reqVO, 10L),
+                VOUCHER_WORD_DEFAULT_REQUIRED);
+    }
+
+    @Test
+    public void testUpdateVoucherWord_inUse() {
+        // mock 数据
+        FmsVoucherWordDO voucherWord = buildVoucherWord(1L, "记", true, 1);
+        voucherWordMapper.insert(voucherWord);
+        when(voucherService.getVoucherCountByVoucherWordId(1L, voucherWord.getId())).thenReturn(1L);
+        // 准备参数
+        FmsVoucherWordSaveReqVO reqVO = buildSaveReqVO(
+                voucherWord.getId(), 1L, "记", "通用记账凭证", true);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherWordService.updateVoucherWord(reqVO, 10L),
+                VOUCHER_WORD_IN_USE_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testUpdateVoucherWord_inUseSwitchDefault() {
+        // mock 数据
+        FmsVoucherWordDO first = buildVoucherWord(1L, "记", false, 1);
+        voucherWordMapper.insert(first);
+        FmsVoucherWordDO second = buildVoucherWord(1L, "收", true, 2);
+        voucherWordMapper.insert(second);
+        when(voucherService.getVoucherCountByVoucherWordId(1L, first.getId())).thenReturn(1L);
+        // 准备参数
+        FmsVoucherWordSaveReqVO reqVO = buildSaveReqVO(
+                first.getId(), 1L, first.getName(), first.getPrintTitle(), true);
+
+        // 调用
+        voucherWordService.updateVoucherWord(reqVO, 10L);
+
+        // 断言
+        assertTrue(voucherWordMapper.selectById(first.getId()).getDefaultStatus());
+        assertFalse(voucherWordMapper.selectById(second.getId()).getDefaultStatus());
+    }
+
+    @Test
+    public void testDeleteVoucherWord_defaultStatus() {
+        // mock 数据
+        FmsVoucherWordDO voucherWord = buildVoucherWord(1L, "记", true, 1);
+        voucherWordMapper.insert(voucherWord);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherWordService.deleteVoucherWord(1L, voucherWord.getId(), 10L),
+                VOUCHER_WORD_DEFAULT_NOT_DELETABLE);
+    }
+
+    @Test
+    public void testDeleteVoucherWord_inUse() {
+        // mock 数据
+        FmsVoucherWordDO voucherWord = buildVoucherWord(1L, "转", false, 2);
+        voucherWordMapper.insert(voucherWord);
+        when(voucherService.getVoucherCountByVoucherWordId(1L, voucherWord.getId())).thenReturn(1L);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherWordService.deleteVoucherWord(1L, voucherWord.getId(), 10L),
+                VOUCHER_WORD_IN_USE_NOT_DELETABLE, 1L);
+    }
+
+    @Test
+    public void testDeleteVoucherWord_closingInUse() {
+        // mock 数据
+        FmsVoucherWordDO voucherWord = buildVoucherWord(1L, "转", false, 2);
+        voucherWordMapper.insert(voucherWord);
+        // mock 方法
+        when(closingSchemeService.getClosingSchemeCountByVoucherWordId(1L, voucherWord.getId())).thenReturn(1L);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherWordService.deleteVoucherWord(1L, voucherWord.getId(), 10L),
+                VOUCHER_WORD_IN_USE_BY_CLOSING_SCHEME_NOT_DELETABLE, 1L);
+    }
+
+    @Test
+    public void testInitializeDefaultVoucherWords_success() {
+        // 准备参数
+        Long accountSetId = randomLongId();
+
+        // 调用
+        voucherWordService.initializeDefaultVoucherWords(accountSetId);
+
+        // 断言
+        List<FmsVoucherWordDO> voucherWords = voucherWordMapper.selectListByAccountSetId(accountSetId);
+        assertEquals(4, voucherWords.size());
+        assertEquals("记", voucherWords.get(0).getName());
+        assertEquals("记账凭证", voucherWords.get(0).getPrintTitle());
+        assertTrue(voucherWords.get(0).getDefaultStatus());
+        assertEquals("收", voucherWords.get(1).getName());
+        assertEquals("收款凭证", voucherWords.get(1).getPrintTitle());
+        assertFalse(voucherWords.get(1).getDefaultStatus());
+        assertEquals("转", voucherWords.get(2).getName());
+        assertEquals("转账凭证", voucherWords.get(2).getPrintTitle());
+        assertFalse(voucherWords.get(2).getDefaultStatus());
+        assertEquals("付", voucherWords.get(3).getName());
+        assertEquals("付款凭证", voucherWords.get(3).getPrintTitle());
+        assertFalse(voucherWords.get(3).getDefaultStatus());
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsVoucherWordSaveReqVO buildSaveReqVO(Long id, Long accountSetId, String name,
+            String printTitle, boolean defaultStatus) {
+        return randomPojo(FmsVoucherWordSaveReqVO.class, reqVO -> reqVO.setId(id)
+                .setAccountSetId(accountSetId).setName(name).setPrintTitle(printTitle)
+                .setDefaultStatus(defaultStatus));
+    }
+
+    private FmsVoucherWordDO buildVoucherWord(
+            Long accountSetId, String name, boolean defaultStatus, int sort) {
+        return randomPojo(FmsVoucherWordDO.class, voucherWord -> voucherWord.setId(null)
+                .setAccountSetId(accountSetId).setName(name).setPrintTitle(name + "账凭证")
+                .setDefaultStatus(defaultStatus).setSort(sort));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeServiceImplTest.java
new file mode 100644
index 0000000..68bfd3a
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/home/FmsHomeServiceImplTest.java
@@ -0,0 +1,192 @@
+package cn.iocoder.yudao.module.fms.service.home;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeMetricDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.home.vo.FmsHomeRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.report.FmsIncomeStatementService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.ACCOUNT_SET_NOT_INITIALIZED;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.HOME_METRIC_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+@Import(FmsHomeServiceImpl.class)
+public class FmsHomeServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsHomeServiceImpl homeService;
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsClosingPeriodService closingPeriodService;
+    @MockitoBean
+    private FmsIncomeStatementService incomeStatementService;
+
+    @Test
+    public void testGetHome_success() {
+        // mock 数据
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(1L).setInitialized(true)
+                .setStartTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(accountSet);
+        when(closingPeriodService.getCurrentMonth(1L, accountSet.getStartTime()))
+                .thenReturn(YearMonth.of(2026, 8));
+        when(incomeStatementService.getIncomeStatement(any(FmsReportListReqVO.class), eq(10L)))
+                .thenAnswer(invocation -> buildIncomeStatement(
+                        invocation.<FmsReportListReqVO>getArgument(0).getStartMonth()));
+
+        // 调用
+        FmsHomeRespVO result = homeService.getHome(1L, 10L);
+
+        // 断言
+        assertEquals("2026-08", result.getCurrentMonth());
+        assertEquals(12, result.getTrends().size());
+        assertEquals(BigDecimal.ZERO, result.getTrends().get(0).getIncome());
+        FmsHomeRespVO.Trend currentTrend = result.getTrends().get(11);
+        assertEquals(new BigDecimal("100.00"), currentTrend.getIncome());
+        assertEquals(new BigDecimal("45.00"), currentTrend.getOperatingCost());
+        assertEquals(new BigDecimal("30.00"), currentTrend.getProfit());
+        assertEquals(new BigDecimal("12.00"), currentTrend.getExpense());
+        assertEquals(new BigDecimal("-13.00"), currentTrend.getOther());
+        assertEquals(5, result.getMetrics().size());
+        verify(incomeStatementService, times(8)).getIncomeStatement(any(FmsReportListReqVO.class), eq(10L));
+    }
+
+    @Test
+    public void testGetMetricDetail_success() {
+        // mock 数据
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(1L).setInitialized(true)
+                .setStartTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(accountSet);
+        when(closingPeriodService.getCurrentMonth(1L, accountSet.getStartTime()))
+                .thenReturn(YearMonth.of(2026, 8));
+        when(incomeStatementService.getIncomeStatement(any(FmsReportListReqVO.class), eq(10L)))
+                .thenAnswer(invocation -> buildMetricIncomeStatement(
+                        invocation.<FmsReportListReqVO>getArgument(0).getStartMonth()));
+
+        // 调用
+        FmsHomeMetricDetailRespVO result = homeService.getMetricDetail(1L, "income", 10L);
+
+        // 断言
+        assertEquals("income", result.getKey());
+        assertEquals("收入", result.getName());
+        assertEquals(12, result.getTrends().size());
+        assertEquals(new BigDecimal("100.00"), result.getTrends().get(11).getAmount());
+        assertEquals(2, result.getStructure().size());
+        assertEquals("5001", result.getStructure().get(0).getSubjectCode());
+        assertEquals(new BigDecimal("80.00"), result.getStructure().get(0).getAmount());
+        assertEquals("5051", result.getStructure().get(1).getSubjectCode());
+        assertEquals(new BigDecimal("20.00"), result.getStructure().get(1).getAmount());
+        verify(incomeStatementService, times(8)).getIncomeStatement(any(FmsReportListReqVO.class), eq(10L));
+    }
+
+    @Test
+    public void testGetMetricDetail_metricInvalid() {
+        // mock 数据
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setInitialized(true)
+                        .setStartTime(LocalDateTime.of(2026, 1, 1, 0, 0)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> homeService.getMetricDetail(1L, "unknown", 10L),
+                HOME_METRIC_INVALID);
+        verify(accountSetService).validateAccountSetReadPermission(1L, 10L);
+    }
+
+    @Test
+    public void testGetHome_notInitialized() {
+        // mock 数据
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setInitialized(false));
+
+        // 调用，并断言异常
+        assertServiceException(() -> homeService.getHome(1L, 10L), ACCOUNT_SET_NOT_INITIALIZED);
+    }
+
+    @Test
+    public void testGetMetricDetail_lineFormula() {
+        // mock 数据
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(1L).setInitialized(true)
+                .setStartTime(LocalDateTime.of(2026, 8, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L)).thenReturn(accountSet);
+        when(closingPeriodService.getCurrentMonth(1L, accountSet.getStartTime()))
+                .thenReturn(YearMonth.of(2026, 8));
+        when(incomeStatementService.getIncomeStatement(any(FmsReportListReqVO.class), eq(10L)))
+                .thenReturn(Arrays.asList(
+                        new FmsReportItemRespVO().setRowNo(1).setCurrentAmount(new BigDecimal("100.00"))
+                                .setFormula("[{\"subjectId\":1444,\"subjectNumber\":\"5001\","
+                                        + "\"subjectName\":\"主营业务收入\",\"operator\":\"+\","
+                                        + "\"currentAmount\":100.00}]"),
+                        new FmsReportItemRespVO().setRowNo(2).setCurrentAmount(new BigDecimal("40.00"))
+                                .setFormula("[{\"subjectId\":1453,\"subjectNumber\":\"5401\","
+                                        + "\"subjectName\":\"主营业务成本\",\"operator\":\"+\","
+                                        + "\"currentAmount\":40.00}]"),
+                        buildReportItem(3, "0.00"), buildReportItem(11, "0.00"),
+                        buildReportItem(14, "0.00"), buildReportItem(18, "0.00"),
+                        new FmsReportItemRespVO().setRowNo(30).setCurrentAmount(new BigDecimal("60.00"))
+                                .setFormula("[\"L1-L2\"]")));
+
+        // 调用
+        FmsHomeMetricDetailRespVO result = homeService.getMetricDetail(1L, "profit", 10L);
+
+        // 断言
+        assertEquals(new BigDecimal("60.00"), result.getTrends().get(11).getAmount());
+        assertEquals(1, result.getStructure().size());
+        assertEquals("5001", result.getStructure().get(0).getSubjectCode());
+        assertEquals(new BigDecimal("100.00"), result.getStructure().get(0).getAmount());
+    }
+
+    // ========== 随机对象 ==========
+
+    private List<FmsReportItemRespVO> buildIncomeStatement(String month) {
+        if (!"2026-08".equals(month)) {
+            return Collections.emptyList();
+        }
+        return Arrays.asList(buildReportItem(1, "100.00"), buildReportItem(2, "40.00"),
+                buildReportItem(3, "5.00"), buildReportItem(11, "3.00"),
+                buildReportItem(14, "4.00"), buildReportItem(18, "5.00"),
+                buildReportItem(30, "30.00"));
+    }
+
+    private FmsReportItemRespVO buildReportItem(Integer rowNo, String amount) {
+        return new FmsReportItemRespVO().setRowNo(rowNo).setCurrentAmount(new BigDecimal(amount));
+    }
+
+    private List<FmsReportItemRespVO> buildMetricIncomeStatement(String month) {
+        if (!"2026-08".equals(month)) {
+            return Collections.emptyList();
+        }
+        return Arrays.asList(new FmsReportItemRespVO().setRowNo(1).setCurrentAmount(new BigDecimal("100.00"))
+                .setFormula("[{\"subjectId\":1444,\"subjectNumber\":\"5001\","
+                        + "\"subjectName\":\"主营业务收入\",\"operator\":\"+\","
+                        + "\"currentAmount\":80.00},{\"subjectId\":1445,"
+                        + "\"subjectNumber\":\"5051\",\"subjectName\":\"其他业务收入\","
+                        + "\"operator\":\"+\",\"currentAmount\":20.00}]"),
+                buildReportItem(2, "40.00"), buildReportItem(3, "5.00"),
+                buildReportItem(11, "3.00"), buildReportItem(14, "4.00"),
+                buildReportItem(18, "5.00"), buildReportItem(30, "30.00"));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerServiceImplTest.java
new file mode 100644
index 0000000..7572a13
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/ledger/FmsLedgerServiceImplTest.java
@@ -0,0 +1,732 @@
+package cn.iocoder.yudao.module.fms.service.ledger;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerAuxiliaryListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.FmsLedgerListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarybalance.FmsLedgerAuxiliaryBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.auxiliarydetail.FmsLedgerAuxiliaryDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.detail.FmsLedgerDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.multicolumn.FmsLedgerMultiColumnRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitydetail.FmsLedgerQuantityDetailRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.quantitygeneral.FmsLedgerQuantityGeneralRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsInitialBalanceDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsInitialBalanceMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.voucher.FmsVoucherEntryMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.voucher.FmsVoucherMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.config.FmsVoucherWordMapper;
+import cn.iocoder.yudao.module.fms.enums.common.FmsDebitCreditDirectionEnum;
+import cn.iocoder.yudao.module.fms.enums.ledger.FmsLedgerBalanceModeEnum;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryItemService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.LEDGER_PERIOD_BEFORE_ACCOUNT_START;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.Mockito.when;
+
+@Import(FmsLedgerServiceImpl.class)
+public class FmsLedgerServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsLedgerServiceImpl ledgerService;
+    @Resource
+    private FmsInitialBalanceMapper initialBalanceMapper;
+    @Resource
+    private FmsVoucherMapper voucherMapper;
+    @Resource
+    private FmsVoucherEntryMapper voucherEntryMapper;
+    @Resource
+    private FmsVoucherWordMapper voucherWordMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsFinanceParameterService financeParameterService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsAuxiliaryItemService auxiliaryItemService;
+
+    private FmsSubjectDO cashSubject;
+    private FmsSubjectDO bankSubject;
+    private FmsSubjectDO receivableSubject;
+    private FmsAuxiliaryItemDO customerItem;
+
+    @BeforeEach
+    public void before() {
+        cashSubject = buildSubject(101L, "1001", "库存现金", null, 1);
+        bankSubject = buildSubject(102L, "100201", "工商银行", 101L, 2);
+        receivableSubject = buildSubject(103L, "1122", "应收账款", null, 1);
+        customerItem = new FmsAuxiliaryItemDO().setId(301L).setCode("KH001")
+                .setName("北京星河科技有限公司").setAuxiliaryTypeId(201L)
+                .setStatus(1).setAccountSetId(1L);
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(1L)
+                .setStartTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(accountSet);
+        when(financeParameterService.getFinanceParameter(1L, 10L))
+                .thenReturn(new FmsFinanceParameterDO().setLedgerBalanceMode(1));
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Arrays.asList(cashSubject, bankSubject, receivableSubject));
+        when(auxiliaryItemService.getAuxiliaryItemList(1L, 201L, 10L))
+                .thenReturn(Collections.singletonList(customerItem));
+        when(auxiliaryItemService.getAuxiliaryItemListByAccountSetId(1L, 10L))
+                .thenReturn(Collections.singletonList(customerItem));
+    }
+
+    @Test
+    public void testGetDetailLedger() {
+        // mock 数据
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(bankSubject.getId())
+                .setAccountSetId(1L).setOpeningAmount(new BigDecimal("100.00"))
+                .setOpeningQuantity(BigDecimal.ZERO).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearDebitQuantity(BigDecimal.ZERO).setYearCreditAmount(BigDecimal.ZERO)
+                .setYearCreditQuantity(BigDecimal.ZERO).setYearOpeningAmount(new BigDecimal("100.00"))
+                .setYearOpeningQuantity(BigDecimal.ZERO).setProfitLossAmount(BigDecimal.ZERO)
+                .setAuxiliaryAccounting(false));
+        FmsVoucherWordDO word = new FmsVoucherWordDO().setName("记").setPrintTitle("记账凭证")
+                .setDefaultStatus(true).setSort(1).setAccountSetId(1L);
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = new FmsVoucherDO().setVoucherWordId(word.getId()).setVoucherNumber(1)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0)).setAttachmentUrls(Collections.emptyList())
+                .setDebitAmount(new BigDecimal("80.00")).setCreditAmount(new BigDecimal("80.00"))
+                .setTotal(new BigDecimal("80.00")).setStatus(1).setAccountSetId(1L);
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(bankSubject.getId()).setSubjectCode("100201")
+                .setSubjectName("工商银行").setDigest("收到客户回款").setSort(1)
+                .setDebitAmount(new BigDecimal("80.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.emptyList()));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+        reqVO.setSubjectId(bankSubject.getId());
+
+        // 调用
+        List<FmsLedgerDetailRespVO> result = ledgerService.getDetailList(reqVO, 10L);
+
+        // 断言
+        assertEquals(4, result.size());
+        assertEquals(new BigDecimal("100.00"), result.get(0).getBalance());
+        assertEquals("记-1", result.get(1).getVoucherNumber());
+        assertEquals(new BigDecimal("180.00"), result.get(1).getBalance());
+        assertEquals(new BigDecimal("80.00"), result.get(2).getDebitAmount());
+        assertEquals("本年累计", result.get(3).getDigest());
+    }
+
+    @Test
+    public void testGetDetailList_startMonthEqualsAccountSetStartMonth() {
+        // mock 数据
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(bankSubject.getId())
+                .setAccountSetId(1L).setOpeningAmount(new BigDecimal("100.00"))
+                .setOpeningQuantity(BigDecimal.ZERO).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearDebitQuantity(BigDecimal.ZERO).setYearCreditAmount(BigDecimal.ZERO)
+                .setYearCreditQuantity(BigDecimal.ZERO).setYearOpeningAmount(new BigDecimal("100.00"))
+                .setYearOpeningQuantity(BigDecimal.ZERO).setProfitLossAmount(BigDecimal.ZERO)
+                .setAuxiliaryAccounting(false));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+        reqVO.setStartMonth("2026-01");
+        reqVO.setEndMonth("2026-01");
+        reqVO.setSubjectId(bankSubject.getId());
+
+        // 调用
+        List<FmsLedgerDetailRespVO> result = ledgerService.getDetailList(reqVO, 10L);
+
+        // 断言
+        assertEquals(new BigDecimal("100.00"), CollUtil.getFirst(result).getBalance());
+    }
+
+    @Test
+    public void testGetDetailList_startMonthBeforeAccountSetStartMonth() {
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+        reqVO.setStartMonth("2025-12");
+
+        // 调用并断言
+        assertServiceException(() -> ledgerService.getDetailList(reqVO, 10L),
+                LEDGER_PERIOD_BEFORE_ACCOUNT_START);
+    }
+
+    @Test
+    public void testGetQuantityDetailList_filterNonQuantityDescendant() {
+        // mock 数据：父科目启用数量核算，非数量子科目存在金额分录
+        cashSubject.setQuantityAccounting(true);
+        FmsVoucherWordDO word = buildVoucherWord();
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = buildVoucher(word.getId(), "80.00");
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(bankSubject.getId()).setSubjectCode(bankSubject.getCode())
+                .setSubjectName(bankSubject.getName()).setDigest("非数量科目分录").setSort(1)
+                .setDebitAmount(new BigDecimal("80.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.emptyList()));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+        reqVO.setSubjectId(cashSubject.getId());
+
+        // 调用
+        List<FmsLedgerQuantityDetailRespVO> result = ledgerService.getQuantityDetailList(reqVO, 10L);
+
+        // 断言
+        assertEquals(3, result.size());
+        assertEquals(BigDecimal.ZERO, result.get(1).getDebitAmount());
+        assertEquals(BigDecimal.ZERO, result.get(1).getBalance());
+    }
+
+    @Test
+    public void testGetQuantityDetailList_negativeDebitKeepsDebitQuantity() {
+        // mock 数据：红字借方金额仍属于借方数量，不转换到贷方
+        bankSubject.setQuantityAccounting(true);
+        FmsVoucherWordDO word = buildVoucherWord();
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = buildVoucher(word.getId(), "-20.00");
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(bankSubject.getId()).setSubjectCode(bankSubject.getCode())
+                .setSubjectName(bankSubject.getName()).setDigest("红字冲销").setSort(1)
+                .setDebitAmount(new BigDecimal("-20.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(new BigDecimal("2.00")).setUnitPrice(new BigDecimal("10.00"))
+                .setAuxiliaries(Collections.emptyList()));
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+        reqVO.setSubjectId(bankSubject.getId());
+
+        // 调用
+        List<FmsLedgerQuantityDetailRespVO> result = ledgerService.getQuantityDetailList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerQuantityDetailRespVO voucherRow = CollUtil.findOne(result,
+                row -> ObjUtil.equal(row.getRowType(), FmsLedgerQuantityDetailRespVO.ROW_TYPE_VOUCHER));
+        assertEquals(new BigDecimal("2.0000"), voucherRow.getDebitQuantity());
+        assertEquals(BigDecimal.ZERO, voucherRow.getCreditQuantity());
+    }
+
+    @Test
+    public void testGetSubjectBalanceList_endSubjectIncludesChild() {
+        // mock 数据
+        FmsVoucherWordDO word = new FmsVoucherWordDO().setName("记").setPrintTitle("记账凭证")
+                .setDefaultStatus(true).setSort(1).setAccountSetId(1L);
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = new FmsVoucherDO().setVoucherWordId(word.getId()).setVoucherNumber(1)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0)).setAttachmentUrls(Collections.emptyList())
+                .setDebitAmount(new BigDecimal("80.00")).setCreditAmount(new BigDecimal("80.00"))
+                .setTotal(new BigDecimal("80.00")).setStatus(1).setAccountSetId(1L);
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(bankSubject.getId()).setSubjectCode("100201")
+                .setSubjectName("工商银行").setDigest("收到客户回款").setSort(1)
+                .setDebitAmount(new BigDecimal("80.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.emptyList()));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+        reqVO.setMinLevel(1);
+        reqVO.setMaxLevel(2);
+        reqVO.setEndSubjectId(cashSubject.getId());
+
+        // 调用
+        List<FmsLedgerSubjectBalanceRespVO> result = ledgerService.getSubjectBalanceList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerSubjectBalanceRespVO parent = CollUtil.getFirst(result);
+        assertEquals(new BigDecimal("80.00"), parent.getPeriodDebitAmount());
+        assertEquals(1, parent.getChildren().size());
+        assertEquals(new BigDecimal("80.00"), CollUtil.getFirst(parent.getChildren()).getEndingDebitAmount());
+    }
+
+    @Test
+    public void testGetSubjectBalanceList_filterZeroRows() {
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+
+        // 调用
+        List<FmsLedgerSubjectBalanceRespVO> result = ledgerService.getSubjectBalanceList(reqVO, 10L);
+
+        // 断言
+        assertEquals(0, result.size());
+    }
+
+    @Test
+    public void testGetSubjectBalanceList_appendAuxiliaryCombination() {
+        // mock 数据
+        receivableSubject.setAuxiliaryTypeIds(Collections.singletonList(201L));
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(receivableSubject.getId())
+                .setAccountSetId(1L).setAuxiliaryAccounting(true)
+                .setOpeningAmount(new BigDecimal("40.00")).setOpeningQuantity(BigDecimal.ZERO)
+                .setYearDebitAmount(BigDecimal.ZERO).setYearDebitQuantity(BigDecimal.ZERO)
+                .setYearCreditAmount(BigDecimal.ZERO).setYearCreditQuantity(BigDecimal.ZERO)
+                .setYearOpeningAmount(new BigDecimal("40.00")).setYearOpeningQuantity(BigDecimal.ZERO)
+                .setProfitLossAmount(BigDecimal.ZERO).setAssistBalances(Collections.singletonList(
+                        FmsInitialBalanceDO.AssistBalance.builder().assistCombinationId(501L)
+                                .auxiliaries(Collections.singletonList(FmsInitialBalanceDO.AuxiliaryItem.builder()
+                                        .type(1).typeId(201L).itemId(customerItem.getId())
+                                        .name(customerItem.getName()).build()))
+                                .openingAmount(new BigDecimal("40.00")).openingQuantity(BigDecimal.ZERO)
+                                .yearDebitAmount(BigDecimal.ZERO).yearDebitQuantity(BigDecimal.ZERO)
+                                .yearCreditAmount(BigDecimal.ZERO).yearCreditQuantity(BigDecimal.ZERO).build())));
+        FmsVoucherWordDO word = buildVoucherWord();
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = buildVoucher(word.getId(), "100.00");
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(receivableSubject.getId()).setSubjectCode("1122")
+                .setSubjectName("应收账款").setDigest("确认客户应收款").setSort(1)
+                .setDebitAmount(new BigDecimal("100.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO).setAssistCombinationId(501L)
+                .setAuxiliaries(Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .type(1).typeId(201L).itemId(customerItem.getId())
+                        .name(customerItem.getName()).build())));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+
+        // 调用
+        List<FmsLedgerSubjectBalanceRespVO> result = ledgerService.getSubjectBalanceList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerSubjectBalanceRespVO subjectBalance = CollUtil.getFirst(result);
+        assertEquals("S:" + receivableSubject.getId(), subjectBalance.getNodeKey());
+        assertEquals(FmsLedgerSubjectBalanceRespVO.NODE_TYPE_SUBJECT, subjectBalance.getNodeType());
+        assertEquals(1, subjectBalance.getChildren().size());
+        FmsLedgerSubjectBalanceRespVO auxiliaryBalance = CollUtil.getFirst(subjectBalance.getChildren());
+        assertEquals("A:501", auxiliaryBalance.getNodeKey());
+        assertEquals(FmsLedgerSubjectBalanceRespVO.NODE_TYPE_AUXILIARY_COMBINATION,
+                auxiliaryBalance.getNodeType());
+        assertEquals(501L, auxiliaryBalance.getAssistCombinationId());
+        assertEquals("1122_KH001", auxiliaryBalance.getSubjectCode());
+        assertEquals("应收账款_北京星河科技有限公司", auxiliaryBalance.getSubjectName());
+        assertEquals(new BigDecimal("40.00"), auxiliaryBalance.getOpeningDebitAmount());
+        assertEquals(new BigDecimal("100.00"), auxiliaryBalance.getPeriodDebitAmount());
+        assertEquals(new BigDecimal("140.00"), auxiliaryBalance.getEndingDebitAmount());
+    }
+
+    @Test
+    public void testGetQuantityGeneralList_filterZeroRowsAndKeepQuantity() {
+        // mock 数据
+        bankSubject.setQuantityAccounting(true);
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(bankSubject.getId())
+                .setAccountSetId(1L).setOpeningAmount(BigDecimal.ZERO)
+                .setOpeningQuantity(new BigDecimal("5.00")).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearDebitQuantity(BigDecimal.ZERO).setYearCreditAmount(BigDecimal.ZERO)
+                .setYearCreditQuantity(BigDecimal.ZERO).setYearOpeningAmount(BigDecimal.ZERO)
+                .setYearOpeningQuantity(new BigDecimal("5.00")).setProfitLossAmount(BigDecimal.ZERO)
+                .setAuxiliaryAccounting(false));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+
+        // 调用
+        List<FmsLedgerQuantityGeneralRespVO> result = ledgerService.getQuantityGeneralList(reqVO, 10L);
+
+        // 断言
+        assertEquals(1, result.size());
+        FmsLedgerQuantityGeneralRespVO parent = CollUtil.getFirst(result);
+        assertEquals(1, parent.getChildren().size());
+        assertEquals(new BigDecimal("5.0000"), CollUtil.getFirst(parent.getChildren()).getEndingQuantity());
+    }
+
+    @Test
+    public void testGetQuantityGeneralList_filterYearOnlyRows() {
+        // mock 数据：本年早期有累计、查询期初和本期均为零
+        bankSubject.setQuantityAccounting(true);
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(bankSubject.getId())
+                .setAccountSetId(1L).setOpeningAmount(BigDecimal.ZERO).setOpeningQuantity(BigDecimal.ZERO)
+                .setYearDebitAmount(new BigDecimal("10.00")).setYearDebitQuantity(new BigDecimal("5.00"))
+                .setYearCreditAmount(new BigDecimal("10.00")).setYearCreditQuantity(new BigDecimal("5.00"))
+                .setYearOpeningAmount(BigDecimal.ZERO).setYearOpeningQuantity(BigDecimal.ZERO)
+                .setProfitLossAmount(BigDecimal.ZERO).setAuxiliaryAccounting(false));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+
+        // 调用
+        List<FmsLedgerQuantityGeneralRespVO> result = ledgerService.getQuantityGeneralList(reqVO, 10L);
+
+        // 断言
+        assertEquals(0, result.size());
+    }
+
+    @Test
+    public void testGetQuantityGeneralList_sameAsSubject() {
+        // mock 数据：借方科目出现贷方净额时，按科目方向保留负数
+        bankSubject.setQuantityAccounting(true);
+        insertQuantityInitialBalance(new BigDecimal("-100.00"), new BigDecimal("-5.00"));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+
+        // 调用
+        List<FmsLedgerQuantityGeneralRespVO> result = ledgerService.getQuantityGeneralList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerQuantityGeneralRespVO balance = CollUtil.getFirst(CollUtil.getFirst(result).getChildren());
+        assertEquals(FmsDebitCreditDirectionEnum.DEBIT.getName(), balance.getOpeningBalanceDirection());
+        assertEquals(new BigDecimal("-100.00"), balance.getOpeningDebitAmount());
+        assertEquals(new BigDecimal("-5.0000"), balance.getOpeningQuantity());
+        assertEquals(FmsDebitCreditDirectionEnum.DEBIT.getName(), balance.getEndingBalanceDirection());
+        assertEquals(new BigDecimal("-100.00"), balance.getEndingDebitAmount());
+        assertEquals(new BigDecimal("-5.0000"), balance.getEndingQuantity());
+    }
+
+    @Test
+    public void testGetQuantityGeneralList_oppositeToSubject() {
+        // mock 数据：按实际净额方向展示时，余额和数量使用绝对值
+        bankSubject.setQuantityAccounting(true);
+        insertQuantityInitialBalance(new BigDecimal("-100.00"), new BigDecimal("-5.00"));
+        when(financeParameterService.getFinanceParameter(1L, 10L)).thenReturn(
+                new FmsFinanceParameterDO().setLedgerBalanceMode(
+                        FmsLedgerBalanceModeEnum.OPPOSITE_TO_SUBJECT.getMode()));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+
+        // 调用
+        List<FmsLedgerQuantityGeneralRespVO> result = ledgerService.getQuantityGeneralList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerQuantityGeneralRespVO balance = CollUtil.getFirst(CollUtil.getFirst(result).getChildren());
+        assertEquals(FmsDebitCreditDirectionEnum.CREDIT.getName(), balance.getOpeningBalanceDirection());
+        assertEquals(new BigDecimal("100.00"), balance.getOpeningCreditAmount());
+        assertEquals(new BigDecimal("5.0000"), balance.getOpeningQuantity());
+        assertEquals(FmsDebitCreditDirectionEnum.CREDIT.getName(), balance.getEndingBalanceDirection());
+        assertEquals(new BigDecimal("100.00"), balance.getEndingCreditAmount());
+        assertEquals(new BigDecimal("5.0000"), balance.getEndingQuantity());
+    }
+
+    @Test
+    public void testGetMultiColumnLedger() {
+        // mock 数据
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(bankSubject.getId())
+                .setAccountSetId(1L).setOpeningAmount(new BigDecimal("100.00"))
+                .setOpeningQuantity(BigDecimal.ZERO).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearDebitQuantity(BigDecimal.ZERO).setYearCreditAmount(BigDecimal.ZERO)
+                .setYearCreditQuantity(BigDecimal.ZERO).setYearOpeningAmount(new BigDecimal("100.00"))
+                .setYearOpeningQuantity(BigDecimal.ZERO).setProfitLossAmount(BigDecimal.ZERO)
+                .setAuxiliaryAccounting(false));
+        FmsVoucherWordDO word = new FmsVoucherWordDO().setName("记").setPrintTitle("记账凭证")
+                .setDefaultStatus(true).setSort(1).setAccountSetId(1L);
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = new FmsVoucherDO().setVoucherWordId(word.getId()).setVoucherNumber(1)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0)).setAttachmentUrls(Collections.emptyList())
+                .setDebitAmount(new BigDecimal("80.00")).setCreditAmount(new BigDecimal("80.00"))
+                .setTotal(new BigDecimal("80.00")).setStatus(1).setAccountSetId(1L);
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(bankSubject.getId()).setSubjectCode("100201")
+                .setSubjectName("工商银行").setDigest("收到客户回款").setSort(1)
+                .setDebitAmount(new BigDecimal("80.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.emptyList()));
+
+        // 准备参数
+        FmsLedgerListReqVO reqVO = buildListReqVO();
+        reqVO.setSubjectId(cashSubject.getId());
+
+        // 调用
+        FmsLedgerMultiColumnRespVO result = ledgerService.getMultiColumn(reqVO, 10L);
+
+        // 断言
+        assertEquals(1, result.getColumns().size());
+        assertEquals(bankSubject.getId(), CollUtil.getFirst(result.getColumns()).getSubjectId());
+        FmsLedgerDetailRespVO voucherRow = CollUtil.findOne(result.getRows(),
+                row -> row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_VOUCHER));
+        assertEquals(new BigDecimal("80.00"), voucherRow.getColumnAmounts().get(bankSubject.getId()));
+        FmsLedgerDetailRespVO periodTotalRow = CollUtil.findOne(result.getRows(),
+                row -> row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_PERIOD_TOTAL));
+        assertEquals(new BigDecimal("80.00"), periodTotalRow.getColumnAmounts().get(bankSubject.getId()));
+        FmsLedgerDetailRespVO endingRow = CollUtil.findOne(result.getRows(),
+                row -> row.getRowType().equals(FmsLedgerDetailRespVO.ROW_TYPE_ENDING));
+        assertEquals("期末余额", endingRow.getDigest());
+        assertEquals(new BigDecimal("180.00"), endingRow.getBalance());
+        assertEquals(new BigDecimal("180.00"), endingRow.getColumnAmounts().get(bankSubject.getId()));
+    }
+
+    @Test
+    public void testGetAuxiliaryDetailList() {
+        // mock 数据
+        insertAuxiliaryVoucherEntry();
+        // 准备参数
+        FmsLedgerAuxiliaryListReqVO reqVO = buildAuxiliaryListReqVO();
+        reqVO.setAuxiliaryItemId(customerItem.getId());
+
+        // 调用
+        List<FmsLedgerAuxiliaryDetailRespVO> result = ledgerService.getAuxiliaryDetailList(reqVO, 10L);
+
+        // 断言
+        assertEquals(4, result.size());
+        FmsLedgerAuxiliaryDetailRespVO voucherRow = CollUtil.findOne(result,
+                row -> row.getRowType().equals(FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_VOUCHER));
+        assertEquals("记-1", voucherRow.getVoucherNumber());
+        assertEquals(new BigDecimal("800.00"), voucherRow.getBalance());
+    }
+
+    @Test
+    public void testGetAuxiliaryDetailList_sameAsSubject() {
+        // mock 数据
+        receivableSubject.setBalanceDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+        insertAuxiliaryVoucherEntry();
+        // 准备参数
+        FmsLedgerAuxiliaryListReqVO reqVO = buildAuxiliaryListReqVO();
+        reqVO.setAuxiliaryItemId(customerItem.getId());
+        reqVO.setSubjectId(receivableSubject.getId());
+
+        // 调用
+        List<FmsLedgerAuxiliaryDetailRespVO> result = ledgerService.getAuxiliaryDetailList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerAuxiliaryDetailRespVO voucherRow = CollUtil.findOne(result,
+                row -> row.getRowType().equals(FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_VOUCHER));
+        assertEquals(FmsDebitCreditDirectionEnum.CREDIT.getName(), voucherRow.getBalanceDirection());
+        assertEquals(new BigDecimal("-800.00"), voucherRow.getBalance());
+    }
+
+    @Test
+    public void testGetAuxiliaryDetailList_oppositeToSubject() {
+        // mock 数据
+        receivableSubject.setBalanceDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+        insertAuxiliaryVoucherEntry();
+        // 准备参数
+        FmsLedgerAuxiliaryListReqVO reqVO = buildAuxiliaryListReqVO();
+        reqVO.setAuxiliaryItemId(customerItem.getId());
+        reqVO.setSubjectId(receivableSubject.getId());
+
+        // mock 财务参数为按实际净额方向展示
+        when(financeParameterService.getFinanceParameter(1L, 10L)).thenReturn(
+                new FmsFinanceParameterDO().setLedgerBalanceMode(
+                        FmsLedgerBalanceModeEnum.OPPOSITE_TO_SUBJECT.getMode()));
+
+        // 调用
+        List<FmsLedgerAuxiliaryDetailRespVO> result = ledgerService.getAuxiliaryDetailList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerAuxiliaryDetailRespVO voucherRow = CollUtil.findOne(result,
+                row -> row.getRowType().equals(FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_VOUCHER));
+        assertEquals(FmsDebitCreditDirectionEnum.DEBIT.getName(), voucherRow.getBalanceDirection());
+        assertEquals(new BigDecimal("800.00"), voucherRow.getBalance());
+    }
+
+    @Test
+    public void testGetAuxiliaryDetailList_withoutSubject() {
+        // mock 数据
+        receivableSubject.setBalanceDirection(FmsDebitCreditDirectionEnum.CREDIT.getType());
+        insertAuxiliaryVoucherEntry();
+        // 准备参数：不指定科目时聚合多个科目，不任取其中一个科目方向
+        FmsLedgerAuxiliaryListReqVO reqVO = buildAuxiliaryListReqVO();
+        reqVO.setAuxiliaryItemId(customerItem.getId());
+
+        // 调用
+        List<FmsLedgerAuxiliaryDetailRespVO> result = ledgerService.getAuxiliaryDetailList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerAuxiliaryDetailRespVO voucherRow = CollUtil.findOne(result,
+                row -> row.getRowType().equals(FmsLedgerAuxiliaryDetailRespVO.ROW_TYPE_VOUCHER));
+        assertEquals(FmsDebitCreditDirectionEnum.DEBIT.getName(), voucherRow.getBalanceDirection());
+        assertEquals(new BigDecimal("800.00"), voucherRow.getBalance());
+    }
+
+    @Test
+    public void testGetAuxiliaryBalanceList() {
+        // mock 数据
+        insertAuxiliaryVoucherEntry();
+        // 准备参数
+        FmsLedgerAuxiliaryListReqVO reqVO = buildAuxiliaryListReqVO();
+
+        // 调用
+        List<FmsLedgerAuxiliaryBalanceRespVO> result = ledgerService.getAuxiliaryBalanceList(reqVO, 10L);
+
+        // 断言
+        FmsLedgerAuxiliaryBalanceRespVO balance = CollUtil.getFirst(result);
+        assertEquals(customerItem.getName(), balance.getName());
+        assertEquals(new BigDecimal("800.00"), balance.getPeriodDebitAmount());
+        assertEquals(new BigDecimal("800.00"), balance.getEndingDebitAmount());
+    }
+
+    @Test
+    public void testGetAuxiliaryBalanceList_filterZeroRows() {
+        // mock 数据
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(receivableSubject.getId())
+                .setAccountSetId(1L).setAuxiliaryAccounting(true)
+                .setOpeningAmount(BigDecimal.ZERO).setOpeningQuantity(BigDecimal.ZERO)
+                .setYearDebitAmount(BigDecimal.ZERO).setYearDebitQuantity(BigDecimal.ZERO)
+                .setYearCreditAmount(BigDecimal.ZERO).setYearCreditQuantity(BigDecimal.ZERO)
+                .setYearOpeningAmount(BigDecimal.ZERO).setYearOpeningQuantity(BigDecimal.ZERO)
+                .setProfitLossAmount(BigDecimal.ZERO).setAssistBalances(Collections.singletonList(
+                        FmsInitialBalanceDO.AssistBalance.builder()
+                                .assistCombinationId(501L)
+                                .auxiliaries(Collections.singletonList(
+                                        FmsInitialBalanceDO.AuxiliaryItem.builder()
+                                                .type(1).typeId(201L).itemId(customerItem.getId())
+                                                .name(customerItem.getName()).build()))
+                                .openingAmount(BigDecimal.ZERO).openingQuantity(BigDecimal.ZERO)
+                                .yearDebitAmount(BigDecimal.ZERO).yearDebitQuantity(BigDecimal.ZERO)
+                                .yearCreditAmount(BigDecimal.ZERO).yearCreditQuantity(BigDecimal.ZERO)
+                                .yearOpeningAmount(BigDecimal.ZERO).yearOpeningQuantity(BigDecimal.ZERO)
+                                .profitLossAmount(BigDecimal.ZERO).profitLossQuantity(BigDecimal.ZERO).build())));
+
+        // 准备参数
+        FmsLedgerAuxiliaryListReqVO reqVO = buildAuxiliaryListReqVO();
+
+        // 调用
+        List<FmsLedgerAuxiliaryBalanceRespVO> result = ledgerService.getAuxiliaryBalanceList(reqVO, 10L);
+
+        // 断言
+        assertEquals(0, result.size());
+    }
+
+    @Test
+    public void testGetAuxiliaryBalanceList_startMonthBeforeAccountSetStartMonth() {
+        // 准备参数
+        FmsLedgerAuxiliaryListReqVO reqVO = buildAuxiliaryListReqVO();
+        reqVO.setStartMonth("2025-12");
+
+        // 调用并断言
+        assertServiceException(() -> ledgerService.getAuxiliaryBalanceList(reqVO, 10L),
+                LEDGER_PERIOD_BEFORE_ACCOUNT_START);
+    }
+
+    @Test
+    public void testGetAuxiliaryCombinationBalance() {
+        // mock 数据
+        receivableSubject.setAuxiliaryTypeIds(Collections.singletonList(201L));
+        when(auxiliaryItemService.validateAuxiliaryItemList(
+                1L, Collections.singletonList(customerItem.getId())))
+                .thenReturn(Collections.singletonList(customerItem));
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(receivableSubject.getId())
+                .setAccountSetId(1L).setAuxiliaryAccounting(true)
+                .setOpeningAmount(new BigDecimal("40.00")).setOpeningQuantity(BigDecimal.ZERO)
+                .setYearDebitAmount(BigDecimal.ZERO).setYearDebitQuantity(BigDecimal.ZERO)
+                .setYearCreditAmount(BigDecimal.ZERO).setYearCreditQuantity(BigDecimal.ZERO)
+                .setYearOpeningAmount(new BigDecimal("40.00")).setYearOpeningQuantity(BigDecimal.ZERO)
+                .setProfitLossAmount(BigDecimal.ZERO).setAssistBalances(Collections.singletonList(
+                        FmsInitialBalanceDO.AssistBalance.builder()
+                                .assistCombinationId(501L)
+                                .auxiliaries(Collections.singletonList(
+                                        FmsInitialBalanceDO.AuxiliaryItem.builder()
+                                                .type(1).typeId(201L).itemId(customerItem.getId())
+                                                .name(customerItem.getName()).build()))
+                                .openingAmount(new BigDecimal("40.00")).build())));
+        FmsVoucherWordDO word = buildVoucherWord();
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = buildVoucher(word.getId(), "100.00");
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(receivableSubject.getId()).setSubjectCode("1122")
+                .setSubjectName("应收账款").setDigest("客户一应收款").setSort(1)
+                .setDebitAmount(new BigDecimal("100.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .type(1).typeId(201L).itemId(customerItem.getId())
+                        .name(customerItem.getName()).build())));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(receivableSubject.getId()).setSubjectCode("1122")
+                .setSubjectName("应收账款").setDigest("客户二冲减").setSort(2)
+                .setDebitAmount(BigDecimal.ZERO).setCreditAmount(new BigDecimal("100.00"))
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .type(1).typeId(201L).itemId(302L).name("上海客户").build())));
+
+        // 调用
+        BigDecimal balance = ledgerService.getAuxiliaryCombinationBalance(
+                1L, "2026-08", receivableSubject.getId(),
+                Collections.singletonList(customerItem.getId()), 10L);
+
+        // 断言
+        assertEquals(new BigDecimal("140.00"), balance);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsLedgerListReqVO buildListReqVO() {
+        FmsLedgerListReqVO reqVO = new FmsLedgerListReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setStartMonth("2026-08");
+        reqVO.setEndMonth("2026-08");
+        return reqVO;
+    }
+
+    private FmsLedgerAuxiliaryListReqVO buildAuxiliaryListReqVO() {
+        FmsLedgerAuxiliaryListReqVO reqVO = new FmsLedgerAuxiliaryListReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setStartMonth("2026-08");
+        reqVO.setEndMonth("2026-08");
+        reqVO.setAuxiliaryTypeId(201L);
+        return reqVO;
+    }
+
+    private FmsVoucherWordDO buildVoucherWord() {
+        return randomPojo(FmsVoucherWordDO.class, voucherWord -> voucherWord.setId(null)
+                .setName("记").setPrintTitle("记账凭证").setDefaultStatus(true)
+                .setSort(1).setAccountSetId(1L));
+    }
+
+    private FmsVoucherDO buildVoucher(Long voucherWordId, String amount) {
+        return randomPojo(FmsVoucherDO.class, voucher -> voucher.setId(null)
+                .setVoucherWordId(voucherWordId).setVoucherNumber(1)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0)).setAttachmentUrls(Collections.emptyList())
+                .setDebitAmount(new BigDecimal(amount)).setCreditAmount(new BigDecimal(amount))
+                .setTotal(new BigDecimal(amount)).setStatus(1).setAccountSetId(1L));
+    }
+
+    private void insertQuantityInitialBalance(BigDecimal openingAmount, BigDecimal openingQuantity) {
+        initialBalanceMapper.insert(new FmsInitialBalanceDO().setSubjectId(bankSubject.getId())
+                .setAccountSetId(1L).setOpeningAmount(openingAmount).setOpeningQuantity(openingQuantity)
+                .setYearDebitAmount(BigDecimal.ZERO).setYearDebitQuantity(BigDecimal.ZERO)
+                .setYearCreditAmount(BigDecimal.ZERO).setYearCreditQuantity(BigDecimal.ZERO)
+                .setYearOpeningAmount(openingAmount).setYearOpeningQuantity(openingQuantity)
+                .setProfitLossAmount(BigDecimal.ZERO).setAuxiliaryAccounting(false));
+    }
+
+    private void insertAuxiliaryVoucherEntry() {
+        FmsVoucherWordDO word = buildVoucherWord();
+        voucherWordMapper.insert(word);
+        FmsVoucherDO voucher = buildVoucher(word.getId(), "800.00");
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(voucher.getId())
+                .setAccountSetId(1L).setSubjectId(receivableSubject.getId()).setSubjectCode("1122")
+                .setSubjectName("应收账款").setDigest("确认客户应收款").setSort(1)
+                .setDebitAmount(new BigDecimal("800.00")).setCreditAmount(BigDecimal.ZERO)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAuxiliaries(Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .type(1).typeId(201L).itemId(customerItem.getId())
+                        .name(customerItem.getName()).build())));
+    }
+
+    private FmsSubjectDO buildSubject(Long id, String code, String name, Long parentId, Integer level) {
+        return randomPojo(FmsSubjectDO.class, subject -> subject.setId(id)
+                .setCode(code).setName(name).setParentId(parentId)
+                .setType(1).setCategory(1).setBalanceDirection(1).setQuantityAccounting(false)
+                .setCash(false).setStatus(1).setLevel(level).setAccountSetId(1L)
+                .setAuxiliaryTypeIds(Collections.emptyList()).setCurrencyIds(Collections.emptyList()));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetServiceImplTest.java
new file mode 100644
index 0000000..6cad241
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsBalanceSheetServiceImplTest.java
@@ -0,0 +1,264 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.config.vo.initialbalance.FmsTrialBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetRowRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsFinanceParameterDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.FmsReportTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.balance.FmsBalanceSheetConfigDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.balance.FmsBalanceSheetReportDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.FmsReportTemplateMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.balance.FmsBalanceSheetConfigMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.balance.FmsBalanceSheetReportMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsReportTypeEnum;
+import cn.iocoder.yudao.module.fms.controller.admin.closing.vo.FmsClosingOverviewRespVO;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsFinanceParameterService;
+import cn.iocoder.yudao.module.fms.service.config.FmsInitialBalanceService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.when;
+
+@Import({FmsBalanceSheetServiceImpl.class, FmsReportCommonServiceImpl.class})
+public class FmsBalanceSheetServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsBalanceSheetServiceImpl balanceSheetService;
+    @Resource
+    private FmsReportTemplateMapper reportTemplateMapper;
+    @Resource
+    private FmsBalanceSheetConfigMapper balanceSheetConfigMapper;
+    @Resource
+    private FmsBalanceSheetReportMapper balanceSheetReportMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsLedgerService ledgerService;
+    @MockitoBean
+    private FmsInitialBalanceService initialBalanceService;
+    @MockitoBean
+    private FmsFinanceParameterService financeParameterService;
+    @MockitoBean
+    private FmsClosingPeriodService closingPeriodService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+    @MockitoBean
+    private FmsClosingVoucherService closingVoucherService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+
+    private FmsSubjectDO cashSubject;
+
+    @BeforeEach
+    public void before() {
+        cashSubject = new FmsSubjectDO().setId(103L).setCode("1001").setName("库存现金")
+                .setBalanceDirection(1).setLevel(1).setAccountSetId(1L);
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(1L)
+                .setStartTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L)).thenReturn(accountSet);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(accountSet);
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Collections.singletonList(cashSubject));
+        when(financeParameterService.getFinanceParameter(1L)).thenReturn(new FmsFinanceParameterDO()
+                .setSubjectCodeRule(FmsFinanceParameterDO.DEFAULT_SUBJECT_CODE_RULE));
+        when(financeParameterService.convertStandardSubjectCode(any(), any()))
+                .thenAnswer(invocation -> invocation.getArgument(0));
+    }
+
+    @Test
+    public void testGetBalanceSheet_pairRowsAndLineFormula() {
+        // mock 数据
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("流动资产：").setRowNo(0)
+                .setFormula("[]").setEditable(false).setSort(0).setRowId(0)
+                .setType(FmsReportTypeEnum.BALANCE_SHEET.getType()).setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("流动负债：").setRowNo(0)
+                .setFormula("[]").setEditable(false).setSort(32).setRowId(0)
+                .setType(FmsReportTypeEnum.BALANCE_SHEET.getType()).setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("货币资金").setRowNo(1)
+                .setFormula("[{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"1001\"}]")
+                .setEditable(true).setSort(1).setRowId(1)
+                .setType(FmsReportTypeEnum.BALANCE_SHEET.getType()).setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("资产总计").setRowNo(30)
+                .setFormula("[\"L1\"]").setEditable(false).setSort(2).setRowId(2)
+                .setType(FmsReportTypeEnum.BALANCE_SHEET.getType()).setLevel(1));
+        FmsLedgerSubjectBalanceRespVO balance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(103L)
+                .setSubjectCode("1001").setOpeningDebitAmount(BigDecimal.ZERO)
+                .setOpeningCreditAmount(new BigDecimal("100.00"))
+                .setEndingDebitAmount(new BigDecimal("900.00")).setEndingCreditAmount(BigDecimal.ZERO)
+                .setChildren(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(balance));
+
+        // 准备参数
+        FmsReportListReqVO reqVO = buildQueryReqVO();
+
+        // 调用
+        List<FmsBalanceSheetRowRespVO> result = balanceSheetService.getBalanceSheet(reqVO, 10L);
+
+        // 断言
+        assertEquals(3, result.size());
+        assertNotNull(CollUtil.getFirst(result).getAssetName());
+        assertNotNull(CollUtil.getFirst(result).getLiabilityName());
+        assertEquals(new BigDecimal("900.00"), result.get(1).getAssetClosingAmount());
+        assertEquals(new BigDecimal("900.00"), result.get(2).getAssetClosingAmount());
+    }
+
+    @Test
+    public void testUpdateBalanceSheetFormula() {
+        // mock 数据
+        FmsBalanceSheetConfigDO config = new FmsBalanceSheetConfigDO().setName("货币资金").setRowNo(1)
+                .setFormula("[]").setEditable(true).setSort(1).setAccountSetId(1L).setLevel(2).setRowId(1);
+        balanceSheetConfigMapper.insert(config);
+        FmsBalanceSheetReportDO report = new FmsBalanceSheetReportDO().setName("货币资金").setRowNo(1)
+                .setFormula("[]").setEditable(true).setSort(1).setAccountSetId(1L).setLevel(2).setRowId(1)
+                .setFromPeriod(202608).setToPeriod(202608).setType(1)
+                .setOpeningAmount(BigDecimal.ZERO).setClosingAmount(BigDecimal.ZERO).setSettled(false);
+        balanceSheetReportMapper.insert(report);
+
+        // 准备参数
+        FmsReportFormulaUpdateReqVO.Formula formulaReqVO = new FmsReportFormulaUpdateReqVO.Formula();
+        formulaReqVO.setSubjectId(cashSubject.getId());
+        formulaReqVO.setOperator("-");
+        formulaReqVO.setRules(1);
+        FmsReportFormulaUpdateReqVO reqVO = new FmsReportFormulaUpdateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setId(report.getId());
+        reqVO.setFormulas(Collections.singletonList(formulaReqVO));
+
+        // 调用
+        balanceSheetService.updateBalanceSheetFormula(reqVO, 10L);
+
+        // 断言
+        FmsBalanceSheetConfigDO updateConfig = balanceSheetConfigMapper.selectById(config.getId());
+        List<FmsReportFormulaRespVO> formulas = JsonUtils.parseArray(updateConfig.getFormula(), FmsReportFormulaRespVO.class);
+        assertEquals(1, formulas.size());
+        assertEquals(cashSubject.getId(), CollUtil.getFirst(formulas).getSubjectId());
+        assertEquals(cashSubject.getCode(), CollUtil.getFirst(formulas).getSubjectNumber());
+        assertEquals(cashSubject.getName(), CollUtil.getFirst(formulas).getSubjectName());
+        assertEquals("-", CollUtil.getFirst(formulas).getOperator());
+        assertEquals(1, CollUtil.getFirst(formulas).getRules());
+        assertEquals(updateConfig.getFormula(), balanceSheetReportMapper.selectById(report.getId()).getFormula());
+    }
+
+    @Test
+    public void testCheckBalanceSheet() {
+        // mock 数据
+        FmsSubjectDO liabilitySubject = new FmsSubjectDO().setId(104L).setCode("2001").setName("短期借款")
+                .setBalanceDirection(2).setLevel(1).setAccountSetId(1L)
+                .setType(FmsSubjectTypeEnum.LIABILITY.getType());
+        cashSubject.setType(FmsSubjectTypeEnum.ASSET.getType());
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Arrays.asList(cashSubject, liabilitySubject));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("货币资金").setRowNo(1)
+                .setFormula("[{\"operator\":\"+\",\"rules\":0,\"subjectNumber\":\"1001\"}]")
+                .setEditable(true).setSort(1).setRowId(1)
+                .setType(FmsReportTypeEnum.BALANCE_SHEET.getType()).setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("资产总计").setRowNo(30)
+                .setFormula("[\"L1\"]").setEditable(false).setSort(2).setRowId(2)
+                .setType(FmsReportTypeEnum.BALANCE_SHEET.getType()).setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("负债和所有者权益总计").setRowNo(53)
+                .setFormula("[]").setEditable(false).setSort(33).setRowId(3)
+                .setType(FmsReportTypeEnum.BALANCE_SHEET.getType()).setLevel(1));
+        FmsLedgerSubjectBalanceRespVO cashBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(103L)
+                .setSubjectCode("1001").setOpeningDebitAmount(new BigDecimal("100.00"))
+                .setOpeningCreditAmount(BigDecimal.ZERO).setEndingDebitAmount(new BigDecimal("110.00"))
+                .setEndingCreditAmount(BigDecimal.ZERO).setChildren(Collections.emptyList());
+        FmsLedgerSubjectBalanceRespVO liabilityBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(104L)
+                .setSubjectCode("2001").setOpeningDebitAmount(BigDecimal.ZERO)
+                .setOpeningCreditAmount(new BigDecimal("90.00")).setEndingDebitAmount(BigDecimal.ZERO)
+                .setEndingCreditAmount(new BigDecimal("95.00")).setChildren(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Arrays.asList(cashBalance, liabilityBalance));
+        FmsTrialBalanceRespVO trialBalance = new FmsTrialBalanceRespVO();
+        trialBalance.setBalanced(false);
+        when(initialBalanceService.getTrialBalance(1L, 10L)).thenReturn(trialBalance);
+        when(closingPeriodService.getClosingOverview(any(), eq(10L)))
+                .thenReturn(new FmsClosingOverviewRespVO().setProfitLossBalance(new BigDecimal("20.00")));
+
+        // 调用
+        FmsBalanceSheetCheckRespVO result = balanceSheetService.checkBalanceSheet(buildQueryReqVO(), 10L);
+
+        // 断言
+        assertFalse(result.getBalanced());
+        assertFalse(result.getInitialBalanceBalanced());
+        assertFalse(result.getProfitLossTransferred());
+        assertEquals(new BigDecimal("100.00"), result.getOpeningDifferenceAmount());
+        assertEquals(new BigDecimal("110.00"), result.getClosingDifferenceAmount());
+        assertEquals(1, result.getUnmappedSubjects().size());
+        assertEquals(liabilitySubject.getId(), CollUtil.getFirst(result.getUnmappedSubjects()).getId());
+    }
+
+    @Test
+    public void testCheckBalanceSheet_capitalizedExpenseWithExpandedCodeRule() {
+        // mock 数据
+        FmsSubjectDO capitalizedExpenseSubject = new FmsSubjectDO().setId(104L).setCode("40404")
+                .setName("资本化支出").setBalanceDirection(1).setLevel(1).setAccountSetId(1L)
+                .setType(FmsSubjectTypeEnum.ASSET.getType());
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Collections.singletonList(capitalizedExpenseSubject));
+        when(financeParameterService.getFinanceParameter(1L)).thenReturn(new FmsFinanceParameterDO()
+                .setSubjectCodeRule("5-2-2-2"));
+        when(financeParameterService.convertStandardSubjectCode("4404", "5-2-2-2"))
+                .thenReturn("40404");
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L))).thenReturn(Collections.singletonList(
+                new FmsLedgerSubjectBalanceRespVO().setSubjectId(104L).setSubjectCode("40404")
+                        .setOpeningDebitAmount(new BigDecimal("100.00")).setOpeningCreditAmount(BigDecimal.ZERO)
+                        .setEndingDebitAmount(new BigDecimal("100.00")).setEndingCreditAmount(BigDecimal.ZERO)
+                        .setChildren(Collections.emptyList())));
+        when(initialBalanceService.getTrialBalance(1L, 10L))
+                .thenReturn(new FmsTrialBalanceRespVO().setBalanced(true));
+        when(closingPeriodService.getClosingOverview(any(), eq(10L)))
+                .thenReturn(new FmsClosingOverviewRespVO().setProfitLossBalance(BigDecimal.ZERO));
+
+        // 调用
+        FmsBalanceSheetCheckRespVO result = balanceSheetService.checkBalanceSheet(buildQueryReqVO(), 10L);
+
+        // 断言
+        assertEquals(0, result.getUnmappedSubjects().size());
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsReportListReqVO buildQueryReqVO() {
+        FmsReportListReqVO reqVO = new FmsReportListReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setStartMonth("2026-08");
+        reqVO.setEndMonth("2026-08");
+        return reqVO;
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementServiceImplTest.java
new file mode 100644
index 0000000..c46a86c
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsCashFlowStatementServiceImplTest.java
@@ -0,0 +1,280 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowAdjustmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.cashflow.FmsCashFlowStatementUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.FmsReportTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowExtendDataDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.cashflow.FmsCashFlowStatementReportDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.FmsReportTemplateMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow.FmsCashFlowExtendDataMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.cashflow.FmsCashFlowStatementReportMapper;
+import cn.iocoder.yudao.module.fms.enums.report.FmsReportTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.when;
+
+@Import({FmsCashFlowStatementServiceImpl.class, FmsReportCommonServiceImpl.class})
+public class FmsCashFlowStatementServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsCashFlowStatementServiceImpl cashFlowStatementService;
+    @Resource
+    private FmsReportTemplateMapper reportTemplateMapper;
+    @Resource
+    private FmsCashFlowExtendDataMapper cashFlowExtendDataMapper;
+    @Resource
+    private FmsCashFlowStatementReportMapper cashFlowStatementReportMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsLedgerService ledgerService;
+    @MockitoBean
+    private FmsBalanceSheetService balanceSheetService;
+    @MockitoBean
+    private FmsIncomeStatementService incomeStatementService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+
+    private FmsSubjectDO expenseSubject;
+
+    @BeforeEach
+    public void before() {
+        expenseSubject = new FmsSubjectDO().setId(102L).setCode("5601").setName("销售费用")
+                .setBalanceDirection(1).setLevel(1).setAccountSetId(1L);
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(1L)
+                .setStartTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L)).thenReturn(accountSet);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(accountSet);
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Collections.singletonList(expenseSubject));
+    }
+
+    @Test
+    public void testGetCashFlowStatement_crossReportFormula() {
+        // mock 数据
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("销售商品收到的现金").setRowNo(1)
+                .setFormula("[\"IN1\"]").setEditable(false).setSort(0)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("支付其他经营活动现金").setRowNo(6)
+                .setFormula("[]").setEditable(false).setSort(1)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("经营活动现金流量净额").setRowNo(7)
+                .setFormula("[\"L1-L6\"]").setEditable(false).setSort(2)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("现金净增加额").setRowNo(20)
+                .setFormula("[\"L7\"]").setEditable(false).setSort(3)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("期初现金余额").setRowNo(21)
+                .setFormula("[\"BA[1,1]\"]").setEditable(false).setSort(4)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("期末现金余额").setRowNo(22)
+                .setFormula("[\"L20+L21\"]").setEditable(false).setSort(5)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(1));
+        Map<Integer, FmsReportItemRespVO> balanceLineMap = new HashMap<>();
+        balanceLineMap.put(FmsBalanceSheetServiceImpl.MONETARY_CASH_ROW_NO, new FmsReportItemRespVO()
+                .setRowNo(FmsBalanceSheetServiceImpl.MONETARY_CASH_ROW_NO)
+                .setOpeningAmount(new BigDecimal("100.00")).setClosingAmount(new BigDecimal("1100.00")));
+        when(balanceSheetService.getBalanceSheetLineMap(any(), any(), any(), eq(10L)))
+                .thenReturn(balanceLineMap);
+        when(incomeStatementService.getIncomeStatement(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(new FmsReportItemRespVO().setRowNo(1)
+                        .setCurrentAmount(new BigDecimal("1000.00"))
+                        .setYearAmount(new BigDecimal("1000.00"))));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.emptyList());
+
+        // 准备参数
+        FmsReportListReqVO reqVO = buildQueryReqVO();
+
+        // 调用
+        List<FmsReportItemRespVO> result = cashFlowStatementService.getCashFlowStatement(reqVO, 10L);
+
+        // 断言
+        assertEquals(6, result.size());
+        assertEquals(new BigDecimal("1000.00"), result.get(0).getCurrentAmount());
+        assertEquals(new BigDecimal("1100.00"), result.get(5).getCurrentAmount());
+        assertEquals(new BigDecimal("1100.00"), result.get(5).getYearAmount());
+        assertEquals(6, cashFlowStatementReportMapper.selectListByPeriod(
+                1L, 202608, 202608, 1).size());
+    }
+
+    @Test
+    public void testUpdateCashFlowStatement() {
+        // mock 数据
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("经营活动现金流入").setRowNo(1)
+                .setFormula("[\"IN1\"]").setEditable(false).setSort(0)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("经营活动现金流量净额").setRowNo(2)
+                .setFormula("[\"L1\"]").setEditable(false).setSort(1)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setLevel(1));
+        when(balanceSheetService.getBalanceSheetLineMap(any(), any(), any(), eq(10L)))
+                .thenReturn(Collections.emptyMap());
+        when(incomeStatementService.getIncomeStatement(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(new FmsReportItemRespVO().setRowNo(1)
+                        .setCurrentAmount(new BigDecimal("100.00"))
+                        .setYearAmount(new BigDecimal("150.00"))));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.emptyList());
+
+        // 准备参数
+        FmsReportListReqVO listReqVO = buildQueryReqVO();
+        List<FmsReportItemRespVO> reports = cashFlowStatementService.getCashFlowStatement(
+                listReqVO, 10L);
+        FmsCashFlowStatementUpdateReqVO updateReqVO = new FmsCashFlowStatementUpdateReqVO()
+                .setAccountSetId(1L).setStartMonth("2026-08").setEndMonth("2026-08")
+                .setItems(Collections.singletonList(new FmsCashFlowStatementUpdateReqVO.Item()
+                        .setId(reports.get(0).getId()).setCurrentAmount(new BigDecimal("80.00"))
+                        .setYearAmount(new BigDecimal("200.00"))));
+
+        // 调用
+        cashFlowStatementService.updateCashFlowStatement(updateReqVO, 10L);
+        reports = cashFlowStatementService.getCashFlowStatement(listReqVO, 10L);
+
+        // 断言保存金额和后续行次联动
+        assertEquals(new BigDecimal("80.00"), reports.get(0).getCurrentAmount());
+        assertEquals(new BigDecimal("200.00"), reports.get(0).getYearAmount());
+        assertEquals(new BigDecimal("80.00"), reports.get(1).getCurrentAmount());
+        assertEquals(new BigDecimal("200.00"), reports.get(1).getYearAmount());
+
+        // 调用：金额清零后重新按公式计算
+        updateReqVO.getItems().get(0).setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO);
+        cashFlowStatementService.updateCashFlowStatement(updateReqVO, 10L);
+        reports = cashFlowStatementService.getCashFlowStatement(listReqVO, 10L);
+
+        // 断言
+        assertEquals(new BigDecimal("100.00"), reports.get(0).getCurrentAmount());
+        assertEquals(new BigDecimal("150.00"), reports.get(0).getYearAmount());
+    }
+
+    @Test
+    public void testGetCashFlowAdjustmentListAndStatement() {
+        // mock 数据
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("支付给职工的工资").setRowNo(1)
+                .setFormula("[{\"operator\":\"+\",\"rules\":5,\"subjectNumber\":\"5601\"}]")
+                .setEditable(true).setSort(0)
+                .setType(FmsReportTypeEnum.CASH_FLOW_ADJUSTMENT.getType()).setCategory(1).setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("支付给职工的其他福利费").setRowNo(2)
+                .setFormula("[]").setEditable(true).setSort(1)
+                .setType(FmsReportTypeEnum.CASH_FLOW_ADJUSTMENT.getType()).setCategory(1).setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("支付给职工以及为职工支付的现金")
+                .setRowNo(4).setFormula("[\"L1+L2\"]").setEditable(false).setSort(2)
+                .setType(FmsReportTypeEnum.CASH_FLOW_ADJUSTMENT.getType()).setCategory(1).setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("支付的职工薪酬").setRowNo(4)
+                .setFormula("[\"EX4\"]").setEditable(false).setSort(0)
+                .setType(FmsReportTypeEnum.CASH_FLOW_STATEMENT.getType()).setCategory(1).setLevel(2));
+        FmsLedgerSubjectBalanceRespVO expenseBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(102L)
+                .setSubjectCode("5601").setPeriodDebitAmount(new BigDecimal("200.00"))
+                .setPeriodCreditAmount(new BigDecimal("20.00")).setYearDebitAmount(new BigDecimal("500.00"))
+                .setYearCreditAmount(new BigDecimal("50.00")).setChildren(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(expenseBalance));
+        when(balanceSheetService.getBalanceSheetLineMap(any(), any(), any(), eq(10L)))
+                .thenReturn(Collections.emptyMap());
+        when(incomeStatementService.getIncomeStatement(any(), eq(10L)))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        List<FmsCashFlowAdjustmentRespVO> adjustments = cashFlowStatementService.getCashFlowAdjustmentList(
+                buildQueryReqVO(), 10L);
+
+        // 断言
+        assertEquals(3, adjustments.size());
+        assertEquals(new BigDecimal("200.00"), adjustments.get(0).getCurrentAmount());
+        assertEquals(new BigDecimal("500.00"), adjustments.get(0).getYearAmount());
+        assertEquals(new BigDecimal("200.00"), adjustments.get(2).getCurrentAmount());
+
+        // 准备参数
+        FmsCashFlowExtendDataDO manualData = cashFlowExtendDataMapper.selectListByPeriod(
+                1L, 202608, 202608, 1, 1).get(1);
+        cashFlowStatementService.getCashFlowStatement(buildQueryReqVO(), 10L);
+        FmsCashFlowStatementReportDO adjustedReport = CollUtil.getFirst(
+                cashFlowStatementReportMapper.selectListByPeriod(1L, 202608, 202608, 1));
+        cashFlowStatementReportMapper.updateById(new FmsCashFlowStatementReportDO().setId(adjustedReport.getId())
+                .setCurrentAmount(new BigDecimal("999.00")).setYearAmount(new BigDecimal("999.00")));
+        FmsCashFlowAdjustmentUpdateReqVO.Item itemReqVO = new FmsCashFlowAdjustmentUpdateReqVO.Item();
+        itemReqVO.setId(manualData.getId());
+        itemReqVO.setCurrentAmount(new BigDecimal("30.00"));
+        itemReqVO.setYearAmount(new BigDecimal("60.00"));
+        FmsCashFlowAdjustmentUpdateReqVO updateReqVO = new FmsCashFlowAdjustmentUpdateReqVO();
+        updateReqVO.setAccountSetId(1L);
+        updateReqVO.setItems(Collections.singletonList(itemReqVO));
+
+        // 调用
+        cashFlowStatementService.updateCashFlowAdjustment(updateReqVO, 10L);
+        adjustedReport = cashFlowStatementReportMapper.selectById(adjustedReport.getId());
+        assertEquals(0, BigDecimal.ZERO.compareTo(adjustedReport.getCurrentAmount()));
+        assertEquals(0, BigDecimal.ZERO.compareTo(adjustedReport.getYearAmount()));
+        adjustments = cashFlowStatementService.getCashFlowAdjustmentList(buildQueryReqVO(), 10L);
+        List<FmsReportItemRespVO> statement = cashFlowStatementService.getCashFlowStatement(
+                buildQueryReqVO(), 10L);
+
+        // 断言
+        assertEquals(new BigDecimal("230.00"), adjustments.get(2).getCurrentAmount());
+        assertEquals(new BigDecimal("560.00"), adjustments.get(2).getYearAmount());
+        assertEquals(new BigDecimal("230.00"), CollUtil.getFirst(statement).getCurrentAmount());
+        assertEquals(new BigDecimal("560.00"), CollUtil.getFirst(statement).getYearAmount());
+    }
+
+    @Test
+    public void testCheckCashFlowStatement() {
+        // mock 数据
+        FmsBalanceSheetCheckRespVO balanceCheck = new FmsBalanceSheetCheckRespVO()
+                .setBalanced(true).setInitialBalanceBalanced(true).setProfitLossTransferred(true)
+                .setOpeningDifferenceAmount(BigDecimal.ZERO).setClosingDifferenceAmount(BigDecimal.ZERO)
+                .setUnmappedSubjects(Collections.emptyList());
+        when(balanceSheetService.checkBalanceSheet(any(), eq(10L))).thenReturn(balanceCheck);
+
+        // 调用
+        FmsCashFlowCheckRespVO result = cashFlowStatementService.checkCashFlowStatement(
+                buildQueryReqVO(), 10L);
+
+        // 断言
+        assertTrue(result.getBalanced());
+        assertTrue(result.getInitialBalanceBalanced());
+        assertTrue(result.getProfitLossTransferred());
+        assertTrue(result.getBalanceSheetReady());
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsReportListReqVO buildQueryReqVO() {
+        FmsReportListReqVO reqVO = new FmsReportListReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setStartMonth("2026-08");
+        reqVO.setEndMonth("2026-08");
+        return reqVO;
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementServiceImplTest.java
new file mode 100644
index 0000000..1e09cf3
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsIncomeStatementServiceImplTest.java
@@ -0,0 +1,334 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.balance.FmsBalanceSheetRowRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.income.FmsIncomeStatementCheckRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportFormulaUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportItemRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.report.vo.FmsReportListReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.FmsReportTemplateDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.income.FmsIncomeStatementConfigDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.report.income.FmsIncomeStatementReportDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.FmsReportTemplateMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.income.FmsIncomeStatementConfigMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.report.income.FmsIncomeStatementReportMapper;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsReportTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_CONFIG_NOT_EDITABLE;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.REPORT_FORMULA_RULE_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.when;
+
+@Import({FmsIncomeStatementServiceImpl.class, FmsReportCommonServiceImpl.class})
+public class FmsIncomeStatementServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsIncomeStatementServiceImpl incomeStatementService;
+    @Resource
+    private FmsReportTemplateMapper reportTemplateMapper;
+    @Resource
+    private FmsIncomeStatementConfigMapper incomeStatementConfigMapper;
+    @Resource
+    private FmsIncomeStatementReportMapper incomeStatementReportMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsLedgerService ledgerService;
+    @MockitoBean
+    private FmsBalanceSheetService balanceSheetService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+    @MockitoBean
+    private FmsClosingVoucherService closingVoucherService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+
+    private FmsSubjectDO revenueSubject;
+    private FmsSubjectDO expenseSubject;
+
+    @BeforeEach
+    public void before() {
+        revenueSubject = new FmsSubjectDO().setId(101L).setCode("5001").setName("主营业务收入")
+                .setBalanceDirection(2).setLevel(1).setAccountSetId(1L);
+        expenseSubject = new FmsSubjectDO().setId(102L).setCode("5601").setName("销售费用")
+                .setBalanceDirection(1).setLevel(1).setAccountSetId(1L);
+        FmsAccountSetDO accountSet = new FmsAccountSetDO().setId(1L)
+                .setStartTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L)).thenReturn(accountSet);
+        when(accountSetService.validateAccountSetWritePermission(1L, 10L)).thenReturn(accountSet);
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Arrays.asList(revenueSubject, expenseSubject));
+    }
+
+    @Test
+    public void testGetIncomeStatement() {
+        // mock 数据
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("一、营业收入").setRowNo(1)
+                .setFormula("[{\"operator\":\"+\",\"rules\":6,\"subjectNumber\":\"5001\"}]")
+                .setEditable(true).setSort(0).setType(FmsReportTypeEnum.INCOME_STATEMENT.getType())
+                .setLevel(1));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("减：销售费用").setRowNo(2)
+                .setFormula("[{\"operator\":\"+\",\"rules\":5,\"subjectNumber\":\"5601\"}]")
+                .setEditable(true).setSort(1).setType(FmsReportTypeEnum.INCOME_STATEMENT.getType())
+                .setLevel(2));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("二、营业利润").setRowNo(3)
+                .setFormula("[\"L1-L2\"]").setEditable(false).setSort(2)
+                .setType(FmsReportTypeEnum.INCOME_STATEMENT.getType()).setLevel(1));
+        FmsLedgerSubjectBalanceRespVO revenueBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setSubjectCode("5001").setPeriodDebitAmount(BigDecimal.ZERO)
+                .setPeriodCreditAmount(new BigDecimal("1000.00")).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearCreditAmount(new BigDecimal("3000.00"));
+        FmsLedgerSubjectBalanceRespVO expenseBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(102L)
+                .setSubjectCode("5601").setPeriodDebitAmount(new BigDecimal("200.00"))
+                .setPeriodCreditAmount(BigDecimal.ZERO).setYearDebitAmount(new BigDecimal("500.00"))
+                .setYearCreditAmount(BigDecimal.ZERO);
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Arrays.asList(revenueBalance, expenseBalance));
+
+        // 准备参数
+        FmsReportListReqVO reqVO = buildQueryReqVO();
+
+        // 调用
+        List<FmsReportItemRespVO> result = incomeStatementService.getIncomeStatement(reqVO, 10L);
+
+        // 断言
+        assertEquals(3, result.size());
+        assertEquals(new BigDecimal("1000.00"), result.get(0).getCurrentAmount());
+        assertEquals(new BigDecimal("500.00"), result.get(1).getYearAmount());
+        assertEquals(new BigDecimal("800.00"), result.get(2).getCurrentAmount());
+        assertEquals(new BigDecimal("2500.00"), result.get(2).getYearAmount());
+    }
+
+    @Test
+    public void testGetIncomeStatement_subjectCodeChanged() {
+        // mock 数据
+        incomeStatementConfigMapper.insert(new FmsIncomeStatementConfigDO().setName("一、营业收入")
+                .setRowNo(1).setFormula("[{\"subjectId\":101,\"subjectName\":\"主营业务收入\","
+                        + "\"subjectNumber\":\"5001\",\"operator\":\"+\",\"rules\":6}]")
+                .setEditable(true).setSort(0).setAccountSetId(1L).setLevel(1));
+        revenueSubject.setCode("50010");
+        FmsLedgerSubjectBalanceRespVO revenueBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setSubjectCode("50010").setPeriodDebitAmount(BigDecimal.ZERO)
+                .setPeriodCreditAmount(new BigDecimal("1000.00")).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearCreditAmount(new BigDecimal("3000.00"));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(revenueBalance));
+
+        // 调用
+        List<FmsReportItemRespVO> result = incomeStatementService.getIncomeStatement(buildQueryReqVO(), 10L);
+
+        // 断言
+        assertEquals(new BigDecimal("1000.00"), CollUtil.getFirst(result).getCurrentAmount());
+        List<FmsReportFormulaRespVO> formulas = JsonUtils.parseArray(
+                CollUtil.getFirst(result).getFormula(), FmsReportFormulaRespVO.class);
+        assertEquals("50010", CollUtil.getFirst(formulas).getSubjectNumber());
+    }
+
+    @Test
+    public void testGetIncomeStatement_formulaSnapshot() {
+        // mock 数据
+        String revenueFormula = "[{\"subjectId\":101,\"subjectName\":\"主营业务收入\","
+                + "\"subjectNumber\":\"5001\",\"operator\":\"+\",\"rules\":6}]";
+        String expenseFormula = "[{\"subjectId\":102,\"subjectName\":\"销售费用\","
+                + "\"subjectNumber\":\"5601\",\"operator\":\"+\",\"rules\":5}]";
+        FmsIncomeStatementConfigDO config = new FmsIncomeStatementConfigDO().setName("一、营业收入")
+                .setRowNo(1).setFormula(revenueFormula).setEditable(true).setSort(1)
+                .setAccountSetId(1L).setLevel(1);
+        incomeStatementConfigMapper.insert(config);
+        FmsLedgerSubjectBalanceRespVO revenueBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setPeriodDebitAmount(BigDecimal.ZERO).setPeriodCreditAmount(new BigDecimal("1000.00"))
+                .setYearDebitAmount(BigDecimal.ZERO).setYearCreditAmount(new BigDecimal("3000.00"));
+        FmsLedgerSubjectBalanceRespVO expenseBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(102L)
+                .setPeriodDebitAmount(new BigDecimal("200.00")).setPeriodCreditAmount(BigDecimal.ZERO)
+                .setYearDebitAmount(new BigDecimal("500.00")).setYearCreditAmount(BigDecimal.ZERO);
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Arrays.asList(revenueBalance, expenseBalance));
+
+        // 调用
+        List<FmsReportItemRespVO> augustResult = incomeStatementService.getIncomeStatement(
+                buildQueryReqVO("2026-08", "2026-08"), 10L);
+        incomeStatementConfigMapper.updateById(new FmsIncomeStatementConfigDO().setId(config.getId())
+                .setFormula(expenseFormula));
+        List<FmsReportItemRespVO> augustResultAfterUpdate = incomeStatementService.getIncomeStatement(
+                buildQueryReqVO("2026-08", "2026-08"), 10L);
+        List<FmsReportItemRespVO> septemberResult = incomeStatementService.getIncomeStatement(
+                buildQueryReqVO("2026-09", "2026-09"), 10L);
+
+        // 断言
+        assertEquals(new BigDecimal("1000.00"), CollUtil.getFirst(augustResult).getCurrentAmount());
+        assertEquals(new BigDecimal("1000.00"), CollUtil.getFirst(augustResultAfterUpdate).getCurrentAmount());
+        assertEquals(new BigDecimal("200.00"), CollUtil.getFirst(septemberResult).getCurrentAmount());
+        assertEquals(revenueFormula, CollUtil.getFirst(incomeStatementReportMapper.selectListByPeriod(
+                1L, 202608, 202608, 1)).getFormula());
+        assertEquals(expenseFormula, CollUtil.getFirst(incomeStatementReportMapper.selectListByPeriod(
+                1L, 202609, 202609, 1)).getFormula());
+    }
+
+    @Test
+    public void testUpdateIncomeStatementFormula() {
+        // mock 数据
+        String oldFormula = "[]";
+        FmsIncomeStatementConfigDO config = new FmsIncomeStatementConfigDO().setName("一、营业收入")
+                .setRowNo(1).setFormula(oldFormula).setEditable(true).setSort(1)
+                .setAccountSetId(1L).setLevel(1);
+        incomeStatementConfigMapper.insert(config);
+        FmsIncomeStatementReportDO currentReport = new FmsIncomeStatementReportDO().setName("一、营业收入")
+                .setRowNo(1).setFormula(oldFormula).setEditable(true).setSort(1).setAccountSetId(1L).setLevel(1)
+                .setFromPeriod(202608).setToPeriod(202608).setType(1)
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO).setSettled(false);
+        incomeStatementReportMapper.insert(currentReport);
+        FmsIncomeStatementReportDO historyReport = new FmsIncomeStatementReportDO().setName("一、营业收入")
+                .setRowNo(1).setFormula(oldFormula).setEditable(true).setSort(1).setAccountSetId(1L).setLevel(1)
+                .setFromPeriod(202607).setToPeriod(202607).setType(1)
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO).setSettled(false);
+        incomeStatementReportMapper.insert(historyReport);
+
+        // 准备参数
+        FmsReportFormulaUpdateReqVO.Formula formulaReqVO = new FmsReportFormulaUpdateReqVO.Formula();
+        formulaReqVO.setSubjectId(revenueSubject.getId());
+        formulaReqVO.setOperator("+");
+        formulaReqVO.setRules(6);
+        FmsReportFormulaUpdateReqVO reqVO = new FmsReportFormulaUpdateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setId(currentReport.getId());
+        reqVO.setFormulas(Collections.singletonList(formulaReqVO));
+
+        // 调用
+        incomeStatementService.updateIncomeStatementFormula(reqVO, 10L);
+
+        // 断言
+        String formula = incomeStatementReportMapper.selectById(currentReport.getId()).getFormula();
+        assertEquals(oldFormula, incomeStatementConfigMapper.selectById(config.getId()).getFormula());
+        assertTrue(formula.contains("\"subjectId\":101"));
+        assertEquals(oldFormula, incomeStatementReportMapper.selectById(historyReport.getId()).getFormula());
+    }
+
+    @Test
+    public void testUpdateIncomeStatementFormula_ruleInvalid() {
+        // mock 数据
+        FmsIncomeStatementConfigDO config = new FmsIncomeStatementConfigDO().setName("一、营业收入")
+                .setRowNo(1).setFormula("[]").setEditable(true).setSort(1).setAccountSetId(1L).setLevel(1);
+        incomeStatementConfigMapper.insert(config);
+        FmsIncomeStatementReportDO report = new FmsIncomeStatementReportDO().setName("一、营业收入")
+                .setRowNo(1).setFormula("[]").setEditable(true).setSort(1).setAccountSetId(1L).setLevel(1)
+                .setFromPeriod(202608).setToPeriod(202608).setType(1)
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO).setSettled(false);
+        incomeStatementReportMapper.insert(report);
+
+        // 准备参数
+        FmsReportFormulaUpdateReqVO.Formula formulaReqVO = new FmsReportFormulaUpdateReqVO.Formula();
+        formulaReqVO.setSubjectId(revenueSubject.getId());
+        formulaReqVO.setOperator("+");
+        formulaReqVO.setRules(0);
+        FmsReportFormulaUpdateReqVO reqVO = new FmsReportFormulaUpdateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setId(report.getId());
+        reqVO.setFormulas(Collections.singletonList(formulaReqVO));
+
+        // 调用，并断言
+        assertServiceException(() -> incomeStatementService.updateIncomeStatementFormula(reqVO, 10L),
+                REPORT_FORMULA_RULE_INVALID);
+    }
+
+    @Test
+    public void testUpdateIncomeStatementFormula_notEditable() {
+        // mock 数据
+        FmsIncomeStatementReportDO report = new FmsIncomeStatementReportDO().setName("二、营业利润")
+                .setRowNo(21).setFormula("[\"L1-L2\"]").setEditable(false).setSort(20)
+                .setAccountSetId(1L).setLevel(1).setFromPeriod(202608).setToPeriod(202608).setType(1)
+                .setCurrentAmount(BigDecimal.ZERO).setYearAmount(BigDecimal.ZERO).setSettled(false);
+        incomeStatementReportMapper.insert(report);
+
+        // 准备参数
+        FmsReportFormulaUpdateReqVO reqVO = new FmsReportFormulaUpdateReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setId(report.getId());
+        reqVO.setFormulas(Collections.emptyList());
+
+        // 调用，并断言
+        assertServiceException(() -> incomeStatementService.updateIncomeStatementFormula(reqVO, 10L),
+                REPORT_CONFIG_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testCheckIncomeStatement() {
+        // mock 数据
+        FmsSubjectDO skippedSubject = new FmsSubjectDO().setId(105L).setCode("6001")
+                .setName("以前年度损益调整").setBalanceDirection(1).setLevel(1).setAccountSetId(1L)
+                .setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        revenueSubject.setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        expenseSubject.setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Arrays.asList(revenueSubject, expenseSubject, skippedSubject));
+        reportTemplateMapper.insert(new FmsReportTemplateDO().setName("四、净利润").setRowNo(32)
+                .setFormula("[{\"operator\":\"+\",\"rules\":6,\"subjectNumber\":\"5001\"}]")
+                .setEditable(false).setSort(0).setType(FmsReportTypeEnum.INCOME_STATEMENT.getType())
+                .setLevel(1));
+        FmsLedgerSubjectBalanceRespVO revenueBalance = new FmsLedgerSubjectBalanceRespVO().setSubjectId(101L)
+                .setSubjectCode("5001").setPeriodDebitAmount(BigDecimal.ZERO)
+                .setPeriodCreditAmount(new BigDecimal("1000.00")).setYearDebitAmount(BigDecimal.ZERO)
+                .setYearCreditAmount(new BigDecimal("3000.00"));
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Collections.singletonList(revenueBalance));
+        when(balanceSheetService.getBalanceSheet(any(), eq(10L))).thenReturn(Collections.singletonList(
+                new FmsBalanceSheetRowRespVO().setLiabilityRowNo(51)
+                        .setLiabilityOpeningAmount(BigDecimal.ZERO)
+                        .setLiabilityClosingAmount(new BigDecimal("3000.00"))));
+
+        // 调用
+        FmsIncomeStatementCheckRespVO result = incomeStatementService.checkIncomeStatement(
+                buildQueryReqVO(), 10L);
+
+        // 断言
+        assertTrue(result.getBalanced());
+        assertEquals(new BigDecimal("0.00"), result.getDifferenceAmount());
+        assertEquals(1, result.getUnmappedSubjects().size());
+        assertEquals(expenseSubject.getId(), CollUtil.getFirst(result.getUnmappedSubjects()).getId());
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsReportListReqVO buildQueryReqVO() {
+        return buildQueryReqVO("2026-08", "2026-08");
+    }
+
+    private FmsReportListReqVO buildQueryReqVO(String startMonth, String endMonth) {
+        FmsReportListReqVO reqVO = new FmsReportListReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setStartMonth(startMonth);
+        reqVO.setEndMonth(endMonth);
+        return reqVO;
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonServiceImplTest.java
new file mode 100644
index 0000000..c44f62d
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/report/FmsReportCommonServiceImplTest.java
@@ -0,0 +1,208 @@
+package cn.iocoder.yudao.module.fms.service.report;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.ledger.vo.subjectbalance.FmsLedgerSubjectBalanceRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSubjectAmountVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingSchemeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.closing.FmsClosingVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.enums.config.FmsSubjectTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.closing.FmsClosingTypeEnum;
+import cn.iocoder.yudao.module.fms.enums.report.FmsFormulaRuleEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingSchemeService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.ledger.FmsLedgerService;
+import cn.iocoder.yudao.module.fms.service.voucher.FmsVoucherService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.LEDGER_PERIOD_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.when;
+
+@Import(FmsReportCommonServiceImpl.class)
+public class FmsReportCommonServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsReportCommonServiceImpl reportCommonService;
+
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsLedgerService ledgerService;
+    @MockitoBean
+    private FmsClosingVoucherService closingVoucherService;
+    @MockitoBean
+    private FmsClosingSchemeService closingSchemeService;
+    @MockitoBean
+    private FmsVoucherService voucherService;
+
+    @Test
+    public void testGetSubjectBalanceMap_excludeProfitLossClosingVoucher() {
+        // mock 数据
+        FmsSubjectDO profitLossRoot = new FmsSubjectDO().setId(100L).setParentId(0L)
+                .setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO profitLossSubject = new FmsSubjectDO().setId(101L).setParentId(100L)
+                .setType(FmsSubjectTypeEnum.PROFIT_LOSS.getType());
+        FmsSubjectDO retainedEarningsSubject = new FmsSubjectDO().setId(201L).setParentId(0L)
+                .setType(FmsSubjectTypeEnum.EQUITY.getType());
+        when(subjectService.getSubjectList(1L, null, 10L)).thenReturn(
+                Arrays.asList(profitLossRoot, profitLossSubject, retainedEarningsSubject));
+        FmsLedgerSubjectBalanceRespVO profitLossBalance = buildProfitLossBalance(100L);
+        FmsLedgerSubjectBalanceRespVO profitLossChildBalance = buildProfitLossBalance(101L);
+        profitLossBalance.setChildren(Collections.singletonList(profitLossChildBalance));
+        FmsLedgerSubjectBalanceRespVO retainedEarningsBalance = new FmsLedgerSubjectBalanceRespVO()
+                .setSubjectId(201L).setOpeningDebitAmount(BigDecimal.ZERO)
+                .setOpeningCreditAmount(new BigDecimal("10.00"))
+                .setPeriodDebitAmount(new BigDecimal("30.00")).setPeriodCreditAmount(BigDecimal.ZERO)
+                .setYearDebitAmount(new BigDecimal("30.00")).setYearCreditAmount(new BigDecimal("10.00"))
+                .setEndingDebitAmount(new BigDecimal("20.00")).setEndingCreditAmount(BigDecimal.ZERO)
+                .setChildren(Collections.emptyList());
+        when(ledgerService.getSubjectBalanceList(any(), eq(10L)))
+                .thenReturn(Arrays.asList(profitLossBalance, retainedEarningsBalance));
+
+        LocalDateTime startTime = LocalDateTime.of(2026, 8, 1, 0, 0);
+        LocalDateTime endTime = LocalDateTime.of(2026, 9, 1, 0, 0);
+        FmsClosingVoucherDO julyClosingVoucher = new FmsClosingVoucherDO().setVoucherId(1L)
+                .setVoucherTime(LocalDateTime.of(2026, 7, 31, 0, 0));
+        FmsClosingVoucherDO augustClosingVoucher = new FmsClosingVoucherDO().setVoucherId(2L)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 31, 0, 0));
+        when(closingSchemeService.getClosingSchemeByAccountSetIdAndType(
+                1L, FmsClosingTypeEnum.PROFIT_LOSS.getType()))
+                .thenReturn(new FmsClosingSchemeDO().setId(11L));
+        when(closingVoucherService.getClosingVoucherListByClosingIdAndPeriod(11L, null, endTime))
+                .thenReturn(Arrays.asList(julyClosingVoucher, augustClosingVoucher));
+        when(voucherService.getVoucherSubjectAmountList(Collections.singletonList(1L)))
+                .thenReturn(Arrays.asList(buildSubjectAmount(101L, "10.00", "0.00"),
+                        buildSubjectAmount(201L, "0.00", "10.00")));
+        when(voucherService.getVoucherSubjectAmountList(Collections.singletonList(2L)))
+                .thenReturn(Arrays.asList(buildSubjectAmount(101L, "0.00", "30.00"),
+                        buildSubjectAmount(201L, "30.00", "0.00")));
+        when(voucherService.getVoucherSubjectAmountList(Arrays.asList(1L, 2L)))
+                .thenReturn(Arrays.asList(buildSubjectAmount(101L, "10.00", "30.00"),
+                        buildSubjectAmount(201L, "30.00", "10.00")));
+
+        // 调用
+        Map<Long, FmsLedgerSubjectBalanceRespVO> result = reportCommonService.getSubjectBalanceMap(
+                1L, YearMonth.of(2026, 8), YearMonth.of(2026, 8), 10L);
+
+        // 断言
+        assertProfitLossBalance(result.get(100L));
+        assertProfitLossBalance(result.get(101L));
+        assertEquals(new BigDecimal("10.00"), result.get(201L).getOpeningCreditAmount());
+        assertEquals(new BigDecimal("30.00"), result.get(201L).getPeriodDebitAmount());
+        assertEquals(new BigDecimal("20.00"), result.get(201L).getEndingDebitAmount());
+    }
+
+    @Test
+    public void testGetPeriodType_periodInvalid() {
+        // 调用，并断言异常
+        assertServiceException(() -> reportCommonService.getPeriodType(202609, 202608),
+                LEDGER_PERIOD_INVALID);
+    }
+
+    @Test
+    public void testCalculateBalanceAmount_subjectBalanceByFirstChild() {
+        // mock 数据
+        FmsSubjectDO parent = new FmsSubjectDO().setId(100L).setBalanceDirection(1);
+        FmsSubjectDO debitChild = new FmsSubjectDO().setId(101L).setParentId(100L).setBalanceDirection(1);
+        FmsSubjectDO creditChild = new FmsSubjectDO().setId(102L).setParentId(100L).setBalanceDirection(1);
+        Map<Long, FmsSubjectDO> subjectMap = new LinkedHashMap<>();
+        subjectMap.put(parent.getId(), parent);
+        subjectMap.put(debitChild.getId(), debitChild);
+        subjectMap.put(creditChild.getId(), creditChild);
+        Map<Long, FmsLedgerSubjectBalanceRespVO> balanceMap = new LinkedHashMap<>();
+        balanceMap.put(parent.getId(), buildBalance(100L, "70.00", "0.00", "80.00", "0.00"));
+        balanceMap.put(debitChild.getId(), buildBalance(101L, "100.00", "0.00", "120.00", "0.00"));
+        balanceMap.put(creditChild.getId(), buildBalance(102L, "0.00", "30.00", "0.00", "40.00"));
+
+        // 调用
+        BigDecimal openingDebitAmount = reportCommonService.calculateBalanceAmount(
+                FmsFormulaRuleEnum.SUBJECT_DEBIT_BALANCE.getRule(), parent, balanceMap, subjectMap, true);
+        BigDecimal openingCreditAmount = reportCommonService.calculateBalanceAmount(
+                FmsFormulaRuleEnum.SUBJECT_CREDIT_BALANCE.getRule(), parent, balanceMap, subjectMap, true);
+        BigDecimal closingDebitAmount = reportCommonService.calculateBalanceAmount(
+                FmsFormulaRuleEnum.SUBJECT_DEBIT_BALANCE.getRule(), parent, balanceMap, subjectMap, false);
+        BigDecimal closingCreditAmount = reportCommonService.calculateBalanceAmount(
+                FmsFormulaRuleEnum.SUBJECT_CREDIT_BALANCE.getRule(), parent, balanceMap, subjectMap, false);
+
+        // 断言
+        assertAmountEquals("100.00", openingDebitAmount);
+        assertAmountEquals("30.00", openingCreditAmount);
+        assertAmountEquals("120.00", closingDebitAmount);
+        assertAmountEquals("40.00", closingCreditAmount);
+    }
+
+    @Test
+    public void testCalculateIncomeOccurrenceAmount_netOppositeAmountForPlusOperator() {
+        // mock 数据
+        FmsSubjectDO subject = new FmsSubjectDO().setId(101L).setBalanceDirection(2);
+        FmsLedgerSubjectBalanceRespVO balance = new FmsLedgerSubjectBalanceRespVO()
+                .setPeriodDebitAmount(new BigDecimal("20.00")).setPeriodCreditAmount(new BigDecimal("100.00"))
+                .setYearDebitAmount(new BigDecimal("30.00")).setYearCreditAmount(new BigDecimal("200.00"));
+
+        // 调用，并断言
+        assertAmountEquals("80.00", reportCommonService.calculateIncomeOccurrenceAmount(
+                FmsFormulaRuleEnum.CREDIT_AMOUNT.getRule(), subject, balance, true, "+"));
+        assertAmountEquals("170.00", reportCommonService.calculateIncomeOccurrenceAmount(
+                FmsFormulaRuleEnum.CREDIT_AMOUNT.getRule(), subject, balance, false, "+"));
+        assertAmountEquals("100.00", reportCommonService.calculateIncomeOccurrenceAmount(
+                FmsFormulaRuleEnum.CREDIT_AMOUNT.getRule(), subject, balance, true, "-"));
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsLedgerSubjectBalanceRespVO buildProfitLossBalance(Long subjectId) {
+        return new FmsLedgerSubjectBalanceRespVO().setSubjectId(subjectId)
+                .setOpeningDebitAmount(new BigDecimal("10.00")).setOpeningCreditAmount(BigDecimal.ZERO)
+                .setPeriodDebitAmount(new BigDecimal("7.00")).setPeriodCreditAmount(new BigDecimal("30.00"))
+                .setYearDebitAmount(new BigDecimal("17.00")).setYearCreditAmount(new BigDecimal("30.00"))
+                .setEndingDebitAmount(BigDecimal.ZERO).setEndingCreditAmount(new BigDecimal("13.00"))
+                .setChildren(Collections.emptyList());
+    }
+
+    private FmsLedgerSubjectBalanceRespVO buildBalance(Long subjectId, String openingDebitAmount,
+            String openingCreditAmount, String endingDebitAmount, String endingCreditAmount) {
+        return new FmsLedgerSubjectBalanceRespVO().setSubjectId(subjectId)
+                .setOpeningDebitAmount(new BigDecimal(openingDebitAmount))
+                .setOpeningCreditAmount(new BigDecimal(openingCreditAmount))
+                .setEndingDebitAmount(new BigDecimal(endingDebitAmount))
+                .setEndingCreditAmount(new BigDecimal(endingCreditAmount));
+    }
+
+    private FmsVoucherSubjectAmountVO buildSubjectAmount(Long subjectId, String debitAmount,
+            String creditAmount) {
+        return new FmsVoucherSubjectAmountVO().setSubjectId(subjectId)
+                .setDebitAmount(new BigDecimal(debitAmount)).setCreditAmount(new BigDecimal(creditAmount));
+    }
+
+    private void assertProfitLossBalance(FmsLedgerSubjectBalanceRespVO balance) {
+        assertAmountEquals("0.00", balance.getOpeningDebitAmount());
+        assertAmountEquals("0.00", balance.getOpeningCreditAmount());
+        assertAmountEquals("7.00", balance.getPeriodDebitAmount());
+        assertAmountEquals("0.00", balance.getPeriodCreditAmount());
+        assertAmountEquals("7.00", balance.getYearDebitAmount());
+        assertAmountEquals("0.00", balance.getYearCreditAmount());
+        assertAmountEquals("7.00", balance.getEndingDebitAmount());
+        assertAmountEquals("0.00", balance.getEndingCreditAmount());
+    }
+
+    private void assertAmountEquals(String expected, BigDecimal actual) {
+        assertEquals(0, new BigDecimal(expected).compareTo(actual));
+    }
+
+}
diff --git a/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherServiceImplTest.java b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherServiceImplTest.java
new file mode 100644
index 0000000..3933135
--- /dev/null
+++ b/yudao-module-fms/src/test/java/cn/iocoder/yudao/module/fms/service/voucher/FmsVoucherServiceImplTest.java
@@ -0,0 +1,1173 @@
+package cn.iocoder.yudao.module.fms.service.voucher;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherEntrySaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherAttachmentUpdateReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherMoveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherPageReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSaveReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsReqVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherStatisticsRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherSubjectAmountVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherTidyReqVO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAccountSetDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryCombinationDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryItemDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsAuxiliaryTypeDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsSubjectDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.voucher.FmsVoucherEntryDO;
+import cn.iocoder.yudao.module.fms.dal.dataobject.config.FmsVoucherWordDO;
+import cn.iocoder.yudao.module.fms.dal.mysql.voucher.FmsVoucherEntryMapper;
+import cn.iocoder.yudao.module.fms.dal.mysql.voucher.FmsVoucherMapper;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherStatusEnum;
+import cn.iocoder.yudao.module.fms.enums.voucher.FmsVoucherTidyTypeEnum;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingPeriodService;
+import cn.iocoder.yudao.module.fms.service.closing.FmsClosingVoucherService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAccountSetService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryCombinationService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryItemService;
+import cn.iocoder.yudao.module.fms.service.config.FmsAuxiliaryTypeService;
+import cn.iocoder.yudao.module.fms.service.config.FmsSubjectService;
+import cn.iocoder.yudao.module.fms.service.config.FmsVoucherWordService;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportRespVO;
+import cn.iocoder.yudao.module.fms.controller.admin.voucher.vo.FmsVoucherImportExcelVO;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.fms.enums.ErrorCodeConstants.*;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.when;
+import static org.mockito.Mockito.doThrow;
+
+@Import(FmsVoucherServiceImpl.class)
+public class FmsVoucherServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private FmsVoucherServiceImpl voucherService;
+    @Resource
+    private FmsVoucherMapper voucherMapper;
+    @Resource
+    private FmsVoucherEntryMapper voucherEntryMapper;
+
+    @MockitoBean
+    private FmsAccountSetService accountSetService;
+    @MockitoBean
+    private FmsClosingPeriodService closingPeriodService;
+    @MockitoBean
+    private FmsClosingVoucherService closingVoucherService;
+    @MockitoBean
+    private FmsVoucherWordService voucherWordService;
+    @MockitoBean
+    private FmsSubjectService subjectService;
+    @MockitoBean
+    private FmsAuxiliaryItemService auxiliaryItemService;
+    @MockitoBean
+    private FmsAuxiliaryTypeService auxiliaryTypeService;
+    @MockitoBean
+    private FmsAuxiliaryCombinationService auxiliaryCombinationService;
+
+    private FmsSubjectDO cashSubject;
+    private FmsSubjectDO payableSubject;
+    private FmsSubjectDO cashChildSubject;
+    private FmsSubjectDO bankSubject;
+
+    @BeforeEach
+    public void before() {
+        cashSubject = buildSubject(101L, "1001", "库存现金");
+        payableSubject = buildSubject(201L, "2202", "应付账款");
+        cashChildSubject = buildSubject(102L, "100101", "人民币现金")
+                .setParentId(cashSubject.getId()).setLevel(2);
+        bankSubject = buildSubject(103L, "1002", "银行存款");
+        when(subjectService.getSubjectList(1L, null, 10L))
+                .thenReturn(Arrays.asList(cashSubject, cashChildSubject, bankSubject, payableSubject));
+        when(accountSetService.validateAccountSetReadPermission(1L, 10L))
+                .thenReturn(new FmsAccountSetDO().setId(1L));
+        when(voucherWordService.validateVoucherWordExists(1L, 11L))
+                .thenReturn(new FmsVoucherWordDO().setId(11L).setAccountSetId(1L).setName("记"));
+        when(voucherWordService.getVoucherWordList(1L)).thenReturn(Collections.singletonList(
+                new FmsVoucherWordDO().setId(11L).setAccountSetId(1L).setName("记")));
+        when(voucherWordService.getVoucherWordMapByName(1L)).thenReturn(Collections.singletonMap(
+                "记", new FmsVoucherWordDO().setId(11L).setAccountSetId(1L).setName("记")));
+        when(auxiliaryTypeService.getAuxiliaryTypeList(1L, 10L)).thenReturn(Collections.emptyList());
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(eq(1L), anyCollection()))
+                .thenReturn(Collections.emptyList());
+        when(auxiliaryItemService.getAuxiliaryItemListByAccountSetId(1L, 10L))
+                .thenReturn(Collections.emptyList());
+    }
+
+    @Test
+    public void testGetVoucherCountByVoucherWordId() {
+        // mock 数据
+        voucherMapper.insert(buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus()));
+        voucherMapper.insert(buildVoucher(2L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus()));
+
+        // 调用，并断言
+        assertEquals(1L, voucherService.getVoucherCountByVoucherWordId(1L, 11L));
+        assertEquals(0L, voucherService.getVoucherCountByVoucherWordId(1L, 12L));
+    }
+
+    @Test
+    public void testGetVoucherSubjectAmountList() {
+        // mock 数据
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(1L).setVoucherId(11L)
+                .setSubjectId(101L).setDebitAmount(new BigDecimal("10.00"))
+                .setCreditAmount(BigDecimal.ZERO));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(1L).setVoucherId(12L)
+                .setSubjectId(101L).setDebitAmount(new BigDecimal("20.00"))
+                .setCreditAmount(BigDecimal.ZERO));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(1L).setVoucherId(12L)
+                .setSubjectId(102L).setDebitAmount(BigDecimal.ZERO)
+                .setCreditAmount(new BigDecimal("30.00")));
+
+        // 调用
+        List<FmsVoucherSubjectAmountVO> result = voucherService.getVoucherSubjectAmountList(
+                Arrays.asList(11L, 12L));
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(0, new BigDecimal("30.00").compareTo(result.get(0).getDebitAmount()));
+        assertEquals(0, new BigDecimal("30.00").compareTo(result.get(1).getCreditAmount()));
+    }
+
+    @Test
+    public void testGetVoucherEntryCountByAuxiliary() {
+        // mock 数据
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(1L)
+                .setAuxiliaries(Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .typeId(31L).itemId(41L).build())));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(2L)
+                .setAuxiliaries(Collections.singletonList(FmsVoucherEntryDO.AuxiliaryItem.builder()
+                        .typeId(31L).itemId(41L).build())));
+
+        // 调用，并断言
+        assertEquals(1L, voucherService.getVoucherEntryCountByAuxiliaryItemIds(
+                1L, Collections.singletonList(41L)));
+        assertEquals(1L, voucherService.getVoucherEntryCountByAuxiliaryTypeId(1L, 31L));
+        assertEquals(0L, voucherService.getVoucherEntryCountByAuxiliaryItemIds(
+                1L, Collections.singletonList(42L)));
+        assertEquals(0L, voucherService.getVoucherEntryCountByAuxiliaryItemIds(
+                1L, Collections.emptyList()));
+    }
+
+    @Test
+    public void testMigrateVoucherEntryAuxiliaries() {
+        // mock 数据
+        FmsVoucherEntryDO entry = new FmsVoucherEntryDO().setAccountSetId(1L)
+                .setVoucherId(11L).setSubjectId(101L);
+        voucherEntryMapper.insert(entry);
+        FmsAuxiliaryCombinationDO combination = new FmsAuxiliaryCombinationDO().setId(51L)
+                .setItems(Collections.singletonList(FmsAuxiliaryCombinationDO.AuxiliaryItem.builder()
+                        .type(1).typeId(31L).itemId(41L).name("北京客户").build()));
+
+        // 调用
+        voucherService.migrateVoucherEntryAuxiliaries(1L, 101L, combination);
+
+        // 断言
+        FmsVoucherEntryDO result = voucherEntryMapper.selectById(entry.getId());
+        assertEquals(combination.getId(), result.getAssistCombinationId());
+        assertEquals(1, result.getAuxiliaries().size());
+        assertEquals(41L, result.getAuxiliaries().get(0).getItemId());
+        assertEquals("北京客户", result.getAuxiliaries().get(0).getName());
+    }
+
+    @Test
+    public void testGetVoucherEntryQuantityCountBySubjectIds() {
+        // mock 数据
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(1L)
+                .setSubjectId(101L).setQuantity(new BigDecimal("2.00")));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(1L)
+                .setSubjectId(101L).setQuantity(BigDecimal.ZERO));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setAccountSetId(1L)
+                .setSubjectId(102L).setQuantity(new BigDecimal("3.00")));
+
+        // 调用，并断言
+        assertEquals(1L, voucherService.getVoucherEntryQuantityCountBySubjectIds(
+                1L, Collections.singletonList(101L)));
+        assertEquals(2L, voucherService.getVoucherEntryQuantityCountBySubjectIds(
+                1L, Arrays.asList(101L, 102L)));
+    }
+
+    @Test
+    public void testCreateVoucher_success() {
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        reqVO.getEntries().get(0).setId(90001L);
+        reqVO.getEntries().get(1).setId(90002L);
+        reqVO.setVoucherTime(LocalDateTime.of(2026, 8, 2, 15, 30));
+        reqVO.setAttachmentCount(3);
+
+        // 调用
+        Long voucherId = voucherService.createVoucher(reqVO, 10L);
+
+        // 断言
+        FmsVoucherDO voucher = voucherMapper.selectById(voucherId);
+        assertEquals(1, voucher.getVoucherNumber());
+        assertEquals(LocalDateTime.of(2026, 8, 2, 0, 0), voucher.getVoucherTime());
+        assertEquals(new BigDecimal("100.00"), voucher.getDebitAmount());
+        assertEquals(new BigDecimal("100.00"), voucher.getCreditAmount());
+        assertEquals(3, voucher.getAttachmentCount());
+        assertEquals(FmsVoucherStatusEnum.PENDING_REVIEW.getStatus(), voucher.getStatus());
+        List<FmsVoucherEntryDO> entries = voucherEntryMapper.selectListByVoucherIds(
+                Collections.singletonList(voucherId));
+        assertEquals(2, entries.size());
+        assertFalse(entries.stream().anyMatch(
+                entry -> Arrays.asList(90001L, 90002L).contains(entry.getId())));
+    }
+
+    @Test
+    public void testCreateVoucher_negativeAmount() {
+        // 准备参数：红字分录保留在原借贷方向
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("-20.00", "-20.00");
+
+        // 调用
+        Long voucherId = voucherService.createVoucher(reqVO, 10L);
+
+        // 断言
+        FmsVoucherDO voucher = voucherMapper.selectById(voucherId);
+        assertEquals(new BigDecimal("-20.00"), voucher.getDebitAmount());
+        assertEquals(new BigDecimal("-20.00"), voucher.getCreditAmount());
+    }
+
+    @Test
+    public void testCreateVoucher_quantityAmountFloor() {
+        // mock 数据
+        bankSubject.setQuantityAccounting(true);
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("1.99", "1.99");
+        CollUtil.getFirst(reqVO.getEntries()).setQuantity(new BigDecimal("1"));
+        CollUtil.getFirst(reqVO.getEntries()).setUnitPrice(new BigDecimal("1.999"));
+
+        // 调用
+        Long voucherId = voucherService.createVoucher(reqVO, 10L);
+
+        // 断言
+        FmsVoucherEntryDO entry = CollUtil.getFirst(voucherEntryMapper.selectListByVoucherIds(
+                Collections.singletonList(voucherId)));
+        assertEquals(new BigDecimal("1.99"), entry.getDebitAmount());
+        assertEquals(0, new BigDecimal("1").compareTo(entry.getQuantity()));
+        assertEquals(0, new BigDecimal("1.999").compareTo(entry.getUnitPrice()));
+    }
+
+    @Test
+    public void testCreateVoucher_attachmentUrlsEmpty() {
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+
+        // 调用
+        Long voucherId = voucherService.createVoucher(reqVO, 10L);
+
+        // 断言
+        FmsVoucherDO voucher = voucherMapper.selectById(voucherId);
+        assertEquals(0, voucher.getAttachmentCount());
+        assertEquals(Collections.emptyList(), voucher.getAttachmentUrls());
+    }
+
+    @Test
+    public void testCreateVoucher_numberDuplicateInSameMonth() {
+        // mock 数据
+        voucherMapper.insert(buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus()));
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        reqVO.setVoucherNumber(1);
+        reqVO.setVoucherTime(LocalDateTime.of(2026, 8, 3, 0, 0));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.createVoucher(reqVO, 10L),
+                VOUCHER_NUMBER_DUPLICATE);
+    }
+
+    @Test
+    public void testCreateVoucher_sameNumberInNextMonth() {
+        // mock 数据
+        voucherMapper.insert(buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus()));
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        reqVO.setVoucherNumber(1);
+        reqVO.setVoucherTime(LocalDateTime.of(2026, 9, 1, 0, 0));
+
+        // 调用
+        Long voucherId = voucherService.createVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(1, voucherMapper.selectById(voucherId).getVoucherNumber());
+    }
+
+    @Test
+    public void testCreateVoucher_periodClosed() {
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        doThrow(exception(CLOSING_PERIOD_CLOSED)).when(closingPeriodService)
+                .validatePeriodOpen(1L, reqVO.getVoucherTime());
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.createVoucher(reqVO, 10L),
+                CLOSING_PERIOD_CLOSED);
+    }
+
+    @Test
+    public void testCreateVoucher_unbalanced() {
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "90.00");
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.createVoucher(reqVO, 10L),
+                VOUCHER_AMOUNT_UNBALANCED);
+    }
+
+    @Test
+    public void testCreateVoucher_auxiliarySnapshot() {
+        // mock 数据
+        bankSubject.setAuxiliaryTypeIds(Collections.singletonList(31L));
+        FmsAuxiliaryTypeDO auxiliaryType = new FmsAuxiliaryTypeDO().setId(31L)
+                .setAccountSetId(1L).setName("客户").setType(1);
+        FmsAuxiliaryItemDO auxiliaryItem = new FmsAuxiliaryItemDO().setId(41L)
+                .setAccountSetId(1L).setAuxiliaryTypeId(31L).setCode("KH001")
+                .setName("上海客户").setStatus(CommonStatusEnum.ENABLE.getStatus());
+        when(auxiliaryItemService.validateAuxiliaryItemList(eq(1L), anyCollection()))
+                .thenReturn(Collections.singletonList(auxiliaryItem));
+        when(auxiliaryTypeService.validateAuxiliaryTypeList(eq(1L), anyCollection()))
+                .thenReturn(Collections.singletonList(auxiliaryType));
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        FmsVoucherEntrySaveReqVO.AuxiliaryItem requestItem = new FmsVoucherEntrySaveReqVO.AuxiliaryItem();
+        requestItem.setTypeId(31L);
+        requestItem.setItemId(41L);
+        CollUtil.getFirst(reqVO.getEntries()).setAuxiliaries(Collections.singletonList(requestItem));
+
+        // 调用
+        Long voucherId = voucherService.createVoucher(reqVO, 10L);
+
+        // 断言
+        FmsVoucherEntryDO entry = CollUtil.getFirst(voucherEntryMapper
+                .selectListByVoucherIds(Collections.singletonList(voucherId)));
+        assertEquals("上海客户", CollUtil.getFirst(entry.getAuxiliaries()).getName());
+        assertEquals(31L, CollUtil.getFirst(entry.getAuxiliaries()).getTypeId());
+    }
+
+    @Test
+    public void testImportVoucher_success() {
+        // 准备参数
+        List<FmsVoucherImportExcelVO> rows = Arrays.asList(
+                buildImportRow(2, "1002", "采购材料", "100.00", null),
+                buildImportRow(3, "2202", "采购材料", null, "100.00"));
+
+        // 调用
+        FmsVoucherImportRespVO result = voucherService.importVoucher(1L, rows, 10L);
+
+        // 断言
+        assertEquals(1, result.getSuccessVoucherCount());
+        assertEquals(2, result.getSuccessRowCount());
+        assertEquals(0, result.getFailureVoucherCount());
+        FmsVoucherDO voucher = CollUtil.getFirst(voucherMapper.selectList());
+        assertEquals(2, voucher.getAttachmentCount());
+        assertEquals(2, voucherEntryMapper.selectListByVoucherIds(
+                Collections.singletonList(voucher.getId())).size());
+    }
+
+    @Test
+    public void testImportVoucher_negativeAmount() {
+        // 准备参数：导入红字凭证时借贷方向保持不变
+        List<FmsVoucherImportExcelVO> rows = Arrays.asList(
+                buildImportRow(2, "1002", "红字冲销", "-20.00", null),
+                buildImportRow(3, "2202", "红字冲销", null, "-20.00"));
+
+        // 调用
+        FmsVoucherImportRespVO result = voucherService.importVoucher(1L, rows, 10L);
+
+        // 断言
+        assertEquals(1, result.getSuccessVoucherCount());
+        assertEquals(0, result.getFailureVoucherCount());
+        FmsVoucherDO voucher = CollUtil.getFirst(voucherMapper.selectList());
+        assertEquals(new BigDecimal("-20.00"), voucher.getDebitAmount());
+        assertEquals(new BigDecimal("-20.00"), voucher.getCreditAmount());
+    }
+
+    @Test
+    public void testImportVoucher_quantityAmountFloor() {
+        // mock 数据
+        bankSubject.setQuantityAccounting(true);
+        // 准备参数
+        FmsVoucherImportExcelVO debitRow = buildImportRow(2, "1002", "采购材料", "1.99", null)
+                .setQuantity(new BigDecimal("1")).setUnitPrice(new BigDecimal("1.999"));
+        List<FmsVoucherImportExcelVO> rows = Arrays.asList(debitRow,
+                buildImportRow(3, "2202", "采购材料", null, "1.99"));
+
+        // 调用
+        FmsVoucherImportRespVO result = voucherService.importVoucher(1L, rows, 10L);
+
+        // 断言
+        assertEquals(1, result.getSuccessVoucherCount());
+        assertEquals(0, result.getFailureVoucherCount());
+    }
+
+    @Test
+    public void testImportVoucher_partialSuccess() {
+        // mock 数据
+        voucherMapper.insert(buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(2).setVoucherTime(LocalDateTime.of(2026, 8, 1, 0, 0)));
+        // 准备参数
+        List<FmsVoucherImportExcelVO> rows = Arrays.asList(
+                buildImportRow(2, "1002", "有效凭证", "100.00", null).setVoucherNumber(1),
+                buildImportRow(3, "2202", "有效凭证", null, "100.00").setVoucherNumber(1),
+                buildImportRow(4, "1002", "重复凭证", "80.00", null).setVoucherNumber(2),
+                buildImportRow(5, "2202", "重复凭证", null, "80.00").setVoucherNumber(2));
+
+        // 调用
+        FmsVoucherImportRespVO result = voucherService.importVoucher(1L, rows, 10L);
+
+        // 断言
+        assertEquals(1, result.getSuccessVoucherCount());
+        assertEquals(1, result.getFailureVoucherCount());
+        assertEquals(2, result.getFailureRowCount());
+        assertTrue(result.getErrorRows().stream().allMatch(row ->
+                row.getErrors().contains("同一会计期间、凭证字和凭证号已存在")));
+    }
+
+    @Test
+    public void testImportVoucher_duplicateInSameMonth() {
+        // 准备参数
+        List<FmsVoucherImportExcelVO> rows = Arrays.asList(
+                buildImportRow(2, "1002", "月初凭证", "100.00", null),
+                buildImportRow(3, "2202", "月初凭证", null, "100.00"),
+                buildImportRow(4, "1002", "月末凭证", "80.00", null)
+                        .setVoucherTime(LocalDateTime.of(2026, 8, 31, 0, 0)),
+                buildImportRow(5, "2202", "月末凭证", null, "80.00")
+                        .setVoucherTime(LocalDateTime.of(2026, 8, 31, 0, 0)));
+
+        // 调用
+        FmsVoucherImportRespVO result = voucherService.importVoucher(1L, rows, 10L);
+
+        // 断言
+        assertEquals(1, result.getSuccessVoucherCount());
+        assertEquals(1, result.getFailureVoucherCount());
+        assertEquals(2, result.getFailureRowCount());
+        assertTrue(result.getErrorRows().stream().allMatch(row ->
+                row.getErrors().contains("同一会计期间、凭证字和凭证号重复")));
+    }
+
+    @Test
+    public void testImportVoucher_auxiliary() {
+        // mock 数据
+        bankSubject.setAuxiliaryTypeIds(Collections.singletonList(31L));
+        FmsAuxiliaryTypeDO auxiliaryType = new FmsAuxiliaryTypeDO().setId(31L)
+                .setAccountSetId(1L).setName("客户").setType(1);
+        FmsAuxiliaryItemDO auxiliaryItem = new FmsAuxiliaryItemDO().setId(41L)
+                .setAccountSetId(1L).setAuxiliaryTypeId(31L).setCode("KH001")
+                .setName("上海客户").setStatus(CommonStatusEnum.ENABLE.getStatus());
+        when(auxiliaryTypeService.getAuxiliaryTypeList(1L, 10L))
+                .thenReturn(Collections.singletonList(auxiliaryType));
+        when(auxiliaryItemService.getAuxiliaryItemListByAccountSetId(1L, 10L))
+                .thenReturn(Collections.singletonList(auxiliaryItem));
+        when(auxiliaryTypeService.getAuxiliaryTypeMap(1L, 10L))
+                .thenReturn(Collections.singletonMap(31L, auxiliaryType));
+        when(auxiliaryItemService.getAuxiliaryItemMapByTypeIdAndCode(1L, 10L))
+                .thenReturn(Collections.singletonMap("31|KH001", auxiliaryItem));
+        // 准备参数
+        FmsVoucherImportExcelVO debitRow = buildImportRow(2, "1002", "采购材料", "100.00", null);
+        debitRow.getAuxiliaryCodes().put(31L, "KH001");
+
+        // 调用
+        FmsVoucherImportRespVO result = voucherService.importVoucher(1L, Arrays.asList(
+                debitRow, buildImportRow(3, "2202", "采购材料", null, "100.00")), 10L);
+
+        // 断言
+        assertEquals(1, result.getSuccessVoucherCount());
+        FmsVoucherDO voucher = CollUtil.getFirst(voucherMapper.selectList());
+        FmsVoucherEntryDO entry = CollUtil.getFirst(voucherEntryMapper.selectListByVoucherIds(
+                Collections.singletonList(voucher.getId())));
+        assertEquals("上海客户", CollUtil.getFirst(entry.getAuxiliaries()).getName());
+    }
+
+    @Test
+    public void testDeleteVoucherList_approved() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.APPROVED.getStatus());
+        voucherMapper.insert(voucher);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.deleteVoucherList(
+                1L, Collections.singletonList(voucher.getId()), 10L), VOUCHER_APPROVED_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testDeleteVoucherList_reusedVoucherNumber() {
+        // mock 数据
+        FmsVoucherDO firstVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(firstVoucher);
+        voucherService.deleteVoucherList(1L, Collections.singletonList(firstVoucher.getId()), 10L);
+        FmsVoucherDO secondVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(secondVoucher);
+
+        // 调用
+        voucherService.deleteVoucherList(1L, Collections.singletonList(secondVoucher.getId()), 10L);
+
+        // 断言
+        assertNull(voucherMapper.selectById(secondVoucher.getId()));
+    }
+
+    @Test
+    public void testUpdateVoucher_closingGenerated() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(voucher);
+        when(closingVoucherService.getClosingVoucherIdSet(
+                1L, Collections.singletonList(voucher.getId())))
+                .thenReturn(Collections.singleton(voucher.getId()));
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        reqVO.setId(voucher.getId());
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.updateVoucher(reqVO, 10L),
+                VOUCHER_CLOSING_GENERATED_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testUpdateVoucher_attachmentCount() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setAttachmentUrls(Collections.singletonList("/admin-api/infra/file/4/get"))
+                .setAttachmentCount(1);
+        voucherMapper.insert(voucher);
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        reqVO.setId(voucher.getId());
+        reqVO.setAttachmentCount(3);
+
+        // 调用
+        voucherService.updateVoucher(reqVO, 10L);
+
+        // 断言
+        FmsVoucherDO actual = voucherMapper.selectById(voucher.getId());
+        assertEquals(3, actual.getAttachmentCount());
+        assertEquals(Collections.singletonList("/admin-api/infra/file/4/get"), actual.getAttachmentUrls());
+    }
+
+    @Test
+    public void testUpdateVoucher_attachmentCountZero() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setAttachmentUrls(Collections.singletonList("/admin-api/infra/file/4/get"))
+                .setAttachmentCount(1);
+        voucherMapper.insert(voucher);
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        reqVO.setId(voucher.getId());
+
+        // 调用
+        voucherService.updateVoucher(reqVO, 10L);
+
+        // 断言
+        FmsVoucherDO actual = voucherMapper.selectById(voucher.getId());
+        assertEquals(0, actual.getAttachmentCount());
+        assertEquals(Collections.singletonList("/admin-api/infra/file/4/get"), actual.getAttachmentUrls());
+    }
+
+    @Test
+    public void testUpdateVoucher_diffEntries() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(voucher);
+        FmsVoucherEntryDO debitEntry = new FmsVoucherEntryDO().setAccountSetId(1L).setVoucherId(voucher.getId())
+                .setDigest("原借方摘要").setSubjectId(101L).setSubjectCode("1001").setSubjectName("库存现金")
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setDebitAmount(new BigDecimal("100.00")).setCreditAmount(BigDecimal.ZERO)
+                .setSort(1).setAuxiliaries(Collections.emptyList());
+        FmsVoucherEntryDO creditEntry = new FmsVoucherEntryDO().setAccountSetId(1L).setVoucherId(voucher.getId())
+                .setDigest("原贷方摘要").setSubjectId(201L).setSubjectCode("2202").setSubjectName("应付账款")
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setDebitAmount(BigDecimal.ZERO).setCreditAmount(new BigDecimal("100.00"))
+                .setSort(2).setAuxiliaries(Collections.emptyList());
+        voucherEntryMapper.insertBatch(Arrays.asList(debitEntry, creditEntry));
+        // 准备参数
+        FmsVoucherSaveReqVO reqVO = buildSaveReqVO("100.00", "100.00");
+        reqVO.setId(voucher.getId());
+        reqVO.getEntries().get(0).setId(debitEntry.getId());
+        reqVO.getEntries().get(0).setDigest("新借方摘要");
+        reqVO.getEntries().get(1).setId(creditEntry.getId());
+
+        // 调用
+        voucherService.updateVoucher(reqVO, 10L);
+
+        // 断言
+        List<FmsVoucherEntryDO> entries = voucherEntryMapper.selectListByVoucherIds(
+                Collections.singletonList(voucher.getId()));
+        assertEquals(Arrays.asList(debitEntry.getId(), creditEntry.getId()),
+                Arrays.asList(entries.get(0).getId(), entries.get(1).getId()));
+        assertEquals("新借方摘要", entries.get(0).getDigest());
+    }
+
+    @Test
+    public void testUpdateVoucherAttachments_success() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setAttachmentCount(3);
+        voucherMapper.insert(voucher);
+        // 准备参数
+        FmsVoucherAttachmentUpdateReqVO reqVO = new FmsVoucherAttachmentUpdateReqVO();
+        reqVO.setId(voucher.getId());
+        reqVO.setAccountSetId(1L);
+        reqVO.setAttachmentUrls(Arrays.asList(
+                "/admin-api/infra/file/4/get", "/admin-api/infra/file/5/get"));
+
+        // 调用
+        voucherService.updateVoucherAttachments(reqVO, 10L);
+
+        // 断言
+        FmsVoucherDO actual = voucherMapper.selectById(voucher.getId());
+        assertEquals(Arrays.asList("/admin-api/infra/file/4/get", "/admin-api/infra/file/5/get"),
+                actual.getAttachmentUrls());
+        assertEquals(3, actual.getAttachmentCount());
+    }
+
+    @Test
+    public void testUpdateVoucherAttachments_accountSetAccessDenied() {
+        // 准备参数
+        FmsVoucherAttachmentUpdateReqVO reqVO = new FmsVoucherAttachmentUpdateReqVO();
+        reqVO.setId(1L);
+        reqVO.setAccountSetId(1L);
+        reqVO.setAttachmentUrls(Collections.singletonList("/admin-api/infra/file/4/get"));
+        // mock 方法
+        doThrow(exception(ACCOUNT_SET_ACCESS_DENIED)).when(accountSetService)
+                .validateAccountSetWritePermission(1L, 10L);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.updateVoucherAttachments(reqVO, 10L),
+                ACCOUNT_SET_ACCESS_DENIED);
+    }
+
+    @Test
+    public void testUpdateVoucherAttachments_approved() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.APPROVED.getStatus());
+        voucherMapper.insert(voucher);
+        // 准备参数
+        FmsVoucherAttachmentUpdateReqVO reqVO = new FmsVoucherAttachmentUpdateReqVO();
+        reqVO.setId(voucher.getId());
+        reqVO.setAccountSetId(1L);
+        reqVO.setAttachmentUrls(Collections.singletonList("/admin-api/infra/file/4/get"));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.updateVoucherAttachments(reqVO, 10L),
+                VOUCHER_APPROVED_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testDeleteVoucherList_closingGenerated() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(voucher);
+        when(closingVoucherService.getClosingVoucherIdSet(
+                1L, Collections.singletonList(voucher.getId())))
+                .thenReturn(Collections.singleton(voucher.getId()));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.deleteVoucherList(
+                1L, Collections.singletonList(voucher.getId()), 10L),
+                VOUCHER_CLOSING_GENERATED_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testUpdateVoucherReviewStatus_closingGenerated() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(voucher);
+        when(closingVoucherService.getClosingVoucherIdSet(
+                1L, Collections.singletonList(voucher.getId())))
+                .thenReturn(Collections.singleton(voucher.getId()));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.updateVoucherReviewStatus(
+                1L, Collections.singletonList(voucher.getId()),
+                FmsVoucherStatusEnum.APPROVED.getStatus(), 10L),
+                VOUCHER_CLOSING_GENERATED_NOT_EDITABLE);
+    }
+
+    @Test
+    public void testUpdateVoucherReviewStatus_success() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(voucher);
+
+        // 调用，并断言
+        voucherService.updateVoucherReviewStatus(1L, Collections.singletonList(voucher.getId()),
+                FmsVoucherStatusEnum.APPROVED.getStatus(), 10L);
+        assertEquals(10L, voucherMapper.selectById(voucher.getId()).getReviewerUserId());
+        voucherService.updateVoucherReviewStatus(1L, Collections.singletonList(voucher.getId()),
+                FmsVoucherStatusEnum.PENDING_REVIEW.getStatus(), 10L);
+        assertNull(voucherMapper.selectById(voucher.getId()).getReviewerUserId());
+    }
+
+    @Test
+    public void testTidyVoucher_fillGaps() {
+        // mock 数据
+        FmsVoucherDO first = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1).setVoucherTime(LocalDateTime.of(2026, 8, 1, 0, 0));
+        FmsVoucherDO second = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(3).setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0));
+        FmsVoucherDO third = buildVoucher(1L, FmsVoucherStatusEnum.APPROVED.getStatus())
+                .setVoucherNumber(5).setVoucherTime(LocalDateTime.of(2026, 8, 3, 0, 0))
+                .setReviewerUserId(99L);
+        voucherMapper.insert(first);
+        voucherMapper.insert(second);
+        voucherMapper.insert(third);
+        // 准备参数
+        FmsVoucherTidyReqVO reqVO = buildTidyReqVO(
+                11L, 2, FmsVoucherTidyTypeEnum.FILL_GAPS.getType());
+
+        // 调用
+        voucherService.tidyVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(1, voucherMapper.selectById(first.getId()).getVoucherNumber());
+        assertEquals(2, voucherMapper.selectById(second.getId()).getVoucherNumber());
+        assertEquals(3, voucherMapper.selectById(third.getId()).getVoucherNumber());
+        assertEquals(99L, voucherMapper.selectById(third.getId()).getReviewerUserId());
+    }
+
+    @Test
+    public void testTidyVoucher_reorderByTime() {
+        // mock 数据
+        FmsVoucherDO first = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1).setVoucherTime(LocalDateTime.of(2026, 8, 3, 0, 0));
+        FmsVoucherDO second = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(2).setVoucherTime(LocalDateTime.of(2026, 8, 1, 0, 0));
+        FmsVoucherDO third = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(3).setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0));
+        voucherMapper.insert(first);
+        voucherMapper.insert(second);
+        voucherMapper.insert(third);
+        // 准备参数
+        FmsVoucherTidyReqVO reqVO = buildTidyReqVO(
+                11L, 1, FmsVoucherTidyTypeEnum.REORDER_BY_TIME.getType());
+
+        // 调用
+        voucherService.tidyVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(3, voucherMapper.selectById(first.getId()).getVoucherNumber());
+        assertEquals(1, voucherMapper.selectById(second.getId()).getVoucherNumber());
+        assertEquals(2, voucherMapper.selectById(third.getId()).getVoucherNumber());
+    }
+
+    @Test
+    public void testTidyVoucher_allWordsIndependent() {
+        // mock 数据
+        FmsVoucherDO firstWordVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherWordId(11L).setVoucherNumber(4);
+        FmsVoucherDO secondWordVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherWordId(12L).setVoucherNumber(7);
+        voucherMapper.insert(firstWordVoucher);
+        voucherMapper.insert(secondWordVoucher);
+        // 准备参数
+        FmsVoucherTidyReqVO reqVO = buildTidyReqVO(
+                null, 2, FmsVoucherTidyTypeEnum.FILL_GAPS.getType());
+
+        // 调用
+        voucherService.tidyVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(2, voucherMapper.selectById(firstWordVoucher.getId()).getVoucherNumber());
+        assertEquals(2, voucherMapper.selectById(secondWordVoucher.getId()).getVoucherNumber());
+    }
+
+    @Test
+    public void testTidyVoucher_periodClosed() {
+        // 准备参数
+        FmsVoucherTidyReqVO reqVO = buildTidyReqVO(
+                11L, 1, FmsVoucherTidyTypeEnum.FILL_GAPS.getType());
+        doThrow(exception(CLOSING_PERIOD_CLOSED)).when(closingPeriodService)
+                .validatePeriodOpen(1L, LocalDateTime.of(2026, 8, 1, 0, 0));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.tidyVoucher(reqVO, 10L),
+                CLOSING_PERIOD_CLOSED);
+    }
+
+    @Test
+    public void testMoveVoucher_success() {
+        // mock 数据
+        FmsVoucherDO first = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1);
+        FmsVoucherDO second = buildVoucher(1L, FmsVoucherStatusEnum.APPROVED.getStatus())
+                .setVoucherNumber(2).setReviewerUserId(99L);
+        FmsVoucherDO third = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(3);
+        FmsVoucherDO fourth = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(4);
+        FmsVoucherDO fifth = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(5);
+        voucherMapper.insert(first);
+        voucherMapper.insert(second);
+        voucherMapper.insert(third);
+        voucherMapper.insert(fourth);
+        voucherMapper.insert(fifth);
+        // 准备参数
+        FmsVoucherMoveReqVO reqVO = buildMoveReqVO(5, 2);
+
+        // 调用
+        voucherService.moveVoucher(reqVO, 10L);
+
+        // 断言
+        assertEquals(1, voucherMapper.selectById(first.getId()).getVoucherNumber());
+        assertEquals(3, voucherMapper.selectById(second.getId()).getVoucherNumber());
+        assertEquals(99L, voucherMapper.selectById(second.getId()).getReviewerUserId());
+        assertEquals(4, voucherMapper.selectById(third.getId()).getVoucherNumber());
+        assertEquals(5, voucherMapper.selectById(fourth.getId()).getVoucherNumber());
+        assertEquals(2, voucherMapper.selectById(fifth.getId()).getVoucherNumber());
+    }
+
+    @Test
+    public void testMoveVoucher_rangeInvalid() {
+        // 准备参数
+        FmsVoucherMoveReqVO reqVO = buildMoveReqVO(2, 2);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.moveVoucher(reqVO, 10L),
+                VOUCHER_MOVE_RANGE_INVALID);
+    }
+
+    @Test
+    public void testMoveVoucher_sourceNotExists() {
+        // mock 数据
+        voucherMapper.insert(buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(2));
+        // 准备参数
+        FmsVoucherMoveReqVO reqVO = buildMoveReqVO(5, 2);
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.moveVoucher(reqVO, 10L),
+                VOUCHER_MOVE_SOURCE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testMoveVoucher_periodClosed() {
+        // 准备参数
+        FmsVoucherMoveReqVO reqVO = buildMoveReqVO(5, 2);
+        doThrow(exception(CLOSING_PERIOD_CLOSED)).when(closingPeriodService)
+                .validatePeriodOpen(1L, LocalDateTime.of(2026, 8, 1, 0, 0));
+
+        // 调用，并断言
+        assertServiceException(() -> voucherService.moveVoucher(reqVO, 10L),
+                CLOSING_PERIOD_CLOSED);
+    }
+
+    @Test
+    public void testGetVoucherPage_digest() {
+        // mock 数据
+        FmsVoucherDO first = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        first.setVoucherNumber(1);
+        voucherMapper.insert(first);
+        FmsVoucherDO second = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        second.setVoucherNumber(2);
+        voucherMapper.insert(second);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(first.getId()).setAccountSetId(1L)
+                .setDigest("购买办公用品").setSubjectId(101L).setSubjectCode("1001")
+                .setSubjectName("库存现金").setSort(1).setQuantity(BigDecimal.ZERO)
+                .setUnitPrice(BigDecimal.ZERO).setDebitAmount(new BigDecimal("100.00"))
+                .setCreditAmount(BigDecimal.ZERO).setAuxiliaries(Collections.emptyList()));
+        // 准备参数
+        FmsVoucherPageReqVO reqVO = new FmsVoucherPageReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setDigest("办公");
+
+        // 调用
+        PageResult<FmsVoucherDO> pageResult = voucherService.getVoucherPage(reqVO, 10L);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(first.getId(), CollUtil.getFirst(pageResult.getList()).getId());
+    }
+
+    @Test
+    public void testGetVoucherPage_parentSubject() {
+        // mock 数据
+        FmsVoucherDO childVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1);
+        voucherMapper.insert(childVoucher);
+        FmsVoucherDO otherVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(2);
+        voucherMapper.insert(otherVoucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(childVoucher.getId()).setAccountSetId(1L)
+                .setDigest("子科目分录").setSubjectId(101L).setSubjectCode("100101")
+                .setSubjectName("人民币现金").setSort(1).setQuantity(BigDecimal.ZERO)
+                .setUnitPrice(BigDecimal.ZERO).setDebitAmount(new BigDecimal("100.00"))
+                .setCreditAmount(BigDecimal.ZERO).setAuxiliaries(Collections.emptyList()));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(otherVoucher.getId()).setAccountSetId(1L)
+                .setDigest("其他科目分录").setSubjectId(201L).setSubjectCode("2202")
+                .setSubjectName("应付账款").setSort(1).setQuantity(BigDecimal.ZERO)
+                .setUnitPrice(BigDecimal.ZERO).setDebitAmount(new BigDecimal("100.00"))
+                .setCreditAmount(BigDecimal.ZERO).setAuxiliaries(Collections.emptyList()));
+        when(subjectService.getSubjectIdListWithChildren(1L, 100L))
+                .thenReturn(Arrays.asList(100L, 101L));
+        // 准备参数
+        FmsVoucherPageReqVO reqVO = new FmsVoucherPageReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setSubjectId(100L);
+
+        // 调用
+        PageResult<FmsVoucherDO> pageResult = voucherService.getVoucherPage(reqVO, 10L);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(childVoucher.getId(), CollUtil.getFirst(pageResult.getList()).getId());
+    }
+
+    @Test
+    public void testGetVoucherPage_entryAmount() {
+        // mock 数据
+        FmsVoucherDO matchingVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1).setDebitAmount(new BigDecimal("250.00"))
+                .setCreditAmount(new BigDecimal("250.00")).setTotal(new BigDecimal("250.00"));
+        voucherMapper.insert(matchingVoucher);
+        FmsVoucherDO otherVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(2);
+        voucherMapper.insert(otherVoucher);
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(matchingVoucher.getId()).setAccountSetId(1L)
+                .setDigest("匹配分录").setSubjectId(101L).setSubjectCode("1001")
+                .setSubjectName("库存现金").setSort(1).setQuantity(BigDecimal.ZERO)
+                .setUnitPrice(BigDecimal.ZERO).setDebitAmount(new BigDecimal("100.00"))
+                .setCreditAmount(BigDecimal.ZERO).setAuxiliaries(Collections.emptyList()));
+        voucherEntryMapper.insert(new FmsVoucherEntryDO().setVoucherId(otherVoucher.getId()).setAccountSetId(1L)
+                .setDigest("不匹配分录").setSubjectId(101L).setSubjectCode("1001")
+                .setSubjectName("库存现金").setSort(1).setQuantity(BigDecimal.ZERO)
+                .setUnitPrice(BigDecimal.ZERO).setDebitAmount(new BigDecimal("300.00"))
+                .setCreditAmount(BigDecimal.ZERO).setAuxiliaries(Collections.emptyList()));
+        // 准备参数
+        FmsVoucherPageReqVO reqVO = new FmsVoucherPageReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMinAmount(new BigDecimal("90.00"));
+        reqVO.setMaxAmount(new BigDecimal("110.00"));
+
+        // 调用
+        PageResult<FmsVoucherDO> pageResult = voucherService.getVoucherPage(reqVO, 10L);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(matchingVoucher.getId(), CollUtil.getFirst(pageResult.getList()).getId());
+    }
+
+    @Test
+    public void testGetVoucherPage_ids() {
+        // mock 数据
+        FmsVoucherDO first = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1);
+        FmsVoucherDO second = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(2);
+        voucherMapper.insert(first);
+        voucherMapper.insert(second);
+        // 准备参数
+        FmsVoucherPageReqVO reqVO = new FmsVoucherPageReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setIds(Collections.singletonList(second.getId()));
+
+        // 调用
+        PageResult<FmsVoucherDO> pageResult = voucherService.getVoucherPage(reqVO, 10L);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(second.getId(), CollUtil.getFirst(pageResult.getList()).getId());
+    }
+
+    @Test
+    public void testGetVoucherPage_orderByTimeAndNumberAsc() {
+        // mock 数据
+        FmsVoucherDO laterVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1).setVoucherTime(LocalDateTime.of(2026, 8, 3, 0, 0));
+        FmsVoucherDO secondVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(2).setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0));
+        FmsVoucherDO firstVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherNumber(1).setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0));
+        voucherMapper.insert(laterVoucher);
+        voucherMapper.insert(secondVoucher);
+        voucherMapper.insert(firstVoucher);
+        // 准备参数
+        FmsVoucherPageReqVO reqVO = new FmsVoucherPageReqVO().setAccountSetId(1L);
+
+        // 调用
+        PageResult<FmsVoucherDO> pageResult = voucherService.getVoucherPage(reqVO, 10L);
+
+        // 断言
+        assertEquals(Arrays.asList(firstVoucher.getId(), secondVoucher.getId(), laterVoucher.getId()),
+                pageResult.getList().stream().map(FmsVoucherDO::getId).collect(Collectors.toList()));
+    }
+
+    @Test
+    public void testGetVoucherStatisticsList_parentIncludesChild() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherWordId(11L).setVoucherNumber(1);
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(buildVoucherEntry(voucher.getId(), cashChildSubject,
+                new BigDecimal("80.00"), BigDecimal.ZERO));
+        voucherEntryMapper.insert(buildVoucherEntry(voucher.getId(), bankSubject,
+                BigDecimal.ZERO, new BigDecimal("80.00")));
+        FmsVoucherDO ignoredVoucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus())
+                .setVoucherWordId(12L).setVoucherNumber(2)
+                .setVoucherTime(LocalDateTime.of(2026, 9, 2, 0, 0));
+        voucherMapper.insert(ignoredVoucher);
+        voucherEntryMapper.insert(buildVoucherEntry(ignoredVoucher.getId(), cashChildSubject,
+                new BigDecimal("20.00"), BigDecimal.ZERO));
+        // 准备参数
+        FmsVoucherStatisticsReqVO reqVO = buildStatisticsReqVO();
+        reqVO.setVoucherWordId(11L).setMinVoucherNumber(1).setMaxVoucherNumber(1);
+
+        // 调用
+        List<FmsVoucherStatisticsRespVO> result = voucherService.getVoucherStatisticsList(reqVO, 10L);
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(cashSubject.getId(), result.get(0).getSubjectId());
+        assertEquals(new BigDecimal("80.00"), result.get(0).getDebitAmount());
+        assertEquals(bankSubject.getId(), result.get(1).getSubjectId());
+        assertEquals(new BigDecimal("80.00"), result.get(1).getCreditAmount());
+    }
+
+    @Test
+    public void testGetVoucherStatisticsList_filterLevel() {
+        // mock 数据
+        FmsVoucherDO voucher = buildVoucher(1L, FmsVoucherStatusEnum.PENDING_REVIEW.getStatus());
+        voucherMapper.insert(voucher);
+        voucherEntryMapper.insert(buildVoucherEntry(voucher.getId(), cashChildSubject,
+                new BigDecimal("80.00"), BigDecimal.ZERO));
+        // 准备参数
+        FmsVoucherStatisticsReqVO reqVO = buildStatisticsReqVO();
+        reqVO.setMinLevel(2).setMaxLevel(2);
+
+        // 调用
+        List<FmsVoucherStatisticsRespVO> result = voucherService.getVoucherStatisticsList(reqVO, 10L);
+
+        // 断言
+        assertEquals(1, result.size());
+        assertEquals(cashChildSubject.getId(), result.get(0).getSubjectId());
+        assertEquals(new BigDecimal("80.00"), result.get(0).getDebitAmount());
+    }
+
+    @Test
+    public void testGetVoucherStatisticsList_periodInvalid() {
+        // 准备参数
+        FmsVoucherStatisticsReqVO reqVO = buildStatisticsReqVO();
+        reqVO.setStartMonth("2026-09").setEndMonth("2026-08");
+
+        // 调用，并断言异常
+        assertServiceException(() -> voucherService.getVoucherStatisticsList(reqVO, 10L),
+                LEDGER_PERIOD_INVALID);
+    }
+
+    @Test
+    public void testGetVoucherStatisticsList_rangeInvalid() {
+        // 准备参数
+        FmsVoucherStatisticsReqVO reqVO = buildStatisticsReqVO();
+        reqVO.setMinVoucherNumber(2).setMaxVoucherNumber(1);
+
+        // 调用，并断言异常
+        assertServiceException(() -> voucherService.getVoucherStatisticsList(reqVO, 10L),
+                VOUCHER_STATISTICS_RANGE_INVALID);
+    }
+
+    // ========== 随机对象 ==========
+
+    private FmsVoucherSaveReqVO buildSaveReqVO(String debitAmount, String creditAmount) {
+        FmsVoucherSaveReqVO reqVO = new FmsVoucherSaveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setVoucherWordId(11L);
+        reqVO.setVoucherNumber(1);
+        reqVO.setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0));
+        reqVO.setAttachmentCount(0);
+        reqVO.setEntries(Arrays.asList(
+                buildEntry("采购材料", bankSubject.getId(), debitAmount, null),
+                buildEntry("采购材料", payableSubject.getId(), null, creditAmount)));
+        return reqVO;
+    }
+
+    private FmsVoucherStatisticsReqVO buildStatisticsReqVO() {
+        return new FmsVoucherStatisticsReqVO().setAccountSetId(1L)
+                .setStartMonth("2026-08").setEndMonth("2026-08").setMinLevel(1).setMaxLevel(1);
+    }
+
+    private FmsVoucherImportExcelVO buildImportRow(Integer rowNumber, String subjectCode,
+            String digest, String debitAmount, String creditAmount) {
+        return new FmsVoucherImportExcelVO().setRowNumber(rowNumber)
+                .setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0)).setVoucherWordName("记")
+                .setVoucherNumber(1).setAttachmentCount(2).setSubjectCode(subjectCode)
+                .setDigest(digest)
+                .setDebitAmount(debitAmount == null ? null : new BigDecimal(debitAmount))
+                .setCreditAmount(creditAmount == null ? null : new BigDecimal(creditAmount));
+    }
+
+    private FmsVoucherTidyReqVO buildTidyReqVO(
+            Long voucherWordId, Integer startNumber, Integer type) {
+        FmsVoucherTidyReqVO reqVO = new FmsVoucherTidyReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+        reqVO.setVoucherWordId(voucherWordId);
+        reqVO.setStartNumber(startNumber);
+        reqVO.setType(type);
+        return reqVO;
+    }
+
+    private FmsVoucherMoveReqVO buildMoveReqVO(Integer sourceNumber, Integer targetNumber) {
+        FmsVoucherMoveReqVO reqVO = new FmsVoucherMoveReqVO();
+        reqVO.setAccountSetId(1L);
+        reqVO.setMonth("2026-08");
+        reqVO.setVoucherWordId(11L);
+        reqVO.setSourceNumber(sourceNumber);
+        reqVO.setTargetNumber(targetNumber);
+        return reqVO;
+    }
+
+    private FmsVoucherEntrySaveReqVO buildEntry(
+            String digest, Long subjectId, String debitAmount, String creditAmount) {
+        FmsVoucherEntrySaveReqVO entry = new FmsVoucherEntrySaveReqVO();
+        entry.setDigest(digest);
+        entry.setSubjectId(subjectId);
+        entry.setDebitAmount(debitAmount == null ? null : new BigDecimal(debitAmount));
+        entry.setCreditAmount(creditAmount == null ? null : new BigDecimal(creditAmount));
+        entry.setAuxiliaries(Collections.emptyList());
+        return entry;
+    }
+
+    private FmsSubjectDO buildSubject(Long id, String code, String name) {
+        return randomPojo(FmsSubjectDO.class, subject -> subject.setId(id).setAccountSetId(1L)
+                .setCode(code).setName(name).setParentId(FmsSubjectDO.PARENT_ID_ROOT).setLevel(1)
+                .setStatus(CommonStatusEnum.ENABLE.getStatus()).setQuantityAccounting(false)
+                .setAuxiliaryTypeIds(Collections.emptyList()).setCurrencyIds(Collections.emptyList()));
+    }
+
+    private FmsVoucherEntryDO buildVoucherEntry(Long voucherId, FmsSubjectDO subject,
+            BigDecimal debitAmount, BigDecimal creditAmount) {
+        return randomPojo(FmsVoucherEntryDO.class, entry -> entry.setId(null)
+                .setVoucherId(voucherId).setAccountSetId(1L).setSubjectId(subject.getId())
+                .setSubjectCode(subject.getCode()).setSubjectName(subject.getName()).setDigest("测试摘要")
+                .setSort(1).setDebitAmount(debitAmount).setCreditAmount(creditAmount)
+                .setQuantity(BigDecimal.ZERO).setUnitPrice(BigDecimal.ZERO)
+                .setAssistCombinationId(null).setAuxiliaries(Collections.emptyList()));
+    }
+
+    private FmsVoucherDO buildVoucher(Long accountSetId, Integer status) {
+        return new FmsVoucherDO().setAccountSetId(accountSetId).setVoucherWordId(11L)
+                .setVoucherNumber(1).setVoucherTime(LocalDateTime.of(2026, 8, 2, 0, 0))
+                .setAttachmentUrls(Collections.emptyList()).setDebitAmount(new BigDecimal("100.00"))
+                .setCreditAmount(new BigDecimal("100.00")).setTotal(new BigDecimal("100.00")).setStatus(status);
+    }
+
+}
diff --git a/yudao-module-fms/src/test/resources/application-unit-test.yaml b/yudao-module-fms/src/test/resources/application-unit-test.yaml
new file mode 100644
index 0000000..f0fcc54
--- /dev/null
+++ b/yudao-module-fms/src/test/resources/application-unit-test.yaml
@@ -0,0 +1,36 @@
+spring:
+  main:
+    lazy-initialization: true
+    banner-mode: off
+    allow-bean-definition-overriding: true
+
+--- #################### 数据库相关配置 ####################
+
+spring:
+  datasource:
+    name: ruoyi-vue-pro
+    url: jdbc:h2:mem:testdb;MODE=MYSQL;DATABASE_TO_UPPER=false;NON_KEYWORDS=value,day,year,month;
+    driver-class-name: org.h2.Driver
+    username: sa
+    password:
+    druid:
+      async-init: true
+      initial-size: 1
+  sql:
+    init:
+      schema-locations: classpath:/sql/create_tables.sql
+
+  data:
+    redis:
+      host: 127.0.0.1
+      port: 16379
+      database: 0
+
+mybatis:
+  lazy-initialization: true
+
+--- #################### 芋道相关配置 ####################
+
+yudao:
+  info:
+    base-package: cn.iocoder.yudao.module
diff --git a/yudao-module-fms/src/test/resources/logback.xml b/yudao-module-fms/src/test/resources/logback.xml
new file mode 100644
index 0000000..8313843
--- /dev/null
+++ b/yudao-module-fms/src/test/resources/logback.xml
@@ -0,0 +1,2 @@
+<configuration>
+</configuration>
diff --git a/yudao-module-fms/src/test/resources/sql/clean.sql b/yudao-module-fms/src/test/resources/sql/clean.sql
new file mode 100644
index 0000000..26da83c
--- /dev/null
+++ b/yudao-module-fms/src/test/resources/sql/clean.sql
@@ -0,0 +1,29 @@
+DELETE FROM "fms_closing_voucher";
+DELETE FROM "fms_closing_template";
+DELETE FROM "fms_closing";
+DELETE FROM "fms_closing_period";
+DELETE FROM "fms_cash_flow_extend_data";
+DELETE FROM "fms_cash_flow_extend_config";
+DELETE FROM "fms_cash_flow_statement_report";
+DELETE FROM "fms_cash_flow_statement_config";
+DELETE FROM "fms_income_statement_report";
+DELETE FROM "fms_income_statement_config";
+DELETE FROM "fms_balance_sheet_report";
+DELETE FROM "fms_balance_sheet_config";
+DELETE FROM "fms_report_template";
+DELETE FROM "fms_voucher_entry";
+DELETE FROM "fms_voucher";
+DELETE FROM "fms_voucher_template";
+DELETE FROM "fms_voucher_template_category";
+DELETE FROM "fms_digest";
+DELETE FROM "fms_finance_indicator";
+DELETE FROM "fms_voucher_word";
+DELETE FROM "fms_initial_balance";
+DELETE FROM "fms_assist_combination";
+DELETE FROM "fms_auxiliary_item";
+DELETE FROM "fms_auxiliary_type";
+DELETE FROM "fms_subject";
+DELETE FROM "fms_subject_template";
+DELETE FROM "fms_currency";
+DELETE FROM "fms_account_user";
+DELETE FROM "fms_account_set";
diff --git a/yudao-module-fms/src/test/resources/sql/create_tables.sql b/yudao-module-fms/src/test/resources/sql/create_tables.sql
new file mode 100644
index 0000000..20246de
--- /dev/null
+++ b/yudao-module-fms/src/test/resources/sql/create_tables.sql
@@ -0,0 +1,619 @@
+-- FMS 单元测试表结构，与 sql/mysql/fms.sql 业务字段保持同步
+
+CREATE TABLE IF NOT EXISTS "fms_account_set" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "company_code" varchar(64) DEFAULT NULL,
+    "company_name" varchar(255) DEFAULT NULL,
+    "company_profile" varchar(500) DEFAULT NULL,
+    "industry" varchar(255) DEFAULT NULL,
+    "location" varchar(255) DEFAULT NULL,
+    "legal_representative" varchar(255) DEFAULT NULL,
+    "legal_representative_id_number" varchar(255) DEFAULT NULL,
+    "business_license_number" varchar(255) DEFAULT NULL,
+    "organization_code" varchar(255) DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "contact_name" varchar(255) DEFAULT NULL,
+    "office_telephone" varchar(32) DEFAULT NULL,
+    "mobile" varchar(32) DEFAULT NULL,
+    "fax_number" varchar(32) DEFAULT NULL,
+    "qq_number" varchar(255) DEFAULT NULL,
+    "email" varchar(255) DEFAULT NULL,
+    "other_contact" varchar(255) DEFAULT NULL,
+    "address" varchar(255) DEFAULT NULL,
+    "currency_id" bigint DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "standard" int DEFAULT NULL,
+    "initialized" bit NOT NULL DEFAULT FALSE,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    UNIQUE ("company_code", "deleted", "tenant_id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_finance_parameter" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "account_set_id" bigint NOT NULL,
+    "level" int NOT NULL,
+    "subject_code_rule" varchar(64) NOT NULL,
+    "ledger_balance_mode" int NOT NULL,
+    "deficit_check" bit NOT NULL DEFAULT FALSE,
+    "voucher_review_required" bit NOT NULL DEFAULT FALSE,
+    "asset_period_locked" bit NOT NULL DEFAULT FALSE,
+    "taxpayer_name" varchar(255) DEFAULT NULL,
+    "taxpayer_number" varchar(64) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    UNIQUE ("account_set_id", "deleted", "tenant_id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_account_user" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "account_set_id" bigint DEFAULT NULL,
+    "user_id" bigint DEFAULT NULL,
+    "default_status" bit NOT NULL DEFAULT FALSE,
+    "founder" bit NOT NULL DEFAULT FALSE,
+    "level" int NOT NULL DEFAULT 2,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_currency" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "code" varchar(64) DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "exchange_rate" decimal(18,6) NOT NULL DEFAULT 0,
+    "standard" bit NOT NULL DEFAULT FALSE,
+    "account_set_id" bigint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    UNIQUE ("account_set_id", "code", "deleted", "tenant_id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_subject" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "code" varchar(64) DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "parent_id" bigint NOT NULL DEFAULT 0,
+    "type" int DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "balance_direction" int DEFAULT NULL,
+    "quantity_unit" varchar(255) DEFAULT NULL,
+    "cash" bit NOT NULL DEFAULT FALSE,
+    "status" tinyint NOT NULL DEFAULT 0,
+    "level" int DEFAULT NULL,
+    "quantity_accounting" bit NOT NULL DEFAULT FALSE,
+    "account_set_id" bigint DEFAULT NULL,
+    "auxiliary_type_ids" varchar(10000) DEFAULT NULL,
+    "currency_ids" varchar(4000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_subject_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "code" varchar(64) DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "parent_id" bigint NOT NULL DEFAULT 0,
+    "type" int DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "balance_direction" int DEFAULT NULL,
+    "quantity_unit" varchar(255) DEFAULT NULL,
+    "cash" bit NOT NULL DEFAULT FALSE,
+    "status" int DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "quantity_accounting" bit NOT NULL DEFAULT FALSE,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_auxiliary_type" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "system_preset" bit NOT NULL DEFAULT FALSE,
+    "account_set_id" bigint DEFAULT NULL,
+    "type" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    UNIQUE ("account_set_id", "name", "deleted", "tenant_id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_auxiliary_item" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "code" varchar(64) DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "auxiliary_type_id" bigint DEFAULT NULL,
+    "status" int DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "specification" varchar(255) DEFAULT NULL,
+    "unit" varchar(255) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    UNIQUE ("account_set_id", "auxiliary_type_id", "code", "deleted", "tenant_id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_assist_combination" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "subject_id" bigint DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "items" varchar(10000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_initial_balance" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "subject_id" bigint DEFAULT NULL,
+    "auxiliary_accounting" bit NOT NULL DEFAULT FALSE,
+    "opening_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "opening_quantity" decimal(18,4) NOT NULL DEFAULT 0,
+    "year_debit_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "year_debit_quantity" decimal(18,4) NOT NULL DEFAULT 0,
+    "year_credit_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "year_credit_quantity" decimal(18,4) NOT NULL DEFAULT 0,
+    "year_opening_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "year_opening_quantity" decimal(18,4) NOT NULL DEFAULT 0,
+    "profit_loss_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "profit_loss_quantity" decimal(18,4) NOT NULL DEFAULT 0,
+    "account_set_id" bigint DEFAULT NULL,
+    "assist_balances" varchar(10000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    UNIQUE ("account_set_id", "subject_id", "deleted", "tenant_id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_voucher" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "voucher_word_id" bigint DEFAULT NULL,
+    "voucher_number" int DEFAULT NULL,
+    "voucher_time" timestamp DEFAULT NULL,
+    "voucher_period" int GENERATED ALWAYS AS (YEAR("voucher_time") * 100 + MONTH("voucher_time")),
+    "attachment_urls" varchar(10000) DEFAULT NULL,
+    "attachment_count" int NOT NULL DEFAULT 0,
+    "debit_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "credit_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "total" decimal(18,2) NOT NULL DEFAULT 0.00,
+    "status" int DEFAULT NULL,
+    "reviewer_user_id" bigint DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_voucher_entry" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "digest" varchar(500) DEFAULT NULL,
+    "subject_name" varchar(255) DEFAULT NULL,
+    "quantity" decimal(18,4) NOT NULL DEFAULT 0,
+    "debit_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "credit_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "voucher_id" bigint DEFAULT NULL,
+    "subject_code" varchar(64) DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "subject_id" bigint DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "unit_price" decimal(18,6) NOT NULL DEFAULT 0,
+    "assist_combination_id" bigint DEFAULT NULL,
+    "auxiliaries" varchar(10000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_voucher_word" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "print_title" varchar(255) DEFAULT NULL,
+    "default_status" bit NOT NULL DEFAULT FALSE,
+    "sort" int NOT NULL DEFAULT 0,
+    "account_set_id" bigint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_digest" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "content" varchar(500) NOT NULL,
+    "account_set_id" bigint NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_finance_indicator" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "account_set_id" bigint NOT NULL,
+    "name" varchar(100) NOT NULL,
+    "code" varchar(64) NOT NULL,
+    "type" int NOT NULL,
+    "formula" varchar(2000) NOT NULL,
+    "sort" int NOT NULL DEFAULT 0,
+    "status" int NOT NULL DEFAULT 0,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_voucher_template_category" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) NOT NULL,
+    "account_set_id" bigint NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_voucher_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) NOT NULL,
+    "category_id" bigint NOT NULL,
+    "entries" text NOT NULL,
+    "account_set_id" bigint NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_balance_sheet_config" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "remark" varchar(500) DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "sort" int DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "row_id" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_balance_sheet_report" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "from_period" int DEFAULT NULL,
+    "to_period" int DEFAULT NULL,
+    "type" int DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "remark" varchar(500) DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "sort" int DEFAULT NULL,
+    "opening_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "closing_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "account_set_id" bigint DEFAULT NULL,
+    "settled" bit NOT NULL DEFAULT FALSE,
+    "row_id" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_income_statement_config" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "sort" int DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "account_set_id" bigint DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_income_statement_report" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "type" int DEFAULT NULL,
+    "from_period" int DEFAULT NULL,
+    "to_period" int DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "sort" int DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "current_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "year_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "account_set_id" bigint DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "settled" bit NOT NULL DEFAULT FALSE,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_cash_flow_statement_config" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "remark" varchar(500) DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "sort" int DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_cash_flow_statement_report" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "from_period" int DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "remark" varchar(500) DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "current_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "year_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "sort" int DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "to_period" int DEFAULT NULL,
+    "type" int DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_cash_flow_extend_config" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "remark" varchar(500) DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "type" int DEFAULT NULL,
+    "current_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "year_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "account_set_id" bigint DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_cash_flow_extend_data" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "remark" varchar(500) DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "current_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "year_amount" decimal(18,2) NOT NULL DEFAULT 0,
+    "from_period" int DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "account_set_id" bigint DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "to_period" int DEFAULT NULL,
+    "type" int DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_report_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "row_no" int DEFAULT NULL,
+    "formula" text,
+    "remark" varchar(500) DEFAULT NULL,
+    "editable" bit NOT NULL DEFAULT FALSE,
+    "sort" int DEFAULT NULL,
+    "row_id" int DEFAULT NULL,
+    "type" int DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "level" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_closing" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) DEFAULT NULL,
+    "period_end" bit NOT NULL DEFAULT FALSE,
+    "subject_id" bigint DEFAULT NULL,
+    "formula_rule" int DEFAULT NULL,
+    "time_type" int DEFAULT NULL,
+    "voucher_word_id" bigint DEFAULT NULL,
+    "digest" varchar(500) DEFAULT NULL,
+    "voucher_type" int DEFAULT NULL,
+    "prior_year_adjustment_subject_id" bigint DEFAULT NULL,
+    "adjustment_closing_subject_id" bigint DEFAULT NULL,
+    "other_closing_subject_id" bigint DEFAULT NULL,
+    "reverse_balance" bit NOT NULL DEFAULT FALSE,
+    "type" int DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "closing_day" int DEFAULT NULL,
+    "subject_rules" varchar(10000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_closing_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "account_set_id" bigint DEFAULT NULL,
+    "preset_code" varchar(64) DEFAULT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "category" int DEFAULT NULL,
+    "period_end" bit NOT NULL DEFAULT FALSE,
+    "subject_id" bigint DEFAULT NULL,
+    "formula_rule" int DEFAULT NULL,
+    "time_type" int DEFAULT NULL,
+    "subject_rules" varchar(10000) DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+ALTER TABLE "fms_closing_template"
+    ADD "unique_active" int GENERATED ALWAYS AS (CASE WHEN "deleted" = FALSE THEN 1 ELSE NULL END);
+CREATE UNIQUE INDEX IF NOT EXISTS "uk_fms_closing_template_active"
+    ON "fms_closing_template" ("account_set_id", "preset_code", "unique_active", "tenant_id");
+
+CREATE TABLE IF NOT EXISTS "fms_closing_voucher" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "closing_id" bigint DEFAULT NULL,
+    "voucher_id" bigint DEFAULT NULL,
+    "voucher_time" timestamp DEFAULT NULL,
+    "amount" decimal(24, 6) NOT NULL DEFAULT 0,
+    "closed" bit NOT NULL DEFAULT FALSE,
+    "account_set_id" bigint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "fms_closing_period" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "closing_time" timestamp DEFAULT NULL,
+    "account_set_id" bigint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
diff --git a/yudao-module-hrm/pom.xml b/yudao-module-hrm/pom.xml
new file mode 100644
index 0000000..750c2dc
--- /dev/null
+++ b/yudao-module-hrm/pom.xml
@@ -0,0 +1,69 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <parent>
+        <groupId>cn.iocoder.boot</groupId>
+        <artifactId>yudao</artifactId>
+        <version>${revision}</version>
+    </parent>
+    <modelVersion>4.0.0</modelVersion>
+    <artifactId>yudao-module-hrm</artifactId>
+    <packaging>jar</packaging>
+
+    <name>${project.artifactId}</name>
+    <description>
+        hrm 包下，人力资源管理（Human Resource Management）
+        例如说：员工、招聘、考勤、薪资、社保、绩效等等
+    </description>
+
+    <dependencies>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-system</artifactId>
+            <version>${revision}</version>
+        </dependency>
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-module-bpm</artifactId>
+            <version>${revision}</version>
+        </dependency>
+
+        <!-- Web 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-web</artifactId>
+        </dependency>
+
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-security</artifactId>
+        </dependency>
+
+        <!-- DB 相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-mybatis</artifactId>
+        </dependency>
+
+        <!-- 工具类相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-excel</artifactId>
+        </dependency>
+
+        <!-- 定时任务相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-job</artifactId>
+        </dependency>
+
+        <!-- Test 测试相关 -->
+        <dependency>
+            <groupId>cn.iocoder.boot</groupId>
+            <artifactId>yudao-spring-boot-starter-test</artifactId>
+            <scope>test</scope>
+        </dependency>
+    </dependencies>
+
+</project>
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceClockController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceClockController.java
new file mode 100644
index 0000000..2721cee
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceClockController.java
@@ -0,0 +1,191 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.TimeRange;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockShiftReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockShiftRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceClockService;
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceGroupService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.time.LocalDate;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 打卡记录")
+@RestController
+@RequestMapping("/hrm/attendance/clock")
+@Validated
+public class HrmAttendanceClockController {
+
+    @Resource
+    private HrmAttendanceClockService attendanceClockService;
+    @Resource
+    private HrmAttendanceGroupService attendanceGroupService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private DeptApi deptApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建打卡记录")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:create')")
+    public CommonResult<Long> createAttendanceClock(@Valid @RequestBody HrmAttendanceClockSaveReqVO createReqVO) {
+        return success(attendanceClockService.createAttendanceClock(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改打卡记录")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:update')")
+    public CommonResult<Boolean> updateAttendanceClock(@Valid @RequestBody HrmAttendanceClockSaveReqVO updateReqVO) {
+        attendanceClockService.updateAttendanceClock(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除打卡记录")
+    @Parameter(name = "id", description = "打卡记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:delete')")
+    public CommonResult<Boolean> deleteAttendanceClock(@RequestParam("id") Long id) {
+        attendanceClockService.deleteAttendanceClock(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "批量删除打卡记录")
+    @Parameter(name = "ids", description = "打卡记录编号列表", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:delete')")
+    public CommonResult<Boolean> deleteAttendanceClockList(
+            @RequestParam("ids") @NotEmpty(message = "打卡记录不能为空") List<Long> ids) {
+        attendanceClockService.deleteAttendanceClockList(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得打卡记录")
+    @Parameter(name = "id", description = "打卡记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:query')")
+    public CommonResult<HrmAttendanceClockRespVO> getAttendanceClock(@RequestParam("id") Long id) {
+        HrmAttendanceClockDO attendanceClock = attendanceClockService.getAttendanceClock(id);
+        return success(attendanceClock == null ? null
+                : CollUtil.getFirst(buildAttendanceClockRespVOList(Collections.singletonList(attendanceClock))));
+    }
+
+    @GetMapping("/get-shift")
+    @Operation(summary = "获得员工实际班次和允许打卡时间")
+    @PreAuthorize("@ss.hasAnyPermissions('hrm:attendance:clock:create', 'hrm:attendance:clock:update')")
+    public CommonResult<HrmAttendanceClockShiftRespVO> getAttendanceClockShift(
+            @Valid HrmAttendanceClockShiftReqVO reqVO) {
+        HrmAttendanceGroupDO.Shift shift = attendanceGroupService.getEmployeeAttendanceShift(
+                reqVO.getEmployeeId(), reqVO.getAttendanceTime());
+        return success(shift == null ? null : buildAttendanceClockShiftRespVO(reqVO, shift));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得打卡记录分页")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:query')")
+    public CommonResult<PageResult<HrmAttendanceClockRespVO>> getAttendanceClockPage(
+            @Validated HrmAttendanceClockPageReqVO pageReqVO) {
+        PageResult<HrmAttendanceClockDO> pageResult = attendanceClockService.getAttendanceClockPage(pageReqVO);
+        return success(new PageResult<>(buildAttendanceClockRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出打卡记录")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportAttendanceClock(@Validated HrmAttendanceClockPageReqVO exportReqVO,
+                                      HttpServletResponse response) throws IOException {
+        exportReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<HrmAttendanceClockRespVO> list = buildAttendanceClockRespVOList(
+                attendanceClockService.getAttendanceClockList(exportReqVO));
+        ExcelUtils.write(response, "打卡记录.xls", "数据", HrmAttendanceClockRespVO.class, list);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmAttendanceClockShiftRespVO buildAttendanceClockShiftRespVO(
+            HrmAttendanceClockShiftReqVO reqVO, HrmAttendanceGroupDO.Shift shift) {
+        if (shift.getStartTime() == null || shift.getEndTime() == null
+                || shift.getClockInStartTime() == null || shift.getClockInEndTime() == null
+                || shift.getClockOutStartTime() == null || shift.getClockOutEndTime() == null) {
+            return null;
+        }
+        LocalDate attendanceDate = reqVO.getAttendanceTime().toLocalDate();
+        TimeRange shiftTimeRange = CollUtil.getFirst(LocalDateTimeUtils.buildDailyTimeRanges(
+                attendanceDate, attendanceDate, shift.getStartTime(), shift.getEndTime()));
+        TimeRange clockInTimeRange = LocalDateTimeUtils.findDailyTimeRange(
+                attendanceDate, shift.getClockInStartTime(),
+                shift.getClockInEndTime(), shiftTimeRange.getStartTime());
+        TimeRange clockOutTimeRange = LocalDateTimeUtils.findDailyTimeRange(
+                attendanceDate, shift.getClockOutStartTime(),
+                shift.getClockOutEndTime(), shiftTimeRange.getEndTime());
+        if (clockInTimeRange == null || clockOutTimeRange == null) {
+            return null;
+        }
+        return new HrmAttendanceClockShiftRespVO()
+                .setStartTime(shiftTimeRange.getStartTime()).setEndTime(shiftTimeRange.getEndTime())
+                .setClockInStartTime(clockInTimeRange.getStartTime()).setClockInEndTime(clockInTimeRange.getEndTime())
+                .setClockOutStartTime(clockOutTimeRange.getStartTime()).setClockOutEndTime(clockOutTimeRange.getEndTime());
+    }
+
+    private List<HrmAttendanceClockRespVO> buildAttendanceClockRespVOList(List<HrmAttendanceClockDO> clocks) {
+        if (CollUtil.isEmpty(clocks)) {
+            return Collections.emptyList();
+        }
+        // 1. 获得员工和部门信息
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(clocks, HrmAttendanceClockDO::getEmployeeId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId));
+
+        // 2. 拼接响应
+        return BeanUtils.toBean(clocks, HrmAttendanceClockRespVO.class, respVO -> {
+            MapUtils.findAndThen(employeeMap, respVO.getEmployeeId(), employee -> {
+                respVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                        .setDeptId(employee.getDeptId()).setPostName(employee.getPostName());
+            });
+            MapUtils.findAndThen(deptMap, respVO.getDeptId(), dept -> respVO.setDeptName(dept.getName()));
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceGroupController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceGroupController.java
new file mode 100644
index 0000000..9a7a4af
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceGroupController.java
@@ -0,0 +1,134 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceGroupService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+
+@Tag(name = "管理后台 - HRM 考勤组")
+@RestController
+@RequestMapping("/hrm/attendance/group")
+@Validated
+public class HrmAttendanceGroupController {
+
+    @Resource
+    private HrmAttendanceGroupService attendanceGroupService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private DeptApi deptApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建考勤组")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:group:create')")
+    public CommonResult<Long> createAttendanceGroup(@Valid @RequestBody HrmAttendanceGroupSaveReqVO createReqVO) {
+        return success(attendanceGroupService.createAttendanceGroup(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改考勤组")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:group:update')")
+    public CommonResult<Boolean> updateAttendanceGroup(@Valid @RequestBody HrmAttendanceGroupSaveReqVO updateReqVO) {
+        attendanceGroupService.updateAttendanceGroup(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除考勤组")
+    @Parameter(name = "id", description = "考勤组编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:group:delete')")
+    public CommonResult<Boolean> deleteAttendanceGroup(@RequestParam("id") Long id) {
+        attendanceGroupService.deleteAttendanceGroup(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得考勤组")
+    @Parameter(name = "id", description = "考勤组编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:group:query')")
+    public CommonResult<HrmAttendanceGroupRespVO> getAttendanceGroup(@RequestParam("id") Long id) {
+        return success(buildAttendanceGroupRespVO(attendanceGroupService.getAttendanceGroup(id)));
+    }
+
+    @GetMapping("/my")
+    @Operation(summary = "获得员工所在考勤组")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:group:query')")
+    public CommonResult<HrmAttendanceGroupRespVO> getMyAttendanceGroup(@RequestParam("employeeId") Long employeeId) {
+        return success(buildAttendanceGroupRespVO(attendanceGroupService.getMyAttendanceGroup(employeeId)));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得考勤组分页")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:group:query')")
+    public CommonResult<PageResult<HrmAttendanceGroupRespVO>> getAttendanceGroupPage(
+            @Validated HrmAttendanceGroupPageReqVO pageReqVO) {
+        PageResult<HrmAttendanceGroupDO> pageResult = attendanceGroupService.getAttendanceGroupPage(pageReqVO);
+        return success(new PageResult<>(
+                buildAttendanceGroupRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得考勤组精简列表")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:group:query')")
+    public CommonResult<List<HrmAttendanceGroupRespVO>> getAttendanceGroupSimpleList() {
+        return success(convertList(attendanceGroupService.getAttendanceGroupList(),
+                group -> new HrmAttendanceGroupRespVO().setId(group.getId()).setName(group.getName())));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmAttendanceGroupRespVO buildAttendanceGroupRespVO(HrmAttendanceGroupDO group) {
+        if (group == null) {
+            return null;
+        }
+        return buildAttendanceGroupRespVOList(Collections.singletonList(group)).get(0);
+    }
+
+    private List<HrmAttendanceGroupRespVO> buildAttendanceGroupRespVOList(List<HrmAttendanceGroupDO> list) {
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSetByFlatMap(list, HrmAttendanceGroupDO::getDeptIds, Collection::stream));
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSetByFlatMap(list, HrmAttendanceGroupDO::getEmployeeIds, Collection::stream));
+        return convertList(list, group -> BeanUtils.toBean(group, HrmAttendanceGroupRespVO.class)
+                .setDeptNames(convertList(group.getDeptIds(),
+                        deptId -> deptMap.containsKey(deptId) ? deptMap.get(deptId).getName() : null))
+                .setEmployeeNames(convertList(group.getEmployeeIds(),
+                        employeeId -> employeeMap.containsKey(employeeId)
+                                ? employeeMap.get(employeeId).getName() : null)));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceHolidayController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceHolidayController.java
new file mode 100644
index 0000000..40d3869
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceHolidayController.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidayPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidayRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidaySaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceHolidayService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Tag(name = "管理后台 - HRM 考勤节假日")
+@RestController
+@RequestMapping("/hrm/attendance/holiday")
+@Validated
+public class HrmAttendanceHolidayController {
+
+    @Resource
+    private HrmAttendanceHolidayService attendanceHolidayService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建考勤节假日")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:holiday:create')")
+    public CommonResult<Long> createAttendanceHoliday(@Valid @RequestBody HrmAttendanceHolidaySaveReqVO createReqVO) {
+        return success(attendanceHolidayService.createAttendanceHoliday(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改考勤节假日")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:holiday:update')")
+    public CommonResult<Boolean> updateAttendanceHoliday(@Valid @RequestBody HrmAttendanceHolidaySaveReqVO updateReqVO) {
+        attendanceHolidayService.updateAttendanceHoliday(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除考勤节假日")
+    @Parameter(name = "id", description = "考勤节假日编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:holiday:delete')")
+    public CommonResult<Boolean> deleteAttendanceHoliday(@RequestParam("id") Long id) {
+        attendanceHolidayService.deleteAttendanceHoliday(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得考勤节假日")
+    @Parameter(name = "id", description = "考勤节假日编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:holiday:query')")
+    public CommonResult<HrmAttendanceHolidayRespVO> getAttendanceHoliday(@RequestParam("id") Long id) {
+        HrmAttendanceHolidayDO holiday = attendanceHolidayService.getAttendanceHoliday(id);
+        return success(BeanUtils.toBean(holiday, HrmAttendanceHolidayRespVO.class));
+    }
+
+    @GetMapping("/check")
+    @Operation(summary = "检查日期是否为考勤节假日")
+    @Parameter(name = "day", description = "日期", required = true)
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:holiday:query')")
+    public CommonResult<HrmAttendanceHolidayRespVO> checkAttendanceHoliday(
+            @RequestParam("day")
+            @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND) LocalDateTime day) {
+        HrmAttendanceHolidayDO holiday = attendanceHolidayService.checkAttendanceHoliday(day);
+        return success(BeanUtils.toBean(holiday, HrmAttendanceHolidayRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得考勤节假日分页")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:holiday:query')")
+    public CommonResult<PageResult<HrmAttendanceHolidayRespVO>> getAttendanceHolidayPage(
+            @Validated HrmAttendanceHolidayPageReqVO pageReqVO) {
+        PageResult<HrmAttendanceHolidayDO> pageResult = attendanceHolidayService.getAttendanceHolidayPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, HrmAttendanceHolidayRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceLeaveController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceLeaveController.java
new file mode 100644
index 0000000..a7c81b9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceLeaveController.java
@@ -0,0 +1,111 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance;
+
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeavePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceLeaveService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 请假")
+@RestController
+@RequestMapping("/hrm/attendance/leave")
+@Validated
+public class HrmAttendanceLeaveController {
+
+    @Resource
+    private HrmAttendanceLeaveService attendanceLeaveService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得请假")
+    @Parameter(name = "id", description = "请假记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasAnyPermissions('hrm:attendance:leave:query', "
+            + "'bpm:process-instance:query', 'bpm:task:query')")
+    public CommonResult<HrmAttendanceLeaveRespVO> getAttendanceLeave(@RequestParam("id") Long id) {
+        HrmAttendanceLeaveDO list = attendanceLeaveService.getAttendanceLeave(id);
+        return success(buildAttendanceLeaveRespVO(list));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得请假分页")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:leave:query')")
+    public CommonResult<PageResult<HrmAttendanceLeaveRespVO>> getAttendanceLeavePage(
+            @Validated HrmAttendanceLeavePageReqVO pageReqVO) {
+        PageResult<HrmAttendanceLeaveDO> pageResult = attendanceLeaveService.getAttendanceLeavePage(pageReqVO);
+        return success(new PageResult<>(buildAttendanceLeaveRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出请假")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:leave:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportAttendanceLeave(@Validated HrmAttendanceLeavePageReqVO exportReqVO,
+                                      HttpServletResponse response) throws IOException {
+        exportReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<HrmAttendanceLeaveRespVO> list = buildAttendanceLeaveRespVOList(
+                attendanceLeaveService.getAttendanceLeaveList(exportReqVO));
+        ExcelUtils.write(response, "请假记录.xls", "数据", HrmAttendanceLeaveRespVO.class, list);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmAttendanceLeaveRespVO buildAttendanceLeaveRespVO(HrmAttendanceLeaveDO attendanceLeave) {
+        if (attendanceLeave == null) {
+            return null;
+        }
+        return buildAttendanceLeaveRespVOList(Collections.singletonList(attendanceLeave)).get(0);
+    }
+
+    private List<HrmAttendanceLeaveRespVO> buildAttendanceLeaveRespVOList(List<HrmAttendanceLeaveDO> list) {
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(list, HrmAttendanceLeaveDO::getEmployeeId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId));
+        return convertList(list, attendanceLeave -> {
+            HrmAttendanceLeaveRespVO respVO = BeanUtils.toBean(attendanceLeave, HrmAttendanceLeaveRespVO.class);
+            HrmEmployeeDO employee = employeeMap.get(attendanceLeave.getEmployeeId());
+            if (employee == null) {
+                return respVO;
+            }
+            respVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                    .setDeptId(employee.getDeptId()).setPostName(employee.getPostName());
+            MapUtils.findAndThen(deptMap, employee.getDeptId(), dept -> respVO.setDeptName(dept.getName()));
+            return respVO;
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceStatisticsController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceStatisticsController.java
new file mode 100644
index 0000000..d7bb6d1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/HrmAttendanceStatisticsController.java
@@ -0,0 +1,212 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.map.MapUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.dict.core.DictFrameworkUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyOverviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthDailyOverviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.service.attendance.statistics.HrmAttendanceStatisticsService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.io.IOException;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 考勤统计")
+@RestController
+@RequestMapping("/hrm/attendance/statistics")
+@Validated
+public class HrmAttendanceStatisticsController {
+
+    @Resource
+    private HrmAttendanceStatisticsService attendanceStatisticsService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @GetMapping("/daily-detail")
+    @Operation(summary = "查询员工每日打卡明细")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:query')")
+    public CommonResult<HrmAttendanceDailyDetailRespVO> getAttendanceDailyDetail(
+            @Valid HrmAttendanceDailyDetailReqVO reqVO) {
+        return success(attendanceStatisticsService.getAttendanceDailyDetail(reqVO));
+    }
+
+    @GetMapping("/month-record-page")
+    @Operation(summary = "查询员工月度考勤汇总")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:statistics:query')")
+    public CommonResult<PageResult<HrmAttendanceMonthRecordRespVO>> getAttendanceMonthRecordPage(
+            @Valid HrmAttendanceMonthRecordPageReqVO reqVO) {
+        PageResult<HrmAttendanceMonthRecordRespVO> pageResult =
+                attendanceStatisticsService.getAttendanceMonthRecordPage(reqVO);
+        fillAttendanceMonthRecordDeptName(pageResult.getList());
+        return success(pageResult);
+    }
+
+    @GetMapping("/month-daily-page")
+    @Operation(summary = "查询员工月度打卡概况")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:query')")
+    public CommonResult<PageResult<HrmAttendanceMonthDailyOverviewRespVO>> getAttendanceMonthDailyOverviewPage(
+            @Valid HrmAttendanceMonthRecordPageReqVO reqVO) {
+        PageResult<HrmAttendanceMonthDailyOverviewRespVO> pageResult =
+                attendanceStatisticsService.getAttendanceMonthDailyOverviewPage(reqVO);
+        fillAttendanceMonthDailyOverview(pageResult.getList());
+        return success(pageResult);
+    }
+
+    @GetMapping("/month-record-export-excel")
+    @Operation(summary = "导出员工月度考勤汇总")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:statistics:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportAttendanceMonthRecord(@Validated HrmAttendanceMonthRecordPageReqVO exportReqVO,
+                                            HttpServletResponse response) throws IOException {
+        exportReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<HrmAttendanceMonthRecordRespVO> list =
+                attendanceStatisticsService.getAttendanceMonthRecordList(exportReqVO);
+        fillAttendanceMonthRecordDeptName(list);
+        ExcelUtils.write(response, "员工月度考勤汇总.xls", "数据", HrmAttendanceMonthRecordRespVO.class, list);
+    }
+
+    @GetMapping("/month-daily-export-excel")
+    @Operation(summary = "导出员工月度打卡概况")
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:clock:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportAttendanceMonthDailyOverview(@Validated HrmAttendanceMonthRecordPageReqVO exportReqVO,
+                                                   HttpServletResponse response) throws IOException {
+        exportReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<HrmAttendanceMonthDailyOverviewRespVO> list =
+                attendanceStatisticsService.getAttendanceMonthDailyOverviewList(exportReqVO);
+        fillAttendanceMonthDailyOverview(list);
+        writeAttendanceMonthDailyOverview(response,
+                YearMonth.of(exportReqVO.getYear(), exportReqVO.getMonth()), list);
+    }
+
+    @GetMapping("/month-detail")
+    @Operation(summary = "查询员工月度考勤详情")
+    @Parameters({
+            @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024"),
+            @Parameter(name = "year", description = "年份", required = true, example = "2026"),
+            @Parameter(name = "month", description = "月份", required = true, example = "8")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:attendance:statistics:query')")
+    public CommonResult<HrmAttendanceMonthDetailRespVO> getAttendanceMonthDetail(
+            @RequestParam("employeeId") Long employeeId,
+            @RequestParam("year") Integer year,
+            @RequestParam("month") Integer month) {
+        HrmAttendanceMonthDetailRespVO detail =
+                attendanceStatisticsService.getAttendanceMonthDetail(employeeId, year, month);
+        fillAttendanceMonthRecordDeptName(Collections.singletonList(detail.getSummary()));
+        return success(detail);
+    }
+
+    private void writeAttendanceMonthDailyOverview(HttpServletResponse response, YearMonth month,
+                                                   List<HrmAttendanceMonthDailyOverviewRespVO> list)
+            throws IOException {
+        List<List<String>> head = convertList(
+                Arrays.asList("员工编号", "员工姓名", "工号", "部门", "岗位"), Collections::singletonList);
+        for (int day = 1; day <= month.lengthOfMonth(); day++) {
+            head.add(Collections.singletonList(month.atDay(day).toString()));
+        }
+        ExcelUtils.write(response, "员工月度打卡概况.xls", "打卡概况", head,
+                buildAttendanceMonthDailyOverviewData(month, list));
+    }
+
+    private List<List<Object>> buildAttendanceMonthDailyOverviewData(
+            YearMonth month, List<HrmAttendanceMonthDailyOverviewRespVO> list) {
+        List<List<Object>> result = new ArrayList<>(list.size());
+        for (HrmAttendanceMonthDailyOverviewRespVO row : list) {
+            List<Object> data = new ArrayList<>(Arrays.asList(row.getEmployeeId(), row.getEmployeeName(),
+                    row.getJobNumber(), row.getDeptName(), row.getPostName()));
+            for (int day = 1; day <= month.lengthOfMonth(); day++) {
+                data.add(formatDailyClockOverview(row.getDailyClockMap().get(month.atDay(day))));
+            }
+            result.add(data);
+        }
+        return result;
+    }
+
+    private List<HrmAttendanceDailyOverviewRespVO.OverviewItem> buildDailyClockOverviewList(
+            HrmAttendanceDailyOverviewRespVO dailyOverview) {
+        if (CollUtil.isEmpty(dailyOverview.getClocks())) {
+            return Collections.singletonList(new HrmAttendanceDailyOverviewRespVO.OverviewItem()
+                    .setText(StrUtil.emptyIfNull(dailyOverview.getAttendanceResult())));
+        }
+        // 按打卡时间升序展示每日打卡概况
+        dailyOverview.getClocks().sort(Comparator.comparing(HrmAttendanceClockRespVO::getClockTime));
+        return convertList(dailyOverview.getClocks(),
+                clock -> new HrmAttendanceDailyOverviewRespVO.OverviewItem()
+                        .setType(StrUtil.removeSuffix(StrUtil.emptyIfNull(DictFrameworkUtils.parseDictDataLabel(
+                                DictTypeConstants.HRM_ATTENDANCE_CLOCK_TYPE, clock.getType())), "打卡"))
+                        .setTime(clock.getClockTime() == null ? "-" : clock.getClockTime().toLocalTime().toString())
+                        .setStatus(StrUtil.emptyIfNull(DictFrameworkUtils.parseDictDataLabel(
+                                DictTypeConstants.HRM_ATTENDANCE_CLOCK_STATUS, clock.getStatus()))));
+    }
+
+    private String formatDailyClockOverview(HrmAttendanceDailyOverviewRespVO dailyOverview) {
+        if (dailyOverview == null) {
+            return "";
+        }
+        return dailyOverview.getOverviews().stream()
+                .map(item -> StrUtil.isNotEmpty(item.getText()) ? item.getText()
+                        : String.format("%s %s %s", item.getType(), item.getTime(), item.getStatus()))
+                .collect(Collectors.joining("；"));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private void fillAttendanceMonthDailyOverview(List<HrmAttendanceMonthDailyOverviewRespVO> list) {
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(list, HrmAttendanceMonthDailyOverviewRespVO::getDeptId));
+        list.forEach(vo -> {
+            MapUtils.findAndThen(deptMap, vo.getDeptId(), dept -> vo.setDeptName(dept.getName()));
+            MapUtil.emptyIfNull(vo.getDailyClockMap()).values().forEach(
+                    overview -> overview.setOverviews(buildDailyClockOverviewList(overview)));
+        });
+    }
+
+    private void fillAttendanceMonthRecordDeptName(List<HrmAttendanceMonthRecordRespVO> list) {
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(list, HrmAttendanceMonthRecordRespVO::getDeptId));
+        list.forEach(vo -> MapUtils.findAndThen(deptMap, vo.getDeptId(), dept -> vo.setDeptName(dept.getName())));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockPageReqVO.java
new file mode 100644
index 0000000..8d6df1d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockPageReqVO.java
@@ -0,0 +1,61 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockSourceEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 打卡记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmAttendanceClockPageReqVO extends PageParam {
+
+    @Schema(description = "员工姓名或工号，模糊匹配", example = "张三")
+    private String search;
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "部门编号数组", example = "100,101")
+    private List<Long> deptIds;
+
+    @Schema(hidden = true)
+    private Collection<Long> employeeIds;
+
+    @Schema(description = "考勤打卡类型", example = "1")
+    @InEnum(value = HrmAttendanceClockTypeEnum.class, message = "打卡类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "考勤打卡状态", example = "1")
+    @InEnum(value = HrmAttendanceClockStatusEnum.class, message = "打卡状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "来源类型数组", example = "[1, 2]")
+    @InEnum(value = HrmAttendanceClockSourceEnum.class, message = "打卡来源必须是 {value}")
+    private List<Integer> sourceTypes;
+
+    @Schema(description = "打卡地点，模糊匹配", example = "文三路")
+    private String address;
+
+    @Schema(description = "上班日期范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] attendanceTime;
+
+    @Schema(description = "实际打卡时间范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] clockTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockRespVO.java
new file mode 100644
index 0000000..35c178d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockRespVO.java
@@ -0,0 +1,95 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 打卡记录 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class HrmAttendanceClockRespVO {
+
+    @Schema(description = "打卡记录编号", example = "1024")
+    @ExcelProperty(value = "记录编号", index = 0)
+    private Long id;
+
+    @Schema(description = "打卡员工编号", example = "1001")
+    @ExcelProperty(value = "员工编号", index = 1)
+    private Long employeeId;
+
+    @Schema(description = "员工姓名", example = "芋道")
+    @ExcelProperty(value = "员工姓名", index = 2)
+    private String employeeName;
+
+    @Schema(description = "工号", example = "HRM001")
+    @ExcelProperty(value = "工号", index = 3)
+    private String jobNumber;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "部门名称", example = "研发部")
+    @ExcelProperty(value = "部门", index = 4)
+    private String deptName;
+
+    @Schema(description = "职位名称", example = "Java 工程师")
+    @ExcelProperty(value = "岗位", index = 5)
+    private String postName;
+
+    @Schema(description = "打卡时间")
+    @ExcelProperty(value = "打卡时间", index = 8)
+    private LocalDateTime clockTime;
+
+    @Schema(description = "打卡类型", example = "1")
+    @ExcelProperty(value = "打卡类型", index = 6, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_ATTENDANCE_CLOCK_TYPE)
+    private Integer type;
+
+    @Schema(description = "应打卡时间")
+    @ExcelProperty(value = "应打卡时间", index = 7)
+    private LocalDateTime attendanceTime;
+
+    @Schema(description = "打卡来源")
+    @ExcelProperty(value = "来源", index = 10, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_ATTENDANCE_CLOCK_SOURCE)
+    private Integer sourceType;
+
+    @Schema(description = "打卡状态")
+    @ExcelProperty(value = "打卡状态", index = 9, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_ATTENDANCE_CLOCK_STATUS)
+    private Integer status;
+
+    @Schema(description = "打卡阶段")
+    private Integer stage;
+
+    @Schema(description = "打卡地址", example = "总部大楼")
+    @ExcelProperty(value = "地点", index = 11)
+    private String address;
+
+    @Schema(description = "经度", example = "121.473701")
+    private BigDecimal longitude;
+
+    @Schema(description = "纬度", example = "31.230416")
+    private BigDecimal latitude;
+
+    @Schema(description = "WiFi 名称", example = "office_wifi")
+    private String ssid;
+
+    @Schema(description = "WiFi MAC 地址", example = "00:11:22:33:44:55")
+    private String mac;
+
+    @Schema(description = "备注", example = "手工补卡")
+    @ExcelProperty(value = "备注", index = 12)
+    private String remark;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockSaveReqVO.java
new file mode 100644
index 0000000..41e50ce
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockSaveReqVO.java
@@ -0,0 +1,65 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 打卡记录保存 Request VO")
+@Data
+public class HrmAttendanceClockSaveReqVO {
+
+    @Schema(description = "打卡记录编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "打卡员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    @NotNull(message = "打卡员工不能为空")
+    private Long employeeId;
+
+    @Schema(description = "打卡时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "打卡时间不能为空")
+    private LocalDateTime clockTime;
+
+    @Schema(description = "打卡类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "打卡类型不能为空")
+    @InEnum(value = HrmAttendanceClockTypeEnum.class, message = "打卡类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "应打卡时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "应打卡时间不能为空")
+    private LocalDateTime attendanceTime;
+
+    @Schema(description = "打卡地址", example = "总部大楼")
+    @Size(max = 255, message = "打卡地址不能超过 255 个字符")
+    private String address;
+
+    @Schema(description = "经度", example = "121.473701")
+    @DecimalMin(value = "-180", message = "经度必须在 -180 到 180 之间")
+    @DecimalMax(value = "180", message = "经度必须在 -180 到 180 之间")
+    private BigDecimal longitude;
+
+    @Schema(description = "纬度", example = "31.230416")
+    @DecimalMin(value = "-90", message = "纬度必须在 -90 到 90 之间")
+    @DecimalMax(value = "90", message = "纬度必须在 -90 到 90 之间")
+    private BigDecimal latitude;
+
+    @Schema(description = "WiFi 名称", example = "office_wifi")
+    @Size(max = 50, message = "WiFi 名称不能超过 50 个字符")
+    private String ssid;
+
+    @Schema(description = "WiFi MAC 地址", example = "00:11:22:33:44:55")
+    @Size(max = 50, message = "WiFi MAC 地址不能超过 50 个字符")
+    private String mac;
+
+    @Schema(description = "备注", example = "手工补卡")
+    @Size(max = 255, message = "备注不能超过 255 个字符")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockShiftReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockShiftReqVO.java
new file mode 100644
index 0000000..0b03d7e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockShiftReqVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 员工实际班次 Request VO")
+@Data
+public class HrmAttendanceClockShiftReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工不能为空")
+    private Long employeeId;
+
+    @Schema(description = "考勤时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "考勤时间不能为空")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime attendanceTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockShiftRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockShiftRespVO.java
new file mode 100644
index 0000000..c1ff2f9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/clock/HrmAttendanceClockShiftRespVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工实际班次 Response VO")
+@Data
+public class HrmAttendanceClockShiftRespVO {
+
+    @Schema(description = "上班时间")
+    private LocalDateTime startTime;
+
+    @Schema(description = "下班时间")
+    private LocalDateTime endTime;
+
+    @Schema(description = "上班打卡开始时间")
+    private LocalDateTime clockInStartTime;
+
+    @Schema(description = "上班打卡结束时间")
+    private LocalDateTime clockInEndTime;
+
+    @Schema(description = "下班打卡开始时间")
+    private LocalDateTime clockOutStartTime;
+
+    @Schema(description = "下班打卡结束时间")
+    private LocalDateTime clockOutEndTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupPageReqVO.java
new file mode 100644
index 0000000..db34028
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupPageReqVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - HRM 考勤组分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmAttendanceGroupPageReqVO extends PageParam {
+
+    @Schema(description = "考勤组名称", example = "默认考勤组")
+    private String name;
+
+    @Schema(description = "是否默认考勤组", example = "true")
+    private Boolean defaultStatus;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupRespVO.java
new file mode 100644
index 0000000..f3e3609
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupRespVO.java
@@ -0,0 +1,178 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group;
+
+import com.fasterxml.jackson.annotation.JsonFormat;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 考勤组 Response VO")
+@Data
+public class HrmAttendanceGroupRespVO {
+
+    @Schema(description = "考勤组编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "名称", example = "总部考勤组")
+    private String name;
+
+    @Schema(description = "是否启用 WiFi 打卡")
+    private Boolean openWifiCard;
+
+    @Schema(description = "是否启用定位打卡")
+    private Boolean openPointCard;
+
+    @Schema(description = "是否法定节假日休息")
+    private Boolean rest;
+
+    @Schema(description = "是否默认配置")
+    private Boolean defaultStatus;
+
+    @Schema(description = "特殊日期设置数组")
+    private List<SpecialDate> specialDates;
+
+    @Schema(description = "部门范围")
+    private List<Long> deptIds;
+
+    @Schema(description = "适用部门名称")
+    private List<String> deptNames;
+
+    @Schema(description = "员工范围")
+    private List<Long> employeeIds;
+
+    @Schema(description = "适用员工名称")
+    private List<String> employeeNames;
+
+    @Schema(description = "班次配置")
+    private List<Shift> shifts;
+
+    @Schema(description = "打卡地点")
+    private List<Point> points;
+
+    @Schema(description = "打卡 WiFi")
+    private List<Wifi> wifis;
+
+    @Schema(description = "扣款规则")
+    private DeductRule deductRule;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "管理后台 - HRM 考勤组特殊日期 Response VO")
+    @Data
+    public static class SpecialDate {
+
+        @Schema(description = "日期类型", example = "1")
+        private Integer type;
+
+        @Schema(description = "特殊日期")
+        private LocalDateTime date;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组班次配置 Response VO")
+    @Data
+    public static class Shift {
+
+        @Schema(description = "工作日数组", example = "[1, 2, 3, 4, 5]")
+        private List<Integer> weeks;
+
+        @Schema(description = "上班时间", example = "09:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime startTime;
+
+        @Schema(description = "下班时间", example = "18:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime endTime;
+
+        @Schema(description = "上班打卡开始时间", example = "08:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockInStartTime;
+
+        @Schema(description = "上班打卡结束时间", example = "10:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockInEndTime;
+
+        @Schema(description = "下班打卡开始时间", example = "17:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockOutStartTime;
+
+        @Schema(description = "下班打卡结束时间", example = "20:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockOutEndTime;
+
+        @Schema(description = "休息开始时间", example = "12:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime restStartTime;
+
+        @Schema(description = "休息结束时间", example = "13:00")
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime restEndTime;
+
+        @Schema(description = "休息时间是否不计入工作时长")
+        private Boolean excludeRestTime;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组打卡地点 Response VO")
+    @Data
+    public static class Point {
+
+        @Schema(description = "地点名称", example = "总部办公区")
+        private String name;
+
+        @Schema(description = "定位地址", example = "北京市海淀区中关村大街")
+        private String address;
+
+        @Schema(description = "纬度", example = "39.983424")
+        private BigDecimal latitude;
+
+        @Schema(description = "经度", example = "116.322987")
+        private BigDecimal longitude;
+
+        @Schema(description = "有效打卡半径，单位：米", example = "300")
+        private Integer radius;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组 WiFi 配置 Response VO")
+    @Data
+    public static class Wifi {
+
+        @Schema(description = "WiFi 名称", example = "Office-WiFi")
+        private String ssid;
+
+        @Schema(description = "MAC 地址", example = "00:11:22:33:44:55")
+        private String mac;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组扣款规则 Response VO")
+    @Data
+    public static class DeductRule {
+
+        @Schema(description = "迟到扣款方式", example = "1")
+        private Integer lateMethod;
+
+        @Schema(description = "迟到扣款金额", example = "10.00")
+        private BigDecimal lateDeductMoney;
+
+        @Schema(description = "早退扣款方式", example = "1")
+        private Integer earlyMethod;
+
+        @Schema(description = "早退扣款金额", example = "10.00")
+        private BigDecimal earlyDeductMoney;
+
+        @Schema(description = "旷工扣款方式", example = "1")
+        private Integer absenteeismMethod;
+
+        @Schema(description = "旷工扣款金额", example = "100.00")
+        private BigDecimal absenteeismDeductMoney;
+
+        @Schema(description = "缺卡扣款方式", example = "1")
+        private Integer misscardMethod;
+
+        @Schema(description = "缺卡扣款金额", example = "20.00")
+        private BigDecimal misscardDeductMoney;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupSaveReqVO.java
new file mode 100644
index 0000000..aa476f8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/group/HrmAttendanceGroupSaveReqVO.java
@@ -0,0 +1,396 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.TimeRange;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceAbsenteeismDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceHolidayTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceLateEarlyDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceMisscardDeductMethodEnum;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import jakarta.validation.constraints.Positive;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.Arrays;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+@Schema(description = "管理后台 - HRM 考勤组保存 Request VO")
+@Data
+public class HrmAttendanceGroupSaveReqVO {
+
+    private static final Set<Integer> POINT_RADIUS_VALUES = new HashSet<>(
+            Arrays.asList(100, 200, 300, 400, 500, 600, 700, 800, 900, 1000, 2000, 3000));
+
+    @Schema(description = "考勤组编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "总部考勤组")
+    @NotBlank(message = "考勤组名称不能为空")
+    @Size(max = 50, message = "考勤组名称不能超过 50 个字符")
+    @DiffLogField(name = "考勤组名称")
+    private String name;
+
+    @Schema(description = "是否启用 WiFi 打卡", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否启用 WiFi 打卡不能为空")
+    @DiffLogField(name = "是否启用 WiFi 打卡")
+    private Boolean openWifiCard;
+
+    @Schema(description = "是否启用定位打卡", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否启用定位打卡不能为空")
+    @DiffLogField(name = "是否启用定位打卡")
+    private Boolean openPointCard;
+
+    @Schema(description = "是否法定节假日休息", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否法定节假日休息不能为空")
+    @DiffLogField(name = "是否法定节假日休息")
+    private Boolean rest;
+
+    @Schema(description = "特殊日期设置数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotNull(message = "特殊日期设置不能为空")
+    @DiffLogField(name = "特殊日期设置")
+    private List<SpecialDate> specialDates;
+
+    @Schema(description = "部门范围", requiredMode = Schema.RequiredMode.REQUIRED, example = "[1024, 2048]")
+    @NotNull(message = "部门范围不能为空")
+    @DiffLogField(name = "适用部门")
+    private List<@NotNull(message = "部门编号不能为空") Long> deptIds;
+
+    @Schema(description = "员工范围", requiredMode = Schema.RequiredMode.REQUIRED, example = "[1024, 2048]")
+    @NotNull(message = "员工范围不能为空")
+    @DiffLogField(name = "适用员工")
+    private List<@NotNull(message = "员工编号不能为空") Long> employeeIds;
+
+    @Schema(description = "班次配置", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "班次配置不能为空")
+    @DiffLogField(name = "班次配置")
+    private List<Shift> shifts;
+
+    @Schema(description = "打卡地点", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotNull(message = "打卡地点不能为空")
+    @DiffLogField(name = "打卡地点")
+    private List<Point> points;
+
+    @Schema(description = "打卡 WiFi", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotNull(message = "打卡 WiFi 不能为空")
+    @DiffLogField(name = "打卡 WiFi")
+    private List<Wifi> wifis;
+
+    @Schema(description = "扣款规则", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotNull(message = "扣款规则不能为空")
+    @DiffLogField(name = "扣款规则")
+    private DeductRule deductRule;
+
+    @Schema(description = "管理后台 - HRM 考勤组特殊日期")
+    @Data
+    public static class SpecialDate {
+
+        @Schema(description = "日期类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "特殊日期类型不能为空")
+        @InEnum(value = HrmAttendanceHolidayTypeEnum.class, message = "特殊日期类型必须是 {value}")
+        private Integer type;
+
+        @Schema(description = "特殊日期", requiredMode = Schema.RequiredMode.REQUIRED)
+        @NotNull(message = "特殊日期不能为空")
+        private LocalDateTime date;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组班次配置")
+    @Data
+    public static class Shift {
+
+        @Schema(description = "工作日数组", requiredMode = Schema.RequiredMode.REQUIRED, example = "[1, 2, 3, 4, 5]")
+        @NotEmpty(message = "班次工作日不能为空")
+        private List<@NotNull(message = "班次工作日不能为空")
+                @Min(value = 1, message = "班次工作日必须在 1 到 7 之间")
+                @Max(value = 7, message = "班次工作日必须在 1 到 7 之间") Integer> weeks;
+
+        @Schema(description = "上班时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "09:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "上班时间不能为空")
+        private LocalTime startTime;
+
+        @Schema(description = "下班时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "18:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "下班时间不能为空")
+        private LocalTime endTime;
+
+        @Schema(description = "上班打卡开始时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "08:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "上班打卡开始时间不能为空")
+        private LocalTime clockInStartTime;
+
+        @Schema(description = "上班打卡结束时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "10:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "上班打卡结束时间不能为空")
+        private LocalTime clockInEndTime;
+
+        @Schema(description = "下班打卡开始时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "17:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "下班打卡开始时间不能为空")
+        private LocalTime clockOutStartTime;
+
+        @Schema(description = "下班打卡结束时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "20:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "下班打卡结束时间不能为空")
+        private LocalTime clockOutEndTime;
+
+        @Schema(description = "休息开始时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "12:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "休息开始时间不能为空")
+        private LocalTime restStartTime;
+
+        @Schema(description = "休息结束时间", requiredMode = Schema.RequiredMode.REQUIRED, example = "13:00")
+        @JsonFormat(pattern = "HH:mm")
+        @NotNull(message = "休息结束时间不能为空")
+        private LocalTime restEndTime;
+
+        @Schema(description = "休息时间是否不计入工作时长", requiredMode = Schema.RequiredMode.REQUIRED)
+        @NotNull(message = "休息时间计算方式不能为空")
+        private Boolean excludeRestTime;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组打卡地点")
+    @Data
+    public static class Point {
+
+        @Schema(description = "地点名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "总部办公区")
+        @NotBlank(message = "地点名称不能为空")
+        @Size(max = 50, message = "地点名称不能超过 50 个字符")
+        private String name;
+
+        @Schema(description = "定位地址", requiredMode = Schema.RequiredMode.REQUIRED, example = "北京市海淀区中关村大街")
+        @NotBlank(message = "定位地址不能为空")
+        @Size(max = 255, message = "定位地址不能超过 255 个字符")
+        private String address;
+
+        @Schema(description = "纬度", requiredMode = Schema.RequiredMode.REQUIRED, example = "39.983424")
+        @NotNull(message = "纬度不能为空")
+        @DecimalMin(value = "-90", message = "纬度必须在 -90 到 90 之间")
+        @DecimalMax(value = "90", message = "纬度必须在 -90 到 90 之间")
+        private BigDecimal latitude;
+
+        @Schema(description = "经度", requiredMode = Schema.RequiredMode.REQUIRED, example = "116.322987")
+        @NotNull(message = "经度不能为空")
+        @DecimalMin(value = "-180", message = "经度必须在 -180 到 180 之间")
+        @DecimalMax(value = "180", message = "经度必须在 -180 到 180 之间")
+        private BigDecimal longitude;
+
+        @Schema(description = "有效打卡半径，单位：米", requiredMode = Schema.RequiredMode.REQUIRED, example = "300")
+        @NotNull(message = "有效打卡半径不能为空")
+        @Positive(message = "有效打卡半径必须大于 0")
+        private Integer radius;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组 WiFi 配置")
+    @Data
+    public static class Wifi {
+
+        @Schema(description = "WiFi 名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "Office-WiFi")
+        @NotBlank(message = "WiFi 名称不能为空")
+        @Size(max = 50, message = "WiFi 名称不能超过 50 个字符")
+        private String ssid;
+
+        @Schema(description = "MAC 地址", requiredMode = Schema.RequiredMode.REQUIRED, example = "00:11:22:33:44:55")
+        @NotBlank(message = "MAC 地址不能为空")
+        @Pattern(regexp = "^((([0-9a-fA-F]{2}:){5})|(([0-9a-fA-F]{2}-){5}))[0-9a-fA-F]{2}$",
+                message = "MAC 地址格式不正确")
+        private String mac;
+    }
+
+    @Schema(description = "管理后台 - HRM 考勤组扣款规则")
+    @Data
+    public static class DeductRule {
+
+        @Schema(description = "迟到扣款方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "迟到扣款方式不能为空")
+        @InEnum(value = HrmAttendanceLateEarlyDeductMethodEnum.class, message = "迟到扣款方式必须是 {value}")
+        private Integer lateMethod;
+
+        @Schema(description = "迟到扣款金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "10.00")
+        @NotNull(message = "迟到扣款金额不能为空")
+        @DecimalMin(value = "0", message = "迟到扣款金额不能小于 0")
+        @Digits(integer = 8, fraction = 2, message = "迟到扣款金额最多 8 位整数和 2 位小数")
+        private BigDecimal lateDeductMoney;
+
+        @Schema(description = "早退扣款方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "早退扣款方式不能为空")
+        @InEnum(value = HrmAttendanceLateEarlyDeductMethodEnum.class, message = "早退扣款方式必须是 {value}")
+        private Integer earlyMethod;
+
+        @Schema(description = "早退扣款金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "10.00")
+        @NotNull(message = "早退扣款金额不能为空")
+        @DecimalMin(value = "0", message = "早退扣款金额不能小于 0")
+        @Digits(integer = 8, fraction = 2, message = "早退扣款金额最多 8 位整数和 2 位小数")
+        private BigDecimal earlyDeductMoney;
+
+        @Schema(description = "旷工扣款方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "旷工扣款方式不能为空")
+        @InEnum(value = HrmAttendanceAbsenteeismDeductMethodEnum.class, message = "旷工扣款方式必须是 {value}")
+        private Integer absenteeismMethod;
+
+        @Schema(description = "旷工扣款金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "100.00")
+        @NotNull(message = "旷工扣款金额不能为空")
+        @DecimalMin(value = "0", message = "旷工扣款金额不能小于 0")
+        @Digits(integer = 8, fraction = 2, message = "旷工扣款金额最多 8 位整数和 2 位小数")
+        private BigDecimal absenteeismDeductMoney;
+
+        @Schema(description = "缺卡扣款方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "缺卡扣款方式不能为空")
+        @InEnum(value = HrmAttendanceMisscardDeductMethodEnum.class, message = "缺卡扣款方式必须是 {value}")
+        private Integer misscardMethod;
+
+        @Schema(description = "缺卡扣款金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "20.00")
+        @NotNull(message = "缺卡扣款金额不能为空")
+        @DecimalMin(value = "0", message = "缺卡扣款金额不能小于 0")
+        @Digits(integer = 8, fraction = 2, message = "缺卡扣款金额最多 8 位整数和 2 位小数")
+        private BigDecimal misscardDeductMoney;
+    }
+
+    @AssertTrue(message = "不同班次不能配置重复工作日")
+    @JsonIgnore
+    public boolean isShiftWeeksUnique() {
+        if (CollUtil.isEmpty(shifts)) {
+            return true;
+        }
+        Set<Integer> weeks = new HashSet<>();
+        return shifts.stream().allMatch(shift -> shift != null && CollUtil.isNotEmpty(shift.getWeeks())
+                && shift.getWeeks().stream().allMatch(weeks::add));
+    }
+
+    @AssertTrue(message = "班次上下班、打卡窗口或休息时间配置不正确")
+    @JsonIgnore
+    public boolean isShiftTimeValid() {
+        if (CollUtil.isEmpty(shifts)) {
+            return true;
+        }
+        return shifts.stream().allMatch(this::isShiftTimeValid);
+    }
+
+    private boolean isShiftTimeValid(Shift shift) {
+        if (shift == null || shift.getStartTime() == null || shift.getEndTime() == null
+                || shift.getClockInStartTime() == null || shift.getClockInEndTime() == null
+                || shift.getClockOutStartTime() == null || shift.getClockOutEndTime() == null
+                || shift.getRestStartTime() == null || shift.getRestEndTime() == null
+                || shift.getExcludeRestTime() == null) {
+            // 交由内嵌字段的 @NotNull 输出具体校验错误
+            return true;
+        }
+        if (shift.getStartTime().equals(shift.getEndTime())
+                || shift.getClockInStartTime().equals(shift.getClockInEndTime())
+                || shift.getClockOutStartTime().equals(shift.getClockOutEndTime())) {
+            return false;
+        }
+        LocalDate attendanceDate = LocalDate.of(2000, 1, 3);
+        TimeRange shiftTimeRange = CollUtil.getFirst(LocalDateTimeUtils.buildDailyTimeRanges(
+                attendanceDate, attendanceDate, shift.getStartTime(), shift.getEndTime()));
+        return LocalDateTimeUtils.findDailyTimeRange(
+                attendanceDate, shift.getClockInStartTime(), shift.getClockInEndTime(),
+                shiftTimeRange.getStartTime()) != null
+                && LocalDateTimeUtils.findDailyTimeRange(
+                        attendanceDate, shift.getClockOutStartTime(), shift.getClockOutEndTime(),
+                        shiftTimeRange.getEndTime()) != null
+                && isRestTimeValid(attendanceDate, shift, shiftTimeRange);
+    }
+
+    private boolean isRestTimeValid(LocalDate attendanceDate, Shift shift,
+                                    TimeRange shiftTimeRange) {
+        if (Boolean.FALSE.equals(shift.getExcludeRestTime())) {
+            return true;
+        }
+        if (shift.getRestStartTime().equals(shift.getRestEndTime())) {
+            return false;
+        }
+        List<TimeRange> restTimeRanges = LocalDateTimeUtils.buildDailyTimeRanges(
+                attendanceDate.minusDays(1), attendanceDate.plusDays(1),
+                shift.getRestStartTime(), shift.getRestEndTime());
+        return CollUtil.findOne(restTimeRanges, restTimeRange ->
+                LocalDateTimeUtils.isAfterOrEqual(restTimeRange.getStartTime(), shiftTimeRange.getStartTime())
+                        && LocalDateTimeUtils.isBeforeOrEqual(
+                        restTimeRange.getEndTime(), shiftTimeRange.getEndTime())) != null;
+    }
+
+    @AssertTrue(message = "特殊日期不能重复")
+    @JsonIgnore
+    public boolean isSpecialDatesUnique() {
+        if (CollUtil.isEmpty(specialDates)) {
+            return true;
+        }
+        Set<LocalDate> dates = new HashSet<>();
+        return specialDates.stream().allMatch(specialDate -> specialDate != null && specialDate.getDate() != null
+                && dates.add(specialDate.getDate().toLocalDate()));
+    }
+
+    @AssertTrue(message = "考勤组至少需要选择一个适用部门或员工")
+    @JsonIgnore
+    public boolean isScopeValid() {
+        if (deptIds == null || employeeIds == null) {
+            return true;
+        }
+        return CollUtil.isNotEmpty(deptIds) || CollUtil.isNotEmpty(employeeIds);
+    }
+
+    @AssertTrue(message = "考勤组至少需要启用定位打卡或 WiFi 打卡")
+    @JsonIgnore
+    public boolean isClockMethodValid() {
+        if (openPointCard == null || openWifiCard == null) {
+            return true;
+        }
+        return openPointCard || openWifiCard;
+    }
+
+    @AssertTrue(message = "启用定位打卡时，打卡地点不能为空")
+    @JsonIgnore
+    public boolean isPointSettingValid() {
+        if (Boolean.TRUE.equals(openPointCard)) {
+            return CollUtil.isNotEmpty(points);
+        }
+        return true;
+    }
+
+    @AssertTrue(message = "启用 WiFi 打卡时，打卡 WiFi 不能为空")
+    @JsonIgnore
+    public boolean isWifiSettingValid() {
+        if (Boolean.TRUE.equals(openWifiCard)) {
+            return CollUtil.isNotEmpty(wifis);
+        }
+        return true;
+    }
+
+    @AssertTrue(message = "有效打卡半径必须是 100 至 1000 米（间隔 100 米），或 2000、3000 米")
+    @JsonIgnore
+    public boolean isPointRadiusValid() {
+        if (CollUtil.isEmpty(points)) {
+            return true;
+        }
+        return points.stream().allMatch(point -> point != null
+                && point.getRadius() != null && POINT_RADIUS_VALUES.contains(point.getRadius()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidayPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidayPageReqVO.java
new file mode 100644
index 0000000..84b817c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidayPageReqVO.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceHolidayTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 考勤节假日分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmAttendanceHolidayPageReqVO extends PageParam {
+
+    @Schema(description = "日期范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] date;
+
+    @Schema(description = "节假日类型", example = "1")
+    @InEnum(value = HrmAttendanceHolidayTypeEnum.class, message = "节假日类型必须是 {value}")
+    private Integer type;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidayRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidayRespVO.java
new file mode 100644
index 0000000..3e520e8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidayRespVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 考勤节假日 Response VO")
+@Data
+public class HrmAttendanceHolidayRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "日期")
+    private LocalDateTime date;
+
+    @Schema(description = "考勤假期类型")
+    private Integer type;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidaySaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidaySaveReqVO.java
new file mode 100644
index 0000000..d999235
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/holiday/HrmAttendanceHolidaySaveReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceHolidayTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 考勤节假日保存 Request VO")
+@Data
+public class HrmAttendanceHolidaySaveReqVO {
+
+    @Schema(description = "节假日编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "日期不能为空")
+    private LocalDateTime date;
+
+    @Schema(description = "节假日类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "类型不能为空")
+    @InEnum(value = HrmAttendanceHolidayTypeEnum.class, message = "节假日类型必须是 {value}")
+    private Integer type;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveCancelReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveCancelReqVO.java
new file mode 100644
index 0000000..1089d4c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveCancelReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工请假申请取消 Request VO")
+@Data
+public class HrmAttendanceLeaveCancelReqVO {
+
+    @Schema(description = "请假记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "请假记录编号不能为空")
+    private Long id;
+
+    @Schema(description = "取消原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "行程取消")
+    @NotBlank(message = "取消原因不能为空")
+    @Size(max = 500, message = "取消原因不能超过 500 个字符")
+    private String reason;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveCreateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveCreateReqVO.java
new file mode 100644
index 0000000..c01783c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveCreateReqVO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工请假申请创建 Request VO")
+@Data
+public class HrmAttendanceLeaveCreateReqVO {
+
+    @Schema(description = "请假类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "事假")
+    @NotBlank(message = "请假类型不能为空")
+    @Size(max = 64, message = "请假类型不能超过 64 个字符")
+    private String type;
+
+    @Schema(description = "请假开始时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "请假开始时间不能为空")
+    private LocalDateTime startTime;
+
+    @Schema(description = "请假结束时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "请假结束时间不能为空")
+    private LocalDateTime endTime;
+
+    @Schema(description = "请假天数", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.00")
+    @NotNull(message = "请假天数不能为空")
+    @DecimalMin(value = "0.01", message = "请假天数必须大于 0")
+    @Digits(integer = 8, fraction = 2, message = "请假天数最多保留两位小数")
+    private BigDecimal day;
+
+    @Schema(description = "请假事由", requiredMode = Schema.RequiredMode.REQUIRED, example = "个人事务")
+    @NotBlank(message = "请假事由不能为空")
+    @Size(max = 300, message = "请假事由不能超过 300 个字符")
+    private String reason;
+
+    @Schema(description = "备注", example = "请审批")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @Schema(hidden = true)
+    @AssertTrue(message = "请假结束时间必须晚于请假开始时间")
+    @JsonIgnore
+    public boolean isTimeRangeValid() {
+        return startTime == null || endTime == null || endTime.isAfter(startTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeavePageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeavePageReqVO.java
new file mode 100644
index 0000000..dc39afc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeavePageReqVO.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave;
+
+import cn.iocoder.yudao.framework.common.pojo.SortablePageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 请假记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmAttendanceLeavePageReqVO extends SortablePageParam {
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "部门编号数组", example = "[100, 101]")
+    private List<Long> deptIds;
+
+    @Schema(description = "员工姓名或工号", example = "张三")
+    private String employeeKeyword;
+
+    @Schema(description = "请假类型数组", example = "[事假, 病假]")
+    private List<String> types;
+
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    @Schema(description = "开始时间")
+    private LocalDateTime[] startTime;
+
+    @Schema(description = "审批状态", example = "2")
+    private Integer approvalStatus;
+
+    @Schema(hidden = true)
+    private Collection<Long> employeeIds;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveRespVO.java
new file mode 100644
index 0000000..d21dc36
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/leave/HrmAttendanceLeaveRespVO.java
@@ -0,0 +1,87 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 请假记录 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class HrmAttendanceLeaveRespVO {
+
+    @Schema(description = "请假记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @ExcelProperty(value = "记录编号", index = 0)
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1001")
+    @ExcelProperty(value = "员工编号", index = 1)
+    private Long employeeId;
+
+    @Schema(description = "员工姓名", example = "张三")
+    @ExcelProperty(value = "员工姓名", index = 2)
+    private String employeeName;
+
+    @Schema(description = "工号", example = "HRM001")
+    @ExcelProperty(value = "工号", index = 3)
+    private String jobNumber;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "部门名称", example = "研发部")
+    @ExcelProperty(value = "部门", index = 4)
+    private String deptName;
+
+    @Schema(description = "职位名称", example = "Java 工程师")
+    @ExcelProperty(value = "岗位", index = 5)
+    private String postName;
+
+    @Schema(description = "请假类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "事假")
+    @ExcelProperty(value = "请假类型", index = 6, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_ATTENDANCE_LEAVE_TYPE)
+    private String type;
+
+    @Schema(description = "开始时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty(value = "开始时间", index = 7)
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty(value = "结束时间", index = 8)
+    private LocalDateTime endTime;
+
+    @Schema(description = "请假天数", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.0")
+    @ExcelProperty(value = "请假天数", index = 9)
+    private BigDecimal day;
+
+    @Schema(description = "请假事由", example = "个人事务")
+    @ExcelProperty(value = "请假事由", index = 10)
+    private String reason;
+
+    @Schema(description = "备注")
+    @ExcelProperty(value = "备注", index = 11)
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @ExcelProperty(value = "创建时间", index = 12)
+    private LocalDateTime createTime;
+
+    @Schema(description = "审批状态", example = "1")
+    private Integer approvalStatus;
+
+    @Schema(description = "流程实例编号")
+    private String processInstanceId;
+
+    @Schema(description = "审批时间")
+    private LocalDateTime approvalTime;
+
+    @Schema(description = "审批意见")
+    private String approvalReason;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyDetailReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyDetailReqVO.java
new file mode 100644
index 0000000..2b77cc8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyDetailReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 员工每日考勤明细 Request VO")
+@Data
+public class HrmAttendanceDailyDetailReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工不能为空")
+    private Long employeeId;
+
+    @Schema(description = "考勤日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "考勤日期不能为空")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime attendanceTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyDetailRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyDetailRespVO.java
new file mode 100644
index 0000000..4708af0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyDetailRespVO.java
@@ -0,0 +1,104 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockRespVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工每日考勤明细 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class HrmAttendanceDailyDetailRespVO {
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "部门名称")
+    private String deptName;
+
+    @Schema(description = "职位名称")
+    private String postName;
+
+    @ExcelProperty(value = "日期", index = 0)
+    @Schema(description = "日期")
+    private LocalDateTime attendanceTime;
+
+    @ExcelProperty(value = "班次", index = 1)
+    @Schema(description = "班次")
+    private String shiftName;
+
+    @Schema(description = "是否排班")
+    private Boolean scheduled;
+
+    @Schema(description = "应打卡次数")
+    private Integer requiredClockCount;
+
+    @Schema(description = "排班分钟数")
+    private Integer scheduledMinutes;
+
+    @ExcelProperty(value = "缺卡次数", index = 8)
+    @Schema(description = "缺卡次数")
+    private Integer misscardCount;
+
+    @Schema(description = "是否旷工")
+    private Boolean absenteeism;
+
+    @Schema(description = "旷工分钟数")
+    private Integer absenteeismMinutes;
+
+    @ExcelProperty(value = "旷工天数", index = 9)
+    @Schema(description = "旷工天数")
+    private BigDecimal absenteeismDays;
+
+    @Schema(description = "是否请假")
+    private Boolean leaveStatus;
+
+    @Schema(description = "请假分钟数")
+    private Integer leaveMinutes;
+
+    @ExcelProperty(value = "请假天数", index = 10)
+    @Schema(description = "请假天数")
+    private BigDecimal leaveDays;
+
+    @ExcelProperty(value = "考勤结果", index = 2)
+    @Schema(description = "考勤结果")
+    private String attendanceResult;
+
+    @ExcelProperty(value = "打卡次数", index = 3)
+    @Schema(description = "打卡次数")
+    private Integer clockCount;
+
+    @ExcelProperty(value = "迟到次数", index = 4)
+    @Schema(description = "迟到次数")
+    private Integer lateCount;
+
+    @ExcelProperty(value = "迟到分钟", index = 5)
+    @Schema(description = "迟到分钟")
+    private Integer lateMinutes;
+
+    @ExcelProperty(value = "早退次数", index = 6)
+    @Schema(description = "早退次数")
+    private Integer earlyCount;
+
+    @ExcelProperty(value = "早退分钟", index = 7)
+    @Schema(description = "早退分钟")
+    private Integer earlyMinutes;
+
+    @Schema(description = "打卡列表")
+    private List<HrmAttendanceClockRespVO> clockList;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyOverviewRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyOverviewRespVO.java
new file mode 100644
index 0000000..ed72469
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceDailyOverviewRespVO.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockRespVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工每日打卡概况 Response VO")
+@Data
+public class HrmAttendanceDailyOverviewRespVO {
+
+    @Schema(description = "打卡记录")
+    private List<HrmAttendanceClockRespVO> clocks;
+
+    @Schema(description = "考勤结果")
+    private String attendanceResult;
+
+    @Schema(description = "打卡概况展示项")
+    private List<OverviewItem> overviews;
+
+    @Schema(description = "管理后台 - HRM 员工每日打卡概况展示项 Response VO")
+    @Data
+    public static class OverviewItem {
+
+        @Schema(description = "打卡类型")
+        private String type;
+
+        @Schema(description = "打卡时间")
+        private String time;
+
+        @Schema(description = "打卡状态")
+        private String status;
+
+        @Schema(description = "考勤结果")
+        private String text;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthDailyOverviewRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthDailyOverviewRespVO.java
new file mode 100644
index 0000000..f6cc003
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthDailyOverviewRespVO.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.util.Map;
+
+@Schema(description = "管理后台 - HRM 员工月度打卡概况 Response VO")
+@Data
+public class HrmAttendanceMonthDailyOverviewRespVO {
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "部门名称")
+    private String deptName;
+
+    @Schema(description = "职位名称")
+    private String postName;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "每日打卡概况，Key 为日期")
+    private Map<LocalDate, HrmAttendanceDailyOverviewRespVO> dailyClockMap;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthDetailRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthDetailRespVO.java
new file mode 100644
index 0000000..32e83d6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthDetailRespVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveRespVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工月度考勤详情 Response VO")
+@Data
+public class HrmAttendanceMonthDetailRespVO {
+
+    @Schema(description = "月度汇总")
+    private HrmAttendanceMonthRecordRespVO summary;
+
+    @Schema(description = "每日打卡明细")
+    private List<HrmAttendanceDailyDetailRespVO> dailyDetails;
+
+    @Schema(description = "请假记录")
+    private List<HrmAttendanceLeaveRespVO> leaves;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthRecordPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthRecordPageReqVO.java
new file mode 100644
index 0000000..b65b106
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthRecordPageReqVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工月度考勤汇总分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmAttendanceMonthRecordPageReqVO extends PageParam {
+
+    @Schema(description = "员工姓名或工号，模糊匹配", example = "张三")
+    private String search;
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "部门编号数组", example = "100,101")
+    private List<Long> deptIds;
+
+    @Schema(description = "年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    @NotNull(message = "年份不能为空")
+    private Integer year;
+
+    @Schema(description = "月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    @NotNull(message = "月份不能为空")
+    @Min(value = 1, message = "月份必须在 1 到 12 之间")
+    @Max(value = 12, message = "月份必须在 1 到 12 之间")
+    private Integer month;
+
+    @Schema(description = "是否全勤", example = "true")
+    private Boolean fullAttendance;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthRecordRespVO.java
new file mode 100644
index 0000000..5aa1eb7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/attendance/vo/statistics/HrmAttendanceMonthRecordRespVO.java
@@ -0,0 +1,126 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工月度考勤汇总 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class HrmAttendanceMonthRecordRespVO {
+
+    @ExcelProperty(value = "员工编号", index = 0)
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @ExcelProperty(value = "员工姓名", index = 1)
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @ExcelProperty(value = "工号", index = 2)
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @ExcelProperty(value = "部门", index = 3)
+    @Schema(description = "部门名称")
+    private String deptName;
+
+    @Schema(description = "职位名称")
+    @ExcelProperty(value = "岗位", index = 4)
+    private String postName;
+
+    @Schema(description = "考勤组名称")
+    private String attendanceGroupName;
+
+    @Schema(description = "入职时间")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "员工状态")
+    private Integer employeeStatus;
+
+    @Schema(description = "工作城市")
+    private String workCity;
+
+    @ExcelProperty(value = "年份", index = 5)
+    @Schema(description = "年份")
+    private Integer year;
+
+    @ExcelProperty(value = "月份", index = 6)
+    @Schema(description = "月份")
+    private Integer month;
+
+    @ExcelProperty(value = "应出勤天数", index = 7)
+    @Schema(description = "应出勤天数")
+    private Integer attendDays;
+
+    @ExcelProperty(value = "实际出勤天数", index = 8)
+    @Schema(description = "实际出勤天数")
+    private BigDecimal actualDays;
+
+    @ExcelProperty(value = "迟到时长（分钟）", index = 9)
+    @Schema(description = "迟到时长（分钟）")
+    private Integer lateMinute;
+
+    @ExcelProperty(value = "迟到次数", index = 10)
+    @Schema(description = "迟到次数")
+    private Integer lateCount;
+
+    @ExcelProperty(value = "早退时长（分钟）", index = 11)
+    @Schema(description = "早退时长（分钟）")
+    private Integer earlyMinute;
+
+    @ExcelProperty(value = "早退次数", index = 12)
+    @Schema(description = "早退次数")
+    private Integer earlyCount;
+
+    @ExcelProperty(value = "缺卡次数", index = 13)
+    @Schema(description = "缺卡次数")
+    private Integer misscardCount;
+
+    @ExcelProperty(value = "旷工天数", index = 14)
+    @Schema(description = "旷工天数")
+    private BigDecimal absenteeismDays;
+
+    @ExcelProperty(value = "旷工时长（分钟）", index = 15)
+    @Schema(description = "旷工时长（分钟）")
+    private Integer absenteeismMinutes;
+
+    @ExcelProperty(value = "请假天数", index = 16)
+    @Schema(description = "请假天数")
+    private BigDecimal leaveDays;
+
+    @ExcelProperty(value = "请假时长（分钟）", index = 17)
+    @Schema(description = "请假时长（分钟）")
+    private Integer leaveMinutes;
+
+    @ExcelProperty(value = "迟到扣款", index = 18)
+    @Schema(description = "迟到扣款")
+    private BigDecimal lateDeductAmount;
+
+    @ExcelProperty(value = "早退扣款", index = 19)
+    @Schema(description = "早退扣款")
+    private BigDecimal earlyDeductAmount;
+
+    @ExcelProperty(value = "缺卡扣款", index = 20)
+    @Schema(description = "缺卡扣款")
+    private BigDecimal misscardDeductAmount;
+
+    @ExcelProperty(value = "旷工扣款", index = 21)
+    @Schema(description = "旷工扣款")
+    private BigDecimal absenteeismDeductAmount;
+
+    @ExcelProperty(value = "考勤扣款合计", index = 22)
+    @Schema(description = "考勤扣款合计")
+    private BigDecimal attendanceDeductAmount;
+
+    @Schema(description = "是否全勤")
+    private Boolean fullAttendance;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeCertificateController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeCertificateController.java
new file mode 100644
index 0000000..770f50e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeCertificateController.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate.HrmEmployeeCertificateRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate.HrmEmployeeCertificateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeCertificateDO;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeCertificateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工证书")
+@RestController
+@RequestMapping("/hrm/employee/certificate")
+@Validated
+public class HrmEmployeeCertificateController {
+
+    @Resource
+    private HrmEmployeeCertificateService certificateService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工证书列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeCertificateRespVO>> getCertificateList(
+            @RequestParam("employeeId") Long employeeId) {
+        List<HrmEmployeeCertificateDO> certificates = certificateService.getCertificateListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(certificates, HrmEmployeeCertificateRespVO.class));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工证书")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Long> createCertificate(
+            @Valid @RequestBody HrmEmployeeCertificateSaveReqVO reqVO) {
+        return success(certificateService.createCertificate(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新员工证书")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> updateCertificate(
+            @Valid @RequestBody HrmEmployeeCertificateSaveReqVO reqVO) {
+        certificateService.updateCertificate(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工证书")
+    @Parameter(name = "id", description = "证书编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteCertificate(@RequestParam("id") Long id) {
+        certificateService.deleteCertificate(id);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeChangeRecordController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeChangeRecordController.java
new file mode 100644
index 0000000..a8cba82
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeChangeRecordController.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeChangeRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.stream.Stream;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+
+@Tag(name = "管理后台 - HRM 员工异动记录")
+@RestController
+@RequestMapping("/hrm/employee/change-record")
+@Validated
+public class HrmEmployeeChangeRecordController {
+
+    @Resource
+    private HrmEmployeeChangeRecordService changeRecordService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private DeptApi deptApi;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工异动记录列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeChangeRecordRespVO>> getEmployeeChangeRecordList(
+            @RequestParam("employeeId") Long employeeId) {
+        return success(buildEmployeeChangeRecordRespVOList(
+                changeRecordService.getEmployeeChangeRecordListByEmployeeId(employeeId)));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<HrmEmployeeChangeRecordRespVO> buildEmployeeChangeRecordRespVOList(
+            List<HrmEmployeeChangeRecordDO> changeRecords) {
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSetByFlatMap(changeRecords, changeRecord -> Stream.of(changeRecord.getOldDeptId(), changeRecord.getNewDeptId())));
+        Map<Long, HrmEmployeeDO> leaderEmployeeMap = employeeService.getEmployeeMap(
+                convertSetByFlatMap(changeRecords, changeRecord -> Stream.of(changeRecord.getOldLeaderEmployeeId(), changeRecord.getNewLeaderEmployeeId())));
+        return BeanUtils.toBean(changeRecords, HrmEmployeeChangeRecordRespVO.class, changeRecord -> {
+            MapUtils.findAndThen(deptMap, changeRecord.getOldDeptId(),
+                    dept -> changeRecord.setOldDeptName(dept.getName()));
+            MapUtils.findAndThen(deptMap, changeRecord.getNewDeptId(),
+                    dept -> changeRecord.setNewDeptName(dept.getName()));
+            MapUtils.findAndThen(leaderEmployeeMap, changeRecord.getOldLeaderEmployeeId(),
+                    leader -> changeRecord.setOldLeaderEmployeeName(leader.getName()));
+            MapUtils.findAndThen(leaderEmployeeMap, changeRecord.getNewLeaderEmployeeId(),
+                    leader -> changeRecord.setNewLeaderEmployeeName(leader.getName()));
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeContactController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeContactController.java
new file mode 100644
index 0000000..d68cfd7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeContactController.java
@@ -0,0 +1,72 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact.HrmEmployeeContactRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact.HrmEmployeeContactSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeContactDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeContactService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工联系人")
+@RestController
+@RequestMapping("/hrm/employee/contact")
+@Validated
+public class HrmEmployeeContactController {
+
+    @Resource
+    private HrmEmployeeContactService contactService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工联系人列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeContactRespVO>> getContactList(
+            @RequestParam("employeeId") Long employeeId) {
+        List<HrmEmployeeContactDO> contacts = contactService.getContactListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(contacts, HrmEmployeeContactRespVO.class));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工联系人")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Long> createContact(@Valid @RequestBody HrmEmployeeContactSaveReqVO reqVO) {
+        return success(contactService.createContact(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新员工联系人")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> updateContact(@Valid @RequestBody HrmEmployeeContactSaveReqVO reqVO) {
+        contactService.updateContact(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工联系人")
+    @Parameter(name = "id", description = "联系人编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteContact(@RequestParam("id") Long id) {
+        contactService.deleteContact(id);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeContractController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeContractController.java
new file mode 100644
index 0000000..365b71b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeContractController.java
@@ -0,0 +1,72 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contract.HrmEmployeeContractRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contract.HrmEmployeeContractSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeContractDO;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeContractService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工合同")
+@RestController
+@RequestMapping("/hrm/employee/contract")
+@Validated
+public class HrmEmployeeContractController {
+
+    @Resource
+    private HrmEmployeeContractService contractService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工合同列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeContractRespVO>> getContractList(
+            @RequestParam("employeeId") Long employeeId) {
+        List<HrmEmployeeContractDO> contracts = contractService.getContractListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(contracts, HrmEmployeeContractRespVO.class));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工合同")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Long> createContract(@Valid @RequestBody HrmEmployeeContractSaveReqVO reqVO) {
+        return success(contractService.createContract(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新员工合同")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> updateContract(@Valid @RequestBody HrmEmployeeContractSaveReqVO reqVO) {
+        contractService.updateContract(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工合同")
+    @Parameter(name = "id", description = "合同编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteContract(@RequestParam("id") Long id) {
+        contractService.deleteContract(id);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeController.java
new file mode 100644
index 0000000..be75c78
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeController.java
@@ -0,0 +1,477 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeConvertToFullTimeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeDemoteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeePromoteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeRegularReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeTransferReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCancelQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeConfirmEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCreateFromUserReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeDeptStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportExcelVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeNotifyRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeRehireReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeStatusCountRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeSalaryCardDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeSalaryCardService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.Size;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getFirst;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sum;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getYearsBetween;
+
+@Tag(name = "管理后台 - HRM 员工档案")
+@RestController
+@RequestMapping("/hrm/employee")
+@Validated
+public class HrmEmployeeController {
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmRecruitChannelService recruitChannelService;
+    @Resource
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @Resource
+    private HrmEmployeeSalaryCardService employeeSalaryCardService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private DeptApi deptApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工档案")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:create')")
+    public CommonResult<Long> createEmployee(@Valid @RequestBody HrmEmployeeSaveReqVO createReqVO) {
+        return success(employeeService.createEmployee(createReqVO));
+    }
+
+    @PostMapping("/create-list")
+    @Operation(summary = "从未建档后台用户批量创建员工档案")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:create')")
+    public CommonResult<List<Long>> createEmployeeList(
+            @RequestBody @NotEmpty(message = "待创建员工列表不能为空")
+            @Size(max = 100, message = "单次最多创建 100 名员工")
+            List<@Valid HrmEmployeeCreateFromUserReqVO> createReqVOList) {
+        return success(employeeService.createEmployeeList(createReqVOList));
+    }
+
+    @GetMapping("/bound-user-id-list")
+    @Operation(summary = "获得已经建立员工档案的后台用户编号列表")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:create')")
+    public CommonResult<List<Long>> getBoundUserIdList() {
+        return success(employeeService.getBoundUserIdList());
+    }
+
+    @PostMapping("/send-profile-fill-message")
+    @Operation(summary = "发送填写员工档案通知")
+    @Parameter(name = "ids", description = "员工编号数组", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<HrmEmployeeNotifyRespVO> sendEmployeeProfileFillMessage(
+            @RequestParam("ids") @NotEmpty(message = "员工不能为空")
+            @Size(max = 100, message = "单次最多通知 100 名员工") List<Long> ids) {
+        return success(employeeService.sendEmployeeProfileFillMessage(ids));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新员工档案")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> updateEmployee(@Valid @RequestBody HrmEmployeeSaveReqVO updateReqVO) {
+        employeeService.updateEmployee(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工档案")
+    @Parameter(name = "id", description = "员工档案编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteEmployee(@RequestParam("id") Long id) {
+        employeeService.deleteEmployee(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "批量删除员工档案")
+    @Parameter(name = "ids", description = "员工档案编号数组", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteEmployeeList(@RequestParam("ids") @NotEmpty List<Long> ids) {
+        employeeService.deleteEmployeeList(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得员工档案")
+    @Parameter(name = "id", description = "员工档案编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<HrmEmployeeRespVO> getEmployee(@RequestParam("id") Long id) {
+        return success(buildEmployeeRespVO(employeeService.getEmployee(id)));
+    }
+
+    @PutMapping("/confirm-entry")
+    @Operation(summary = "确认员工入职")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> confirmEmployeeEntry(@Valid @RequestBody HrmEmployeeConfirmEntryReqVO reqVO) {
+        employeeService.confirmEmployeeEntry(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/rehire")
+    @Operation(summary = "办理离职员工再入职")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> rehireEmployee(@Valid @RequestBody HrmEmployeeRehireReqVO reqVO) {
+        employeeService.rehireEmployee(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/regular")
+    @Operation(summary = "办理员工转正")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> regularEmployee(@Valid @RequestBody HrmEmployeeRegularReqVO reqVO) {
+        employeeService.regularEmployee(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/transfer")
+    @Operation(summary = "办理员工调岗")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> transferEmployee(@Valid @RequestBody HrmEmployeeTransferReqVO reqVO) {
+        employeeService.transferEmployee(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/promote")
+    @Operation(summary = "办理员工晋升")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> promoteEmployee(@Valid @RequestBody HrmEmployeePromoteReqVO reqVO) {
+        employeeService.promoteEmployee(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/demote")
+    @Operation(summary = "办理员工降级")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> demoteEmployee(@Valid @RequestBody HrmEmployeeDemoteReqVO reqVO) {
+        employeeService.demoteEmployee(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/convert-to-full-time")
+    @Operation(summary = "办理员工转为全职")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> convertEmployeeToFullTime(
+            @Valid @RequestBody HrmEmployeeConvertToFullTimeReqVO reqVO) {
+        employeeService.convertEmployeeToFullTime(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/quit")
+    @Operation(summary = "办理员工离职")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> quitEmployee(@Valid @RequestBody HrmEmployeeQuitReqVO reqVO) {
+        employeeService.quitEmployee(reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/cancel-quit")
+    @Operation(summary = "取消员工离职")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> cancelEmployeeQuit(@Valid @RequestBody HrmEmployeeCancelQuitReqVO reqVO) {
+        employeeService.cancelEmployeeQuit(reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得员工档案分页")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<PageResult<HrmEmployeeRespVO>> getEmployeePage(@Validated HrmEmployeePageReqVO pageReqVO) {
+        PageResult<HrmEmployeeDO> pageResult = employeeService.getEmployeePage(pageReqVO);
+        return success(new PageResult<>(buildEmployeeRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工列表", description = "用于表单回显已选员工")
+    @Parameter(name = "ids", description = "员工编号列表", required = true, example = "[1024]")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeRespVO>> getEmployeeList(@RequestParam("ids") @NotEmpty List<Long> ids) {
+        return success(buildEmployeeRespVOList(employeeService.getEmployeeListByIds(ids)));
+    }
+
+    @GetMapping("/simple-page")
+    @Operation(summary = "获得员工精简分页", description = "只返回员工选择器需要的非敏感字段")
+    public CommonResult<PageResult<HrmEmployeeRespVO>> getEmployeeSimplePage(
+            @Validated HrmEmployeePageReqVO pageReqVO) {
+        PageResult<HrmEmployeeDO> pageResult = employeeService.getEmployeePage(pageReqVO);
+        return success(new PageResult<>(buildEmployeeSimpleRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得员工精简列表", description = "用于员工选择器回显已选员工")
+    @Parameter(name = "ids", description = "员工编号列表", required = true, example = "[1024]")
+    public CommonResult<List<HrmEmployeeRespVO>> getEmployeeSimpleList(
+            @RequestParam("ids") @NotEmpty List<Long> ids) {
+        return success(buildEmployeeSimpleRespVOList(employeeService.getEmployeeListByIds(ids)));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出员工档案")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:export')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void exportEmployee(@Validated HrmEmployeePageReqVO exportReqVO,
+                               HttpServletResponse response) throws IOException {
+        exportReqVO.setPageSize(PageParam.PAGE_SIZE_NONE);
+        List<HrmEmployeeRespVO> list = buildEmployeeExportRespVOList(employeeService.getEmployeeList(
+                BeanUtils.toBean(exportReqVO, HrmEmployeeListReqVO.class)));
+        ExcelUtils.write(response, "员工档案.xlsx", "数据", HrmEmployeeRespVO.class, list);
+    }
+
+    @GetMapping("/get-import-template")
+    @Operation(summary = "获得员工档案导入模板")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void importTemplate(HttpServletResponse response) throws IOException {
+        List<HrmEmployeeImportExcelVO> list = Collections.singletonList(
+                HrmEmployeeImportExcelVO.builder()
+                        .name("张三").jobNumber("HRM001").mobile("15601691300")
+                        .country("中国").nation("汉族").idType(5).idNumber("OTHER-19900101")
+                        .sex(1).email("hrm@example.com").nativePlace("浙江杭州")
+                        .birthday(LocalDateTime.of(1990, 1, 1, 0, 0))
+                        .address("杭州市西湖区").highestEducation(8)
+                        .deptId(1L).leaderJobNumber("HRM000")
+                        .postName("Java 工程师").postLevel("P6")
+                        .entryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                        .status(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                        .type(HrmEmployeeTypeEnum.FORMAL.getType()).probation(3)
+                        .entryTime(LocalDateTime.of(2026, 7, 9, 9, 0))
+                        .regularTime(LocalDateTime.of(2026, 10, 9, 9, 0))
+                        .workCity("杭州").workAddress("西湖区").workDetailAddress("文三路")
+                        .companyAgeStartTime(LocalDateTime.of(2026, 7, 9, 9, 0))
+                        .userMobile("15601691301")
+                        .bankCardNumber("622202600001").bankAreaId(330100).bankName("招商银行")
+                        .bankBranchName("杭州高新支行").firstSocialSecurity(false)
+                        .firstAccumulationFund(false).socialSecurityNumber("SB20260001")
+                        .accumulationFundNumber("GJJ20260001")
+                        .socialSecurityStartMonth(LocalDateTime.of(2026, 7, 1, 0, 0))
+                        .schemeName("杭州标准参保方案")
+                        .remark("示例员工").build()
+        );
+        ExcelUtils.write(response, "员工档案导入模板.xlsx", "员工列表", HrmEmployeeImportExcelVO.class, list);
+    }
+
+    @PostMapping("/import")
+    @Operation(summary = "导入员工档案")
+    @Parameters({
+            @Parameter(name = "file", description = "Excel 文件", required = true),
+            @Parameter(name = "duplicateStrategy", description = "重复员工处理策略：1 跳过，2 覆盖，3 判失败", example = "3")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:employee:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<HrmEmployeeImportRespVO> importExcel(
+            @RequestParam("file") MultipartFile file,
+            @RequestParam(value = "duplicateStrategy", required = false, defaultValue = "3") Integer duplicateStrategy)
+            throws Exception {
+        List<HrmEmployeeImportExcelVO> list = ExcelUtils.read(file, HrmEmployeeImportExcelVO.class);
+        return success(employeeService.importEmployeeList(list, duplicateStrategy));
+    }
+
+    @GetMapping("/status-count")
+    @Operation(summary = "获得员工状态统计")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeStatusCountRespVO>> getEmployeeStatusCount(
+            @Validated HrmEmployeePageReqVO pageReqVO) {
+        Map<Integer, Long> countMap = employeeService.getEmployeeStatusCount(pageReqVO);
+        return success(convertList(Arrays.asList(HrmEmployeeStatusTabEnum.values()),
+                status -> new HrmEmployeeStatusCountRespVO(status.getStatus(),
+                        countMap.getOrDefault(status.getStatus(), 0L))));
+    }
+
+    @GetMapping("/dept-statistics")
+    @Operation(summary = "获得员工部门统计")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeDeptStatisticsRespVO>> getEmployeeDeptStatistics() {
+        Map<Long, Map<Integer, Long>> countMap = employeeService.getEmployeeCountMapByDeptAndType();
+        return success(convertList(countMap.entrySet(), entry -> {
+            Map<Integer, Long> typeCountMap = entry.getValue();
+            long activeCount = sum(typeCountMap.values(), Long::longValue);
+            return new HrmEmployeeDeptStatisticsRespVO(entry.getKey(), activeCount,
+                    typeCountMap.getOrDefault(HrmEmployeeTypeEnum.FORMAL.getType(), 0L),
+                    typeCountMap.getOrDefault(HrmEmployeeTypeEnum.INFORMAL.getType(), 0L));
+        }));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmEmployeeRespVO buildEmployeeRespVO(HrmEmployeeDO employee) {
+        if (employee == null) {
+            return null;
+        }
+        return getFirst(buildEmployeeRespVOList(Collections.singletonList(employee)));
+    }
+
+    private List<HrmEmployeeRespVO> buildEmployeeRespVOList(List<HrmEmployeeDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1.1 后台用户信息
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(list, HrmEmployeeDO::getUserId));
+        // 1.2 部门信息
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(list, HrmEmployeeDO::getDeptId));
+        // 1.3 直属上级员工信息
+        Map<Long, HrmEmployeeDO> leaderEmployeeMap = employeeService.getEmployeeMap(
+                convertSet(list, HrmEmployeeDO::getLeaderEmployeeId));
+        // 1.4 招聘渠道信息
+        Map<Long, HrmRecruitChannelDO> channelMap = recruitChannelService.getRecruitChannelMap(
+                convertSet(list, HrmEmployeeDO::getChannelId));
+        // 1.5 工资卡和社保资料
+        Set<Long> employeeIds = convertSet(list, HrmEmployeeDO::getId);
+        Map<Long, HrmEmployeeSalaryCardDO> salaryCardMap =
+                employeeSalaryCardService.getSalaryCardMap(employeeIds);
+        Map<Long, HrmInsuranceEmployeeInfoDO> insuranceEmployeeInfoMap =
+                insuranceEmployeeInfoService.getInsuranceEmployeeInfoMap(employeeIds);
+
+        // 2. 拼接响应
+        LocalDate today = LocalDate.now();
+        return BeanUtils.toBean(list, HrmEmployeeRespVO.class, vo -> {
+            MapUtils.findAndThen(userMap, vo.getUserId(), user -> vo.setUserNickname(user.getNickname()));
+            MapUtils.findAndThen(deptMap, vo.getDeptId(), dept -> vo.setDeptName(dept.getName()));
+            MapUtils.findAndThen(leaderEmployeeMap, vo.getLeaderEmployeeId(),
+                    leader -> vo.setLeaderEmployeeName(leader.getName()));
+            MapUtils.findAndThen(channelMap, vo.getChannelId(),
+                    channel -> vo.setChannelName(channel.getName()));
+            MapUtils.findAndThen(salaryCardMap, vo.getId(), salaryCard -> vo
+                    .setSalaryCardNumber(salaryCard.getBankCardNumber())
+                    .setSalaryCardAreaId(salaryCard.getBankAreaId())
+                    .setSalaryCardAreaName(AreaUtils.format(salaryCard.getBankAreaId()))
+                    .setSalaryCardBankName(salaryCard.getBankName())
+                    .setSalaryCardBankBranchName(salaryCard.getBankBranchName()));
+            MapUtils.findAndThen(insuranceEmployeeInfoMap, vo.getId(), socialSecurity -> vo
+                    .setSocialSecurityNumber(socialSecurity.getSocialSecurityNumber())
+                    .setAccumulationFundNumber(socialSecurity.getAccumulationFundNumber()));
+            if (vo.getBirthday() != null) {
+                vo.setAge(getYearsBetween(vo.getBirthday().toLocalDate(), today));
+            }
+            if (vo.getCompanyAgeStartTime() != null) {
+                vo.setCompanyAge(getYearsBetween(vo.getCompanyAgeStartTime().toLocalDate(), today));
+            }
+        });
+    }
+
+    private List<HrmEmployeeRespVO> buildEmployeeSimpleRespVOList(List<HrmEmployeeDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 查询部门和直属上级信息
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(list, HrmEmployeeDO::getDeptId));
+        Map<Long, HrmEmployeeDO> leaderEmployeeMap = employeeService.getEmployeeMap(
+                convertSet(list, HrmEmployeeDO::getLeaderEmployeeId));
+
+        // 2. 拼接精简响应
+        return convertList(list, employee -> {
+            HrmEmployeeRespVO vo = new HrmEmployeeRespVO()
+                    .setId(employee.getId()).setName(employee.getName())
+                    .setJobNumber(employee.getJobNumber()).setMobile(employee.getMobile())
+                    .setDeptId(employee.getDeptId()).setLeaderEmployeeId(employee.getLeaderEmployeeId())
+                    .setPostName(employee.getPostName()).setPostLevel(employee.getPostLevel())
+                    .setEntryStatus(employee.getEntryStatus()).setStatus(employee.getStatus());
+            MapUtils.findAndThen(deptMap, employee.getDeptId(), dept -> vo.setDeptName(dept.getName()));
+            MapUtils.findAndThen(leaderEmployeeMap, employee.getLeaderEmployeeId(),
+                    leader -> vo.setLeaderEmployeeName(leader.getName()));
+            return vo;
+        });
+    }
+
+    private List<HrmEmployeeRespVO> buildEmployeeExportRespVOList(List<HrmEmployeeDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 查询导出展示信息，不加载工资卡和社保等敏感聚合
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(convertSet(list, HrmEmployeeDO::getUserId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(list, HrmEmployeeDO::getDeptId));
+        Map<Long, HrmEmployeeDO> leaderEmployeeMap = employeeService.getEmployeeMap(
+                convertSet(list, HrmEmployeeDO::getLeaderEmployeeId));
+        Map<Long, HrmRecruitChannelDO> channelMap = recruitChannelService.getRecruitChannelMap(
+                convertSet(list, HrmEmployeeDO::getChannelId));
+
+        // 2. 拼接安全导出字段
+        return convertList(list, employee -> {
+            HrmEmployeeRespVO vo = new HrmEmployeeRespVO()
+                    .setId(employee.getId()).setName(employee.getName())
+                    .setJobNumber(employee.getJobNumber()).setMobile(employee.getMobile())
+                    .setPostName(employee.getPostName()).setPostLevel(employee.getPostLevel())
+                    .setEntryStatus(employee.getEntryStatus()).setStatus(employee.getStatus()).setType(employee.getType())
+                    .setEntryTime(employee.getEntryTime()).setRegularTime(employee.getRegularTime())
+                    .setLeaveTime(employee.getLeaveTime())
+                    .setWorkCity(employee.getWorkCity()).setWorkAddress(employee.getWorkAddress());
+            MapUtils.findAndThen(userMap, employee.getUserId(), user -> vo.setUserNickname(user.getNickname()));
+            MapUtils.findAndThen(deptMap, employee.getDeptId(), dept -> vo.setDeptName(dept.getName()));
+            MapUtils.findAndThen(leaderEmployeeMap, employee.getLeaderEmployeeId(),
+                    leader -> vo.setLeaderEmployeeName(leader.getName()));
+            MapUtils.findAndThen(channelMap, employee.getChannelId(), channel -> vo.setChannelName(channel.getName()));
+            return vo;
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeEducationExperienceController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeEducationExperienceController.java
new file mode 100644
index 0000000..abb6800
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeEducationExperienceController.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience.HrmEmployeeEducationExperienceRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience.HrmEmployeeEducationExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeEducationExperienceDO;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeEducationExperienceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工教育经历")
+@RestController
+@RequestMapping("/hrm/employee/education-experience")
+@Validated
+public class HrmEmployeeEducationExperienceController {
+
+    @Resource
+    private HrmEmployeeEducationExperienceService educationExperienceService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工教育经历列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeEducationExperienceRespVO>> getEducationExperienceList(
+            @RequestParam("employeeId") Long employeeId) {
+        List<HrmEmployeeEducationExperienceDO> educationExperiences =
+                educationExperienceService.getEducationExperienceListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(educationExperiences, HrmEmployeeEducationExperienceRespVO.class));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工教育经历")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Long> createEducationExperience(
+            @Valid @RequestBody HrmEmployeeEducationExperienceSaveReqVO reqVO) {
+        return success(educationExperienceService.createEducationExperience(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新员工教育经历")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> updateEducationExperience(
+            @Valid @RequestBody HrmEmployeeEducationExperienceSaveReqVO reqVO) {
+        educationExperienceService.updateEducationExperience(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工教育经历")
+    @Parameter(name = "id", description = "教育经历编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteEducationExperience(@RequestParam("id") Long id) {
+        educationExperienceService.deleteEducationExperience(id);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeFieldConfigController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeFieldConfigController.java
new file mode 100644
index 0000000..48c3f2a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeFieldConfigController.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeArchiveFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeCreateFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigRespVO;
+import cn.iocoder.yudao.module.hrm.service.employee.config.HrmEmployeeFieldConfigService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工字段配置")
+@RestController
+@RequestMapping("/hrm/employee/config")
+@Validated
+public class HrmEmployeeFieldConfigController {
+
+    @Resource
+    private HrmEmployeeFieldConfigService employeeFieldConfigService;
+
+    @GetMapping("/create-field/list")
+    @Operation(summary = "获得新建员工字段配置")
+    @Parameter(name = "entryStatus", description = "入职状态：1 在职，2 待入职", required = true, example = "1")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:config:query') or @ss.hasPermission('hrm:employee:create')")
+    public CommonResult<List<HrmEmployeeFieldConfigRespVO>> getEmployeeCreateFieldConfigList(
+            @RequestParam("entryStatus") Integer entryStatus) {
+        return success(employeeFieldConfigService.getEmployeeCreateFieldConfigList(entryStatus));
+    }
+
+    @PutMapping("/create-field/save")
+    @Operation(summary = "保存新建员工字段配置")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:config:update')")
+    public CommonResult<Boolean> saveEmployeeCreateFieldConfig(
+            @Valid @RequestBody HrmEmployeeCreateFieldConfigSaveReqVO reqVO) {
+        employeeFieldConfigService.saveEmployeeCreateFieldConfig(reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/archive-field/list")
+    @Operation(summary = "获得员工档案字段配置")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:config:query')")
+    public CommonResult<List<HrmEmployeeFieldConfigRespVO>> getEmployeeArchiveFieldConfigList() {
+        return success(employeeFieldConfigService.getEmployeeArchiveFieldConfigList());
+    }
+
+    @PutMapping("/archive-field/save")
+    @Operation(summary = "保存员工档案字段配置")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:config:update')")
+    public CommonResult<Boolean> saveEmployeeArchiveFieldConfig(
+            @Valid @RequestBody HrmEmployeeArchiveFieldConfigSaveReqVO reqVO) {
+        employeeFieldConfigService.saveEmployeeArchiveFieldConfig(reqVO);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeFileController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeFileController.java
new file mode 100644
index 0000000..3e54592
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeFileController.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.file.HrmEmployeeFileRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.file.HrmEmployeeFileSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeFileDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeFileService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工材料附件")
+@RestController
+@RequestMapping("/hrm/employee/file")
+@Validated
+public class HrmEmployeeFileController {
+
+    @Resource
+    private HrmEmployeeFileService employeeFileService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工材料附件列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeFileRespVO>> getEmployeeFileList(
+            @RequestParam("employeeId") Long employeeId) {
+        List<HrmEmployeeFileDO> employeeFiles = employeeFileService.getEmployeeFileList(employeeId);
+        return success(BeanUtils.toBean(employeeFiles, HrmEmployeeFileRespVO.class));
+    }
+
+    @PutMapping("/save")
+    @Operation(summary = "保存员工材料附件")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> saveEmployeeFiles(@Valid @RequestBody HrmEmployeeFileSaveReqVO reqVO) {
+        employeeFileService.saveEmployeeFiles(reqVO);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeePersonalNoteController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeePersonalNoteController.java
new file mode 100644
index 0000000..8dfacb5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeePersonalNoteController.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.personalnote.HrmEmployeePersonalNoteCreateReqVO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeePersonalNoteService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工个人备忘")
+@RestController
+@RequestMapping("/hrm/employee/personal-note")
+@Validated
+public class HrmEmployeePersonalNoteController {
+
+    @Resource
+    private HrmEmployeePersonalNoteService personalNoteService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工个人备忘")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:personal-note:create')")
+    public CommonResult<Long> createPersonalNote(
+            @Valid @RequestBody HrmEmployeePersonalNoteCreateReqVO reqVO) {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        return success(personalNoteService.createPersonalNote(employeeId, reqVO));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工个人备忘")
+    @Parameter(name = "id", description = "员工个人备忘编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:personal-note:delete')")
+    public CommonResult<Boolean> deletePersonalNote(@RequestParam("id") Long id) {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        personalNoteService.deletePersonalNote(employeeId, id);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeQuitInfoController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeQuitInfoController.java
new file mode 100644
index 0000000..b26172e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeQuitInfoController.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo.HrmEmployeeQuitInfoRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeQuitInfoService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工离职信息")
+@RestController
+@RequestMapping("/hrm/employee/quit-info")
+@Validated
+public class HrmEmployeeQuitInfoController {
+
+    @Resource
+    private HrmEmployeeQuitInfoService quitInfoService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得员工离职信息")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<HrmEmployeeQuitInfoRespVO> getQuitInfo(
+            @RequestParam("employeeId") Long employeeId) {
+        HrmEmployeeQuitInfoDO quitInfo = quitInfoService.getQuitInfoByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(quitInfo, HrmEmployeeQuitInfoRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeSalaryCardController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeSalaryCardController.java
new file mode 100644
index 0000000..854d10c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeSalaryCardController.java
@@ -0,0 +1,68 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard.HrmEmployeeSalaryCardRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard.HrmEmployeeSalaryCardSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeSalaryCardDO;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeSalaryCardService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工工资卡")
+@RestController
+@RequestMapping("/hrm/employee/salary-card")
+@Validated
+public class HrmEmployeeSalaryCardController {
+
+    @Resource
+    private HrmEmployeeSalaryCardService salaryCardService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得员工工资卡")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<HrmEmployeeSalaryCardRespVO> getEmployeeSalaryCard(
+            @RequestParam("employeeId") Long employeeId) {
+        HrmEmployeeSalaryCardDO salaryCard = salaryCardService.getSalaryCardByEmployeeId(employeeId);
+        if (salaryCard == null) {
+            return success(null);
+        }
+        HrmEmployeeSalaryCardRespVO respVO = BeanUtils.toBean(salaryCard, HrmEmployeeSalaryCardRespVO.class)
+                .setBankAreaName(AreaUtils.format(salaryCard.getBankAreaId()));
+        return success(respVO);
+    }
+
+    @PutMapping("/save")
+    @Operation(summary = "保存员工工资卡")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Long> saveEmployeeSalaryCard(
+            @Valid @RequestBody HrmEmployeeSalaryCardSaveReqVO reqVO) {
+        return success(salaryCardService.saveSalaryCard(reqVO));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工工资卡")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> deleteEmployeeSalaryCard(@RequestParam("employeeId") Long employeeId) {
+        salaryCardService.deleteSalaryCardByEmployeeId(employeeId);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeTrainingExperienceController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeTrainingExperienceController.java
new file mode 100644
index 0000000..b90bf12
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeTrainingExperienceController.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience.HrmEmployeeTrainingExperienceRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience.HrmEmployeeTrainingExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeTrainingExperienceDO;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeTrainingExperienceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工培训经历")
+@RestController
+@RequestMapping("/hrm/employee/training-experience")
+@Validated
+public class HrmEmployeeTrainingExperienceController {
+
+    @Resource
+    private HrmEmployeeTrainingExperienceService trainingExperienceService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工培训经历列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeTrainingExperienceRespVO>> getTrainingExperienceList(
+            @RequestParam("employeeId") Long employeeId) {
+        List<HrmEmployeeTrainingExperienceDO> trainingExperiences =
+                trainingExperienceService.getTrainingExperienceListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(trainingExperiences, HrmEmployeeTrainingExperienceRespVO.class));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工培训经历")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Long> createTrainingExperience(
+            @Valid @RequestBody HrmEmployeeTrainingExperienceSaveReqVO reqVO) {
+        return success(trainingExperienceService.createTrainingExperience(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新员工培训经历")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> updateTrainingExperience(
+            @Valid @RequestBody HrmEmployeeTrainingExperienceSaveReqVO reqVO) {
+        trainingExperienceService.updateTrainingExperience(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工培训经历")
+    @Parameter(name = "id", description = "培训经历编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteTrainingExperience(@RequestParam("id") Long id) {
+        trainingExperienceService.deleteTrainingExperience(id);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeWorkExperienceController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeWorkExperienceController.java
new file mode 100644
index 0000000..47d23b7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/HrmEmployeeWorkExperienceController.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience.HrmEmployeeWorkExperienceRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience.HrmEmployeeWorkExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeWorkExperienceDO;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeWorkExperienceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工工作经历")
+@RestController
+@RequestMapping("/hrm/employee/work-experience")
+@Validated
+public class HrmEmployeeWorkExperienceController {
+
+    @Resource
+    private HrmEmployeeWorkExperienceService workExperienceService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工工作经历列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:query')")
+    public CommonResult<List<HrmEmployeeWorkExperienceRespVO>> getWorkExperienceList(
+            @RequestParam("employeeId") Long employeeId) {
+        List<HrmEmployeeWorkExperienceDO> workExperiences =
+                workExperienceService.getWorkExperienceListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(workExperiences, HrmEmployeeWorkExperienceRespVO.class));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建员工工作经历")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Long> createWorkExperience(
+            @Valid @RequestBody HrmEmployeeWorkExperienceSaveReqVO reqVO) {
+        return success(workExperienceService.createWorkExperience(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新员工工作经历")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:update')")
+    public CommonResult<Boolean> updateWorkExperience(
+            @Valid @RequestBody HrmEmployeeWorkExperienceSaveReqVO reqVO) {
+        workExperienceService.updateWorkExperience(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除员工工作经历")
+    @Parameter(name = "id", description = "工作经历编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:employee:delete')")
+    public CommonResult<Boolean> deleteWorkExperience(@RequestParam("id") Long id) {
+        workExperienceService.deleteWorkExperience(id);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/certificate/HrmEmployeeCertificateRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/certificate/HrmEmployeeCertificateRespVO.java
new file mode 100644
index 0000000..25ba685
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/certificate/HrmEmployeeCertificateRespVO.java
@@ -0,0 +1,48 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工证书 Response VO")
+@Data
+public class HrmEmployeeCertificateRespVO {
+
+    @Schema(description = "证书编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "证书名称", example = "高级工程师")
+    private String name;
+
+    @Schema(description = "证书级别", example = "高级")
+    private String level;
+
+    @Schema(description = "证书编号", example = "CERT-001")
+    private String no;
+
+    @Schema(description = "有效起始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "有效结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "发证机构", example = "人社局")
+    private String issuingAuthority;
+
+    @Schema(description = "发证日期")
+    private LocalDateTime issuingTime;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/certificate/HrmEmployeeCertificateSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/certificate/HrmEmployeeCertificateSaveReqVO.java
new file mode 100644
index 0000000..79b48ed
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/certificate/HrmEmployeeCertificateSaveReqVO.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isAfterOrEqual;
+
+@Schema(description = "管理后台 - HRM 员工证书保存 Request VO")
+@Data
+public class HrmEmployeeCertificateSaveReqVO {
+
+    @Schema(description = "证书编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "证书名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "高级工程师")
+    @NotBlank(message = "证书名称不能为空")
+    @Size(max = 255, message = "证书名称长度不能超过 255 个字符")
+    @DiffLogField(name = "证书名称")
+    private String name;
+
+    @Schema(description = "证书级别", example = "高级")
+    @Size(max = 255, message = "证书级别长度不能超过 255 个字符")
+    @DiffLogField(name = "证书级别")
+    private String level;
+
+    @Schema(description = "证书编号", example = "CERT-001")
+    @Size(max = 255, message = "证书编号长度不能超过 255 个字符")
+    @DiffLogField(name = "证书编号")
+    private String no;
+
+    @Schema(description = "有效起始日期")
+    @DiffLogField(name = "有效起始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "有效结束日期")
+    @DiffLogField(name = "有效结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "发证机构", example = "人社局")
+    @Size(max = 255, message = "发证机构长度不能超过 255 个字符")
+    @DiffLogField(name = "发证机构")
+    private String issuingAuthority;
+
+    @Schema(description = "发证日期")
+    @DiffLogField(name = "发证日期")
+    private LocalDateTime issuingTime;
+
+    @Schema(description = "备注", example = "专业技术资格证书")
+    @Size(max = 500, message = "备注长度不能超过 500 个字符")
+    @DiffLogField(name = "备注")
+    private String remark;
+
+    @Schema(description = "排序", example = "1")
+    @DiffLogField(name = "排序")
+    private Integer sort;
+
+    @AssertTrue(message = "证书有效期的结束日期不能早于开始日期")
+    @JsonIgnore
+    public boolean isTimeRangeValid() {
+        return startTime == null || endTime == null || isAfterOrEqual(endTime, startTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeChangeRecordCreateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeChangeRecordCreateReqVO.java
new file mode 100644
index 0000000..0c514c8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeChangeRecordCreateReqVO.java
@@ -0,0 +1,81 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工异动记录创建 Request VO")
+@Data
+public class HrmEmployeeChangeRecordCreateReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "异动类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "5")
+    @NotNull(message = "异动类型不能为空")
+    @InEnum(value = HrmEmployeeChangeTypeEnum.class, message = "异动类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "异动原因", example = "1")
+    @InEnum(value = HrmEmployeeChangeReasonEnum.class, message = "异动原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "原部门编号", example = "100")
+    private Long oldDeptId;
+
+    @Schema(description = "原岗位名称", example = "Java 工程师")
+    @Size(max = 255, message = "原岗位名称不能超过 255 个字符")
+    private String oldPostName;
+
+    @Schema(description = "原职级", example = "P5")
+    @Size(max = 255, message = "原职级不能超过 255 个字符")
+    private String oldPostLevel;
+
+    @Schema(description = "原工作地点", example = "杭州")
+    @Size(max = 255, message = "原工作地点不能超过 255 个字符")
+    private String oldWorkAddress;
+
+    @Schema(description = "原直属上级员工编号", example = "2")
+    private Long oldLeaderEmployeeId;
+
+    @Schema(description = "新部门编号", example = "200")
+    private Long newDeptId;
+
+    @Schema(description = "新岗位名称", example = "高级 Java 工程师")
+    @Size(max = 255, message = "新岗位名称不能超过 255 个字符")
+    private String newPostName;
+
+    @Schema(description = "新职级", example = "P6")
+    @Size(max = 255, message = "新职级不能超过 255 个字符")
+    private String newPostLevel;
+
+    @Schema(description = "新工作地点", example = "上海")
+    @Size(max = 255, message = "新工作地点不能超过 255 个字符")
+    private String newWorkAddress;
+
+    @Schema(description = "新直属上级员工编号", example = "3")
+    private Long newLeaderEmployeeId;
+
+    @Schema(description = "试用期，单位月", example = "3")
+    @Min(value = 0, message = "试用期不能小于 0")
+    @Max(value = 6, message = "试用期不能超过 6 个月")
+    private Integer probation;
+
+    @Schema(description = "生效时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "生效时间不能为空")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "年度晋升")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeChangeRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeChangeRecordRespVO.java
new file mode 100644
index 0000000..5c747a1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeChangeRecordRespVO.java
@@ -0,0 +1,78 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工异动记录 Response VO")
+@Data
+public class HrmEmployeeChangeRecordRespVO {
+
+    @Schema(description = "异动编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "变动类型", example = "5")
+    private Integer type;
+
+    @Schema(description = "异动原因", example = "1")
+    private Integer reason;
+
+    @Schema(description = "原部门编号", example = "100")
+    private Long oldDeptId;
+
+    @Schema(description = "原部门名称", example = "研发部")
+    private String oldDeptName;
+
+    @Schema(description = "新部门编号", example = "200")
+    private Long newDeptId;
+
+    @Schema(description = "新部门名称", example = "产品部")
+    private String newDeptName;
+
+    @Schema(description = "原岗位名称")
+    private String oldPostName;
+
+    @Schema(description = "新岗位名称")
+    private String newPostName;
+
+    @Schema(description = "原职级")
+    private String oldPostLevel;
+
+    @Schema(description = "新职级")
+    private String newPostLevel;
+
+    @Schema(description = "原工作地点")
+    private String oldWorkAddress;
+
+    @Schema(description = "新工作地点")
+    private String newWorkAddress;
+
+    @Schema(description = "原直属上级员工编号")
+    private Long oldLeaderEmployeeId;
+
+    @Schema(description = "原直属上级员工姓名")
+    private String oldLeaderEmployeeName;
+
+    @Schema(description = "新直属上级员工编号")
+    private Long newLeaderEmployeeId;
+
+    @Schema(description = "新直属上级员工姓名")
+    private String newLeaderEmployeeName;
+
+    @Schema(description = "试用期，单位月")
+    private Integer probation;
+
+    @Schema(description = "生效日期")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeConvertToFullTimeReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeConvertToFullTimeReqVO.java
new file mode 100644
index 0000000..1907443
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeConvertToFullTimeReqVO.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeReasonEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工转为全职 Request VO")
+@Data
+public class HrmEmployeeConvertToFullTimeReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "异动原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "异动原因不能为空")
+    @InEnum(value = HrmEmployeeChangeReasonEnum.class, message = "异动原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "试用期，单位：月；0 表示无试用期", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "3")
+    @NotNull(message = "试用期不能为空")
+    @Min(value = 0, message = "试用期不能小于 0")
+    @Max(value = 6, message = "试用期不能超过 6 个月")
+    private Integer probation;
+
+    @Schema(description = "新部门编号；未填写表示不变", example = "200")
+    private Long newDeptId;
+
+    @Schema(description = "新岗位名称；未填写表示不变", example = "Java 工程师")
+    @Size(max = 255, message = "新岗位名称不能超过 255 个字符")
+    private String newPostName;
+
+    @Schema(description = "新职级；未填写表示不变", example = "P6")
+    @Size(max = 255, message = "新职级不能超过 255 个字符")
+    private String newPostLevel;
+
+    @Schema(description = "新工作地点；未填写表示不变", example = "上海")
+    @Size(max = 255, message = "新工作地点不能超过 255 个字符")
+    private String newWorkAddress;
+
+    @Schema(description = "新直属上级员工编号；未填写表示不变", example = "3")
+    private Long newLeaderEmployeeId;
+
+    @Schema(description = "生效日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "生效日期不能为空")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "转为全职员工")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeDemoteReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeDemoteReqVO.java
new file mode 100644
index 0000000..0442e0e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeDemoteReqVO.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeReasonEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工降级 Request VO")
+@Data
+public class HrmEmployeeDemoteReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "异动原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "异动原因不能为空")
+    @InEnum(value = HrmEmployeeChangeReasonEnum.class, message = "异动原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "新部门编号", example = "200")
+    private Long newDeptId;
+
+    @Schema(description = "新岗位名称", example = "Java 工程师")
+    @Size(max = 255, message = "新岗位名称不能超过 255 个字符")
+    private String newPostName;
+
+    @Schema(description = "新职级", example = "P5")
+    @Size(max = 255, message = "新职级不能超过 255 个字符")
+    private String newPostLevel;
+
+    @Schema(description = "新工作地点", example = "杭州")
+    @Size(max = 255, message = "新工作地点不能超过 255 个字符")
+    private String newWorkAddress;
+
+    @Schema(description = "新直属上级员工编号", example = "3")
+    private Long newLeaderEmployeeId;
+
+    @Schema(description = "生效日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "生效日期不能为空")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "岗位职级调整")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @AssertTrue(message = "降级原因不合法")
+    @JsonIgnore
+    public boolean isReasonValid() {
+        return reason == null || HrmEmployeeChangeReasonEnum.DEMOTION_REASONS.contains(reason);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeePromoteReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeePromoteReqVO.java
new file mode 100644
index 0000000..3b2b1c6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeePromoteReqVO.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeReasonEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工晋升 Request VO")
+@Data
+public class HrmEmployeePromoteReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "异动原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "异动原因不能为空")
+    @InEnum(value = HrmEmployeeChangeReasonEnum.class, message = "异动原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "新部门编号", example = "200")
+    private Long newDeptId;
+
+    @Schema(description = "新岗位名称", example = "高级 Java 工程师")
+    @Size(max = 255, message = "新岗位名称不能超过 255 个字符")
+    private String newPostName;
+
+    @Schema(description = "新职级", example = "P6")
+    @Size(max = 255, message = "新职级不能超过 255 个字符")
+    private String newPostLevel;
+
+    @Schema(description = "新工作地点", example = "上海")
+    @Size(max = 255, message = "新工作地点不能超过 255 个字符")
+    private String newWorkAddress;
+
+    @Schema(description = "新直属上级员工编号", example = "3")
+    private Long newLeaderEmployeeId;
+
+    @Schema(description = "生效日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "生效日期不能为空")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "年度晋升")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @AssertTrue(message = "晋升原因不合法")
+    @JsonIgnore
+    public boolean isReasonValid() {
+        return reason == null || HrmEmployeeChangeReasonEnum.TRANSFER_AND_PROMOTION_REASONS.contains(reason);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeRegularReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeRegularReqVO.java
new file mode 100644
index 0000000..86d6c1f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeRegularReqVO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeReasonEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工转正 Request VO")
+@Data
+public class HrmEmployeeRegularReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "异动原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "异动原因不能为空")
+    @InEnum(value = HrmEmployeeChangeReasonEnum.class, message = "异动原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "新部门编号；未填写表示不变", example = "200")
+    private Long newDeptId;
+
+    @Schema(description = "新岗位名称；未填写表示不变", example = "Java 工程师")
+    @Size(max = 255, message = "新岗位名称不能超过 255 个字符")
+    private String newPostName;
+
+    @Schema(description = "新职级；未填写表示不变", example = "P6")
+    @Size(max = 255, message = "新职级不能超过 255 个字符")
+    private String newPostLevel;
+
+    @Schema(description = "新工作地点；未填写表示不变", example = "上海")
+    @Size(max = 255, message = "新工作地点不能超过 255 个字符")
+    private String newWorkAddress;
+
+    @Schema(description = "新直属上级员工编号；未填写表示不变", example = "3")
+    private Long newLeaderEmployeeId;
+
+    @Schema(description = "生效日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "生效日期不能为空")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "试用期考核通过")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeTransferReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeTransferReqVO.java
new file mode 100644
index 0000000..71ef61a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/changerecord/HrmEmployeeTransferReqVO.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeReasonEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工调岗 Request VO")
+@Data
+public class HrmEmployeeTransferReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "异动原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "异动原因不能为空")
+    @InEnum(value = HrmEmployeeChangeReasonEnum.class, message = "异动原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "新部门编号", example = "200")
+    private Long newDeptId;
+
+    @Schema(description = "新岗位名称", example = "产品经理")
+    @Size(max = 255, message = "新岗位名称不能超过 255 个字符")
+    private String newPostName;
+
+    @Schema(description = "新职级", example = "P6")
+    @Size(max = 255, message = "新职级不能超过 255 个字符")
+    private String newPostLevel;
+
+    @Schema(description = "新工作地点", example = "上海")
+    @Size(max = 255, message = "新工作地点不能超过 255 个字符")
+    private String newWorkAddress;
+
+    @Schema(description = "新直属上级员工编号", example = "3")
+    private Long newLeaderEmployeeId;
+
+    @Schema(description = "生效日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "生效日期不能为空")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "业务调整")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @AssertTrue(message = "调岗原因不合法")
+    @JsonIgnore
+    public boolean isReasonValid() {
+        return reason == null || HrmEmployeeChangeReasonEnum.TRANSFER_AND_PROMOTION_REASONS.contains(reason);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeArchiveFieldConfigSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeArchiveFieldConfigSaveReqVO.java
new file mode 100644
index 0000000..d6ffbf1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeArchiveFieldConfigSaveReqVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工档案字段配置保存 Request VO")
+@Data
+public class HrmEmployeeArchiveFieldConfigSaveReqVO {
+
+    @Schema(description = "字段配置列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "字段配置列表不能为空")
+    @DiffLogField(name = "字段配置")
+    private List<HrmEmployeeFieldConfigSaveReqVO> fields;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeCreateFieldConfigSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeCreateFieldConfigSaveReqVO.java
new file mode 100644
index 0000000..f45f17f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeCreateFieldConfigSaveReqVO.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import org.hibernate.validator.constraints.Range;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 新建员工字段配置保存 Request VO")
+@Data
+public class HrmEmployeeCreateFieldConfigSaveReqVO {
+
+    @Schema(description = "入职状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "入职状态不能为空")
+    @InEnum(value = HrmEmployeeEntryStatusEnum.class, message = "入职状态必须是 {value}")
+    @Range(min = 1, max = 2, message = "入职状态必须是 1 或 2")
+    @DiffLogField(name = "入职状态")
+    private Integer entryStatus;
+
+    @Schema(description = "字段配置列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "字段配置列表不能为空")
+    @DiffLogField(name = "字段配置")
+    private List<HrmEmployeeFieldConfigSaveReqVO> fields;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigRespVO.java
new file mode 100644
index 0000000..cef80ed
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigRespVO.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工字段配置 Response VO")
+@Data
+public class HrmEmployeeFieldConfigRespVO {
+
+    @Schema(description = "字段名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "name")
+    private String name;
+
+    @Schema(description = "字段标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "员工姓名")
+    private String title;
+
+    @Schema(description = "字段分组名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "基本信息")
+    private String groupName;
+
+    @Schema(description = "是否显示", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean visible;
+
+    @Schema(description = "是否允许员工编辑", example = "true")
+    private Boolean editable;
+
+    @Schema(description = "是否锁定显示", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    private Boolean visibleLocked;
+
+    @Schema(description = "是否锁定编辑", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    private Boolean editableLocked;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigSaveReqVO.java
new file mode 100644
index 0000000..d7e773c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigSaveReqVO.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工字段配置保存 Request VO")
+@Data
+public class HrmEmployeeFieldConfigSaveReqVO {
+
+    @Schema(description = "字段名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "name")
+    @NotBlank(message = "字段名称不能为空")
+    @Size(max = 40, message = "字段名称不能超过 40 个字符")
+    @DiffLogField(name = "字段名称")
+    private String name;
+
+    @Schema(description = "是否显示", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否显示不能为空")
+    @DiffLogField(name = "是否显示")
+    private Boolean visible;
+
+    @Schema(description = "是否允许员工编辑", example = "true")
+    @DiffLogField(name = "是否允许员工编辑")
+    private Boolean editable;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigValueVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigValueVO.java
new file mode 100644
index 0000000..3b1c88b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/config/HrmEmployeeFieldConfigValueVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - HRM 员工字段配置值 VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeFieldConfigValueVO {
+
+    @Schema(description = "字段名称", example = "mobile")
+    private String name;
+
+    @Schema(description = "是否显示", example = "true")
+    private Boolean visible;
+
+    @Schema(description = "是否允许员工编辑", example = "true")
+    private Boolean editable;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contact/HrmEmployeeContactRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contact/HrmEmployeeContactRespVO.java
new file mode 100644
index 0000000..6b0c2f0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contact/HrmEmployeeContactRespVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工联系人 Response VO")
+@Data
+public class HrmEmployeeContactRespVO {
+
+    @Schema(description = "联系人编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "联系人名称", example = "李四")
+    private String name;
+
+    @Schema(description = "关系", example = "配偶")
+    private String relation;
+
+    @Schema(description = "联系人电话", example = "15601691301")
+    private String phone;
+
+    @Schema(description = "联系人工作单位")
+    private String workUnit;
+
+    @Schema(description = "联系人职务")
+    private String postName;
+
+    @Schema(description = "联系人地址")
+    private String address;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contact/HrmEmployeeContactSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contact/HrmEmployeeContactSaveReqVO.java
new file mode 100644
index 0000000..46e8cd8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contact/HrmEmployeeContactSaveReqVO.java
@@ -0,0 +1,56 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工联系人保存 Request VO")
+@Data
+public class HrmEmployeeContactSaveReqVO {
+
+    @Schema(description = "联系人编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "联系人名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "李四")
+    @NotBlank(message = "联系人名称不能为空")
+    @Size(max = 64, message = "联系人名称长度不能超过 64 个字符")
+    @DiffLogField(name = "联系人名称")
+    private String name;
+
+    @Schema(description = "关系", example = "配偶")
+    @Size(max = 64, message = "关系长度不能超过 64 个字符")
+    @DiffLogField(name = "关系")
+    private String relation;
+
+    @Schema(description = "联系人电话", example = "15601691301")
+    @Size(max = 40, message = "联系人电话长度不能超过 40 个字符")
+    @DiffLogField(name = "联系人电话")
+    private String phone;
+
+    @Schema(description = "联系人工作单位", example = "示例科技")
+    @Size(max = 128, message = "联系人工作单位长度不能超过 128 个字符")
+    @DiffLogField(name = "联系人工作单位")
+    private String workUnit;
+
+    @Schema(description = "联系人职务", example = "产品经理")
+    @Size(max = 128, message = "联系人职务长度不能超过 128 个字符")
+    @DiffLogField(name = "联系人职务")
+    private String postName;
+
+    @Schema(description = "联系人地址", example = "杭州市西湖区")
+    @Size(max = 255, message = "联系人地址长度不能超过 255 个字符")
+    @DiffLogField(name = "联系人地址")
+    private String address;
+
+    @Schema(description = "排序", example = "1")
+    @DiffLogField(name = "排序")
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contract/HrmEmployeeContractRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contract/HrmEmployeeContractRespVO.java
new file mode 100644
index 0000000..cb4265d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contract/HrmEmployeeContractRespVO.java
@@ -0,0 +1,58 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contract;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工合同 Response VO")
+@Data
+public class HrmEmployeeContractRespVO {
+
+    @Schema(description = "合同编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "合同编号", example = "HT-2026-001")
+    private String no;
+
+    @Schema(description = "合同类型", example = "1")
+    private Integer type;
+
+    @Schema(description = "合同开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "合同结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "期限", example = "36")
+    private Integer term;
+
+    @Schema(description = "合同状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "签约公司")
+    private String signCompany;
+
+    @Schema(description = "合同签订日期")
+    private LocalDateTime signTime;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "是否到期提醒", example = "true")
+    private Boolean expireRemind;
+
+    @Schema(description = "附件地址数组")
+    private List<String> fileUrls;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contract/HrmEmployeeContractSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contract/HrmEmployeeContractSaveReqVO.java
new file mode 100644
index 0000000..d2c60ed
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/contract/HrmEmployeeContractSaveReqVO.java
@@ -0,0 +1,106 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contract;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeContractStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeContractTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isAfterOrEqual;
+
+@Schema(description = "管理后台 - HRM 员工合同保存 Request VO")
+@Data
+public class HrmEmployeeContractSaveReqVO {
+
+    @Schema(description = "合同编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "合同编号", example = "HT-2026-001")
+    @Size(max = 128, message = "合同编号长度不能超过 128 个字符")
+    @DiffLogField(name = "合同编号")
+    private String no;
+
+    @Schema(description = "合同类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "合同类型不能为空")
+    @InEnum(value = HrmEmployeeContractTypeEnum.class, message = "合同类型必须是 {value}")
+    @DiffLogField(name = "合同类型")
+    private Integer type;
+
+    @Schema(description = "合同开始日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "合同开始日期不能为空")
+    @DiffLogField(name = "合同开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "合同结束日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "合同结束日期不能为空")
+    @DiffLogField(name = "合同结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "期限，单位：年", example = "3")
+    @Min(value = 1, message = "合同期限不能小于 1 年")
+    @Max(value = 10, message = "合同期限不能超过 10 年")
+    @DiffLogField(name = "合同期限")
+    private Integer term;
+
+    @Schema(description = "合同状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "合同状态不能为空")
+    @InEnum(value = HrmEmployeeContractStatusEnum.class, message = "合同状态必须是 {value}")
+    @DiffLogField(name = "合同状态")
+    private Integer status;
+
+    @Schema(description = "签约公司", example = "示例科技有限公司")
+    @Size(max = 255, message = "签约公司长度不能超过 255 个字符")
+    @DiffLogField(name = "签约公司")
+    private String signCompany;
+
+    @Schema(description = "合同签订日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "合同签订日期不能为空")
+    @DiffLogField(name = "合同签订日期")
+    private LocalDateTime signTime;
+
+    @Schema(description = "备注", example = "首次签订劳动合同")
+    @Size(max = 500, message = "备注长度不能超过 500 个字符")
+    @DiffLogField(name = "备注")
+    private String remark;
+
+    @Schema(description = "是否到期提醒", example = "true")
+    @DiffLogField(name = "是否到期提醒")
+    private Boolean expireRemind;
+
+    @Schema(description = "附件地址数组", example = "[https://example.com/contract.pdf]")
+    @DiffLogField(name = "附件")
+    private List<String> fileUrls;
+
+    @Schema(description = "排序", example = "1")
+    @DiffLogField(name = "排序")
+    private Integer sort;
+
+    @AssertTrue(message = "合同结束日期不能早于开始日期")
+    @JsonIgnore
+    public boolean isTimeRangeValid() {
+        return startTime == null || endTime == null || isAfterOrEqual(endTime, startTime);
+    }
+
+    @AssertTrue(message = "合同期限不能为空")
+    @JsonIgnore
+    public boolean isTermValid() {
+        return type == null
+                || HrmEmployeeContractTypeEnum.NON_FIXED_TERM_LABOR_CONTRACT.getType().equals(type)
+                || term != null;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/educationexperience/HrmEmployeeEducationExperienceRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/educationexperience/HrmEmployeeEducationExperienceRespVO.java
new file mode 100644
index 0000000..7efd972
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/educationexperience/HrmEmployeeEducationExperienceRespVO.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工教育经历 Response VO")
+@Data
+public class HrmEmployeeEducationExperienceRespVO {
+
+    @Schema(description = "教育经历编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "学历", example = "8")
+    private Integer education;
+
+    @Schema(description = "毕业院校", example = "浙江大学")
+    private String graduateSchool;
+
+    @Schema(description = "专业", example = "软件工程")
+    private String major;
+
+    @Schema(description = "入学日期")
+    private LocalDateTime admissionTime;
+
+    @Schema(description = "毕业日期")
+    private LocalDateTime graduationTime;
+
+    @Schema(description = "教学方式", example = "1")
+    private Integer teachingMethods;
+
+    @Schema(description = "是否第一学历", example = "true")
+    private Boolean firstDegree;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/educationexperience/HrmEmployeeEducationExperienceSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/educationexperience/HrmEmployeeEducationExperienceSaveReqVO.java
new file mode 100644
index 0000000..aa40592
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/educationexperience/HrmEmployeeEducationExperienceSaveReqVO.java
@@ -0,0 +1,71 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isAfterOrEqual;
+
+@Schema(description = "管理后台 - HRM 员工教育经历保存 Request VO")
+@Data
+public class HrmEmployeeEducationExperienceSaveReqVO {
+
+    @Schema(description = "教育经历编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "学历", requiredMode = Schema.RequiredMode.REQUIRED, example = "8")
+    @NotNull(message = "学历不能为空")
+    @DiffLogField(name = "学历")
+    private Integer education;
+
+    @Schema(description = "毕业院校", requiredMode = Schema.RequiredMode.REQUIRED, example = "浙江大学")
+    @NotBlank(message = "毕业院校不能为空")
+    @Size(max = 255, message = "毕业院校长度不能超过 255 个字符")
+    @DiffLogField(name = "毕业院校")
+    private String graduateSchool;
+
+    @Schema(description = "专业", requiredMode = Schema.RequiredMode.REQUIRED, example = "软件工程")
+    @NotBlank(message = "专业不能为空")
+    @Size(max = 255, message = "专业长度不能超过 255 个字符")
+    @DiffLogField(name = "专业")
+    private String major;
+
+    @Schema(description = "入学日期")
+    @DiffLogField(name = "入学日期")
+    private LocalDateTime admissionTime;
+
+    @Schema(description = "毕业日期")
+    @DiffLogField(name = "毕业日期")
+    private LocalDateTime graduationTime;
+
+    @Schema(description = "教学方式", example = "1")
+    @DiffLogField(name = "教学方式")
+    private Integer teachingMethods;
+
+    @Schema(description = "是否第一学历", example = "true")
+    @DiffLogField(name = "是否第一学历")
+    private Boolean firstDegree;
+
+    @Schema(description = "排序", example = "1")
+    @DiffLogField(name = "排序")
+    private Integer sort;
+
+    @AssertTrue(message = "毕业日期不能早于入学日期")
+    @JsonIgnore
+    public boolean isTimeRangeValid() {
+        return admissionTime == null || graduationTime == null
+                || isAfterOrEqual(graduationTime, admissionTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeCancelQuitReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeCancelQuitReqVO.java
new file mode 100644
index 0000000..97e13e3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeCancelQuitReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工取消离职 Request VO")
+@Data
+public class HrmEmployeeCancelQuitReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "取消原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "员工撤回离职申请")
+    @NotBlank(message = "取消原因不能为空")
+    @Size(max = 500, message = "取消原因不能超过 500 个字符")
+    private String reason;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeConfirmEntryReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeConfirmEntryReqVO.java
new file mode 100644
index 0000000..ec9a6b8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeConfirmEntryReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.beforeOrEqualNow;
+
+@Schema(description = "管理后台 - HRM 员工确认入职 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmEmployeeConfirmEntryReqVO extends HrmEmployeeSaveReqVO {
+
+    @AssertTrue(message = "入职时间不能晚于当前时间")
+    @JsonIgnore
+    public boolean isEntryTimeValid() {
+        return getEntryTime() == null || beforeOrEqualNow(getEntryTime());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeCreateFromUserReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeCreateFromUserReqVO.java
new file mode 100644
index 0000000..2413090
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeCreateFromUserReqVO.java
@@ -0,0 +1,101 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.framework.common.validation.Mobile;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 从后台用户创建员工 Request VO")
+@Data
+public class HrmEmployeeCreateFromUserReqVO {
+
+    @Schema(description = "后台用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "后台用户编号不能为空")
+    private Long userId;
+
+    @Schema(description = "工号", requiredMode = Schema.RequiredMode.REQUIRED, example = "HRM001")
+    @NotBlank(message = "工号不能为空")
+    @Size(max = 64, message = "工号不能超过 64 个字符")
+    private String jobNumber;
+
+    @Schema(description = "员工手机号", requiredMode = Schema.RequiredMode.REQUIRED, example = "15601691300")
+    @NotBlank(message = "员工手机号不能为空")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "直属上级员工编号", example = "1")
+    private Long leaderEmployeeId;
+
+    @Schema(description = "聘用形式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "聘用形式不能为空")
+    @InEnum(value = HrmEmployeeTypeEnum.class, message = "聘用形式必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "员工状态；非正式员工必填", example = "3")
+    @InEnum(value = HrmEmployeeStatusEnum.class, message = "员工状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "入职时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "入职时间不能为空")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "试用期，单位：月；正式员工必填", example = "3")
+    @Min(value = 0, message = "试用期不能小于 0")
+    @Max(value = 6, message = "试用期不能超过 6 个月")
+    private Integer probation;
+
+    @Schema(description = "职位名称", example = "Java 工程师")
+    @Size(max = 255, message = "职位名称不能超过 255 个字符")
+    private String postName;
+
+    @Schema(description = "岗位职级", example = "P6")
+    @Size(max = 255, message = "岗位职级不能超过 255 个字符")
+    private String postLevel;
+
+    @Schema(description = "工作城市", example = "杭州")
+    @Size(max = 64, message = "工作城市不能超过 64 个字符")
+    private String workCity;
+
+    @Schema(description = "工作地点", example = "西湖区")
+    @Size(max = 255, message = "工作地点不能超过 255 个字符")
+    private String workAddress;
+
+    @Schema(description = "备注", example = "从后台用户批量建档")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @AssertTrue(message = "正式员工试用期不能为空")
+    @JsonIgnore
+    public boolean isProbationValid() {
+        return ObjUtil.notEqual(HrmEmployeeTypeEnum.FORMAL.getType(), type) || probation != null;
+    }
+
+    @AssertTrue(message = "非正式员工状态不能为空")
+    @JsonIgnore
+    public boolean isStatusRequired() {
+        return ObjUtil.notEqual(HrmEmployeeTypeEnum.INFORMAL.getType(), type) || status != null;
+    }
+
+    @AssertTrue(message = "员工状态与聘用形式不匹配")
+    @JsonIgnore
+    public boolean isStatusValid() {
+        return ObjUtil.notEqual(HrmEmployeeTypeEnum.INFORMAL.getType(), type)
+                || status == null || HrmEmployeeStatusEnum.INFORMAL_STATUSES.contains(status);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeDeptStatisticsRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeDeptStatisticsRespVO.java
new file mode 100644
index 0000000..7533fb7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeDeptStatisticsRespVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工部门统计 Response VO")
+@Data
+@AllArgsConstructor
+public class HrmEmployeeDeptStatisticsRespVO {
+
+    @Schema(description = "部门编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Long deptId;
+
+    @Schema(description = "在职员工人数", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Long activeCount;
+
+    @Schema(description = "全职员工人数", requiredMode = Schema.RequiredMode.REQUIRED, example = "8")
+    private Long fullTimeCount;
+
+    @Schema(description = "非全职员工人数", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Long nonFullTimeCount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeImportExcelVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeImportExcelVO.java
new file mode 100644
index 0000000..87b37db
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeImportExcelVO.java
@@ -0,0 +1,210 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.iocoder.yudao.framework.excel.core.annotations.ExcelColumnSelect;
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.AreaConvert;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.framework.excel.core.HrmEmployeeProbationExcelColumnSelectFunction;
+import cn.iocoder.yudao.module.hrm.framework.excel.core.HrmRecruitChannelExcelColumnSelectFunction;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工档案 Excel 导入 VO")
+@Data
+@Builder
+@AllArgsConstructor
+@NoArgsConstructor
+@ExcelIgnoreUnannotated
+public class HrmEmployeeImportExcelVO {
+
+    @ExcelProperty("员工姓名")
+    @Schema(description = "员工姓名")
+    private String name;
+
+    @ExcelProperty("工号")
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @ExcelProperty("手机号")
+    @Schema(description = "手机号")
+    private String mobile;
+
+    @ExcelProperty("国家或地区")
+    @Schema(description = "国家或地区")
+    private String country;
+
+    @ExcelProperty("民族")
+    @Schema(description = "民族")
+    private String nation;
+
+    @ExcelProperty(value = "证件类型", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_ID_TYPE)
+    @ExcelColumnSelect(dictType = DictTypeConstants.HRM_EMPLOYEE_ID_TYPE)
+    @Schema(description = "证件类型")
+    private Integer idType;
+
+    @ExcelProperty("证件号码")
+    @Schema(description = "证件号码")
+    private String idNumber;
+
+    @ExcelProperty(value = "性别", converter = DictConvert.class)
+    @DictFormat(cn.iocoder.yudao.module.system.enums.DictTypeConstants.USER_SEX)
+    @ExcelColumnSelect(dictType = cn.iocoder.yudao.module.system.enums.DictTypeConstants.USER_SEX)
+    @Schema(description = "性别")
+    private Integer sex;
+
+    @ExcelProperty("邮箱")
+    @Schema(description = "邮箱")
+    private String email;
+
+    @ExcelProperty("籍贯")
+    @Schema(description = "籍贯")
+    private String nativePlace;
+
+    @ExcelProperty("出生日期")
+    @Schema(description = "出生日期")
+    private LocalDateTime birthday;
+
+    @ExcelProperty("户籍地址")
+    @Schema(description = "户籍地址")
+    private String address;
+
+    @ExcelProperty(value = "最高学历", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_EDUCATION)
+    @ExcelColumnSelect(dictType = DictTypeConstants.HRM_EMPLOYEE_EDUCATION)
+    @Schema(description = "最高学历")
+    private Integer highestEducation;
+
+    @ExcelProperty("部门编号")
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @ExcelProperty("直属上级工号")
+    @Schema(description = "直属上级工号")
+    private String leaderJobNumber;
+
+    @ExcelProperty("职位名称")
+    @Schema(description = "职位名称")
+    private String postName;
+
+    @ExcelProperty("岗位职级")
+    @Schema(description = "岗位职级")
+    private String postLevel;
+
+    @ExcelProperty(value = "入职状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_ENTRY_STATUS)
+    @ExcelColumnSelect(dictType = DictTypeConstants.HRM_EMPLOYEE_ENTRY_STATUS)
+    @Schema(description = "入职状态")
+    private Integer entryStatus;
+
+    @ExcelProperty(value = "员工状态", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_STATUS)
+    @ExcelColumnSelect(dictType = DictTypeConstants.HRM_EMPLOYEE_STATUS)
+    @Schema(description = "员工状态")
+    private Integer status;
+
+    @ExcelProperty(value = "聘用形式", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_TYPE)
+    @ExcelColumnSelect(dictType = DictTypeConstants.HRM_EMPLOYEE_TYPE)
+    @Schema(description = "聘用形式")
+    private Integer type;
+
+    @ExcelProperty("入职时间")
+    @Schema(description = "入职时间")
+    private LocalDateTime entryTime;
+
+    @ExcelProperty("试用期（月）")
+    @ExcelColumnSelect(functionName = HrmEmployeeProbationExcelColumnSelectFunction.NAME)
+    @Schema(description = "试用期（月）")
+    private Integer probation;
+
+    @ExcelProperty("转正时间")
+    @Schema(description = "转正时间")
+    private LocalDateTime regularTime;
+
+    @ExcelProperty("离职时间")
+    @Schema(description = "离职时间")
+    private LocalDateTime leaveTime;
+
+    @ExcelProperty("工作城市")
+    @Schema(description = "工作城市")
+    private String workCity;
+
+    @ExcelProperty("工作地点")
+    @Schema(description = "工作地点")
+    private String workAddress;
+
+    @ExcelProperty("工作详细地址")
+    @Schema(description = "工作详细地址")
+    private String workDetailAddress;
+
+    @ExcelProperty("招聘渠道")
+    @ExcelColumnSelect(functionName = HrmRecruitChannelExcelColumnSelectFunction.NAME)
+    @Schema(description = "招聘渠道选项，格式为名称（ID）")
+    private String channelName;
+
+    @ExcelProperty("司龄起算时间")
+    @Schema(description = "司龄起算时间")
+    private LocalDateTime companyAgeStartTime;
+
+    @ExcelProperty("绑定用户手机号")
+    @Schema(description = "绑定后台用户的手机号")
+    private String userMobile;
+
+    @ExcelProperty("银行卡号")
+    @Schema(description = "银行卡号")
+    private String bankCardNumber;
+
+    @ExcelProperty(value = "开户地区", converter = AreaConvert.class)
+    @Schema(description = "开户地区")
+    private Integer bankAreaId;
+
+    @ExcelProperty("银行名称")
+    @Schema(description = "银行名称")
+    private String bankName;
+
+    @ExcelProperty("开户支行名称")
+    @Schema(description = "开户支行名称")
+    private String bankBranchName;
+
+    @ExcelProperty(value = "是否首次参保", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.BOOLEAN_STRING)
+    @ExcelColumnSelect(dictType = DictTypeConstants.BOOLEAN_STRING)
+    @Schema(description = "是否首次参保")
+    private Boolean firstSocialSecurity;
+
+    @ExcelProperty(value = "是否首次缴纳公积金", converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.BOOLEAN_STRING)
+    @ExcelColumnSelect(dictType = DictTypeConstants.BOOLEAN_STRING)
+    @Schema(description = "是否首次缴纳公积金")
+    private Boolean firstAccumulationFund;
+
+    @ExcelProperty("个人社保账号")
+    @Schema(description = "个人社保账号")
+    private String socialSecurityNumber;
+
+    @ExcelProperty("个人公积金账号")
+    @Schema(description = "个人公积金账号")
+    private String accumulationFundNumber;
+
+    @ExcelProperty("社保起缴月份")
+    @Schema(description = "社保起缴月份")
+    private LocalDateTime socialSecurityStartMonth;
+
+    @ExcelProperty("参保方案名称")
+    @Schema(description = "参保方案名称")
+    private String schemeName;
+
+    @ExcelProperty("备注")
+    @Schema(description = "备注")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeImportRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeImportRespVO.java
new file mode 100644
index 0000000..a555dc0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeImportRespVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - HRM 员工档案导入 Response VO")
+@Data
+@Builder
+public class HrmEmployeeImportRespVO {
+
+    @Schema(description = "创建成功的工号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> createJobNumbers;
+
+    @Schema(description = "更新成功的工号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> updateJobNumbers;
+
+    @Schema(description = "因重复而跳过的工号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> skipJobNumbers;
+
+    @Schema(description = "导入失败的员工集合，key 为原始行号和员工标识，value 为失败原因",
+            requiredMode = Schema.RequiredMode.REQUIRED)
+    private Map<String, String> failureJobNumbers;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeListReqVO.java
new file mode 100644
index 0000000..0688961
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeListReqVO.java
@@ -0,0 +1,97 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeSurveyTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTodoTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 员工档案列表 Request VO")
+@Data
+public class HrmEmployeeListReqVO {
+
+    @Schema(description = "员工编号列表", example = "1,2")
+    private List<Long> ids;
+
+    @Schema(hidden = true)
+    private List<Long> excludeIds;
+
+    @Schema(description = "员工姓名或工号，模糊匹配", example = "张三")
+    private String search;
+
+    @Schema(description = "员工姓名，模糊匹配", example = "张")
+    private String name;
+
+    @Schema(description = "工号，模糊匹配", example = "HRM")
+    private String jobNumber;
+
+    @Schema(description = "手机号，模糊匹配", example = "156")
+    private String mobile;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "部门编号数组", example = "100,101")
+    private List<Long> deptIds;
+
+    @Schema(description = "直属上级员工编号", example = "1")
+    private Long leaderEmployeeId;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "入职时间范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] entryTime;
+
+    @Schema(description = "职位名称，模糊匹配", example = "Java")
+    private String postName;
+
+    @Schema(description = "转正时间范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] regularTime;
+
+    @Schema(description = "工作地点，模糊匹配", example = "西湖区")
+    private String workAddress;
+
+    @Schema(description = "招聘渠道编号", example = "10")
+    private Long channelId;
+
+    @Schema(description = "聘用形式", example = "1")
+    @InEnum(value = HrmEmployeeTypeEnum.class, message = "聘用形式必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "入职状态", example = "1")
+    @InEnum(value = HrmEmployeeEntryStatusEnum.class, message = "入职状态必须是 {value}")
+    private Integer entryStatus;
+
+    @Schema(description = "员工状态", example = "1")
+    @InEnum(value = HrmEmployeeStatusEnum.class, message = "员工状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "员工状态分类", example = "12")
+    @InEnum(value = HrmEmployeeStatusTabEnum.class, message = "员工状态分类必须是 {value}")
+    private Integer statusCategory;
+
+    @Schema(description = "首页人事概况筛选类型", example = "1")
+    @InEnum(value = HrmEmployeeSurveyTypeEnum.class, message = "首页人事概况筛选类型必须是 {value}")
+    private Integer surveyType;
+
+    @Schema(description = "首页待办筛选类型", example = "5")
+    @InEnum(value = HrmEmployeeTodoTypeEnum.class, message = "首页待办筛选类型必须是 {value}")
+    private Integer todoType;
+
+    @Schema(hidden = true)
+    private LocalDateTime[] activeTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeNotifyRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeNotifyRespVO.java
new file mode 100644
index 0000000..c54ba74
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeNotifyRespVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+@Schema(description = "管理后台 - HRM 员工通知发送结果 Response VO")
+@Data
+@Accessors(chain = true)
+public class HrmEmployeeNotifyRespVO {
+
+    @Schema(description = "发送成功数量", example = "10")
+    private Integer successCount;
+
+    @Schema(description = "无后台账号跳过数量", example = "2")
+    private Integer skippedCount;
+
+    @Schema(description = "发送失败数量", example = "1")
+    private Integer failureCount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeePageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeePageReqVO.java
new file mode 100644
index 0000000..b69b7e7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeePageReqVO.java
@@ -0,0 +1,100 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.SortablePageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeSurveyTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTodoTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 员工档案分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmEmployeePageReqVO extends SortablePageParam {
+
+    @Schema(description = "员工编号列表", example = "1,2")
+    private List<Long> ids;
+
+    @Schema(hidden = true)
+    private List<Long> excludeIds;
+
+    @Schema(description = "员工姓名、工号或手机号，模糊匹配", example = "张三")
+    private String search;
+
+    @Schema(description = "员工姓名，模糊匹配", example = "张")
+    private String name;
+
+    @Schema(description = "工号，模糊匹配", example = "HRM")
+    private String jobNumber;
+
+    @Schema(description = "手机号，模糊匹配", example = "156")
+    private String mobile;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "部门编号数组", example = "100,101")
+    private List<Long> deptIds;
+
+    @Schema(description = "直属上级员工编号", example = "1")
+    private Long leaderEmployeeId;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "入职时间范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] entryTime;
+
+    @Schema(description = "职位名称，模糊匹配", example = "Java")
+    private String postName;
+
+    @Schema(description = "转正时间范围")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] regularTime;
+
+    @Schema(description = "工作地点，模糊匹配", example = "西湖区")
+    private String workAddress;
+
+    @Schema(description = "招聘渠道编号", example = "10")
+    private Long channelId;
+
+    @Schema(description = "聘用形式", example = "1")
+    @InEnum(value = HrmEmployeeTypeEnum.class, message = "聘用形式必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "入职状态", example = "1")
+    @InEnum(value = HrmEmployeeEntryStatusEnum.class, message = "入职状态必须是 {value}")
+    private Integer entryStatus;
+
+    @Schema(description = "员工状态", example = "1")
+    @InEnum(value = HrmEmployeeStatusEnum.class, message = "员工状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "员工状态分类", example = "12")
+    @InEnum(value = HrmEmployeeStatusTabEnum.class, message = "员工状态分类必须是 {value}")
+    private Integer statusCategory;
+
+    @Schema(description = "首页人事概况筛选类型", example = "1")
+    @InEnum(value = HrmEmployeeSurveyTypeEnum.class, message = "首页人事概况筛选类型必须是 {value}")
+    private Integer surveyType;
+
+    @Schema(description = "首页待办筛选类型", example = "5")
+    @InEnum(value = HrmEmployeeTodoTypeEnum.class, message = "首页待办筛选类型必须是 {value}")
+    private Integer todoType;
+
+    @Schema(hidden = true)
+    private LocalDateTime[] activeTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeQuitReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeQuitReqVO.java
new file mode 100644
index 0000000..99b0a48
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeQuitReqVO.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeQuitReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeQuitTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isAfterOrEqual;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isBeforeOrEqual;
+
+@Schema(description = "管理后台 - HRM 员工离职 Request VO")
+@Data
+public class HrmEmployeeQuitReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "计划离职时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "计划离职时间不能为空")
+    private LocalDateTime planQuitTime;
+
+    @Schema(description = "申请离职时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "申请离职时间不能为空")
+    private LocalDateTime applyQuitTime;
+
+    @Schema(description = "薪资结算时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "薪资结算时间不能为空")
+    private LocalDateTime salarySettlementTime;
+
+    @Schema(description = "离职类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "离职类型不能为空")
+    @InEnum(value = HrmEmployeeQuitTypeEnum.class, message = "离职类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "离职原因", example = "1")
+    @InEnum(value = HrmEmployeeQuitReasonEnum.class, message = "离职原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "备注", example = "个人原因离职")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @AssertTrue(message = "申请离职时间不能晚于计划离职时间")
+    @JsonIgnore
+    public boolean isApplyQuitTimeValid() {
+        return applyQuitTime == null || planQuitTime == null
+                || isBeforeOrEqual(applyQuitTime.toLocalDate(), planQuitTime.toLocalDate());
+    }
+
+    @AssertTrue(message = "薪资结算时间不能早于计划离职时间")
+    @JsonIgnore
+    public boolean isSalarySettlementTimeValid() {
+        return salarySettlementTime == null || planQuitTime == null
+                || isAfterOrEqual(salarySettlementTime.toLocalDate(), planQuitTime.toLocalDate());
+    }
+
+    @AssertTrue(message = "离职原因与离职类型不匹配")
+    @JsonIgnore
+    public boolean isReasonValid() {
+        if (type == null || HrmEmployeeQuitTypeEnum.RETIREMENT.getType().equals(type)) {
+            return true;
+        }
+        HrmEmployeeQuitReasonEnum quitReason = HrmEmployeeQuitReasonEnum.valueOf(reason);
+        return quitReason != null && quitReason.getQuitType().equals(type);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeRehireReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeRehireReqVO.java
new file mode 100644
index 0000000..64ace83
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeRehireReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.beforeOrEqualNow;
+
+@Schema(description = "管理后台 - HRM 员工再入职 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmEmployeeRehireReqVO extends HrmEmployeeSaveReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @AssertTrue(message = "入职时间不能晚于当前时间")
+    @JsonIgnore
+    public boolean isEntryTimeValid() {
+        return getEntryTime() == null || beforeOrEqualNow(getEntryTime());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeRespVO.java
new file mode 100644
index 0000000..d7e0319
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeRespVO.java
@@ -0,0 +1,186 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工档案 Response VO")
+@Data
+@Accessors(chain = true)
+@ExcelIgnoreUnannotated
+public class HrmEmployeeRespVO {
+
+    @ExcelProperty(value = "员工编号", index = 0)
+    @Schema(description = "员工档案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @ExcelProperty(value = "员工姓名", index = 1)
+    @Schema(description = "员工姓名", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    private String name;
+
+    @ExcelProperty(value = "工号", index = 2)
+    @Schema(description = "工号", example = "HRM001")
+    private String jobNumber;
+
+    @Schema(description = "系统用户编号", example = "1024")
+    private Long userId;
+
+    @ExcelProperty(value = "绑定用户", index = 17)
+    @Schema(description = "后台用户昵称", example = "芋道")
+    private String userNickname;
+
+    @ExcelProperty(value = "手机号", index = 3)
+    @Schema(description = "手机号", example = "15601691300")
+    private String mobile;
+
+    @Schema(description = "国家地区", example = "中国")
+    private String country;
+
+    @Schema(description = "民族", example = "汉族")
+    private String nation;
+
+    @Schema(description = "证件类型", example = "1")
+    private Integer idType;
+
+    @Schema(description = "证件号码", example = "310101199001011234")
+    private String idNumber;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "邮箱", example = "hrm@example.com")
+    private String email;
+
+    @Schema(description = "籍贯", example = "浙江杭州")
+    private String nativePlace;
+
+    @Schema(description = "出生时间")
+    private LocalDateTime birthday;
+
+    @Schema(description = "年龄", example = "28")
+    private Integer age;
+
+    @Schema(description = "户籍地址", example = "杭州市西湖区")
+    private String address;
+
+    @Schema(description = "最高学历", example = "8")
+    private Integer highestEducation;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @ExcelProperty(value = "部门", index = 4)
+    @Schema(description = "部门名称", example = "研发部")
+    private String deptName;
+
+    @Schema(description = "直属上级员工编号", example = "1")
+    private Long leaderEmployeeId;
+
+    @ExcelProperty(value = "直属上级", index = 7)
+    @Schema(description = "直属上级员工姓名", example = "李四")
+    private String leaderEmployeeName;
+
+    @ExcelProperty(value = "入职状态", index = 8, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_ENTRY_STATUS)
+    @Schema(description = "入职状态", example = "1")
+    private Integer entryStatus;
+
+    @ExcelProperty(value = "员工状态", index = 9, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_STATUS)
+    @Schema(description = "员工状态", example = "1")
+    private Integer status;
+
+    @ExcelProperty(value = "聘用形式", index = 10, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_EMPLOYEE_TYPE)
+    @Schema(description = "聘用形式", example = "1")
+    private Integer type;
+
+    @ExcelProperty(value = "入职时间", index = 11)
+    @Schema(description = "入职时间")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "试用期，单位月；0 表示无试用期", example = "3")
+    private Integer probation;
+
+    @ExcelProperty(value = "转正时间", index = 12)
+    @Schema(description = "转正时间")
+    private LocalDateTime regularTime;
+
+    @ExcelProperty(value = "离职时间", index = 13)
+    @Schema(description = "离职时间")
+    private LocalDateTime leaveTime;
+
+    @ExcelProperty(value = "岗位", index = 5)
+    @Schema(description = "职位名称", example = "Java 工程师")
+    private String postName;
+
+    @ExcelProperty(value = "岗位职级", index = 6)
+    @Schema(description = "岗位职级", example = "P6")
+    private String postLevel;
+
+    @ExcelProperty(value = "工作城市", index = 14)
+    @Schema(description = "工作城市", example = "上海")
+    private String workCity;
+
+    @ExcelProperty(value = "工作地点", index = 15)
+    @Schema(description = "工作地址", example = "浦东新区")
+    private String workAddress;
+
+    @Schema(description = "工作详细地址", example = "张江高科 1 号楼")
+    private String workDetailAddress;
+
+    @Schema(description = "招聘渠道编号", example = "10")
+    private Long channelId;
+
+    @ExcelProperty(value = "招聘渠道", index = 16)
+    @Schema(description = "招聘渠道名称", example = "BOSS直聘")
+    private String channelName;
+
+    @Schema(description = "司龄开始时间")
+    private LocalDateTime companyAgeStartTime;
+
+    @Schema(description = "司龄，单位年", example = "2")
+    private Integer companyAge;
+
+    @Schema(description = "关联招聘候选人编号", example = "200")
+    private Long candidateId;
+
+    // ==================== 工资卡信息 ====================
+
+    @Schema(description = "银行卡号", example = "622202600001")
+    private String salaryCardNumber;
+
+    @Schema(description = "开户地区编号", example = "440300")
+    private Integer salaryCardAreaId;
+
+    @Schema(description = "开户地区名称", example = "广东省 深圳市")
+    private String salaryCardAreaName;
+
+    @Schema(description = "银行名称", example = "招商银行")
+    private String salaryCardBankName;
+
+    @Schema(description = "开户支行名称", example = "科技园支行")
+    private String salaryCardBankBranchName;
+
+    // ==================== 社保信息 ====================
+
+    @Schema(description = "个人社保账号", example = "SB20260001")
+    private String socialSecurityNumber;
+
+    @Schema(description = "个人公积金账号", example = "GJJ20260001")
+    private String accumulationFundNumber;
+
+    @Schema(description = "备注", example = "首批迁移员工")
+    private String remark;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeSaveReqVO.java
new file mode 100644
index 0000000..7fcad99
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeSaveReqVO.java
@@ -0,0 +1,207 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import cn.hutool.core.util.IdcardUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.framework.common.validation.Mobile;
+import cn.iocoder.yudao.module.hrm.enums.employee.experience.HrmEmployeeEducationEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeIdTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.PastOrPresent;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isBeforeOrEqual;
+
+@Schema(description = "管理后台 - HRM 员工档案新增/修改 Request VO")
+@Data
+public class HrmEmployeeSaveReqVO {
+
+    @Schema(description = "员工档案编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工姓名", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    @NotBlank(message = "员工姓名不能为空")
+    @Size(max = 255, message = "员工姓名不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "工号", example = "HRM001")
+    @Size(max = 64, message = "工号不能超过 64 个字符")
+    private String jobNumber;
+
+    @Schema(description = "系统用户编号", example = "1024")
+    private Long userId;
+
+    @Schema(description = "手机号", requiredMode = Schema.RequiredMode.REQUIRED, example = "15601691300")
+    @NotBlank(message = "手机号不能为空")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "国家地区", example = "中国")
+    @Size(max = 64, message = "国家地区不能超过 64 个字符")
+    private String country;
+
+    @Schema(description = "民族", example = "汉族")
+    @Size(max = 64, message = "民族不能超过 64 个字符")
+    private String nation;
+
+    @Schema(description = "证件类型", example = "1")
+    @InEnum(value = HrmEmployeeIdTypeEnum.class, message = "证件类型必须是 {value}")
+    private Integer idType;
+
+    @Schema(description = "证件号码", example = "310101199001011234")
+    @Size(max = 255, message = "证件号码不能超过 255 个字符")
+    private String idNumber;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "邮箱", example = "hrm@example.com")
+    @Email(message = "邮箱格式不正确")
+    @Size(max = 255, message = "邮箱不能超过 255 个字符")
+    private String email;
+
+    @Schema(description = "籍贯", example = "浙江杭州")
+    @Size(max = 128, message = "籍贯不能超过 128 个字符")
+    private String nativePlace;
+
+    @Schema(description = "出生时间")
+    @PastOrPresent(message = "出生时间不能晚于当前时间")
+    private LocalDateTime birthday;
+
+    @Schema(description = "年龄", example = "28")
+    private Integer age;
+
+    @Schema(description = "户籍地址", example = "杭州市西湖区")
+    @Size(max = 255, message = "户籍地址不能超过 255 个字符")
+    private String address;
+
+    @Schema(description = "最高学历", example = "8")
+    @InEnum(value = HrmEmployeeEducationEnum.class, message = "最高学历必须是 {value}")
+    private Integer highestEducation;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "直属上级员工编号", example = "1")
+    private Long leaderEmployeeId;
+
+    @Schema(description = "入职状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "入职状态不能为空")
+    @InEnum(value = HrmEmployeeEntryStatusEnum.class, message = "入职状态必须是 {value}")
+    private Integer entryStatus;
+
+    @Schema(description = "员工状态", example = "1")
+    @InEnum(value = HrmEmployeeStatusEnum.class, message = "员工状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "聘用形式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "聘用形式不能为空")
+    @InEnum(value = HrmEmployeeTypeEnum.class, message = "聘用形式必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "入职时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "入职时间不能为空")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "试用期，单位月；0 表示无试用期", example = "3")
+    @Min(value = 0, message = "试用期不能小于 0 个月")
+    @Max(value = 6, message = "试用期不能超过 6 个月")
+    private Integer probation;
+
+    @Schema(description = "转正时间")
+    private LocalDateTime regularTime;
+
+    @Schema(description = "离职时间")
+    private LocalDateTime leaveTime;
+
+    @Schema(description = "职位名称", example = "Java 工程师")
+    @Size(max = 255, message = "职位名称不能超过 255 个字符")
+    private String postName;
+
+    @Schema(description = "岗位职级", example = "P6")
+    @Size(max = 255, message = "岗位职级不能超过 255 个字符")
+    private String postLevel;
+
+    @Schema(description = "工作城市", example = "上海")
+    @Size(max = 64, message = "工作城市不能超过 64 个字符")
+    private String workCity;
+
+    @Schema(description = "工作地址", example = "浦东新区")
+    @Size(max = 255, message = "工作地址不能超过 255 个字符")
+    private String workAddress;
+
+    @Schema(description = "工作详细地址", example = "张江高科 1 号楼")
+    @Size(max = 255, message = "工作详细地址不能超过 255 个字符")
+    private String workDetailAddress;
+
+    @Schema(description = "招聘渠道编号", example = "10")
+    private Long channelId;
+
+    @Schema(description = "司龄开始时间")
+    private LocalDateTime companyAgeStartTime;
+
+    @Schema(description = "司龄，单位年", example = "2")
+    private Integer companyAge;
+
+    @Schema(description = "关联招聘候选人编号", example = "200")
+    private Long candidateId;
+
+    @Schema(description = "备注", example = "首批迁移员工")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @AssertTrue(message = "身份证号码格式不正确")
+    @JsonIgnore
+    public boolean isIdNumberValid() {
+        return ObjUtil.notEqual(HrmEmployeeIdTypeEnum.ID_CARD.getType(), idType)
+                || StrUtil.isBlank(idNumber) || IdcardUtil.isValidCard(idNumber);
+    }
+
+    @AssertTrue(message = "员工状态与聘用形式不匹配")
+    @JsonIgnore
+    public boolean isStatusValid() {
+        return ObjUtil.notEqual(HrmEmployeeTypeEnum.INFORMAL.getType(), type)
+                || status == null || HrmEmployeeStatusEnum.INFORMAL_STATUSES.contains(status);
+    }
+
+    @AssertTrue(message = "非正式员工状态不能为空")
+    @JsonIgnore
+    public boolean isStatusRequired() {
+        return ObjUtil.notEqual(HrmEmployeeTypeEnum.INFORMAL.getType(), type) || status != null;
+    }
+
+    @AssertTrue(message = "在职员工工号不能为空")
+    @JsonIgnore
+    public boolean isJobNumberValid() {
+        return ObjUtil.notEqual(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus(), entryStatus)
+                || StrUtil.isNotBlank(jobNumber);
+    }
+
+    @AssertTrue(message = "正式员工试用期不能为空")
+    @JsonIgnore
+    public boolean isProbationValid() {
+        return ObjUtil.notEqual(HrmEmployeeTypeEnum.FORMAL.getType(), type) || probation != null;
+    }
+
+    @AssertTrue(message = "司龄起算时间不能晚于入职时间")
+    @JsonIgnore
+    public boolean isCompanyAgeStartTimeValid() {
+        return entryTime == null || companyAgeStartTime == null
+                || isBeforeOrEqual(companyAgeStartTime, entryTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeStatusCountRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeStatusCountRespVO.java
new file mode 100644
index 0000000..6cac978
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/employee/HrmEmployeeStatusCountRespVO.java
@@ -0,0 +1,18 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工状态数量 Response VO")
+@Data
+@AllArgsConstructor
+public class HrmEmployeeStatusCountRespVO {
+
+    @Schema(description = "状态页签", requiredMode = Schema.RequiredMode.REQUIRED, example = "12")
+    private Integer status;
+
+    @Schema(description = "数量", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Long count;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/file/HrmEmployeeFileRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/file/HrmEmployeeFileRespVO.java
new file mode 100644
index 0000000..a3e61b2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/file/HrmEmployeeFileRespVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.file;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工材料附件 Response VO")
+@Data
+public class HrmEmployeeFileRespVO {
+
+    @Schema(description = "附件编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "附件类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+    private Integer type;
+
+    @Schema(description = "附件地址", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String url;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/file/HrmEmployeeFileSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/file/HrmEmployeeFileSaveReqVO.java
new file mode 100644
index 0000000..4c793b6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/file/HrmEmployeeFileSaveReqVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.file;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeFileTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工材料附件保存 Request VO")
+@Data
+public class HrmEmployeeFileSaveReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "附件类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "11")
+    @NotNull(message = "附件类型不能为空")
+    @InEnum(value = HrmEmployeeFileTypeEnum.class, message = "附件类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "附件地址数组", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "[https://example.com/archive.pdf]")
+    @NotNull(message = "附件地址数组不能为空")
+    @Size(max = 20, message = "同类附件不能超过 20 个")
+    private List<@NotBlank(message = "附件地址不能为空")
+            @Size(max = 512, message = "附件地址长度不能超过 512 个字符") String> fileUrls;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/personalnote/HrmEmployeePersonalNoteCreateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/personalnote/HrmEmployeePersonalNoteCreateReqVO.java
new file mode 100644
index 0000000..baf3feb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/personalnote/HrmEmployeePersonalNoteCreateReqVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.personalnote;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工个人备忘创建 Request VO")
+@Data
+public class HrmEmployeePersonalNoteCreateReqVO {
+
+    @Schema(description = "备忘内容", requiredMode = Schema.RequiredMode.REQUIRED, example = "跟进转正材料")
+    @NotBlank(message = "备忘内容不能为空")
+    @Size(max = 1024, message = "备忘内容不能超过 1024 个字符")
+    private String content;
+
+    @Schema(description = "提醒时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "提醒时间不能为空")
+    private LocalDateTime reminderTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/quitinfo/HrmEmployeeQuitInfoRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/quitinfo/HrmEmployeeQuitInfoRespVO.java
new file mode 100644
index 0000000..a7bbcbf
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/quitinfo/HrmEmployeeQuitInfoRespVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工离职信息 Response VO")
+@Data
+public class HrmEmployeeQuitInfoRespVO {
+
+    @Schema(description = "离职信息编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "计划离职时间")
+    private LocalDateTime planQuitTime;
+
+    @Schema(description = "申请离职时间")
+    private LocalDateTime applyQuitTime;
+
+    @Schema(description = "薪资结算时间")
+    private LocalDateTime salarySettlementTime;
+
+    @Schema(description = "离职类型", example = "1")
+    private Integer type;
+
+    @Schema(description = "离职原因", example = "1")
+    private Integer reason;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "离职前员工状态")
+    private Integer oldEmployeeStatus;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/quitinfo/HrmEmployeeQuitInfoSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/quitinfo/HrmEmployeeQuitInfoSaveReqVO.java
new file mode 100644
index 0000000..ed97170
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/quitinfo/HrmEmployeeQuitInfoSaveReqVO.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeQuitReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeQuitTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工离职信息保存 Request VO")
+@Data
+public class HrmEmployeeQuitInfoSaveReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "计划离职时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "计划离职时间不能为空")
+    private LocalDateTime planQuitTime;
+
+    @Schema(description = "申请离职时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "申请离职时间不能为空")
+    private LocalDateTime applyQuitTime;
+
+    @Schema(description = "薪资结算时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "薪资结算时间不能为空")
+    private LocalDateTime salarySettlementTime;
+
+    @Schema(description = "离职类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "离职类型不能为空")
+    @InEnum(value = HrmEmployeeQuitTypeEnum.class, message = "离职类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "离职原因", example = "1")
+    @InEnum(value = HrmEmployeeQuitReasonEnum.class, message = "离职原因必须是 {value}")
+    private Integer reason;
+
+    @Schema(description = "备注", example = "个人原因离职")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @Schema(description = "离职前员工状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "离职前员工状态不能为空")
+    @InEnum(value = HrmEmployeeStatusEnum.class, message = "离职前员工状态必须是 {value}")
+    private Integer oldEmployeeStatus;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/salarycard/HrmEmployeeSalaryCardRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/salarycard/HrmEmployeeSalaryCardRespVO.java
new file mode 100644
index 0000000..d1da559
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/salarycard/HrmEmployeeSalaryCardRespVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工工资卡 Response VO")
+@Data
+public class HrmEmployeeSalaryCardRespVO {
+
+    @Schema(description = "工资卡编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "银行卡号", example = "622202600001")
+    private String bankCardNumber;
+
+    @Schema(description = "开户地区编号", example = "440300")
+    private Integer bankAreaId;
+
+    @Schema(description = "开户地区名称", example = "广东省 深圳市")
+    private String bankAreaName;
+
+    @Schema(description = "银行名称", example = "招商银行")
+    private String bankName;
+
+    @Schema(description = "开户支行名称", example = "科技园支行")
+    private String bankBranchName;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/salarycard/HrmEmployeeSalaryCardSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/salarycard/HrmEmployeeSalaryCardSaveReqVO.java
new file mode 100644
index 0000000..e0125bc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/salarycard/HrmEmployeeSalaryCardSaveReqVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard;
+
+import cn.iocoder.yudao.module.hrm.framework.operatelog.core.HrmBankCardNumberParseFunction;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工工资卡保存 Request VO")
+@Data
+public class HrmEmployeeSalaryCardSaveReqVO {
+
+    @Schema(description = "工资卡编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工不能为空")
+    private Long employeeId;
+
+    @Schema(description = "银行卡号", requiredMode = Schema.RequiredMode.REQUIRED, example = "622202600001")
+    @NotBlank(message = "银行卡号不能为空")
+    @Size(max = 64, message = "银行卡号不能超过 64 个字符")
+    @DiffLogField(name = "银行卡号", function = HrmBankCardNumberParseFunction.NAME)
+    private String bankCardNumber;
+
+    @Schema(description = "开户地区编号", example = "440300")
+    @DiffLogField(name = "开户地区编号")
+    private Integer bankAreaId;
+
+    @Schema(description = "银行名称", example = "招商银行")
+    @Size(max = 64, message = "银行名称不能超过 64 个字符")
+    @DiffLogField(name = "银行名称")
+    private String bankName;
+
+    @Schema(description = "开户支行名称", example = "科技园支行")
+    @Size(max = 128, message = "开户支行名称不能超过 128 个字符")
+    @DiffLogField(name = "开户支行名称")
+    private String bankBranchName;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/trainingexperience/HrmEmployeeTrainingExperienceRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/trainingexperience/HrmEmployeeTrainingExperienceRespVO.java
new file mode 100644
index 0000000..ad83c06
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/trainingexperience/HrmEmployeeTrainingExperienceRespVO.java
@@ -0,0 +1,48 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工培训经历 Response VO")
+@Data
+public class HrmEmployeeTrainingExperienceRespVO {
+
+    @Schema(description = "培训经历编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "培训课程", example = "项目管理")
+    private String course;
+
+    @Schema(description = "培训机构名称", example = "内部学院")
+    private String organizationName;
+
+    @Schema(description = "培训开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "培训结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "培训时长", example = "16 小时")
+    private String duration;
+
+    @Schema(description = "培训成绩", example = "优秀")
+    private String result;
+
+    @Schema(description = "培训证书名称", example = "PMP")
+    private String certificateName;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/trainingexperience/HrmEmployeeTrainingExperienceSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/trainingexperience/HrmEmployeeTrainingExperienceSaveReqVO.java
new file mode 100644
index 0000000..72c4804
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/trainingexperience/HrmEmployeeTrainingExperienceSaveReqVO.java
@@ -0,0 +1,76 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isAfterOrEqual;
+
+@Schema(description = "管理后台 - HRM 员工培训经历保存 Request VO")
+@Data
+public class HrmEmployeeTrainingExperienceSaveReqVO {
+
+    @Schema(description = "培训经历编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "培训课程", requiredMode = Schema.RequiredMode.REQUIRED, example = "项目管理")
+    @NotBlank(message = "培训课程不能为空")
+    @Size(max = 128, message = "培训课程长度不能超过 128 个字符")
+    @DiffLogField(name = "培训课程")
+    private String course;
+
+    @Schema(description = "培训机构名称", example = "内部学院")
+    @Size(max = 128, message = "培训机构名称长度不能超过 128 个字符")
+    @DiffLogField(name = "培训机构名称")
+    private String organizationName;
+
+    @Schema(description = "培训开始日期")
+    @DiffLogField(name = "培训开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "培训结束日期")
+    @DiffLogField(name = "培训结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "培训时长", example = "16 小时")
+    @Size(max = 64, message = "培训时长长度不能超过 64 个字符")
+    @DiffLogField(name = "培训时长")
+    private String duration;
+
+    @Schema(description = "培训成绩", example = "优秀")
+    @Size(max = 64, message = "培训成绩长度不能超过 64 个字符")
+    @DiffLogField(name = "培训成绩")
+    private String result;
+
+    @Schema(description = "培训证书名称", example = "PMP")
+    @Size(max = 128, message = "培训证书名称长度不能超过 128 个字符")
+    @DiffLogField(name = "培训证书名称")
+    private String certificateName;
+
+    @Schema(description = "备注", example = "公司内部培训")
+    @Size(max = 500, message = "备注长度不能超过 500 个字符")
+    @DiffLogField(name = "备注")
+    private String remark;
+
+    @Schema(description = "排序", example = "1")
+    @DiffLogField(name = "排序")
+    private Integer sort;
+
+    @AssertTrue(message = "培训经历的结束日期不能早于开始日期")
+    @JsonIgnore
+    public boolean isTimeRangeValid() {
+        return startTime == null || endTime == null || isAfterOrEqual(endTime, startTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/workexperience/HrmEmployeeWorkExperienceRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/workexperience/HrmEmployeeWorkExperienceRespVO.java
new file mode 100644
index 0000000..4210305
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/workexperience/HrmEmployeeWorkExperienceRespVO.java
@@ -0,0 +1,48 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工工作经历 Response VO")
+@Data
+public class HrmEmployeeWorkExperienceRespVO {
+
+    @Schema(description = "工作经历编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long employeeId;
+
+    @Schema(description = "工作单位", example = "示例科技")
+    private String workUnit;
+
+    @Schema(description = "职务", example = "开发工程师")
+    private String postName;
+
+    @Schema(description = "工作开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "工作结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "离职原因")
+    private String reason;
+
+    @Schema(description = "证明人")
+    private String witnessName;
+
+    @Schema(description = "证明人手机号")
+    private String witnessPhone;
+
+    @Schema(description = "工作备注")
+    private String remark;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/workexperience/HrmEmployeeWorkExperienceSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/workexperience/HrmEmployeeWorkExperienceSaveReqVO.java
new file mode 100644
index 0000000..6c8c017
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/employee/vo/workexperience/HrmEmployeeWorkExperienceSaveReqVO.java
@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isAfterOrEqual;
+
+@Schema(description = "管理后台 - HRM 员工工作经历保存 Request VO")
+@Data
+public class HrmEmployeeWorkExperienceSaveReqVO {
+
+    @Schema(description = "工作经历编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "工作单位", requiredMode = Schema.RequiredMode.REQUIRED, example = "示例科技")
+    @NotBlank(message = "工作单位不能为空")
+    @Size(max = 255, message = "工作单位长度不能超过 255 个字符")
+    @DiffLogField(name = "工作单位")
+    private String workUnit;
+
+    @Schema(description = "职务", requiredMode = Schema.RequiredMode.REQUIRED, example = "开发工程师")
+    @NotBlank(message = "职务不能为空")
+    @Size(max = 255, message = "职务长度不能超过 255 个字符")
+    @DiffLogField(name = "职务")
+    private String postName;
+
+    @Schema(description = "工作开始日期")
+    @DiffLogField(name = "工作开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "工作结束日期")
+    @DiffLogField(name = "工作结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "离职原因", example = "职业发展")
+    @Size(max = 1024, message = "离职原因长度不能超过 1024 个字符")
+    @DiffLogField(name = "离职原因")
+    private String reason;
+
+    @Schema(description = "证明人", example = "李四")
+    @Size(max = 255, message = "证明人长度不能超过 255 个字符")
+    @DiffLogField(name = "证明人")
+    private String witnessName;
+
+    @Schema(description = "证明人手机号", example = "15601691301")
+    @Size(max = 32, message = "证明人手机号长度不能超过 32 个字符")
+    @DiffLogField(name = "证明人手机号")
+    private String witnessPhone;
+
+    @Schema(description = "工作备注", example = "负责核心业务研发")
+    @Size(max = 500, message = "工作备注长度不能超过 500 个字符")
+    @DiffLogField(name = "工作备注")
+    private String remark;
+
+    @Schema(description = "排序", example = "1")
+    @DiffLogField(name = "排序")
+    private Integer sort;
+
+    @AssertTrue(message = "工作经历的结束日期不能早于开始日期")
+    @JsonIgnore
+    public boolean isTimeRangeValid() {
+        return startTime == null || endTime == null || isAfterOrEqual(endTime, startTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/HrmHomeController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/HrmHomeController.java
new file mode 100644
index 0000000..4e30d3b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/HrmHomeController.java
@@ -0,0 +1,76 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.home;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHomeCalendarItemRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmTeamHomeStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.service.home.HrmHomeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDate;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 首页")
+@RestController
+@RequestMapping("/hrm/home")
+@Validated
+public class HrmHomeController {
+
+    @Resource
+    private HrmHomeService homeService;
+
+    @GetMapping("/hr-statistics-summary")
+    @Operation(summary = "获得 HR 工作台统计")
+    @PreAuthorize("@ss.hasPermission('hrm:home:hr-query')")
+    public CommonResult<HrmHrHomeStatisticsRespVO> getHrHomeStatisticsSummary() {
+        return success(homeService.getHrHomeStatisticsSummary());
+    }
+
+    @GetMapping("/hr-calendar")
+    @Operation(summary = "获得 HR 工作台日历")
+    @Parameters({
+            @Parameter(name = "startDate", description = "开始日期", required = true, example = "2026-08-01"),
+            @Parameter(name = "endDate", description = "结束日期", required = true, example = "2026-08-31")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:home:hr-query')")
+    public CommonResult<List<HrmHomeCalendarItemRespVO>> getHrHomeCalendar(
+            @RequestParam("startDate") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate startDate,
+            @RequestParam("endDate") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate endDate) {
+        return success(homeService.getHrHomeCalendar(getLoginUserId(), startDate, endDate));
+    }
+
+    @GetMapping("/team-statistics-summary")
+    @Operation(summary = "获得团队工作台统计")
+    @PreAuthorize("@ss.hasPermission('hrm:home:team-query')")
+    public CommonResult<HrmTeamHomeStatisticsRespVO> getTeamHomeStatisticsSummary() {
+        return success(homeService.getTeamHomeStatisticsSummary(getLoginUserId()));
+    }
+
+    @GetMapping("/team-calendar")
+    @Operation(summary = "获得团队工作台日历")
+    @Parameters({
+            @Parameter(name = "startDate", description = "开始日期", required = true, example = "2026-08-01"),
+            @Parameter(name = "endDate", description = "结束日期", required = true, example = "2026-08-31")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:home:team-query')")
+    public CommonResult<List<HrmHomeCalendarItemRespVO>> getTeamHomeCalendar(
+            @RequestParam("startDate") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate startDate,
+            @RequestParam("endDate") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate endDate) {
+        return success(homeService.getTeamHomeCalendar(getLoginUserId(), startDate, endDate));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmHomeCalendarItemRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmHomeCalendarItemRespVO.java
new file mode 100644
index 0000000..30c225e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmHomeCalendarItemRespVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+@Schema(description = "管理后台 - HRM 首页日历事项 Response VO")
+@Data
+public class HrmHomeCalendarItemRespVO {
+
+    @Schema(description = "员工个人备忘编号")
+    private Long personalNoteId;
+
+    @Schema(description = "事项类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+    @Schema(description = "事项类型名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "备忘")
+    private String typeName;
+
+    @Schema(description = "事项内容", requiredMode = Schema.RequiredMode.REQUIRED)
+    private String content;
+
+    @Schema(description = "关联业务编号")
+    private Long typeId;
+
+    @Schema(description = "事项日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDate date;
+
+    @Schema(description = "事项时间")
+    private LocalDateTime eventTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmHrHomeStatisticsRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmHrHomeStatisticsRespVO.java
new file mode 100644
index 0000000..d98713a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmHrHomeStatisticsRespVO.java
@@ -0,0 +1,130 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM HR 工作台统计 Response VO")
+@Data
+public class HrmHrHomeStatisticsRespVO {
+
+    @Schema(description = "人事概况")
+    private EmployeeSurvey employeeSurvey;
+
+    @Schema(description = "招聘动态")
+    private RecruitSurvey recruitSurvey;
+
+    @Schema(description = "上月薪资")
+    private SalarySurvey salarySurvey;
+
+    @Schema(description = "待办提醒")
+    private TodoSurvey todoSurvey;
+
+    @Schema(description = "管理后台 - HRM HR 工作台人事概况 Response VO")
+    @Data
+    public static class EmployeeSurvey {
+
+        @Schema(description = "在职人数")
+        private Long activeCount;
+
+        @Schema(description = "本月入职人数")
+        private Long entryThisMonthCount;
+
+        @Schema(description = "本月待入职人数")
+        private Long pendingEntryThisMonthCount;
+
+        @Schema(description = "本月离职人数")
+        private Long leaveThisMonthCount;
+
+        @Schema(description = "本月待离职人数")
+        private Long pendingLeaveThisMonthCount;
+
+        @Schema(description = "本月转正人数")
+        private Long regularThisMonthCount;
+
+        @Schema(description = "本月调岗人数")
+        private Long transferThisMonthCount;
+
+    }
+
+    @Schema(description = "管理后台 - HRM HR 工作台招聘动态 Response VO")
+    @Data
+    public static class RecruitSurvey {
+
+        @Schema(description = "招聘中职位数量")
+        private Long recruitingPostCount;
+
+        @Schema(description = "招聘流程中候选人数")
+        private Long candidateInProcessCount;
+
+        @Schema(description = "待入职人数")
+        private Long pendingEntryCount;
+
+        @Schema(description = "已入职人数")
+        private Long joinedCount;
+
+    }
+
+    @Schema(description = "管理后台 - HRM HR 工作台上月薪资 Response VO")
+    @Data
+    public static class SalarySurvey {
+
+        @Schema(description = "工资表编号")
+        private Long monthRecordId;
+
+        @Schema(description = "员工数量")
+        private Integer employeeCount;
+
+        @Schema(description = "实发工资")
+        private BigDecimal realPaySalary;
+
+        @Schema(description = "部门薪资占比列表")
+        private List<SalaryDept> deptProportions;
+
+    }
+
+    @Schema(description = "管理后台 - HRM HR 工作台部门薪资占比 Response VO")
+    @Data
+    public static class SalaryDept {
+
+        @Schema(description = "部门编号")
+        private Long deptId;
+
+        @Schema(description = "部门名称")
+        private String deptName;
+
+        @Schema(description = "薪资占比")
+        private BigDecimal proportion;
+
+        @Schema(description = "实发工资")
+        private BigDecimal totalSalary;
+
+    }
+
+    @Schema(description = "管理后台 - HRM HR 工作台待办提醒 Response VO")
+    @Data
+    public static class TodoSurvey {
+
+        @Schema(description = "待入职人数")
+        private Long toEntryCount;
+
+        @Schema(description = "待离职人数")
+        private Long toLeaveCount;
+
+        @Schema(description = "合同待到期人数")
+        private Long toExpireContractCount;
+
+        @Schema(description = "待转正人数")
+        private Long toRegularCount;
+
+        @Schema(description = "待核算工资表数量")
+        private Long toSalaryComputeCount;
+
+        @Schema(description = "本月生日员工数量")
+        private Long toBirthdayCount;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmTeamHomeStatisticsRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmTeamHomeStatisticsRespVO.java
new file mode 100644
index 0000000..1009c12
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/home/vo/HrmTeamHomeStatisticsRespVO.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.home.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 团队工作台统计 Response VO")
+@Data
+public class HrmTeamHomeStatisticsRespVO {
+
+    @Schema(description = "当前主管员工编号", example = "1")
+    private Long leaderEmployeeId;
+
+    @Schema(description = "我的团队")
+    private TeamOverview teamOverview;
+
+    @Schema(description = "团队概况")
+    private TeamSurvey teamSurvey;
+
+    @Schema(description = "管理后台 - HRM 团队工作台我的团队 Response VO")
+    @Data
+    public static class TeamOverview {
+
+        @Schema(description = "团队人数", example = "12")
+        private Long employeeCount;
+
+        @Schema(description = "本月入职人数", example = "2")
+        private Long entryThisMonthCount;
+
+        @Schema(description = "本月离职人数", example = "1")
+        private Long leaveThisMonthCount;
+
+        @Schema(description = "本月转正人数", example = "3")
+        private Long regularThisMonthCount;
+
+    }
+
+    @Schema(description = "管理后台 - HRM 团队工作台团队概况 Response VO")
+    @Data
+    public static class TeamSurvey {
+
+        @Schema(description = "员工状态占比")
+        private List<AnalysisItem> statusAnalysis;
+
+        @Schema(description = "男女性别占比")
+        private List<AnalysisItem> sexAnalysis;
+
+        @Schema(description = "成员年龄占比")
+        private List<AnalysisItem> ageAnalysis;
+
+        @Schema(description = "成员司龄占比")
+        private List<AnalysisItem> companyAgeAnalysis;
+
+    }
+
+    @Schema(description = "管理后台 - HRM 团队工作台统计分析项 Response VO")
+    @Data
+    public static class AnalysisItem {
+
+        @Schema(description = "分类类型；null 表示未填写", example = "1")
+        private Integer type;
+
+        @Schema(description = "数量", example = "8")
+        private Long count;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceEmployeeInfoController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceEmployeeInfoController.java
new file mode 100644
index 0000000..1dd3cfd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceEmployeeInfoController.java
@@ -0,0 +1,73 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo.HrmInsuranceEmployeeInfoRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo.HrmInsuranceEmployeeInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo.HrmInsuranceEmployeeInfoUpdateSchemeReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工参保信息")
+@RestController
+@RequestMapping("/hrm/insurance/employee-info")
+@Validated
+public class HrmInsuranceEmployeeInfoController {
+
+    @Resource
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @Resource
+    private HrmInsuranceSchemeService insuranceSchemeService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得员工参保信息")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:employee-info:query')")
+    public CommonResult<HrmInsuranceEmployeeInfoRespVO> getInsuranceEmployeeInfo(
+            @RequestParam("employeeId") Long employeeId) {
+        HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoService
+                .getInsuranceEmployeeInfoByEmployeeId(employeeId);
+        HrmInsuranceEmployeeInfoRespVO respVO = BeanUtils.toBean(
+                employeeInfo, HrmInsuranceEmployeeInfoRespVO.class);
+        if (respVO != null && respVO.getSchemeId() != null) {
+            HrmInsuranceSchemeDO scheme = insuranceSchemeService.getScheme(respVO.getSchemeId());
+            respVO.setSchemeName(scheme == null ? null : scheme.getName());
+        }
+        return success(respVO);
+    }
+
+    @PutMapping("/save")
+    @Operation(summary = "保存员工参保信息")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:employee-info:update')")
+    public CommonResult<Long> saveInsuranceEmployeeInfo(
+            @Valid @RequestBody HrmInsuranceEmployeeInfoSaveReqVO reqVO) {
+        return success(insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(reqVO));
+    }
+
+    @PutMapping("/update-scheme")
+    @Operation(summary = "更新员工参保方案")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:employee-info:update')")
+    public CommonResult<Boolean> updateEmployeeScheme(
+            @Valid @RequestBody HrmInsuranceEmployeeInfoUpdateSchemeReqVO reqVO) {
+        insuranceEmployeeInfoService.updateEmployeeScheme(reqVO.getEmployeeId(), reqVO.getSchemeId());
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceMonthEmployeeRecordController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceMonthEmployeeRecordController.java
new file mode 100644
index 0000000..bccb82e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceMonthEmployeeRecordController.java
@@ -0,0 +1,188 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeProjectRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordCreateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordStopListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 员工月度社保")
+@RestController
+@RequestMapping("/hrm/insurance/month-employee-record")
+@Validated
+public class HrmInsuranceMonthEmployeeRecordController {
+
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordService monthEmployeeRecordService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @Resource
+    private HrmInsuranceSchemeService insuranceSchemeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得员工月度社保分页")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:query')")
+    public CommonResult<PageResult<HrmInsuranceMonthEmployeeRecordRespVO>> getMonthEmployeeRecordPage(
+            @Valid HrmInsuranceMonthEmployeeRecordPageReqVO reqVO) {
+        PageResult<HrmInsuranceMonthEmployeeRecordDO> pageResult =
+                monthEmployeeRecordService.getMonthEmployeeRecordPage(reqVO);
+        return success(new PageResult<>(buildMonthEmployeeRecordRespVOList(pageResult.getList()),
+                pageResult.getTotal()));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得员工月度社保详情")
+    @Parameter(name = "id", description = "员工月度社保记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:query')")
+    public CommonResult<HrmInsuranceMonthEmployeeRecordRespVO> getMonthEmployeeRecord(@RequestParam("id") Long id) {
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord =
+                monthEmployeeRecordService.getMonthEmployeeRecord(id);
+        if (employeeRecord == null) {
+            return success(null);
+        }
+        return success(CollUtil.getFirst(buildMonthEmployeeRecordRespVOList(
+                Collections.singletonList(employeeRecord))));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改员工月度参保项目")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:update')")
+    public CommonResult<Boolean> updateMonthEmployeeRecord(
+            @Valid @RequestBody HrmInsuranceMonthEmployeeRecordUpdateReqVO reqVO) {
+        monthEmployeeRecordService.updateMonthEmployeeRecord(reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/stop-list")
+    @Operation(summary = "批量停止员工参保")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:update')")
+    public CommonResult<Boolean> stopMonthEmployeeRecordList(
+            @Valid @RequestBody HrmInsuranceMonthEmployeeRecordStopListReqVO reqVO) {
+        monthEmployeeRecordService.stopMonthEmployeeRecordList(reqVO.getIds());
+        return success(true);
+    }
+
+    @PostMapping("/create-list")
+    @Operation(summary = "添加参保人员")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:update')")
+    public CommonResult<Boolean> createMonthEmployeeRecordList(
+            @Valid @RequestBody HrmInsuranceMonthEmployeeRecordCreateListReqVO reqVO) {
+        monthEmployeeRecordService.createMonthEmployeeRecordList(reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/uninsured-employee-list")
+    @Operation(summary = "获得本月未参保员工")
+    @Parameter(name = "monthRecordId", description = "社保表编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:query')")
+    public CommonResult<List<HrmEmployeeRespVO>> getUninsuredEmployeeList(
+            @RequestParam("monthRecordId") Long monthRecordId) {
+        List<HrmEmployeeDO> employees = monthEmployeeRecordService.getUninsuredEmployeeList(monthRecordId);
+        return success(BeanUtils.toBean(employees, HrmEmployeeRespVO.class));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<HrmInsuranceMonthEmployeeRecordRespVO> buildMonthEmployeeRecordRespVOList(
+            List<HrmInsuranceMonthEmployeeRecordDO> employeeRecords) {
+        if (CollUtil.isEmpty(employeeRecords)) {
+            return Collections.emptyList();
+        }
+
+        // 1.1 批量查询员工和部门
+        Set<Long> employeeIds = convertSet(employeeRecords, HrmInsuranceMonthEmployeeRecordDO::getEmployeeId);
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId));
+        // 1.2 批量查询社保方案和员工社保资料
+        Map<Long, HrmInsuranceSchemeDO> schemeMap = convertMap(insuranceSchemeService.getSchemeListByIds(
+                convertSet(employeeRecords, HrmInsuranceMonthEmployeeRecordDO::getSchemeId)),
+                HrmInsuranceSchemeDO::getId);
+        Map<Long, HrmInsuranceEmployeeInfoDO> insuranceEmployeeInfoMap =
+                insuranceEmployeeInfoService.getInsuranceEmployeeInfoMap(employeeIds);
+        Map<Long, List<HrmInsuranceMonthEmployeeRecordDO.Project>> projectMap =
+                convertMap(employeeRecords, HrmInsuranceMonthEmployeeRecordDO::getId,
+                        record -> record.getProjects() == null ? Collections.emptyList() : record.getProjects());
+
+        // 2. 拼接响应
+        List<HrmInsuranceMonthEmployeeRecordRespVO> respVOs =
+                BeanUtils.toBean(employeeRecords, HrmInsuranceMonthEmployeeRecordRespVO.class);
+        for (HrmInsuranceMonthEmployeeRecordRespVO respVO : respVOs) {
+            MapUtils.findAndThen(employeeMap, respVO.getEmployeeId(), employee -> {
+                respVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                        .setMobile(employee.getMobile()).setIdNumber(employee.getIdNumber())
+                        .setSex(employee.getSex()).setAge(employee.getAge())
+                        .setDeptId(employee.getDeptId()).setPostName(employee.getPostName())
+                        .setEntryStatus(employee.getEntryStatus()).setEmployeeStatus(employee.getStatus())
+                        .setEntryTime(employee.getEntryTime());
+                MapUtils.findAndThen(deptMap, employee.getDeptId(),
+                        dept -> respVO.setDeptName(dept.getName()));
+            });
+            MapUtils.findAndThen(schemeMap, respVO.getSchemeId(), scheme -> {
+                respVO.setSchemeName(scheme.getName()).setAreaId(scheme.getAreaId())
+                        .setAreaName(AreaUtils.format(scheme.getAreaId()))
+                        .setHouseType(scheme.getHouseholdType()).setSchemeType(scheme.getType());
+            });
+            MapUtils.findAndThen(insuranceEmployeeInfoMap, respVO.getEmployeeId(), insuranceEmployeeInfo -> {
+                respVO.setSocialSecurityNumber(insuranceEmployeeInfo.getSocialSecurityNumber())
+                        .setAccumulationFundNumber(insuranceEmployeeInfo.getAccumulationFundNumber());
+            });
+            List<HrmInsuranceMonthEmployeeProjectRespVO> projects = BeanUtils.toBean(
+                    projectMap.getOrDefault(respVO.getId(), Collections.emptyList()),
+                    HrmInsuranceMonthEmployeeProjectRespVO.class);
+            respVO.setSocialSecurityProjectList(convertList(projects, project -> project,
+                    project -> HrmInsuranceProjectTypeEnum.isSocialSecurity(project.getType())));
+            respVO.setProvidentFundProjectList(convertList(projects, project -> project,
+                    project -> HrmInsuranceProjectTypeEnum.isProvidentFund(project.getType())));
+        }
+        return respVOs;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceMonthRecordController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceMonthRecordController.java
new file mode 100644
index 0000000..4d984a3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceMonthRecordController.java
@@ -0,0 +1,88 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.HrmInsuranceMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.HrmInsuranceMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthRecordService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 月度社保表")
+@RestController
+@RequestMapping("/hrm/insurance/month-record")
+@Validated
+public class HrmInsuranceMonthRecordController {
+
+    @Resource
+    private HrmInsuranceMonthRecordService insuranceMonthRecordService;
+
+    @PostMapping("/create-first")
+    @Operation(summary = "创建首月社保表")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:create')")
+    public CommonResult<Long> createFirstMonthRecord(
+            @Valid @RequestBody HrmInsuranceMonthRecordCreateReqVO reqVO) {
+        return success(insuranceMonthRecordService.createFirstMonthRecord(reqVO));
+    }
+
+    @PostMapping("/create-next")
+    @Operation(summary = "创建下月社保表")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:create')")
+    public CommonResult<Long> createNextMonthRecord() {
+        return success(insuranceMonthRecordService.createNextMonthRecord());
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除月度社保表")
+    @Parameter(name = "id", description = "社保表编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:delete')")
+    public CommonResult<Boolean> deleteMonthRecord(@RequestParam("id") Long id) {
+        insuranceMonthRecordService.deleteMonthRecord(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得月度社保表")
+    @Parameter(name = "id", description = "月度社保表编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:query')")
+    public CommonResult<HrmInsuranceMonthRecordRespVO> getMonthRecord(@RequestParam("id") Long id) {
+        HrmInsuranceMonthRecordDO monthRecord = insuranceMonthRecordService.getMonthRecord(id);
+        return success(BeanUtils.toBean(monthRecord, HrmInsuranceMonthRecordRespVO.class));
+    }
+
+    @GetMapping("/last")
+    @Operation(summary = "获得最近月度社保表")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:query')")
+    public CommonResult<HrmInsuranceMonthRecordRespVO> getLastMonthRecord() {
+        HrmInsuranceMonthRecordDO monthRecord = insuranceMonthRecordService.getLastMonthRecord();
+        return success(BeanUtils.toBean(monthRecord, HrmInsuranceMonthRecordRespVO.class));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得月度社保表列表")
+    @Parameter(name = "year", description = "年份", example = "2026")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:month-record:query')")
+    public CommonResult<List<HrmInsuranceMonthRecordRespVO>> getMonthRecordList(
+            @RequestParam(value = "year", required = false) Integer year) {
+        List<HrmInsuranceMonthRecordDO> monthRecords = insuranceMonthRecordService.getMonthRecordList(year);
+        return success(BeanUtils.toBean(monthRecords, HrmInsuranceMonthRecordRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceSchemeController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceSchemeController.java
new file mode 100644
index 0000000..67ada40
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceSchemeController.java
@@ -0,0 +1,157 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeProjectRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.math.BigDecimal;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getSumValue;
+
+@Tag(name = "管理后台 - HRM 社保方案")
+@RestController
+@RequestMapping("/hrm/insurance/scheme")
+@Validated
+public class HrmInsuranceSchemeController {
+
+    @Resource
+    private HrmInsuranceSchemeService insuranceSchemeService;
+    @Resource
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordService insuranceMonthEmployeeRecordService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建社保方案")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:create')")
+    public CommonResult<Long> createScheme(@Valid @RequestBody HrmInsuranceSchemeSaveReqVO reqVO) {
+        return success(insuranceSchemeService.createScheme(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新社保方案")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:update')")
+    public CommonResult<Boolean> updateScheme(@Valid @RequestBody HrmInsuranceSchemeSaveReqVO reqVO) {
+        insuranceSchemeService.updateScheme(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除社保方案")
+    @Parameter(name = "id", description = "方案编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:delete')")
+    public CommonResult<Boolean> deleteScheme(@RequestParam("id") Long id) {
+        insuranceSchemeService.deleteScheme(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得社保方案")
+    @Parameter(name = "id", description = "社保方案编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:query')")
+    public CommonResult<HrmInsuranceSchemeRespVO> getScheme(@RequestParam("id") Long id) {
+        HrmInsuranceSchemeDO scheme = insuranceSchemeService.getScheme(id);
+        return success(buildSchemeRespVO(scheme));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得社保方案列表")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:query')")
+    public CommonResult<List<HrmInsuranceSchemeRespVO>> getSchemeList() {
+        List<HrmInsuranceSchemeDO> schemes = insuranceSchemeService.getSchemeList();
+        return success(buildSchemeRespVOList(schemes));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得社保方案精简列表")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:query')")
+    public CommonResult<List<HrmInsuranceSchemeRespVO>> getSchemeSimpleList() {
+        List<HrmInsuranceSchemeDO> list = insuranceSchemeService.getSchemeList();
+        return success(BeanUtils.toBean(list, HrmInsuranceSchemeRespVO.class,
+                scheme -> scheme.setAreaName(AreaUtils.format(scheme.getAreaId()))));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmInsuranceSchemeRespVO buildSchemeRespVO(HrmInsuranceSchemeDO scheme) {
+        if (scheme == null) {
+            return null;
+        }
+        return CollUtil.getFirst(buildSchemeRespVOList(Collections.singletonList(scheme)));
+    }
+
+    private List<HrmInsuranceSchemeRespVO> buildSchemeRespVOList(List<HrmInsuranceSchemeDO> schemes) {
+        if (CollUtil.isEmpty(schemes)) {
+            return Collections.emptyList();
+        }
+        // 1. 批量查询社保项目和使用人数
+        Set<Long> schemeIds = convertSet(schemes, HrmInsuranceSchemeDO::getId);
+        Map<Long, List<HrmInsuranceSchemeProjectDO>> projectMap =
+                insuranceSchemeService.getSchemeProjectListMap(schemeIds);
+        Map<Long, Long> useCountMap =
+                insuranceEmployeeInfoService.getInsuranceEmployeeInfoCountMapBySchemeIds(schemeIds);
+        Map<Long, Long> monthRecordCountMap = insuranceMonthEmployeeRecordService
+                .getMonthEmployeeRecordCountMapBySchemeIds(schemeIds);
+
+        // 2. 拼接响应
+        return convertList(schemes, scheme -> {
+            HrmInsuranceSchemeRespVO respVO = BeanUtils.toBean(scheme, HrmInsuranceSchemeRespVO.class);
+            respVO.setAreaName(AreaUtils.format(respVO.getAreaId()));
+            List<HrmInsuranceSchemeProjectRespVO> projects = BeanUtils.toBean(
+                    projectMap.getOrDefault(scheme.getId(), Collections.emptyList()), HrmInsuranceSchemeProjectRespVO.class);
+            respVO.setProjectList(projects);
+            List<HrmInsuranceSchemeProjectRespVO> socialSecurityProjects = convertList(
+                    projects, project -> project,
+                    project -> HrmInsuranceProjectTypeEnum.isSocialSecurity(project.getType()));
+            List<HrmInsuranceSchemeProjectRespVO> providentFundProjects = convertList(
+                    projects, project -> project,
+                    project -> HrmInsuranceProjectTypeEnum.isProvidentFund(project.getType()));
+            respVO.setSocialSecurityProjectList(socialSecurityProjects)
+                    .setProvidentFundProjectList(providentFundProjects);
+            respVO.setPersonalInsuranceAmount(getSumValue(socialSecurityProjects,
+                            HrmInsuranceSchemeProjectRespVO::getPersonalAmount, BigDecimal::add, BigDecimal.ZERO))
+                    .setCorporateInsuranceAmount(getSumValue(socialSecurityProjects,
+                            HrmInsuranceSchemeProjectRespVO::getCorporateAmount, BigDecimal::add, BigDecimal.ZERO))
+                    .setPersonalProvidentFundAmount(getSumValue(providentFundProjects,
+                            HrmInsuranceSchemeProjectRespVO::getPersonalAmount, BigDecimal::add, BigDecimal.ZERO))
+                    .setCorporateProvidentFundAmount(getSumValue(providentFundProjects,
+                            HrmInsuranceSchemeProjectRespVO::getCorporateAmount, BigDecimal::add, BigDecimal.ZERO))
+                    .setUseCount(useCountMap.getOrDefault(scheme.getId(), 0L))
+                    .setMonthRecordCount(monthRecordCountMap.getOrDefault(scheme.getId(), 0L));
+            return respVO;
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceStandardController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceStandardController.java
new file mode 100644
index 0000000..07680d5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/HrmInsuranceStandardController.java
@@ -0,0 +1,48 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardProjectListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardProjectRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardTypeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardTypeRespVO;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceStandardService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 标准参保数据")
+@RestController
+@RequestMapping("/hrm/insurance/standard")
+@Validated
+public class HrmInsuranceStandardController {
+
+    @Resource
+    private HrmInsuranceStandardService insuranceStandardService;
+
+    @GetMapping("/type-list")
+    @Operation(summary = "获得标准参保类型列表")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:query')")
+    public CommonResult<List<HrmInsuranceStandardTypeRespVO>> getStandardTypeList(
+            @Valid HrmInsuranceStandardTypeListReqVO reqVO) {
+        return success(insuranceStandardService.getStandardTypeList(reqVO.getAreaId()));
+    }
+
+    @GetMapping("/project-list")
+    @Operation(summary = "获得标准参保项目列表")
+    @PreAuthorize("@ss.hasPermission('hrm:insurance:scheme:query')")
+    public CommonResult<List<HrmInsuranceStandardProjectRespVO>> getStandardProjectList(
+            @Valid HrmInsuranceStandardProjectListReqVO reqVO) {
+        return success(insuranceStandardService.getStandardProjectList(reqVO.getAreaId(), reqVO.getTypeCode()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoRespVO.java
new file mode 100644
index 0000000..4c5d094
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoRespVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工参保信息 Response VO")
+@Data
+public class HrmInsuranceEmployeeInfoRespVO {
+
+    @Schema(description = "员工参保信息编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "是否本地首次缴纳社保", example = "true")
+    private Boolean firstSocialSecurity;
+
+    @Schema(description = "是否本地首次缴纳公积金", example = "false")
+    private Boolean firstAccumulationFund;
+
+    @Schema(description = "社保账号", example = "SB20260001")
+    private String socialSecurityNumber;
+
+    @Schema(description = "公积金账号", example = "GJJ20260001")
+    private String accumulationFundNumber;
+
+    @Schema(description = "社保起缴月份")
+    private LocalDateTime socialSecurityStartMonth;
+
+    @Schema(description = "社保方案编号", example = "1024")
+    private Long schemeId;
+
+    @Schema(description = "社保方案名称", example = "深圳标准社保方案")
+    private String schemeName;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoSaveReqVO.java
new file mode 100644
index 0000000..fea4f46
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoSaveReqVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工参保信息保存 Request VO")
+@Data
+public class HrmInsuranceEmployeeInfoSaveReqVO {
+
+    @Schema(description = "员工参保信息编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工不能为空")
+    private Long employeeId;
+
+    @Schema(description = "是否本地首次缴纳社保", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否本地首次缴纳社保不能为空")
+    private Boolean firstSocialSecurity;
+
+    @Schema(description = "是否本地首次缴纳公积金", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    @NotNull(message = "是否本地首次缴纳公积金不能为空")
+    private Boolean firstAccumulationFund;
+
+    @Schema(description = "社保账号", example = "SB20260001")
+    @Size(max = 64, message = "社保账号不能超过 64 个字符")
+    private String socialSecurityNumber;
+
+    @Schema(description = "公积金账号", example = "GJJ20260001")
+    @Size(max = 64, message = "公积金账号不能超过 64 个字符")
+    private String accumulationFundNumber;
+
+    @Schema(description = "社保起缴月份")
+    private LocalDateTime socialSecurityStartMonth;
+
+    @Schema(description = "社保方案编号", example = "1024")
+    private Long schemeId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoUpdateSchemeReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoUpdateSchemeReqVO.java
new file mode 100644
index 0000000..28a87cd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/employeeinfo/HrmInsuranceEmployeeInfoUpdateSchemeReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工参保方案更新 Request VO")
+@Data
+public class HrmInsuranceEmployeeInfoUpdateSchemeReqVO {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工不能为空")
+    private Long employeeId;
+
+    @Schema(description = "社保方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "社保方案不能为空")
+    private Long schemeId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/HrmInsuranceMonthRecordCreateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/HrmInsuranceMonthRecordCreateReqVO.java
new file mode 100644
index 0000000..77ff671
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/HrmInsuranceMonthRecordCreateReqVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 月度社保表创建 Request VO")
+@Data
+public class HrmInsuranceMonthRecordCreateReqVO {
+
+    @Schema(description = "年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    @NotNull(message = "年份不能为空")
+    @Min(value = 2000, message = "年份不能小于 2000")
+    @Max(value = 2100, message = "年份不能大于 2100")
+    private Integer year;
+
+    @Schema(description = "月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    @NotNull(message = "月份不能为空")
+    @Min(value = 1, message = "月份必须在 1 到 12 之间")
+    @Max(value = 12, message = "月份必须在 1 到 12 之间")
+    private Integer month;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/HrmInsuranceMonthRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/HrmInsuranceMonthRecordRespVO.java
new file mode 100644
index 0000000..3f3a452
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/HrmInsuranceMonthRecordRespVO.java
@@ -0,0 +1,49 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 月度社保表 Response VO")
+@Data
+public class HrmInsuranceMonthRecordRespVO {
+
+    @Schema(description = "月度社保表编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    private Integer year;
+
+    @Schema(description = "月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    private Integer month;
+
+    @Schema(description = "标题", example = "2026 年 7 月社保表")
+    private String title;
+
+    @Schema(description = "参保人数", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Integer insuredEmployeeCount;
+
+    @Schema(description = "停保人数", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Integer stoppedEmployeeCount;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer status;
+
+    @Schema(description = "个人社保金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "800.00")
+    private BigDecimal personalInsuranceAmount;
+
+    @Schema(description = "个人公积金金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "700.00")
+    private BigDecimal personalProvidentFundAmount;
+
+    @Schema(description = "企业社保金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "1600.00")
+    private BigDecimal corporateInsuranceAmount;
+
+    @Schema(description = "企业公积金金额", requiredMode = Schema.RequiredMode.REQUIRED, example = "700.00")
+    private BigDecimal corporateProvidentFundAmount;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeProjectRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeProjectRespVO.java
new file mode 100644
index 0000000..bd63e12
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeProjectRespVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工月度社保项目 Response VO")
+@Data
+public class HrmInsuranceMonthEmployeeProjectRespVO {
+
+    @Schema(description = "来源社保方案项目编号", example = "1024")
+    private Long schemeProjectId;
+
+    @Schema(description = "项目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "养老保险")
+    private String name;
+
+    @Schema(description = "缴纳基数", example = "10000.00")
+    private BigDecimal baseAmount;
+
+    @Schema(description = "公司缴纳比例", example = "16.00")
+    private BigDecimal corporateRate;
+
+    @Schema(description = "个人缴纳比例", example = "8.00")
+    private BigDecimal personalRate;
+
+    @Schema(description = "公司缴纳金额", example = "1600.00")
+    private BigDecimal corporateAmount;
+
+    @Schema(description = "个人缴纳金额", example = "800.00")
+    private BigDecimal personalAmount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeProjectUpdateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeProjectUpdateReqVO.java
new file mode 100644
index 0000000..140a611
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeProjectUpdateReqVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工月度社保项目调整 Request VO")
+@Data
+public class HrmInsuranceMonthEmployeeProjectUpdateReqVO {
+
+    @Schema(description = "社保方案项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "社保方案项目编号不能为空")
+    private Long schemeProjectId;
+
+    @Schema(description = "缴纳基数", example = "10000.00")
+    @DecimalMin(value = "0", message = "缴纳基数不能小于 0")
+    @Digits(integer = 10, fraction = 2, message = "缴纳基数最多 10 位整数和 2 位小数")
+    private BigDecimal baseAmount;
+
+    @Schema(description = "公司缴纳金额", example = "1600.00")
+    @DecimalMin(value = "0", message = "公司缴纳金额不能小于 0")
+    @Digits(integer = 10, fraction = 2, message = "公司缴纳金额最多 10 位整数和 2 位小数")
+    private BigDecimal corporateAmount;
+
+    @Schema(description = "个人缴纳金额", example = "800.00")
+    @DecimalMin(value = "0", message = "个人缴纳金额不能小于 0")
+    @Digits(integer = 10, fraction = 2, message = "个人缴纳金额最多 10 位整数和 2 位小数")
+    private BigDecimal personalAmount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordCreateListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordCreateListReqVO.java
new file mode 100644
index 0000000..9fad291
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordCreateListReqVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 添加参保人员 Request VO")
+@Data
+public class HrmInsuranceMonthEmployeeRecordCreateListReqVO {
+
+    @Schema(description = "月度社保表编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "社保表编号不能为空")
+    private Long monthRecordId;
+
+    @Schema(description = "员工编号列表", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "[1024, 1025]")
+    @NotEmpty(message = "员工不能为空")
+    private List<@NotNull(message = "员工编号不能为空") Long> employeeIds;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordPageReqVO.java
new file mode 100644
index 0000000..89acdf1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordPageReqVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.employee.HrmInsuranceEmployeeStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 员工月度社保分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmInsuranceMonthEmployeeRecordPageReqVO extends PageParam {
+
+    @Schema(description = "月度社保表编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "社保表编号不能为空")
+    private Long monthRecordId;
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名", example = "张三")
+    private String employeeName;
+
+    @Schema(description = "社保方案编号", example = "1024")
+    private Long schemeId;
+
+    @Schema(description = "参保地区编号", example = "440300")
+    private Integer areaId;
+
+    @Schema(description = "参保状态", example = "1")
+    @InEnum(value = HrmInsuranceEmployeeStatusEnum.class, message = "参保状态必须是 {value}")
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordRespVO.java
new file mode 100644
index 0000000..fe05804
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordRespVO.java
@@ -0,0 +1,113 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工月度社保 Response VO")
+@Data
+public class HrmInsuranceMonthEmployeeRecordRespVO {
+
+    @Schema(description = "记录编号")
+    private Long id;
+
+    @Schema(description = "社保表编号")
+    private Long monthRecordId;
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "手机号")
+    private String mobile;
+
+    @Schema(description = "身份证号")
+    private String idNumber;
+
+    @Schema(description = "性别")
+    private Integer sex;
+
+    @Schema(description = "年龄")
+    private Integer age;
+
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "部门")
+    private String deptName;
+
+    @Schema(description = "职位名称")
+    private String postName;
+
+    @Schema(description = "入职状态")
+    private Integer entryStatus;
+
+    @Schema(description = "员工状态")
+    private Integer employeeStatus;
+
+    @Schema(description = "入职时间")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "社保方案编号")
+    private Long schemeId;
+
+    @Schema(description = "社保方案")
+    private String schemeName;
+
+    @Schema(description = "参保地区")
+    private String areaName;
+
+    @Schema(description = "参保地区编号")
+    private Integer areaId;
+
+    @Schema(description = "户籍类型")
+    private String houseType;
+
+    @Schema(description = "社保方案类型")
+    private Integer schemeType;
+
+    @Schema(description = "个人社保号")
+    private String socialSecurityNumber;
+
+    @Schema(description = "个人公积金号")
+    private String accumulationFundNumber;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "个人社保")
+    private BigDecimal personalInsuranceAmount;
+
+    @Schema(description = "个人公积金")
+    private BigDecimal personalProvidentFundAmount;
+
+    @Schema(description = "公司社保")
+    private BigDecimal corporateInsuranceAmount;
+
+    @Schema(description = "公司公积金")
+    private BigDecimal corporateProvidentFundAmount;
+
+    @Schema(description = "参保状态")
+    private Integer status;
+
+    @Schema(description = "社保项目列表")
+    private List<HrmInsuranceMonthEmployeeProjectRespVO> socialSecurityProjectList;
+
+    @Schema(description = "公积金项目列表")
+    private List<HrmInsuranceMonthEmployeeProjectRespVO> providentFundProjectList;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordStopListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordStopListReqVO.java
new file mode 100644
index 0000000..78d6b59
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordStopListReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工停止参保 Request VO")
+@Data
+public class HrmInsuranceMonthEmployeeRecordStopListReqVO {
+
+    @Schema(description = "员工月度社保记录编号列表", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "[1024, 1025]")
+    @NotEmpty(message = "员工社保记录不能为空")
+    private List<@NotNull(message = "员工社保记录编号不能为空") Long> ids;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordUpdateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordUpdateReqVO.java
new file mode 100644
index 0000000..266e002
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/monthrecord/employee/HrmInsuranceMonthEmployeeRecordUpdateReqVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工月度社保项目修改 Request VO")
+@Data
+public class HrmInsuranceMonthEmployeeRecordUpdateReqVO {
+
+    @Schema(description = "员工月度社保记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工社保记录编号不能为空")
+    private Long id;
+
+    @Schema(description = "社保方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "社保方案不能为空")
+    private Long schemeId;
+
+    @Schema(description = "社保项目列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "社保项目不能为空")
+    @Valid
+    private List<HrmInsuranceMonthEmployeeProjectUpdateReqVO> projects;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeProjectRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeProjectRespVO.java
new file mode 100644
index 0000000..ac10171
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeProjectRespVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 社保方案项目 Response VO")
+@Data
+public class HrmInsuranceSchemeProjectRespVO {
+
+    @Schema(description = "社保方案项目编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "社保方案编号", example = "1024")
+    private Long schemeId;
+
+    @Schema(description = "项目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "养老保险")
+    private String name;
+
+    @Schema(description = "缴纳基数", example = "10000.00")
+    private BigDecimal baseAmount;
+
+    @Schema(description = "公司缴纳比例", example = "16.00")
+    private BigDecimal corporateRate;
+
+    @Schema(description = "个人缴纳比例", example = "8.00")
+    private BigDecimal personalRate;
+
+    @Schema(description = "公司缴纳金额", example = "1600.00")
+    private BigDecimal corporateAmount;
+
+    @Schema(description = "个人缴纳金额", example = "800.00")
+    private BigDecimal personalAmount;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeProjectSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeProjectSaveReqVO.java
new file mode 100644
index 0000000..9dbc9f7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeProjectSaveReqVO.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 社保方案项目保存 Request VO")
+@Data
+public class HrmInsuranceSchemeProjectSaveReqVO {
+
+    @Schema(description = "社保方案项目编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "项目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "项目类型不能为空")
+    @InEnum(value = HrmInsuranceProjectTypeEnum.class, message = "项目类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "养老保险")
+    @NotBlank(message = "项目名称不能为空")
+    @Size(max = 64, message = "项目名称不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "缴纳基数", example = "10000.00")
+    @DecimalMin(value = "0.00", message = "缴纳基数不能小于 0")
+    @Digits(integer = 10, fraction = 2, message = "缴纳基数最多 10 位整数和 2 位小数")
+    private BigDecimal baseAmount;
+
+    @Schema(description = "公司缴纳比例", example = "16.00")
+    @DecimalMin(value = "0.00", message = "公司缴纳比例不能小于 0")
+    @DecimalMax(value = "100.00", message = "公司缴纳比例不能大于 100")
+    @Digits(integer = 3, fraction = 2, message = "公司缴纳比例最多 2 位小数")
+    private BigDecimal corporateRate;
+
+    @Schema(description = "个人缴纳比例", example = "8.00")
+    @DecimalMin(value = "0.00", message = "个人缴纳比例不能小于 0")
+    @DecimalMax(value = "100.00", message = "个人缴纳比例不能大于 100")
+    @Digits(integer = 3, fraction = 2, message = "个人缴纳比例最多 2 位小数")
+    private BigDecimal personalRate;
+
+    @Schema(description = "公司缴纳金额", example = "1600.00")
+    @DecimalMin(value = "0.00", message = "公司缴纳金额不能小于 0")
+    @Digits(integer = 10, fraction = 2, message = "公司缴纳金额最多 10 位整数和 2 位小数")
+    private BigDecimal corporateAmount;
+
+    @Schema(description = "个人缴纳金额", example = "800.00")
+    @DecimalMin(value = "0.00", message = "个人缴纳金额不能小于 0")
+    @Digits(integer = 10, fraction = 2, message = "个人缴纳金额最多 10 位整数和 2 位小数")
+    private BigDecimal personalAmount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeRespVO.java
new file mode 100644
index 0000000..3c8e71b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeRespVO.java
@@ -0,0 +1,62 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 社保方案 Response VO")
+@Data
+public class HrmInsuranceSchemeRespVO {
+
+    @Schema(description = "社保方案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "方案名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "深圳标准社保方案")
+    private String name;
+
+    @Schema(description = "参保地区编号", example = "440300")
+    private Integer areaId;
+
+    @Schema(description = "参保地区", example = "广东省 深圳市")
+    private String areaName;
+
+    @Schema(description = "户籍类型", example = "深户")
+    private String householdType;
+
+    @Schema(description = "方案类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+    @Schema(description = "全部社保项目")
+    private List<HrmInsuranceSchemeProjectRespVO> projectList;
+
+    @Schema(description = "社保项目")
+    private List<HrmInsuranceSchemeProjectRespVO> socialSecurityProjectList;
+
+    @Schema(description = "公积金项目")
+    private List<HrmInsuranceSchemeProjectRespVO> providentFundProjectList;
+
+    @Schema(description = "个人社保金额", example = "800.00")
+    private BigDecimal personalInsuranceAmount;
+
+    @Schema(description = "公司社保金额", example = "1600.00")
+    private BigDecimal corporateInsuranceAmount;
+
+    @Schema(description = "个人公积金金额", example = "700.00")
+    private BigDecimal personalProvidentFundAmount;
+
+    @Schema(description = "公司公积金金额", example = "700.00")
+    private BigDecimal corporateProvidentFundAmount;
+
+    @Schema(description = "使用人数", example = "10")
+    private Long useCount;
+
+    @Schema(description = "历史月记录数", example = "120")
+    private Long monthRecordCount;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeSaveReqVO.java
new file mode 100644
index 0000000..d2f4661
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/scheme/HrmInsuranceSchemeSaveReqVO.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceSchemeTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 社保方案保存 Request VO")
+@Data
+public class HrmInsuranceSchemeSaveReqVO {
+
+    @Schema(description = "社保方案编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "方案名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "深圳标准社保方案")
+    @NotBlank(message = "方案名称不能为空")
+    @Size(max = 64, message = "方案名称不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "参保地区编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "440300")
+    @NotNull(message = "参保城市不能为空")
+    private Integer areaId;
+
+    @Schema(description = "户籍类型", example = "深户")
+    @Size(max = 64, message = "户籍类型不能超过 64 个字符")
+    private String householdType;
+
+    @Schema(description = "方案类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "方案类型不能为空")
+    @InEnum(value = HrmInsuranceSchemeTypeEnum.class, message = "方案类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "社保项目列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "社保项目不能为空")
+    private List<@NotNull(message = "社保项目不能为空") @Valid HrmInsuranceSchemeProjectSaveReqVO> projectList;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardProjectListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardProjectListReqVO.java
new file mode 100644
index 0000000..64a7909
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardProjectListReqVO.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 标准参保项目列表 Request VO")
+@Data
+public class HrmInsuranceStandardProjectListReqVO {
+
+    @Schema(description = "参保地区编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "440300")
+    @NotNull(message = "参保城市不能为空")
+    private Integer areaId;
+
+    @Schema(description = "参保方案编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "SS100173")
+    @NotBlank(message = "参保方案编码不能为空")
+    private String typeCode;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardProjectRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardProjectRespVO.java
new file mode 100644
index 0000000..a75887a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardProjectRespVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 标准参保项目 Response VO")
+@Data
+public class HrmInsuranceStandardProjectRespVO {
+
+    @Schema(description = "项目类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+    @Schema(description = "项目名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "养老保险")
+    private String name;
+
+    @Schema(description = "缴纳基数", example = "10000.00")
+    private BigDecimal baseAmount;
+
+    @Schema(description = "公司缴纳比例", example = "16.00")
+    private BigDecimal corporateRate;
+
+    @Schema(description = "个人缴纳比例", example = "8.00")
+    private BigDecimal personalRate;
+
+    @Schema(description = "公司缴纳金额", example = "1600.00")
+    private BigDecimal corporateAmount;
+
+    @Schema(description = "个人缴纳金额", example = "800.00")
+    private BigDecimal personalAmount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardTypeListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardTypeListReqVO.java
new file mode 100644
index 0000000..1a907fd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardTypeListReqVO.java
@@ -0,0 +1,15 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 标准参保类型列表 Request VO")
+@Data
+public class HrmInsuranceStandardTypeListReqVO {
+
+    @Schema(description = "参保地区编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "440300")
+    @NotNull(message = "参保城市不能为空")
+    private Integer areaId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardTypeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardTypeRespVO.java
new file mode 100644
index 0000000..aaf9d3c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/insurance/vo/standard/HrmInsuranceStandardTypeRespVO.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 标准参保类型 Response VO")
+@Data
+public class HrmInsuranceStandardTypeRespVO {
+
+    @Schema(description = "参保方案编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "SS100173")
+    private String code;
+
+    @Schema(description = "参保方案名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "深户一档")
+    private String name;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/HrmOperateLogController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/HrmOperateLogController.java
new file mode 100644
index 0000000..b353cdd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/HrmOperateLogController.java
@@ -0,0 +1,67 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.operatelog;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.operatelog.vo.HrmOperateLogPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.operatelog.vo.HrmOperateLogRespVO;
+import cn.iocoder.yudao.module.hrm.enums.LogRecordConstants;
+import cn.iocoder.yudao.module.hrm.enums.common.HrmBizTypeEnum;
+import cn.iocoder.yudao.module.system.api.logger.OperateLogApi;
+import cn.iocoder.yudao.module.system.api.logger.dto.OperateLogPageReqDTO;
+import cn.iocoder.yudao.module.system.api.logger.dto.OperateLogRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.pojo.PageParam.PAGE_SIZE_NONE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_RECRUIT_CANDIDATE_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_RECRUIT_POST_TYPE;
+
+@Tag(name = "管理后台 - HRM 操作日志")
+@RestController
+@RequestMapping("/hrm/operate-log")
+@Validated
+public class HrmOperateLogController {
+
+    private static final Map<Integer, String> BIZ_TYPE_MAP = new HashMap<>();
+
+    static {
+        BIZ_TYPE_MAP.put(HrmBizTypeEnum.RECRUIT_POST.getType(), HRM_RECRUIT_POST_TYPE);
+        BIZ_TYPE_MAP.put(HrmBizTypeEnum.RECRUIT_CANDIDATE.getType(), HRM_RECRUIT_CANDIDATE_TYPE);
+        BIZ_TYPE_MAP.put(HrmBizTypeEnum.EMPLOYEE.getType(), HRM_EMPLOYEE_TYPE);
+        BIZ_TYPE_MAP.put(HrmBizTypeEnum.PERFORMANCE_ASSESSMENT.getType(), HRM_PERFORMANCE_TYPE);
+        BIZ_TYPE_MAP.put(HrmBizTypeEnum.PERFORMANCE_PLAN.getType(), HRM_PERFORMANCE_PLAN_TYPE);
+    }
+
+    @Resource
+    private OperateLogApi operateLogApi;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得操作日志")
+    @PreAuthorize("@ss.hasAnyPermissions('hrm:recruit:post:query', 'hrm:recruit:candidate:query', "
+            + "'hrm:employee:query', 'hrm:performance:plan:query')")
+    public CommonResult<PageResult<HrmOperateLogRespVO>> getOperateLogPage(
+            @Valid HrmOperateLogPageReqVO pageReqVO) {
+        OperateLogPageReqDTO reqDTO = new OperateLogPageReqDTO();
+        reqDTO.setPageSize(PAGE_SIZE_NONE);
+        reqDTO.setType(BIZ_TYPE_MAP.get(pageReqVO.getBizType()));
+        reqDTO.setBizId(pageReqVO.getBizId());
+        PageResult<OperateLogRespDTO> pageResult = operateLogApi.getOperateLogPage(reqDTO);
+        return success(BeanUtils.toBean(pageResult, HrmOperateLogRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/vo/HrmOperateLogPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/vo/HrmOperateLogPageReqVO.java
new file mode 100644
index 0000000..ce6ad8a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/vo/HrmOperateLogPageReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.operatelog.vo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.common.HrmBizTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+@Schema(description = "管理后台 - HRM 操作日志分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmOperateLogPageReqVO extends PageParam {
+
+    @Schema(description = "业务类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @InEnum(HrmBizTypeEnum.class)
+    @NotNull(message = "业务类型不能为空")
+    private Integer bizType;
+
+    @Schema(description = "业务编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "业务编号不能为空")
+    private Long bizId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/vo/HrmOperateLogRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/vo/HrmOperateLogRespVO.java
new file mode 100644
index 0000000..1119910
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/operatelog/vo/HrmOperateLogRespVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.operatelog.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 操作日志 Response VO")
+@Data
+public class HrmOperateLogRespVO {
+
+    @Schema(description = "日志编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "操作用户编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long userId;
+
+    @Schema(description = "操作用户名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "芋道源码")
+    private String userName;
+
+    @Schema(description = "操作用户类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    private Integer userType;
+
+    @Schema(description = "日志类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "HRM 招聘职位")
+    private String type;
+
+    @Schema(description = "日志子类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "更新招聘职位")
+    private String subType;
+
+    @Schema(description = "业务编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long bizId;
+
+    @Schema(description = "操作内容", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "更新了招聘职位【Java 开发工程师】")
+    private String action;
+
+    @Schema(description = "拓展字段", example = "{}")
+    private String extra;
+
+    @Schema(description = "操作时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceAssessmentController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceAssessmentController.java
new file mode 100644
index 0000000..1cd6934
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceAssessmentController.java
@@ -0,0 +1,202 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchivePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentBatchReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceProcessRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentProcessService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentQueryService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentService;
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertLinkedSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工绩效考核")
+@RestController
+@RequestMapping("/hrm/performance/assessment")
+@Validated
+public class HrmPerformanceAssessmentController {
+
+    @Resource
+    private HrmPerformanceAssessmentService performanceAssessmentService;
+    @Resource
+    private HrmPerformanceAssessmentQueryService performanceAssessmentQueryService;
+    @Resource
+    private HrmPerformancePlanService performancePlanService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @PostMapping("/create-list")
+    @Operation(summary = "添加员工绩效考核")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> addPerformancePlanEmployees(
+            @Valid @RequestBody HrmPerformanceAssessmentBatchReqVO reqVO) {
+        performancePlanService.addPerformancePlanEmployees(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "移除员工绩效考核")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> removePerformancePlanEmployees(
+            @Valid @RequestBody HrmPerformanceAssessmentBatchReqVO reqVO) {
+        performancePlanService.removePerformancePlanEmployees(reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得员工绩效考核分页")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentPage(
+            @Validated HrmPerformanceAssessmentPageReqVO reqVO) {
+        PageResult<HrmPerformanceAssessmentDO> pageResult =
+                performanceAssessmentService.getPerformanceAssessmentPage(reqVO);
+        return success(performanceAssessmentQueryService.getPerformanceAssessmentRespVOPage(pageResult));
+    }
+
+    @GetMapping("/unassigned-employee-id-list")
+    @Operation(summary = "获得未加入指定绩效计划的员工编号列表")
+    @Parameter(name = "planId", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<List<Long>> getPerformancePlanUnassignedEmployeeIdList(
+            @RequestParam("planId") Long planId) {
+        performancePlanService.validatePerformancePlanExists(planId);
+        // 1. 查询已经参与计划的员工
+        List<HrmPerformanceAssessmentDO> assessments =
+                performanceAssessmentService.getPerformanceAssessmentListByPlanId(planId);
+        Set<Long> assignedEmployeeIds = convertSet(assessments, HrmPerformanceAssessmentDO::getEmployeeId);
+        // 2. 筛选尚未参与计划的员工
+        List<HrmEmployeeDO> employees = employeeService.getEmployeeList(new HrmEmployeeListReqVO());
+        return success(convertList(employees, HrmEmployeeDO::getId,
+                employee -> !assignedEmployeeIds.contains(employee.getId())));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得员工绩效考核")
+    @Parameter(name = "id", description = "员工绩效考核编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<HrmPerformanceAssessmentRespVO> getPerformanceAssessment(@RequestParam("id") Long id) {
+        HrmPerformanceAssessmentDO assessment = performanceAssessmentService.getPerformanceAssessment(id);
+        return success(performanceAssessmentQueryService.getPerformanceAssessmentProcessRespVO(
+                assessment, getLoginUserId()));
+    }
+
+    @GetMapping("/process-record-list")
+    @Operation(summary = "获得绩效流程记录列表")
+    @Parameter(name = "id", description = "员工绩效考核编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<List<HrmPerformanceProcessRecordRespVO>> getPerformanceAssessmentProcessRecordList(
+            @RequestParam("id") Long id) {
+        HrmPerformanceAssessmentDO assessment = performanceAssessmentService.getPerformanceAssessment(id);
+        return success(performanceAssessmentQueryService.getPerformanceAssessmentProcessRecordList(assessment));
+    }
+
+    @GetMapping("/archive-page")
+    @Operation(summary = "获得绩效归档分页")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:archive:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentArchivePage(
+            @Validated HrmPerformanceArchivePageReqVO reqVO) {
+        PageResult<HrmPerformanceAssessmentDO> pageResult =
+                performanceAssessmentService.getPerformanceAssessmentArchivePage(reqVO);
+        return success(performanceAssessmentQueryService.getPerformanceAssessmentRespVOPage(pageResult));
+    }
+
+    @GetMapping("/archive-employee-page")
+    @Operation(summary = "获得员工绩效档案分页")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:archive:query')")
+    public CommonResult<PageResult<HrmPerformanceArchiveEmployeeRespVO>> getPerformanceArchiveEmployeePage(
+            @Validated HrmPerformanceArchiveEmployeePageReqVO reqVO) {
+        PageResult<HrmEmployeeDO> pageResult =
+                performanceAssessmentService.getPerformanceArchiveEmployeePage(reqVO);
+        return success(performanceAssessmentQueryService.getPerformanceArchiveEmployeeRespVOPage(pageResult));
+    }
+
+    @GetMapping("/archive-get")
+    @Operation(summary = "获得绩效归档详情")
+    @Parameter(name = "id", description = "员工绩效考核编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:archive:query')")
+    public CommonResult<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentArchive(@RequestParam("id") Long id) {
+        HrmPerformanceAssessmentDO assessment = performanceAssessmentService.getPerformanceAssessmentArchive(id);
+        return success(performanceAssessmentQueryService.getPerformanceAssessmentRespVO(assessment));
+    }
+
+    @GetMapping("/archive-process-record-list")
+    @Operation(summary = "获得绩效归档流程记录列表")
+    @Parameter(name = "id", description = "员工绩效考核编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:archive:query')")
+    public CommonResult<List<HrmPerformanceProcessRecordRespVO>> getPerformanceAssessmentArchiveProcessRecordList(
+            @RequestParam("id") Long id) {
+        HrmPerformanceAssessmentDO assessment = performanceAssessmentService.getPerformanceAssessmentArchive(id);
+        return success(performanceAssessmentQueryService.getPerformanceAssessmentProcessRecordList(assessment));
+    }
+
+    @GetMapping("/archive-plan-simple-list")
+    @Operation(summary = "获得绩效归档计划精简列表")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:archive:query')")
+    public CommonResult<List<HrmPerformancePlanRespVO>> getPerformanceArchivePlanSimpleList() {
+        // 1. 查询存在归档考核的绩效计划
+        List<HrmPerformanceAssessmentDO> assessments =
+                performanceAssessmentService.getPerformanceAssessmentListByStatus(
+                        HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+        Set<Long> planIds = convertLinkedSet(assessments, HrmPerformanceAssessmentDO::getPlanId);
+        List<HrmPerformancePlanDO> plans = performancePlanService.getPerformancePlanList(planIds);
+        // 2. 转换响应
+        return success(convertList(plans, plan -> new HrmPerformancePlanRespVO()
+                .setId(plan.getId()).setName(plan.getName())));
+    }
+
+    @DeleteMapping("/archive-delete")
+    @Operation(summary = "删除绩效归档记录")
+    @Parameter(name = "ids", description = "绩效归档记录编号列表", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:archive:delete')")
+    public CommonResult<Boolean> deletePerformanceArchiveRecords(
+            @RequestParam("ids") @NotEmpty(message = "归档记录不能为空") List<Long> ids) {
+        performanceAssessmentService.deletePerformanceArchiveRecords(ids);
+        return success(true);
+    }
+
+    @DeleteMapping("/archive-employee-delete")
+    @Operation(summary = "删除员工的全部绩效档案")
+    @Parameter(name = "employeeIds", description = "员工编号列表", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:archive:delete')")
+    public CommonResult<Boolean> deletePerformanceArchiveEmployeeRecords(
+            @RequestParam("employeeIds") @NotEmpty(message = "员工不能为空") List<Long> employeeIds) {
+        performanceAssessmentService.deletePerformanceArchiveRecordsByEmployeeIds(employeeIds);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceAssessmentTemplateController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceAssessmentTemplateController.java
new file mode 100644
index 0000000..24b4a5b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceAssessmentTemplateController.java
@@ -0,0 +1,148 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplateRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.service.performance.config.HrmPerformanceAssessmentTemplateService;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.singletonList;
+
+@Tag(name = "管理后台 - HRM 绩效考核模板")
+@RestController
+@RequestMapping("/hrm/performance/assessment-template")
+@Validated
+public class HrmPerformanceAssessmentTemplateController {
+
+    @Resource
+    private HrmPerformanceAssessmentTemplateService assessmentTemplateService;
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建绩效考核模板")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:assessment-template:create')")
+    public CommonResult<Long> createPerformanceAssessmentTemplate(
+            @Valid @RequestBody HrmPerformanceAssessmentTemplateSaveReqVO createReqVO) {
+        return success(assessmentTemplateService.createPerformanceAssessmentTemplate(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新绩效考核模板")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:assessment-template:update')")
+    public CommonResult<Boolean> updatePerformanceAssessmentTemplate(
+            @Valid @RequestBody HrmPerformanceAssessmentTemplateSaveReqVO updateReqVO) {
+        assessmentTemplateService.updatePerformanceAssessmentTemplate(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除绩效考核模板")
+    @Parameter(name = "id", description = "模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:assessment-template:delete')")
+    public CommonResult<Boolean> deletePerformanceAssessmentTemplate(@RequestParam("id") Long id) {
+        assessmentTemplateService.deletePerformanceAssessmentTemplate(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "批量删除绩效考核模板")
+    @Parameter(name = "ids", description = "模板编号列表", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:assessment-template:delete')")
+    public CommonResult<Boolean> deletePerformanceAssessmentTemplateList(@RequestParam("ids") List<Long> ids) {
+        assessmentTemplateService.deletePerformanceAssessmentTemplateList(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得绩效考核模板")
+    @Parameter(name = "id", description = "模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:assessment-template:query')")
+    public CommonResult<HrmPerformanceAssessmentTemplateRespVO> getPerformanceAssessmentTemplate(
+            @RequestParam("id") Long id) {
+        // 1. 获得考核模板
+        HrmPerformanceAssessmentTemplateDO template =
+                assessmentTemplateService.getPerformanceAssessmentTemplate(id);
+        // 2. 拼接数据
+        return success(buildAssessmentTemplateRespVO(template));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得绩效考核模板分页")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:assessment-template:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentTemplateRespVO>> getPerformanceAssessmentTemplatePage(
+            @Validated HrmPerformanceAssessmentTemplatePageReqVO pageReqVO) {
+        PageResult<HrmPerformanceAssessmentTemplateDO> pageResult =
+                assessmentTemplateService.getPerformanceAssessmentTemplatePage(pageReqVO);
+        if (CollUtil.isEmpty(pageResult.getList())) {
+            return success(PageResult.empty(pageResult.getTotal()));
+        }
+        // 2. 拼接数据
+        return success(new PageResult<>(buildAssessmentTemplateRespVOList(pageResult.getList()),
+                pageResult.getTotal()));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得绩效考核模板精简列表")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:assessment-template:query')")
+    public CommonResult<List<HrmPerformanceAssessmentTemplateRespVO>> getPerformanceAssessmentTemplateSimpleList() {
+        List<HrmPerformanceAssessmentTemplateDO> templates = assessmentTemplateService
+                .getPerformanceAssessmentTemplateListByStatus(CommonStatusEnum.ENABLE.getStatus());
+        return success(BeanUtils.toBean(templates, HrmPerformanceAssessmentTemplateRespVO.class));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmPerformanceAssessmentTemplateRespVO buildAssessmentTemplateRespVO(
+            HrmPerformanceAssessmentTemplateDO template) {
+        if (template == null) {
+            return null;
+        }
+        return CollUtil.getFirst(buildAssessmentTemplateRespVOList(singletonList(template)));
+    }
+
+    private List<HrmPerformanceAssessmentTemplateRespVO> buildAssessmentTemplateRespVOList(
+            List<HrmPerformanceAssessmentTemplateDO> templates) {
+        if (CollUtil.isEmpty(templates)) {
+            return emptyList();
+        }
+        // 1. 获得创建人信息
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(templates, template -> NumberUtils.parseLong(template.getCreator())));
+        // 2. 拼接响应
+        return BeanUtils.toBean(templates, HrmPerformanceAssessmentTemplateRespVO.class, template ->
+                MapUtils.findAndThen(userMap, NumberUtils.parseLong(template.getCreator()),
+                        user -> template.setCreatorName(user.getNickname())));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformancePlanController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformancePlanController.java
new file mode 100644
index 0000000..e2398ea
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformancePlanController.java
@@ -0,0 +1,258 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformancePlanResultLevelCountRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformancePlanStageCountRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentProcessStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanScopeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentService;
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertListByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getSumValue;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 绩效计划")
+@RestController
+@RequestMapping("/hrm/performance/plan")
+@Validated
+public class HrmPerformancePlanController {
+
+    @Resource
+    private HrmPerformancePlanService performancePlanService;
+    @Resource
+    private HrmPerformanceAssessmentService performanceAssessmentService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建绩效计划")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:create')")
+    public CommonResult<Long> createPerformancePlan(
+            @Valid @RequestBody HrmPerformancePlanSaveReqVO reqVO) {
+        return success(performancePlanService.createPerformancePlan(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新绩效计划")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> updatePerformancePlan(@Valid @RequestBody HrmPerformancePlanSaveReqVO reqVO) {
+        performancePlanService.updatePerformancePlan(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除绩效计划")
+    @Parameter(name = "id", description = "计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:delete')")
+    public CommonResult<Boolean> deletePerformancePlan(@RequestParam("id") Long id) {
+        performancePlanService.deletePerformancePlan(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得绩效计划")
+    @Parameter(name = "id", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<HrmPerformancePlanRespVO> getPerformancePlan(@RequestParam("id") Long id) {
+        return success(buildPlanRespVO(performancePlanService.getPerformancePlan(id)));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得绩效计划分页")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<PageResult<HrmPerformancePlanRespVO>> getPerformancePlanPage(
+            @Validated HrmPerformancePlanPageReqVO reqVO) {
+        PageResult<HrmPerformancePlanDO> pageResult = performancePlanService.getPerformancePlanPage(reqVO);
+        return success(new PageResult<>(buildPlanRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @PostMapping("/start")
+    @Operation(summary = "启动绩效计划")
+    @Parameter(name = "id", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> startPerformancePlan(@RequestParam("id") Long id) {
+        performancePlanService.startPerformancePlan(id);
+        return success(true);
+    }
+
+    @PostMapping("/open-scoring")
+    @Operation(summary = "开启绩效评分")
+    @Parameter(name = "id", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> openPerformancePlanScoring(@RequestParam("id") Long id) {
+        performancePlanService.openPerformancePlanScoring(id);
+        return success(true);
+    }
+
+    @PostMapping("/start-interview")
+    @Operation(summary = "发起绩效面谈")
+    @Parameter(name = "id", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> startPerformancePlanInterview(@RequestParam("id") Long id) {
+        performancePlanService.startPerformancePlanInterview(id);
+        return success(true);
+    }
+
+    @PostMapping("/archive")
+    @Operation(summary = "归档绩效计划")
+    @Parameter(name = "id", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> archivePerformancePlan(@RequestParam("id") Long id) {
+        performancePlanService.archivePerformancePlan(id);
+        return success(true);
+    }
+
+    @PostMapping("/terminate")
+    @Operation(summary = "终止绩效计划")
+    @Parameter(name = "id", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:update')")
+    public CommonResult<Boolean> terminatePerformancePlan(@RequestParam("id") Long id) {
+        performancePlanService.terminatePerformancePlan(getLoginUserId(), id);
+        return success(true);
+    }
+
+    @GetMapping("/status-count")
+    @Operation(summary = "获得绩效计划状态统计")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<Map<Integer, Long>> getPerformancePlanStatusCount(
+            @Validated HrmPerformancePlanPageReqVO reqVO) {
+        return success(performancePlanService.getPerformancePlanStatusCount(reqVO));
+    }
+
+    @GetMapping("/stage-count")
+    @Operation(summary = "获得绩效计划阶段统计")
+    @Parameter(name = "planId", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<List<HrmPerformancePlanStageCountRespVO>> getPerformancePlanStageCount(
+            @RequestParam("planId") Long planId) {
+        performancePlanService.validatePerformancePlanExists(planId);
+        // 1.1 查询绩效计划的员工考核
+        List<HrmPerformanceAssessmentDO> assessments =
+                performanceAssessmentService.getPerformanceAssessmentListByPlanId(planId);
+        // 1.2 按考核阶段统计
+        Map<Integer, Long> countMap = convertMap(
+                filterList(assessments, assessment -> assessment.getStageType() != null),
+                HrmPerformanceAssessmentDO::getStageType, assessment -> 1L, Long::sum, LinkedHashMap::new);
+        // 2. 转换响应
+        return success(convertList(Arrays.asList(HrmPerformanceStageTypeEnum.ARRAYS),
+                stageType -> new HrmPerformancePlanStageCountRespVO()
+                        .setStageType(stageType).setCount(countMap.get(stageType)),
+                stageType -> countMap.getOrDefault(stageType, 0L) > 0));
+    }
+
+    @GetMapping("/level-count")
+    @Operation(summary = "获得绩效结果等级统计")
+    @Parameter(name = "planId", description = "绩效计划编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:plan:query')")
+    public CommonResult<List<HrmPerformancePlanResultLevelCountRespVO>> getPerformancePlanLevelCount(
+            @RequestParam("planId") Long planId) {
+        HrmPerformancePlanDO plan = performancePlanService.getPerformancePlan(planId);
+        if (plan == null) {
+            return success(Collections.emptyList());
+        }
+        // 1.1 查询绩效计划的员工考核
+        List<HrmPerformanceAssessmentDO> assessments =
+                performanceAssessmentService.getPerformanceAssessmentListByPlanId(planId);
+        // 1.2 按结果模板顺序初始化全部等级，再累计实际人数
+        Map<String, Long> levelCountMap = new LinkedHashMap<>();
+        plan.getResultConfig().getLevels().forEach(level -> levelCountMap.put(level.getName(), 0L));
+        filterList(assessments, assessment -> StrUtil.isNotBlank(assessment.getResultLevel()))
+                .forEach(assessment -> levelCountMap.merge(assessment.getResultLevel(), 1L, Long::sum));
+        // 2. 转换响应
+        return success(convertList(levelCountMap.entrySet(), entry -> new HrmPerformancePlanResultLevelCountRespVO()
+                .setLevelName(entry.getKey()).setCount(entry.getValue())));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmPerformancePlanRespVO buildPlanRespVO(HrmPerformancePlanDO plan) {
+        return plan == null ? null : CollUtil.getFirst(buildPlanRespVOList(Collections.singletonList(plan)));
+    }
+
+    private List<HrmPerformancePlanRespVO> buildPlanRespVOList(List<HrmPerformancePlanDO> plans) {
+        // 1. 获得员工考核和阶段信息
+        List<HrmPerformanceAssessmentDO> assessments =
+                performanceAssessmentService.getPerformanceAssessmentListByPlanIds(
+                        convertList(plans, HrmPerformancePlanDO::getId));
+        Map<Long, List<HrmPerformanceAssessmentDO>> assessmentMap =
+                convertMultiMap(assessments, HrmPerformanceAssessmentDO::getPlanId);
+        List<HrmPerformanceAssessmentStageDO> stages = performanceAssessmentService.getPerformanceAssessmentStageList(
+                convertSet(assessments, HrmPerformanceAssessmentDO::getId));
+        Map<Long, List<HrmPerformanceAssessmentStageDO>> stageMap =
+                convertMultiMap(stages, HrmPerformanceAssessmentStageDO::getAssessmentId);
+        // 2. 拼接响应
+        Map<Long, HrmPerformancePlanDO> planMap = convertMap(plans, HrmPerformancePlanDO::getId);
+        return BeanUtils.toBean(plans, HrmPerformancePlanRespVO.class, respVO -> {
+            HrmPerformancePlanDO plan = planMap.get(respVO.getId());
+            // 排除员工范围只用于计划内部维护，不返回给前端编辑
+            respVO.setScopes(filterList(respVO.getScopes(), scope -> ObjUtil.notEqual(scope.getType(),
+                    HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType())));
+            if (plan.getAssessmentConfig() != null) {
+                respVO.setAssessmentTemplateName(plan.getAssessmentConfig().getName());
+            }
+            if (plan.getResultConfig() != null) {
+                respVO.setResultTemplateName(plan.getResultConfig().getName());
+            }
+            // 获得当前计划的员工考核和处理阶段，用于统计执行进度并判断后续可操作节点
+            List<HrmPerformanceAssessmentDO> planAssessments =
+                    assessmentMap.getOrDefault(plan.getId(), Collections.emptyList());
+            List<HrmPerformanceAssessmentStageDO> planStages = convertListByFlatMap(
+                    planAssessments, assessment -> stageMap.getOrDefault(
+                            assessment.getId(), Collections.emptyList()).stream());
+            int finishedCount = getSumValue(planAssessments, assessment -> Objects.equals(
+                    assessment.getProcessStatus(),
+                    HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus()) ? 1 : 0, Integer::sum, 0);
+            Map<Integer, Long> stageCountMap = convertMap(
+                    filterList(planAssessments, assessment -> assessment.getStageType() != null),
+                    HrmPerformanceAssessmentDO::getStageType, assessment -> 1L, Long::sum, LinkedHashMap::new);
+            respVO.setEmployeeCount(planAssessments.size()).setFinishedCount(finishedCount)
+                    .setStageCountMap(stageCountMap)
+                    .setScoringReady(performanceAssessmentService
+                            .isPerformanceAssessmentScoringReady(plan, planAssessments))
+                    .setInterviewReady(performanceAssessmentService
+                            .isPerformanceAssessmentInterviewReady(plan, planAssessments, planStages))
+                    .setArchiveReady(performanceAssessmentService
+                            .isPerformanceAssessmentArchiveReady(plan, planAssessments));
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceResultTemplateController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceResultTemplateController.java
new file mode 100644
index 0000000..0f87939
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/HrmPerformanceResultTemplateController.java
@@ -0,0 +1,149 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplateRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import cn.iocoder.yudao.module.hrm.service.performance.config.HrmPerformanceResultTemplateService;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.singletonList;
+
+@Tag(name = "管理后台 - HRM 绩效结果模板")
+@RestController
+@RequestMapping("/hrm/performance/result-template")
+@Validated
+public class HrmPerformanceResultTemplateController {
+
+    @Resource
+    private HrmPerformanceResultTemplateService resultTemplateService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建绩效结果模板")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:result-template:create')")
+    public CommonResult<Long> createPerformanceResultTemplate(
+            @Valid @RequestBody HrmPerformanceResultTemplateSaveReqVO createReqVO) {
+        return success(resultTemplateService.createPerformanceResultTemplate(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新绩效结果模板")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:result-template:update')")
+    public CommonResult<Boolean> updatePerformanceResultTemplate(
+            @Valid @RequestBody HrmPerformanceResultTemplateSaveReqVO updateReqVO) {
+        resultTemplateService.updatePerformanceResultTemplate(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除绩效结果模板")
+    @Parameter(name = "id", description = "模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:result-template:delete')")
+    public CommonResult<Boolean> deletePerformanceResultTemplate(@RequestParam("id") Long id) {
+        resultTemplateService.deletePerformanceResultTemplate(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete-list")
+    @Operation(summary = "批量删除绩效结果模板")
+    @Parameter(name = "ids", description = "模板编号列表", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:result-template:delete')")
+    public CommonResult<Boolean> deletePerformanceResultTemplateList(@RequestParam("ids") List<Long> ids) {
+        resultTemplateService.deletePerformanceResultTemplateList(ids);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得绩效结果模板")
+    @Parameter(name = "id", description = "模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:result-template:query')")
+    public CommonResult<HrmPerformanceResultTemplateRespVO> getPerformanceResultTemplate(
+            @RequestParam("id") Long id) {
+        // 1. 获得结果模板
+        HrmPerformanceResultTemplateDO template = resultTemplateService.getPerformanceResultTemplate(id);
+        // 2. 拼接数据
+        return success(buildResultTemplateRespVO(template));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得绩效结果模板分页")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:result-template:query')")
+    public CommonResult<PageResult<HrmPerformanceResultTemplateRespVO>> getPerformanceResultTemplatePage(
+            @Validated HrmPerformanceResultTemplatePageReqVO pageReqVO) {
+        PageResult<HrmPerformanceResultTemplateDO> pageResult =
+                resultTemplateService.getPerformanceResultTemplatePage(pageReqVO);
+        if (CollUtil.isEmpty(pageResult.getList())) {
+            return success(PageResult.empty(pageResult.getTotal()));
+        }
+        // 2. 拼接数据
+        return success(new PageResult<>(buildResultTemplateRespVOList(pageResult.getList()),
+                pageResult.getTotal()));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得绩效结果模板精简列表")
+    @Parameter(name = "status", description = "状态", example = "0")
+    @PreAuthorize("@ss.hasPermission('hrm:performance:result-template:query')")
+    public CommonResult<List<HrmPerformanceResultTemplateRespVO>> getPerformanceResultTemplateSimpleList(
+            @RequestParam(value = "status", required = false) Integer status) {
+        List<HrmPerformanceResultTemplateDO> templates =
+                resultTemplateService.getPerformanceResultTemplateList(status);
+        return success(BeanUtils.toBean(templates, HrmPerformanceResultTemplateRespVO.class));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmPerformanceResultTemplateRespVO buildResultTemplateRespVO(
+            HrmPerformanceResultTemplateDO template) {
+        if (template == null) {
+            return null;
+        }
+        return CollUtil.getFirst(buildResultTemplateRespVOList(singletonList(template)));
+    }
+
+    private List<HrmPerformanceResultTemplateRespVO> buildResultTemplateRespVOList(
+            List<HrmPerformanceResultTemplateDO> templates) {
+        if (CollUtil.isEmpty(templates)) {
+            return emptyList();
+        }
+        // 1. 获得创建人信息
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(templates, template -> NumberUtils.parseLong(template.getCreator())));
+        // 2. 拼接响应
+        return BeanUtils.toBean(templates, HrmPerformanceResultTemplateRespVO.class, template ->
+                MapUtils.findAndThen(userMap, NumberUtils.parseLong(template.getCreator()),
+                        user -> template.setCreatorName(user.getNickname())));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchiveEmployeePageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchiveEmployeePageReqVO.java
new file mode 100644
index 0000000..517d787
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchiveEmployeePageReqVO.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 员工绩效档案分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPerformanceArchiveEmployeePageReqVO extends PageParam {
+
+    @Schema(description = "员工姓名或工号，模糊匹配", example = "张三")
+    private String search;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchiveEmployeeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchiveEmployeeRespVO.java
new file mode 100644
index 0000000..d18e4e1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchiveEmployeeRespVO.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工绩效档案 Response VO")
+@Data
+public class HrmPerformanceArchiveEmployeeRespVO {
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名", example = "张三")
+    private String employeeName;
+
+    @Schema(description = "工号", example = "HRM001")
+    private String jobNumber;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "部门名称", example = "研发部")
+    private String deptName;
+
+    @Schema(description = "职位名称", example = "Java 工程师")
+    private String postName;
+
+    @Schema(description = "手机号码", example = "15601691300")
+    private String mobile;
+
+    @Schema(description = "员工状态", example = "1")
+    private Integer employeeStatus;
+
+    @Schema(description = "聘用形式", example = "1")
+    private Integer employeeType;
+
+    @Schema(description = "最近考核编号", example = "2048")
+    private Long latestAssessmentId;
+
+    @Schema(description = "最近考核计划", example = "2026 年度绩效考核")
+    private String latestPlanName;
+
+    @Schema(description = "最近绩效评分", example = "95.50")
+    private BigDecimal latestScore;
+
+    @Schema(description = "最近绩效等级", example = "A")
+    private String latestResultLevel;
+
+    @Schema(description = "考核次数", example = "3")
+    private Long assessmentCount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchivePageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchivePageReqVO.java
new file mode 100644
index 0000000..8d33b2a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceArchivePageReqVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 绩效归档分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPerformanceArchivePageReqVO extends PageParam {
+
+    @Schema(description = "绩效计划编号", example = "1024")
+    private Long planId;
+
+    @Schema(description = "员工编号", example = "2048")
+    private Long employeeId;
+
+    @Schema(description = "员工编号列表", example = "[2048, 2049]")
+    private List<Long> employeeIds;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentBatchReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentBatchReqVO.java
new file mode 100644
index 0000000..8a8fc67
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentBatchReqVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 绩效计划增删员工 Request VO")
+@Data
+public class HrmPerformanceAssessmentBatchReqVO {
+
+    @Schema(description = "绩效计划编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "绩效计划不能为空")
+    private Long planId;
+
+    @Schema(description = "员工编号列表", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "[1024, 2048]")
+    @NotEmpty(message = "员工不能为空")
+    private List<Long> employeeIds;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentDimensionRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentDimensionRespVO.java
new file mode 100644
index 0000000..94dfba8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentDimensionRespVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工绩效维度 Response VO")
+@Data
+public class HrmPerformanceAssessmentDimensionRespVO {
+
+    @Schema(description = "维度编号")
+    private Long id;
+
+    @Schema(description = "员工绩效考核编号")
+    private Long assessmentId;
+
+    @Schema(description = "维度名称")
+    private String name;
+
+    @Schema(description = "指标类型")
+    private Integer quotaType;
+
+    @Schema(description = "维度权重")
+    private BigDecimal weight;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "是否允许编辑")
+    private Boolean allowEdit;
+
+    @Schema(description = "排序")
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentPageReqVO.java
new file mode 100644
index 0000000..bb62fc3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentPageReqVO.java
@@ -0,0 +1,58 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 绩效计划员工分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPerformanceAssessmentPageReqVO extends PageParam {
+
+    @Schema(description = "绩效计划编号", example = "1024")
+    private Long planId;
+
+    @Schema(description = "员工编号", example = "2048")
+    private Long employeeId;
+
+    @Schema(description = "员工编号列表", example = "[2048, 2049]")
+    private List<Long> employeeIds;
+
+    @Schema(description = "员工姓名或工号", example = "张三")
+    private String search;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "聘用形式", example = "1")
+    private Integer employeeType;
+
+    @Schema(description = "员工状态", example = "1")
+    private Integer employeeStatus;
+
+    @Schema(description = "考核状态", example = "1")
+    @InEnum(value = HrmPerformancePlanStatusEnum.class, message = "考核状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "阶段状态", example = "2")
+    @InEnum(value = HrmPerformanceStageTypeEnum.class, message = "阶段状态必须是 {value}")
+    private Integer stageType;
+
+    @Schema(description = "申诉状态", example = "1")
+    @InEnum(value = HrmPerformanceAppealStatusEnum.class, message = "申诉状态必须是 {value}")
+    private Integer appealStatus;
+
+    @Schema(description = "结果等级", example = "A")
+    private String resultLevel;
+
+    @Schema(description = "结果等级是否为空", example = "false")
+    private Boolean resultLevelEmpty;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentQuotaRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentQuotaRespVO.java
new file mode 100644
index 0000000..51abaf6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentQuotaRespVO.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工绩效指标 Response VO")
+@Data
+public class HrmPerformanceAssessmentQuotaRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "员工绩效考核编号")
+    private Long assessmentId;
+
+    @Schema(description = "员工绩效维度编号")
+    private Long dimensionId;
+
+    @Schema(description = "是否允许编辑")
+    private Boolean allowEdit;
+
+    @Schema(description = "预设值")
+    private Boolean preset;
+
+    @Schema(description = "维度名称")
+    private String dimensionName;
+
+    @Schema(description = "指标名称")
+    private String name;
+
+    @Schema(description = "指标说明")
+    private String description;
+
+    @Schema(description = "标准值")
+    private String standard;
+
+    @Schema(description = "维度权重")
+    private BigDecimal dimensionWeight;
+
+    @Schema(description = "指标权重")
+    private BigDecimal weight;
+
+    @Schema(description = "分数类型")
+    private Integer scoreType;
+
+    @Schema(description = "目标值")
+    private String targetValue;
+
+    @Schema(description = "实际值")
+    private String actualValue;
+
+    @Schema(description = "自评分数")
+    private BigDecimal selfScore;
+
+    @Schema(description = "评分人得分")
+    private BigDecimal reviewerScore;
+
+    @Schema(description = "最终得分")
+    private BigDecimal finalScore;
+
+    @Schema(description = "说明")
+    private String comment;
+
+    @Schema(description = "排序")
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentQuotaScoreRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentQuotaScoreRespVO.java
new file mode 100644
index 0000000..e1e66cb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentQuotaScoreRespVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工绩效指标评分明细 Response VO")
+@Data
+public class HrmPerformanceAssessmentQuotaScoreRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "员工评分阶段编号")
+    private Long assessmentStageId;
+
+    @Schema(description = "员工绩效指标编号")
+    private Long assessmentQuotaId;
+
+    @Schema(description = "得分")
+    private BigDecimal score;
+
+    @Schema(description = "说明")
+    private String comment;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentRespVO.java
new file mode 100644
index 0000000..1fc3f02
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentRespVO.java
@@ -0,0 +1,170 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 绩效员工 Response VO")
+@Data
+public class HrmPerformanceAssessmentRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "绩效计划编号")
+    private Long planId;
+
+    @Schema(description = "绩效计划名称")
+    private String name;
+
+    @Schema(description = "考核周期类型")
+    private Integer cycleType;
+
+    @Schema(description = "考核周期")
+    private String cycle;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "单项评分上限")
+    private BigDecimal upperLimitScore;
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "手机号")
+    private String mobile;
+
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "部门名称")
+    private String deptName;
+
+    @Schema(description = "职位名称")
+    private String postName;
+
+    @Schema(description = "聘用形式")
+    private Integer employeeType;
+
+    @Schema(description = "员工状态")
+    private Integer employeeStatus;
+
+    @Schema(description = "当前处理人")
+    private String currentHandlerName;
+
+    @Schema(description = "考核状态")
+    private Integer status;
+
+    @Schema(description = "激活状态")
+    private Integer processStatus;
+
+    @Schema(description = "阶段状态")
+    private Integer stageType;
+
+    @Schema(description = "阶段排序")
+    private Integer stageSort;
+
+    @Schema(description = "得分")
+    private BigDecimal score;
+
+    @Schema(description = "结果等级")
+    private String resultLevel;
+
+    @Schema(description = "绩效系数")
+    private BigDecimal coefficient;
+
+    @Schema(description = "目标确认员工姓名")
+    private String targetConfirmationEmployeeName;
+
+    @Schema(description = "目标确认结果")
+    private Integer targetConfirmationResult;
+
+    @Schema(description = "目标确认意见")
+    private String targetConfirmationComment;
+
+    @Schema(description = "目标确认时间")
+    private LocalDateTime targetConfirmationTime;
+
+    @Schema(description = "是否可确认目标")
+    private Boolean canConfirmTarget;
+
+    @Schema(description = "自评说明")
+    private String selfComment;
+
+    @Schema(description = "评分人说明")
+    private String reviewerComment;
+
+    @Schema(description = "结果说明")
+    private String resultComment;
+
+    @Schema(description = "结果确认时间")
+    private LocalDateTime resultConfirmationTime;
+
+    @Schema(description = "结果审核状态")
+    private Integer resultAuditStatus;
+
+    @Schema(description = "结果审核时间")
+    private LocalDateTime resultAuditTime;
+
+    @Schema(description = "结果审核意见")
+    private String resultAuditReason;
+
+    @Schema(description = "申诉原因")
+    private String appealReason;
+
+    @Schema(description = "申诉附件地址列表")
+    private List<String> appealFileUrls;
+
+    @Schema(description = "申诉退回评分阶段编号列表")
+    private List<Long> appealReviewStageIds;
+
+    @Schema(description = "申诉提交时间")
+    private LocalDateTime appealSubmitTime;
+
+    @Schema(description = "申诉状态")
+    private Integer appealStatus;
+
+    @Schema(description = "申诉处理时间")
+    private LocalDateTime appealTime;
+
+    @Schema(description = "申诉处理意见")
+    private String appealComment;
+
+    @Schema(description = "归档时间")
+    private LocalDateTime archiveTime;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "指标维度列表")
+    private List<HrmPerformanceAssessmentDimensionRespVO> dimensions;
+
+    @Schema(description = "指标列表")
+    private List<HrmPerformanceAssessmentQuotaRespVO> quotas;
+
+    @Schema(description = "评分阶段列表")
+    private List<HrmPerformanceAssessmentStageRespVO> reviewStages;
+
+    @Schema(description = "当前评分阶段")
+    private HrmPerformanceAssessmentStageRespVO currentReviewStage;
+
+    @Schema(description = "运行阶段列表")
+    private List<HrmPerformanceAssessmentStageRespVO> stages;
+
+    @Schema(description = "当前待处理阶段")
+    private HrmPerformanceAssessmentStageRespVO currentStage;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentStageRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentStageRespVO.java
new file mode 100644
index 0000000..b98bbf1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceAssessmentStageRespVO.java
@@ -0,0 +1,83 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工绩效运行阶段 Response VO")
+@Data
+public class HrmPerformanceAssessmentStageRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "员工绩效考核编号")
+    private Long assessmentId;
+
+    @Schema(description = "阶段类型")
+    private Integer type;
+
+    @Schema(description = "处理员工编号")
+    private Long handlerEmployeeId;
+
+    @Schema(description = "处理人姓名")
+    private String handlerName;
+
+    @Schema(description = "阶段名称")
+    private String name;
+
+    @Schema(description = "评分人类型")
+    private Integer raterType;
+
+    @Schema(description = "权重")
+    private BigDecimal weight;
+
+    @Schema(description = "评分类型")
+    private Integer scoringType;
+
+    @Schema(description = "可见内容")
+    private Integer visibleContent;
+
+    @Schema(description = "是否必填")
+    private Boolean requiredSetting;
+
+    @Schema(description = "驳回权限")
+    private Boolean rejectAuthority;
+
+    @Schema(description = "排序")
+    private Integer sort;
+
+    @Schema(description = "绩效员工评审阶段状态")
+    private Integer status;
+
+    @Schema(description = "得分")
+    private BigDecimal score;
+
+    @Schema(description = "结果等级")
+    private String resultLevel;
+
+    @Schema(description = "说明")
+    private String comment;
+
+    @Schema(description = "驳回原因")
+    private String rejectReason;
+
+    @Schema(description = "提交时间")
+    private LocalDateTime submitTime;
+
+    @Schema(description = "截止时间")
+    private LocalDateTime deadlineTime;
+
+    @Schema(description = "是否可处理")
+    private Boolean canHandle;
+
+    @Schema(description = "是否可评分")
+    private Boolean canScore;
+
+    @Schema(description = "指标评分列表")
+    private List<HrmPerformanceAssessmentQuotaScoreRespVO> quotaScoreList;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformancePlanResultLevelCountRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformancePlanResultLevelCountRespVO.java
new file mode 100644
index 0000000..409e03c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformancePlanResultLevelCountRespVO.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 绩效计划结果等级统计 Response VO")
+@Data
+public class HrmPerformancePlanResultLevelCountRespVO {
+
+    @Schema(description = "等级名称")
+    private String levelName;
+
+    @Schema(description = "数量")
+    private Long count;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformancePlanStageCountRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformancePlanStageCountRespVO.java
new file mode 100644
index 0000000..82602e9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformancePlanStageCountRespVO.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 绩效计划阶段统计 Response VO")
+@Data
+public class HrmPerformancePlanStageCountRespVO {
+
+    @Schema(description = "阶段状态")
+    private Integer stageType;
+
+    @Schema(description = "数量")
+    private Long count;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceProcessRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceProcessRecordRespVO.java
new file mode 100644
index 0000000..6a43e38
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessment/HrmPerformanceProcessRecordRespVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工绩效考核流程记录 Response VO")
+@Data
+public class HrmPerformanceProcessRecordRespVO {
+
+    @Schema(description = "标题")
+    private String title;
+
+    @Schema(description = "内容")
+    private String content;
+
+    @Schema(description = "来源")
+    private String source;
+
+    @Schema(description = "绩效流程记录状态")
+    private Integer status;
+
+    @Schema(description = "操作人姓名")
+    private String operatorName;
+
+    @Schema(description = "操作时间")
+    private LocalDateTime operateTime;
+
+    @Schema(description = "附件地址列表")
+    private List<String> fileUrls;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplatePageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplatePageReqVO.java
new file mode 100644
index 0000000..288b3b0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplatePageReqVO.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 绩效考核模板分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPerformanceAssessmentTemplatePageReqVO extends PageParam {
+
+    @Schema(description = "模板名称，模糊匹配", example = "季度")
+    private String name;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplateRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplateRespVO.java
new file mode 100644
index 0000000..5930ed0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplateRespVO.java
@@ -0,0 +1,99 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 绩效考核模板 Response VO")
+@Data
+public class HrmPerformanceAssessmentTemplateRespVO {
+
+    @Schema(description = "模板编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "模板名称", example = "季度绩效模板")
+    private String name;
+
+    @Schema(description = "模板说明", example = "适用于季度绩效考核")
+    private String illustrate;
+
+    @Schema(description = "计分方式", example = "1")
+    private Integer scoreCalculation;
+
+    @Schema(description = "分数上限类型", example = "1")
+    private Integer upperLimitType;
+
+    @Schema(description = "分数上限", example = "100")
+    private BigDecimal upperLimitScore;
+
+    @Schema(description = "维度数量", example = "3")
+    private Integer dimensionCount;
+
+    @Schema(description = "指标数量", example = "12")
+    private Integer quotaCount;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "考核维度列表")
+    private List<Dimension> dimensions;
+
+    @Schema(description = "创建人")
+    private String creator;
+
+    @Schema(description = "创建人名称")
+    private String creatorName;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updateTime;
+
+    @Schema(description = "管理后台 - HRM 绩效考核模板维度")
+    @Data
+    public static class Dimension {
+
+        @Schema(description = "维度名称", example = "工作业绩")
+        private String name;
+
+        @Schema(description = "指标类型", example = "1")
+        private Integer quotaType;
+
+        @Schema(description = "维度权重", example = "60")
+        private BigDecimal weight;
+
+        @Schema(description = "备注", example = "核心业绩指标")
+        private String remark;
+
+        @Schema(description = "是否允许员工编辑", example = "true")
+        private Boolean allowEdit;
+
+        @Schema(description = "考核指标列表")
+        private List<Quota> quotas;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效考核模板指标")
+    @Data
+    public static class Quota {
+
+        @Schema(description = "指标名称", example = "销售目标达成率")
+        private String name;
+
+        @Schema(description = "指标说明", example = "按季度销售目标计算")
+        private String illustrate;
+
+        @Schema(description = "评分标准", example = "完成率达到 100% 得满分")
+        private String standard;
+
+        @Schema(description = "指标权重", example = "50")
+        private BigDecimal weight;
+
+        @Schema(description = "评分类型", example = "1")
+        private Integer scoreType;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplateSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplateSaveReqVO.java
new file mode 100644
index 0000000..4a84b91
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/assessmenttemplate/HrmPerformanceAssessmentTemplateSaveReqVO.java
@@ -0,0 +1,234 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaScoreTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceQuotaTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceScoreCalculationEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceUpperLimitTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.PERCENT_100;
+
+@Schema(description = "管理后台 - HRM 绩效考核模板保存 Request VO")
+@Data
+public class HrmPerformanceAssessmentTemplateSaveReqVO {
+
+    @Schema(description = "模板编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "季度绩效模板")
+    @NotBlank(message = "模板名称不能为空")
+    @Size(max = 50, message = "模板名称不能超过 50 个字符")
+    private String name;
+
+    @Schema(description = "模板说明", example = "适用于季度绩效考核")
+    @Size(max = 200, message = "模板说明不能超过 200 个字符")
+    private String illustrate;
+
+    @Schema(description = "计分方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "计分方式不能为空")
+    @InEnum(value = HrmPerformanceScoreCalculationEnum.class, message = "计分方式必须是 {value}")
+    private Integer scoreCalculation;
+
+    @Schema(description = "分数上限类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "分数上限类型不能为空")
+    @InEnum(value = HrmPerformanceUpperLimitTypeEnum.class, message = "分数上限类型必须是 {value}")
+    private Integer upperLimitType;
+
+    @Schema(description = "分数上限", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    @NotNull(message = "分数上限不能为空")
+    @DecimalMin(value = "0", message = "分数上限不能小于 0")
+    @DecimalMax(value = "100", message = "分数上限不能大于 100")
+    private BigDecimal upperLimitScore;
+
+    @Schema(description = "考核维度列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "至少需要一个考核维度")
+    private List<@NotNull(message = "考核维度不能为空") Dimension> dimensions;
+
+    @AssertTrue(message = "考核维度名称不能重复")
+    @JsonIgnore
+    public boolean isDimensionNamesUnique() {
+        if (CollUtil.isEmpty(dimensions)) {
+            return true;
+        }
+        Set<String> names = new HashSet<>();
+        for (Dimension dimension : dimensions) {
+            if (dimension != null && StrUtil.isNotBlank(dimension.getName())
+                    && !names.add(dimension.getName().trim())) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @AssertTrue(message = "考核指标名称不能重复")
+    @JsonIgnore
+    public boolean isQuotaNamesUnique() {
+        if (CollUtil.isEmpty(dimensions)) {
+            return true;
+        }
+        Set<String> names = new HashSet<>();
+        for (Dimension dimension : dimensions) {
+            if (dimension == null || CollUtil.isEmpty(dimension.getQuotas())) {
+                continue;
+            }
+            for (Quota quota : dimension.getQuotas()) {
+                if (quota != null && StrUtil.isNotBlank(quota.getName())
+                        && !names.add(quota.getName().trim())) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+
+    @AssertTrue(message = "维度权重总和必须等于 100%")
+    @JsonIgnore
+    public boolean isDimensionWeightTotalValid() {
+        if (CollUtil.isEmpty(dimensions)) {
+            return true;
+        }
+        BigDecimal totalWeight = BigDecimal.ZERO;
+        for (Dimension dimension : dimensions) {
+            if (dimension == null || dimension.getWeight() == null) {
+                return true;
+            }
+            totalWeight = totalWeight.add(dimension.getWeight());
+        }
+        return totalWeight.compareTo(PERCENT_100) == 0;
+    }
+
+    @AssertTrue(message = "不可编辑维度的指标权重总和必须等于 100%")
+    @JsonIgnore
+    public boolean isFixedQuotaWeightTotalValid() {
+        if (CollUtil.isEmpty(dimensions)) {
+            return true;
+        }
+        for (Dimension dimension : dimensions) {
+            if (dimension == null || ObjUtil.notEqual(Boolean.FALSE, dimension.getAllowEdit())
+                    || CollUtil.isEmpty(dimension.getQuotas())) {
+                continue;
+            }
+            BigDecimal totalWeight = BigDecimal.ZERO;
+            for (Quota quota : dimension.getQuotas()) {
+                if (quota == null || quota.getWeight() == null) {
+                    return true;
+                }
+                totalWeight = totalWeight.add(quota.getWeight());
+            }
+            if (totalWeight.compareTo(PERCENT_100) != 0) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @AssertTrue(message = "可编辑维度的指标权重总和不能大于 100%")
+    @JsonIgnore
+    public boolean isEditableQuotaWeightTotalValid() {
+        if (CollUtil.isEmpty(dimensions)) {
+            return true;
+        }
+        for (Dimension dimension : dimensions) {
+            if (dimension == null || ObjUtil.notEqual(Boolean.TRUE, dimension.getAllowEdit())
+                    || CollUtil.isEmpty(dimension.getQuotas())) {
+                continue;
+            }
+            BigDecimal totalWeight = BigDecimal.ZERO;
+            for (Quota quota : dimension.getQuotas()) {
+                if (quota == null || quota.getWeight() == null) {
+                    return true;
+                }
+                totalWeight = totalWeight.add(quota.getWeight());
+            }
+            if (totalWeight.compareTo(PERCENT_100) > 0) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效考核模板维度")
+    @Data
+    public static class Dimension {
+
+        @Schema(description = "维度名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "工作业绩")
+        @NotBlank(message = "维度名称不能为空")
+        @Size(max = 50, message = "维度名称不能超过 50 个字符")
+        private String name;
+
+        @Schema(description = "指标类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "指标类型不能为空")
+        @InEnum(value = HrmPerformanceQuotaTypeEnum.class, message = "指标类型必须是 {value}")
+        private Integer quotaType;
+
+        @Schema(description = "维度权重", requiredMode = Schema.RequiredMode.REQUIRED, example = "60")
+        @NotNull(message = "维度权重不能为空")
+        @DecimalMin(value = "0", message = "维度权重不能小于 0")
+        @DecimalMax(value = "100", message = "维度权重不能大于 100")
+        private BigDecimal weight;
+
+        @Schema(description = "备注", example = "核心业绩指标")
+        @Size(max = 200, message = "维度备注不能超过 200 个字符")
+        private String remark;
+
+        @Schema(description = "是否允许员工编辑", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+        @NotNull(message = "是否允许员工编辑不能为空")
+        private Boolean allowEdit;
+
+        @Schema(description = "考核指标列表", requiredMode = Schema.RequiredMode.REQUIRED)
+        @Valid
+        @NotEmpty(message = "每个考核维度至少需要一个指标")
+        private List<@NotNull(message = "考核指标不能为空") Quota> quotas;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效考核模板指标")
+    @Data
+    public static class Quota {
+
+        @Schema(description = "指标名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "销售目标达成率")
+        @NotBlank(message = "指标名称不能为空")
+        @Size(max = 50, message = "指标名称不能超过 50 个字符")
+        private String name;
+
+        @Schema(description = "指标说明", example = "按季度销售目标计算")
+        @Size(max = 200, message = "指标说明不能超过 200 个字符")
+        private String illustrate;
+
+        @Schema(description = "评分标准", requiredMode = Schema.RequiredMode.REQUIRED, example = "完成率达到 100% 得满分")
+        @NotBlank(message = "评分标准不能为空")
+        @Size(max = 200, message = "评分标准不能超过 200 个字符")
+        private String standard;
+
+        @Schema(description = "指标权重", requiredMode = Schema.RequiredMode.REQUIRED, example = "50")
+        @NotNull(message = "指标权重不能为空")
+        @DecimalMin(value = "0", message = "指标权重不能小于 0")
+        @DecimalMax(value = "100", message = "指标权重不能大于 100")
+        private BigDecimal weight;
+
+        @Schema(description = "评分类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "评分类型不能为空")
+        @InEnum(value = HrmPerformanceQuotaScoreTypeEnum.class, message = "评分类型必须是 {value}")
+        private Integer scoreType;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanPageReqVO.java
new file mode 100644
index 0000000..917dc1c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanPageReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 绩效计划分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPerformancePlanPageReqVO extends PageParam {
+
+    @Schema(description = "绩效计划名称", example = "2026 年第三季度绩效计划")
+    private String name;
+
+    @Schema(description = "绩效计划状态", example = "1")
+    @InEnum(value = HrmPerformancePlanStatusEnum.class, message = "计划状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "阶段状态", example = "2")
+    @InEnum(value = HrmPerformanceStageTypeEnum.class, message = "阶段状态必须是 {value}")
+    private Integer stageType;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanRespVO.java
new file mode 100644
index 0000000..eed7f5d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanRespVO.java
@@ -0,0 +1,280 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - HRM 绩效计划 Response VO")
+@Data
+public class HrmPerformancePlanRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "绩效计划名称")
+    private String name;
+
+    @Schema(description = "考核周期类型")
+    private Integer cycleType;
+
+    @Schema(description = "考核周期")
+    private String cycle;
+
+    @Schema(description = "季度")
+    private Integer quarter;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "考核说明")
+    private String description;
+
+    @Schema(description = "考评范围列表")
+    private List<Scope> scopes;
+
+    @Schema(description = "考核模板编号")
+    private Long assessmentTemplateId;
+
+    @Schema(description = "考核配置快照")
+    private AssessmentConfig assessmentConfig;
+
+    @Schema(description = "结果模板编号")
+    private Long resultTemplateId;
+
+    @Schema(description = "结果配置快照")
+    private ResultConfig resultConfig;
+
+    @Schema(description = "指标设置类型")
+    private Integer quotaSettingType;
+
+    @Schema(description = "是否需要目标确认")
+    private Boolean targetConfirmation;
+
+    @Schema(description = "目标确认节点")
+    private HandlerStage targetConfirmationStage;
+
+    @Schema(description = "评分阶段列表")
+    private List<ReviewStage> reviewStages;
+
+    @Schema(description = "是否需要结果审核")
+    private Boolean resultAudit;
+
+    @Schema(description = "结果审核节点列表")
+    private List<HandlerStage> resultAuditStages;
+
+    @Schema(description = "是否需要结果确认")
+    private Boolean resultConfirmation;
+
+    @Schema(description = "申诉处理节点列表")
+    private List<HandlerStage> appealStages;
+
+    @Schema(description = "申诉超期天数")
+    private Integer appealTimeoutDays;
+
+    @Schema(description = "申诉超期处理方式")
+    private Integer appealTimeoutAction;
+
+    @Schema(description = "是否同步薪资")
+    private Boolean syncToSalary;
+
+    @Schema(description = "计薪月份")
+    private String paidForMonth;
+
+    @Schema(description = "各阶段员工数量")
+    private Map<Integer, Long> stageCountMap;
+
+    @Schema(description = "阶段状态")
+    private Integer stageType;
+
+    @Schema(description = "绩效计划状态")
+    private Integer status;
+
+    @Schema(description = "当前操作阶段")
+    private Integer operationType;
+
+    @Schema(description = "终止时间")
+    private LocalDateTime terminateTime;
+
+    @Schema(description = "考核模板名称")
+    private String assessmentTemplateName;
+
+    @Schema(description = "结果模板名称")
+    private String resultTemplateName;
+
+    @Schema(description = "员工数量")
+    private Integer employeeCount;
+
+    @Schema(description = "已完成数量")
+    private Integer finishedCount;
+
+    @Schema(description = "是否可开始评分")
+    private Boolean scoringReady;
+
+    @Schema(description = "是否可开始面谈")
+    private Boolean interviewReady;
+
+    @Schema(description = "是否可归档")
+    private Boolean archiveReady;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "管理后台 - HRM 绩效计划考评范围 Response VO")
+    @Data
+    public static class Scope {
+
+        @Schema(description = "范围类型", example = "1")
+        private Integer type;
+
+        @Schema(description = "员工编号列表", example = "[1024, 1025]")
+        private List<Long> employeeIds;
+
+        @Schema(description = "部门编号列表", example = "[100, 101]")
+        private List<Long> deptIds;
+
+        @Schema(description = "聘用形式", example = "1")
+        private Integer employeeType;
+
+        @Schema(description = "员工状态列表", example = "[1, 2]")
+        private List<Integer> employeeStatuses;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效计划处理节点 Response VO")
+    @Data
+    public static class HandlerStage {
+
+        @Schema(description = "处理人类型", example = "1")
+        private Integer type;
+
+        @Schema(description = "上级或部门层级", example = "1")
+        private Integer level;
+
+        @Schema(description = "指定处理员工编号", example = "1024")
+        private Long employeeId;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效计划评分阶段 Response VO")
+    @Data
+    public static class ReviewStage {
+
+        @Schema(description = "评分阶段名称", example = "直属上级评分")
+        private String name;
+
+        @Schema(description = "评分人")
+        private HandlerStage rater;
+
+        @Schema(description = "评分权重", example = "60")
+        private BigDecimal weight;
+
+        @Schema(description = "评分方式", example = "1")
+        private Integer scoringType;
+
+        @Schema(description = "评分内容可见范围", example = "1")
+        private Integer visibleContent;
+
+        @Schema(description = "评语是否必填", example = "true")
+        private Boolean requiredSetting;
+
+        @Schema(description = "是否允许驳回", example = "true")
+        private Boolean rejectAuthority;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效考核配置快照 Response VO")
+    @Data
+    public static class AssessmentConfig {
+
+        @Schema(description = "模板名称", example = "季度绩效模板")
+        private String name;
+
+        @Schema(description = "计分方式", example = "1")
+        private Integer scoreCalculation;
+
+        @Schema(description = "分数上限类型", example = "1")
+        private Integer upperLimitType;
+
+        @Schema(description = "分数上限", example = "100")
+        private BigDecimal upperLimitScore;
+
+        @Schema(description = "考核维度配置")
+        private List<Dimension> dimensions;
+
+        @Schema(description = "管理后台 - HRM 绩效考核维度 Response VO")
+        @Data
+        public static class Dimension {
+
+            @Schema(description = "维度名称", example = "工作业绩")
+            private String name;
+
+            @Schema(description = "指标类型", example = "1")
+            private Integer quotaType;
+
+            @Schema(description = "维度权重", example = "60")
+            private BigDecimal weight;
+
+            @Schema(description = "备注", example = "核心业绩指标")
+            private String remark;
+
+            @Schema(description = "是否允许员工编辑", example = "true")
+            private Boolean allowEdit;
+
+            @Schema(description = "考核指标列表")
+            private List<Quota> quotas;
+        }
+
+        @Schema(description = "管理后台 - HRM 绩效考核指标 Response VO")
+        @Data
+        public static class Quota {
+
+            @Schema(description = "指标名称", example = "销售目标达成率")
+            private String name;
+
+            @Schema(description = "指标说明", example = "按季度销售目标计算")
+            private String illustrate;
+
+            @Schema(description = "评分标准", example = "完成率达到 100% 得满分")
+            private String standard;
+
+            @Schema(description = "指标权重", example = "50")
+            private BigDecimal weight;
+
+            @Schema(description = "评分类型", example = "1")
+            private Integer scoreType;
+        }
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效结果配置快照 Response VO")
+    @Data
+    public static class ResultConfig {
+
+        @Schema(description = "模板名称", example = "绩效结果模板")
+        private String name;
+
+        @Schema(description = "结果等级配置")
+        private List<Level> levels;
+
+        @Schema(description = "管理后台 - HRM 绩效结果等级 Response VO")
+        @Data
+        public static class Level {
+
+            @Schema(description = "等级名称", example = "优秀")
+            private String name;
+
+            @Schema(description = "最低分数", example = "90")
+            private BigDecimal minScore;
+
+            @Schema(description = "最高分数", example = "100")
+            private BigDecimal maxScore;
+
+            @Schema(description = "绩效系数", example = "1.2")
+            private BigDecimal coefficient;
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanSaveReqVO.java
new file mode 100644
index 0000000..a3a0b5a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/plan/HrmPerformancePlanSaveReqVO.java
@@ -0,0 +1,665 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplateSaveReqVO.Dimension;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplateSaveReqVO.Quota;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplateSaveReqVO.Level;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealTimeoutActionEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanScopeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuarterEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaSettingTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewScoringTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewVisibleContentEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceScoreCalculationEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceUpperLimitTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.Year;
+import java.time.YearMonth;
+import java.time.format.DateTimeParseException;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.PERCENT_100;
+
+@Schema(description = "管理后台 - HRM 绩效计划保存 Request VO")
+@Data
+public class HrmPerformancePlanSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "绩效计划名称", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "2026 年第三季度绩效计划")
+    @NotBlank(message = "计划名称不能为空")
+    @Size(max = 50, message = "计划名称不能超过 50 个字符")
+    private String name;
+
+    @Schema(description = "考核周期类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "考核周期类型不能为空")
+    @InEnum(value = HrmPerformanceCycleTypeEnum.class, message = "考核周期类型必须是 {value}")
+    private Integer cycleType;
+
+    @Schema(description = "考核周期", example = "2026-08")
+    @Size(max = 255, message = "考核周期不能超过 255 个字符")
+    private String cycle;
+
+    @Schema(description = "季度", example = "3")
+    @InEnum(value = HrmPerformanceQuarterEnum.class, message = "季度必须是 {value}")
+    private Integer quarter;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "考核说明", example = "2026 年第三季度绩效考核")
+    @Size(max = 200, message = "考核说明不能超过 200 个字符")
+    private String description;
+
+    @Schema(description = "考评范围列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "考评范围不能为空")
+    @Size(max = 3, message = "考评范围不能超过 3 个")
+    private List<@NotNull(message = "考评范围不能为空") Scope> scopes;
+
+    @Schema(description = "考核模板编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "考核模板不能为空")
+    private Long assessmentTemplateId;
+
+    @Schema(description = "考核配置快照", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotNull(message = "考核配置不能为空")
+    private AssessmentConfig assessmentConfig;
+
+    @Schema(description = "指标设置类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "指标设置类型不能为空")
+    @InEnum(value = HrmPerformanceQuotaSettingTypeEnum.class, message = "指标设置类型必须是 {value}")
+    private Integer quotaSettingType;
+
+    @Schema(description = "是否需要目标确认", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否需要目标确认不能为空")
+    private Boolean targetConfirmation;
+
+    @Schema(description = "目标确认节点")
+    @Valid
+    private HandlerStage targetConfirmationStage;
+
+    @Schema(description = "评分阶段列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "评分阶段不能为空")
+    private List<@NotNull(message = "评分阶段不能为空") ReviewStage> reviewStages;
+
+    @Schema(description = "是否需要结果审核", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否需要结果审核不能为空")
+    private Boolean resultAudit;
+
+    @Schema(description = "结果审核节点列表")
+    @Valid
+    private List<@NotNull(message = "结果审核节点不能为空") HandlerStage> resultAuditStages;
+
+    @Schema(description = "是否需要结果确认", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否需要结果确认不能为空")
+    private Boolean resultConfirmation;
+
+    @Schema(description = "申诉处理节点列表")
+    @Valid
+    private List<@NotNull(message = "申诉处理节点不能为空") HandlerStage> appealStages;
+
+    @Schema(description = "申诉超期天数", requiredMode = Schema.RequiredMode.REQUIRED, example = "3")
+    @Min(value = 1, message = "申诉超期天数不能小于 1 天")
+    @Max(value = 100, message = "申诉超期天数不能超过 100 天")
+    @NotNull(message = "申诉超期天数不能为空")
+    private Integer appealTimeoutDays;
+
+    @Schema(description = "申诉超期处理方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @InEnum(HrmPerformanceAppealTimeoutActionEnum.class)
+    @NotNull(message = "申诉超期处理方式不能为空")
+    private Integer appealTimeoutAction;
+
+    @Schema(description = "结果模板编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "结果模板不能为空")
+    private Long resultTemplateId;
+
+    @Schema(description = "结果配置快照", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotNull(message = "结果配置不能为空")
+    private ResultConfig resultConfig;
+
+    @Schema(description = "是否同步薪资", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    @NotNull(message = "是否同步薪资不能为空")
+    private Boolean syncToSalary;
+
+    @Schema(description = "计薪月份", example = "2026-09")
+    @Size(max = 20, message = "计薪月份不能超过 20 个字符")
+    private String paidForMonth;
+
+    @Schema(description = "管理后台 - HRM 绩效计划考评范围")
+    @Data
+    public static class Scope {
+
+        @Schema(description = "范围类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "考评范围类型不能为空")
+        @InEnum(value = HrmPerformancePlanScopeTypeEnum.class, message = "考评范围类型必须是 {value}")
+        private Integer type;
+
+        @Schema(description = "员工编号列表", example = "[1024, 1025]")
+        private List<@NotNull(message = "员工编号不能为空") Long> employeeIds;
+
+        @Schema(description = "部门编号列表", example = "[100, 101]")
+        private List<@NotNull(message = "部门编号不能为空") Long> deptIds;
+
+        @Schema(description = "聘用形式", example = "1")
+        @InEnum(value = HrmEmployeeTypeEnum.class, message = "聘用形式必须是 {value}")
+        private Integer employeeType;
+
+        @Schema(description = "员工状态列表", example = "[1, 2]")
+        @InEnum(value = HrmEmployeeStatusEnum.class, message = "员工状态必须是 {value}")
+        private List<Integer> employeeStatuses;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效计划处理节点")
+    @Data
+    public static class HandlerStage {
+
+        @Schema(description = "处理人类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "处理人类型不能为空")
+        @InEnum(value = HrmPerformanceRaterTypeEnum.class, message = "处理人类型必须是 {value}")
+        private Integer type;
+
+        @Schema(description = "上级或部门层级", example = "1")
+        @Min(value = 1, message = "处理人层级不能小于 1")
+        @Max(value = 10, message = "处理人层级不能大于 10")
+        private Integer level;
+
+        @Schema(description = "指定处理员工编号", example = "1024")
+        private Long employeeId;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效计划评分阶段")
+    @Data
+    public static class ReviewStage {
+
+        @Schema(description = "评分阶段名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "直属上级评分")
+        @NotBlank(message = "评分阶段名称不能为空")
+        @Size(max = 50, message = "评分阶段名称不能超过 50 个字符")
+        private String name;
+
+        @Schema(description = "评分人", requiredMode = Schema.RequiredMode.REQUIRED)
+        @Valid
+        @NotNull(message = "评分人不能为空")
+        private HandlerStage rater;
+
+        @Schema(description = "评分权重", requiredMode = Schema.RequiredMode.REQUIRED, example = "60")
+        @NotNull(message = "评分权重不能为空")
+        @DecimalMin(value = "0.01", message = "评分权重必须大于 0")
+        @DecimalMax(value = "100", message = "评分权重不能大于 100")
+        private BigDecimal weight;
+
+        @Schema(description = "评分方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "评分方式不能为空")
+        @InEnum(value = HrmPerformanceReviewScoringTypeEnum.class, message = "评分方式必须是 {value}")
+        private Integer scoringType;
+
+        @Schema(description = "评分内容可见范围", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "评分内容可见范围不能为空")
+        @InEnum(value = HrmPerformanceReviewVisibleContentEnum.class, message = "评分内容可见范围必须是 {value}")
+        private Integer visibleContent;
+
+        @Schema(description = "评语是否必填", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+        @NotNull(message = "评语是否必填不能为空")
+        private Boolean requiredSetting;
+
+        @Schema(description = "是否允许驳回", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+        @NotNull(message = "是否允许驳回不能为空")
+        private Boolean rejectAuthority;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效考核配置快照")
+    @Data
+    public static class AssessmentConfig {
+
+        @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "季度绩效模板")
+        @NotBlank(message = "模板名称不能为空")
+        @Size(max = 50, message = "模板名称不能超过 50 个字符")
+        private String name;
+
+        @Schema(description = "计分方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "计分方式不能为空")
+        @InEnum(value = HrmPerformanceScoreCalculationEnum.class, message = "计分方式必须是 {value}")
+        private Integer scoreCalculation;
+
+        @Schema(description = "分数上限类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+        @NotNull(message = "分数上限类型不能为空")
+        @InEnum(value = HrmPerformanceUpperLimitTypeEnum.class, message = "分数上限类型必须是 {value}")
+        private Integer upperLimitType;
+
+        @Schema(description = "分数上限", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+        @NotNull(message = "分数上限不能为空")
+        @DecimalMin(value = "0", message = "分数上限不能小于 0")
+        @DecimalMax(value = "100", message = "分数上限不能大于 100")
+        private BigDecimal upperLimitScore;
+
+        @Schema(description = "考核维度配置", requiredMode = Schema.RequiredMode.REQUIRED)
+        @Valid
+        @NotEmpty(message = "至少需要一个考核维度")
+        private List<@NotNull(message = "考核维度不能为空") Dimension> dimensions;
+
+        @AssertTrue(message = "考核维度名称不能重复")
+        @JsonIgnore
+        public boolean isDimensionNamesUnique() {
+            if (CollUtil.isEmpty(dimensions)) {
+                return true;
+            }
+            Set<String> names = new HashSet<>();
+            for (Dimension dimension : dimensions) {
+                if (dimension != null && StrUtil.isNotBlank(dimension.getName())
+                        && !names.add(dimension.getName().trim())) {
+                    return false;
+                }
+            }
+            return true;
+        }
+
+        @AssertTrue(message = "考核指标名称不能重复")
+        @JsonIgnore
+        public boolean isQuotaNamesUnique() {
+            if (CollUtil.isEmpty(dimensions)) {
+                return true;
+            }
+            Set<String> names = new HashSet<>();
+            for (Dimension dimension : dimensions) {
+                if (dimension == null || CollUtil.isEmpty(dimension.getQuotas())) {
+                    continue;
+                }
+                for (Quota quota : dimension.getQuotas()) {
+                    if (quota != null && StrUtil.isNotBlank(quota.getName())
+                            && !names.add(quota.getName().trim())) {
+                        return false;
+                    }
+                }
+            }
+            return true;
+        }
+
+        @AssertTrue(message = "维度权重总和必须等于 100%")
+        @JsonIgnore
+        public boolean isDimensionWeightTotalValid() {
+            if (CollUtil.isEmpty(dimensions)) {
+                return true;
+            }
+            BigDecimal totalWeight = BigDecimal.ZERO;
+            for (Dimension dimension : dimensions) {
+                if (dimension == null || dimension.getWeight() == null) {
+                    return true;
+                }
+                totalWeight = totalWeight.add(dimension.getWeight());
+            }
+            return totalWeight.compareTo(PERCENT_100) == 0;
+        }
+
+        @AssertTrue(message = "不可编辑维度的指标权重总和必须等于 100%")
+        @JsonIgnore
+        public boolean isFixedQuotaWeightTotalValid() {
+            if (CollUtil.isEmpty(dimensions)) {
+                return true;
+            }
+            for (Dimension dimension : dimensions) {
+                if (dimension == null || ObjUtil.notEqual(Boolean.FALSE, dimension.getAllowEdit())
+                        || CollUtil.isEmpty(dimension.getQuotas())) {
+                    continue;
+                }
+                BigDecimal totalWeight = BigDecimal.ZERO;
+                for (Quota quota : dimension.getQuotas()) {
+                    if (quota == null || quota.getWeight() == null) {
+                        return true;
+                    }
+                    totalWeight = totalWeight.add(quota.getWeight());
+                }
+                if (totalWeight.compareTo(PERCENT_100) != 0) {
+                    return false;
+                }
+            }
+            return true;
+        }
+
+        @AssertTrue(message = "可编辑维度的指标权重总和不能大于 100%")
+        @JsonIgnore
+        public boolean isEditableQuotaWeightTotalValid() {
+            if (CollUtil.isEmpty(dimensions)) {
+                return true;
+            }
+            for (Dimension dimension : dimensions) {
+                if (dimension == null || ObjUtil.notEqual(Boolean.TRUE, dimension.getAllowEdit())
+                        || CollUtil.isEmpty(dimension.getQuotas())) {
+                    continue;
+                }
+                BigDecimal totalWeight = BigDecimal.ZERO;
+                for (Quota quota : dimension.getQuotas()) {
+                    if (quota == null || quota.getWeight() == null) {
+                        return true;
+                    }
+                    totalWeight = totalWeight.add(quota.getWeight());
+                }
+                if (totalWeight.compareTo(PERCENT_100) > 0) {
+                    return false;
+                }
+            }
+            return true;
+        }
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效结果配置快照")
+    @Data
+    public static class ResultConfig {
+
+        private static final BigDecimal MIN_SCORE = BigDecimal.ZERO;
+        private static final BigDecimal MAX_SCORE = BigDecimal.valueOf(100);
+        private static final BigDecimal SCORE_STEP = new BigDecimal("0.01");
+
+        @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "绩效结果模板")
+        @NotBlank(message = "结果模板名称不能为空")
+        @Size(max = 255, message = "结果模板名称不能超过 255 个字符")
+        private String name;
+
+        @Schema(description = "结果等级配置", requiredMode = Schema.RequiredMode.REQUIRED)
+        @Valid
+        @NotEmpty(message = "至少需要一个结果等级")
+        private List<@NotNull(message = "结果等级不能为空") Level> levels;
+
+        @AssertTrue(message = "结果等级名称不能重复")
+        @JsonIgnore
+        public boolean isLevelNamesUnique() {
+            if (CollUtil.isEmpty(levels)) {
+                return true;
+            }
+            Set<String> names = new HashSet<>();
+            for (Level level : levels) {
+                if (level != null && StrUtil.isNotBlank(level.getName())
+                        && !names.add(level.getName().trim())) {
+                    return false;
+                }
+            }
+            return true;
+        }
+
+        @AssertTrue(message = "结果等级分数区间必须连续覆盖 0 到 100 分")
+        @JsonIgnore
+        public boolean isScoreRangeContinuous() {
+            if (CollUtil.isEmpty(levels)) {
+                return true;
+            }
+            List<Level> sortedLevels = new ArrayList<>(levels);
+            if (sortedLevels.stream().anyMatch(level -> level == null
+                    || level.getMinScore() == null || level.getMaxScore() == null)) {
+                return true;
+            }
+            sortedLevels.sort(Comparator.comparing(Level::getMinScore));
+            if (CollUtil.getFirst(sortedLevels).getMinScore().compareTo(MIN_SCORE) != 0) {
+                return false;
+            }
+            for (int i = 1; i < sortedLevels.size(); i++) {
+                Level previous = sortedLevels.get(i - 1);
+                Level current = sortedLevels.get(i);
+                if (current.getMinScore().compareTo(previous.getMaxScore().add(SCORE_STEP)) != 0) {
+                    return false;
+                }
+            }
+            return CollUtil.getLast(sortedLevels).getMaxScore().compareTo(MAX_SCORE) == 0;
+        }
+    }
+
+    // Service 只校验模板、员工和部门等数据引用。
+    @AssertTrue(message = "考评范围配置不正确")
+    @JsonIgnore
+    public boolean isScopeConfigValid() {
+        if (CollUtil.isEmpty(scopes)) {
+            return true;
+        }
+        for (Scope scope : scopes) {
+            if (scope == null || scope.getType() == null) {
+                continue;
+            }
+            if (Objects.equals(scope.getType(), HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType())) {
+                if (CollUtil.isEmpty(scope.getEmployeeIds()) && CollUtil.isEmpty(scope.getDeptIds())) {
+                    return false;
+                }
+            } else if (Objects.equals(scope.getType(), HrmPerformancePlanScopeTypeEnum.EMPLOYMENT.getType())) {
+                if (scope.getEmployeeType() == null || CollUtil.isEmpty(scope.getEmployeeStatuses())) {
+                    return false;
+                }
+            } else if (Objects.equals(scope.getType(),
+                    HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType())) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @AssertTrue(message = "评分人配置不正确")
+    @JsonIgnore
+    public boolean isReviewStageConfigValid() {
+        if (CollUtil.isEmpty(reviewStages)) {
+            return true;
+        }
+        for (ReviewStage reviewStage : reviewStages) {
+            if (reviewStage == null || reviewStage.getRater() == null) {
+                continue;
+            }
+            if (!isHandlerStageValid(reviewStage.getRater(), true)
+                    || Objects.equals(reviewStage.getRater().getType(), HrmPerformanceRaterTypeEnum.SELF.getType())
+                    && Boolean.TRUE.equals(reviewStage.getRejectAuthority())) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    @AssertTrue(message = "评分权重总和必须等于 100%")
+    @JsonIgnore
+    public boolean isReviewStageWeightTotalValid() {
+        if (CollUtil.isEmpty(reviewStages)) {
+            return true;
+        }
+        BigDecimal totalWeight = BigDecimal.ZERO;
+        for (ReviewStage reviewStage : reviewStages) {
+            if (reviewStage == null || reviewStage.getWeight() == null) {
+                return true;
+            }
+            totalWeight = totalWeight.add(reviewStage.getWeight());
+        }
+        return totalWeight.compareTo(PERCENT_100) == 0;
+    }
+
+    @AssertTrue(message = "评分人不能重复")
+    @JsonIgnore
+    public boolean isReviewStageRaterUnique() {
+        if (CollUtil.isEmpty(reviewStages)) {
+            return true;
+        }
+        List<HandlerStage> raters = new ArrayList<>();
+        for (ReviewStage reviewStage : reviewStages) {
+            if (reviewStage != null) {
+                raters.add(reviewStage.getRater());
+            }
+        }
+        return isHandlerStageUnique(raters);
+    }
+
+    @AssertTrue(message = "目标确认配置不正确")
+    @JsonIgnore
+    public boolean isTargetConfirmationConfigValid() {
+        if (quotaSettingType == null || targetConfirmation == null) {
+            return true;
+        }
+        if (Objects.equals(quotaSettingType, HrmPerformanceQuotaSettingTypeEnum.SYSTEM.getType())) {
+            return !targetConfirmation;
+        }
+        return !targetConfirmation || targetConfirmationStage != null
+                && isHandlerStageValid(targetConfirmationStage, true);
+    }
+
+    @AssertTrue(message = "结果审核节点配置不正确")
+    @JsonIgnore
+    public boolean isResultAuditConfigValid() {
+        return ObjUtil.notEqual(Boolean.TRUE, resultAudit) || isHandlerStagesValid(resultAuditStages);
+    }
+
+    @AssertTrue(message = "申诉节点配置不正确")
+    @JsonIgnore
+    public boolean isResultConfirmationConfigValid() {
+        return ObjUtil.notEqual(Boolean.TRUE, resultConfirmation) || isHandlerStagesValid(appealStages);
+    }
+
+    @AssertTrue(message = "计薪月份配置不正确")
+    @JsonIgnore
+    public boolean isSalaryConfigValid() {
+        if (!Boolean.TRUE.equals(syncToSalary)) {
+            return true;
+        }
+        if (StrUtil.isBlank(paidForMonth)) {
+            return false;
+        }
+        try {
+            YearMonth.parse(paidForMonth);
+            return true;
+        } catch (DateTimeParseException ignored) {
+            return false;
+        }
+    }
+
+    @AssertTrue(message = "考核周期、季度和起止时间配置不正确")
+    @JsonIgnore
+    public boolean isCycleConfigValid() {
+        if (cycleType == null) {
+            return true;
+        }
+        if (startTime == null || endTime == null || endTime.isBefore(startTime)) {
+            return false;
+        }
+        if (Objects.equals(cycleType, HrmPerformanceCycleTypeEnum.OTHER.getType())) {
+            return StrUtil.isNotBlank(cycle) && quarter == null;
+        }
+        try {
+            if (Objects.equals(cycleType, HrmPerformanceCycleTypeEnum.MONTH.getType())) {
+                YearMonth month = YearMonth.parse(cycle);
+                return quarter == null && startTime.toLocalDate().equals(month.atDay(1))
+                        && endTime.toLocalDate().equals(month.atEndOfMonth());
+            }
+            Year year = Year.parse(cycle);
+            int beginMonth = 1;
+            int endMonth = 12;
+            if (Objects.equals(cycleType, HrmPerformanceCycleTypeEnum.QUARTER.getType())) {
+                if (HrmPerformanceQuarterEnum.valueOf(quarter) == null) {
+                    return false;
+                }
+                beginMonth = (quarter - 1) * 3 + 1;
+                endMonth = beginMonth + 2;
+            } else if (Objects.equals(cycleType,
+                    HrmPerformanceCycleTypeEnum.FIRST_HALF_YEAR.getType())) {
+                endMonth = 6;
+            } else if (Objects.equals(cycleType,
+                    HrmPerformanceCycleTypeEnum.SECOND_HALF_YEAR.getType())) {
+                beginMonth = 7;
+            }
+            if (!Objects.equals(cycleType, HrmPerformanceCycleTypeEnum.QUARTER.getType())
+                    && quarter != null) {
+                return false;
+            }
+            YearMonth beginYearMonth = year.atMonth(beginMonth);
+            YearMonth endYearMonth = year.atMonth(endMonth);
+            return startTime.toLocalDate().equals(beginYearMonth.atDay(1))
+                    && endTime.toLocalDate().equals(endYearMonth.atEndOfMonth());
+        } catch (DateTimeParseException | NullPointerException ignored) {
+            return false;
+        }
+    }
+
+    private boolean isHandlerStagesValid(List<HandlerStage> stages) {
+        if (CollUtil.isEmpty(stages) || stages.size() > 3) {
+            return false;
+        }
+        for (HandlerStage stage : stages) {
+            if (stage != null && !isHandlerStageValid(stage, false)) {
+                return false;
+            }
+        }
+        return isHandlerStageUnique(stages);
+    }
+
+    private boolean isHandlerStageValid(HandlerStage stage, boolean allowSelf) {
+        if (stage == null || stage.getType() == null) {
+            return true;
+        }
+        if (Objects.equals(stage.getType(), HrmPerformanceRaterTypeEnum.SELF.getType())) {
+            return allowSelf;
+        }
+        if (ObjectUtils.equalsAny(stage.getType(), HrmPerformanceRaterTypeEnum.SUPERIOR.getType(),
+                HrmPerformanceRaterTypeEnum.DEPT_LEADER.getType())) {
+            return stage.getLevel() != null && stage.getLevel() >= 1 && stage.getLevel() <= 10;
+        }
+        if (Objects.equals(stage.getType(), HrmPerformanceRaterTypeEnum.SPECIFIED.getType())) {
+            return stage.getEmployeeId() != null;
+        }
+        return true;
+    }
+
+    private boolean isHandlerStageUnique(List<HandlerStage> stages) {
+        if (CollUtil.isEmpty(stages)) {
+            return true;
+        }
+        Set<String> handlerKeys = new HashSet<>();
+        for (HandlerStage stage : stages) {
+            String handlerKey = buildHandlerKey(stage);
+            if (handlerKey != null && !handlerKeys.add(handlerKey)) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    private String buildHandlerKey(HandlerStage stage) {
+        if (stage == null || stage.getType() == null) {
+            return null;
+        }
+        if (Objects.equals(stage.getType(), HrmPerformanceRaterTypeEnum.SELF.getType())) {
+            return String.valueOf(stage.getType());
+        }
+        if (Objects.equals(stage.getType(), HrmPerformanceRaterTypeEnum.SPECIFIED.getType())) {
+            return stage.getEmployeeId() == null ? null : stage.getType() + ":" + stage.getEmployeeId();
+        }
+        if (ObjectUtils.equalsAny(stage.getType(), HrmPerformanceRaterTypeEnum.SUPERIOR.getType(),
+                HrmPerformanceRaterTypeEnum.DEPT_LEADER.getType())) {
+            return stage.getLevel() == null ? null : stage.getType() + ":" + stage.getLevel();
+        }
+        return null;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplatePageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplatePageReqVO.java
new file mode 100644
index 0000000..3b3b4e9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplatePageReqVO.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 绩效结果模板分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPerformanceResultTemplatePageReqVO extends PageParam {
+
+    @Schema(description = "结果模板名称，模糊匹配", example = "季度")
+    private String name;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplateRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplateRespVO.java
new file mode 100644
index 0000000..109c9e9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplateRespVO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 绩效结果模板 Response VO")
+@Data
+public class HrmPerformanceResultTemplateRespVO {
+
+    @Schema(description = "结果模板编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "结果模板名称", example = "季度绩效结果")
+    private String name;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+    @Schema(description = "结果等级列表")
+    private List<Level> levels;
+
+    @Schema(description = "创建人")
+    private String creator;
+
+    @Schema(description = "创建人名称")
+    private String creatorName;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updateTime;
+
+    @Schema(description = "管理后台 - HRM 绩效结果模板等级")
+    @Data
+    public static class Level {
+
+        @Schema(description = "等级名称", example = "A")
+        private String name;
+
+        @Schema(description = "最低分数", example = "90")
+        private BigDecimal minScore;
+
+        @Schema(description = "最高分数", example = "100")
+        private BigDecimal maxScore;
+
+        @Schema(description = "绩效系数", example = "1.2")
+        private BigDecimal coefficient;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplateSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplateSaveReqVO.java
new file mode 100644
index 0000000..968d823
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/performance/vo/resulttemplate/HrmPerformanceResultTemplateSaveReqVO.java
@@ -0,0 +1,129 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+@Schema(description = "管理后台 - HRM 绩效结果模板保存 Request VO")
+@Data
+public class HrmPerformanceResultTemplateSaveReqVO {
+
+    private static final BigDecimal MIN_SCORE = BigDecimal.ZERO;
+    private static final BigDecimal MAX_SCORE = BigDecimal.valueOf(100);
+    private static final BigDecimal SCORE_STEP = new BigDecimal("0.01");
+
+    @Schema(description = "结果模板编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "结果模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "季度绩效结果")
+    @NotBlank(message = "结果模板名称不能为空")
+    @Size(max = 255, message = "结果模板名称不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "结果等级列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "至少需要一个结果等级")
+    private List<@NotNull(message = "结果等级不能为空") Level> levels;
+
+    /**
+     * 校验结果等级名称唯一
+     */
+    @AssertTrue(message = "结果等级名称不能重复")
+    @JsonIgnore
+    public boolean isLevelNamesUnique() {
+        if (CollUtil.isEmpty(levels)) {
+            return true;
+        }
+        Set<String> names = new HashSet<>();
+        for (Level level : levels) {
+            if (level != null && StrUtil.isNotBlank(level.getName())
+                    && !names.add(level.getName().trim())) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    /**
+     * 校验结果等级分数区间连续覆盖 0 到 100 分
+     */
+    @AssertTrue(message = "结果等级分数区间必须连续覆盖 0 到 100 分")
+    @JsonIgnore
+    public boolean isScoreRangeContinuous() {
+        if (CollUtil.isEmpty(levels)) {
+            return true;
+        }
+        List<Level> sortedLevels = new ArrayList<>(levels);
+        if (sortedLevels.stream().anyMatch(level -> level == null
+                || level.getMinScore() == null || level.getMaxScore() == null)) {
+            return true;
+        }
+        sortedLevels.sort(Comparator.comparing(Level::getMinScore));
+        if (CollUtil.getFirst(sortedLevels).getMinScore().compareTo(MIN_SCORE) != 0) {
+            return false;
+        }
+        for (int i = 1; i < sortedLevels.size(); i++) {
+            Level previous = sortedLevels.get(i - 1);
+            Level current = sortedLevels.get(i);
+            if (current.getMinScore().compareTo(previous.getMaxScore().add(SCORE_STEP)) != 0) {
+                return false;
+            }
+        }
+        return CollUtil.getLast(sortedLevels).getMaxScore().compareTo(MAX_SCORE) == 0;
+    }
+
+    @Schema(description = "管理后台 - HRM 绩效结果模板等级")
+    @Data
+    public static class Level {
+
+        @Schema(description = "等级名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "A")
+        @NotBlank(message = "等级名称不能为空")
+        @Size(max = 255, message = "等级名称不能超过 255 个字符")
+        private String name;
+
+        @Schema(description = "最低分数", requiredMode = Schema.RequiredMode.REQUIRED, example = "90")
+        @NotNull(message = "最低分数不能为空")
+        @DecimalMin(value = "0", message = "最低分数不能小于 0")
+        @DecimalMax(value = "100", message = "最低分数不能大于 100")
+        @Digits(integer = 3, fraction = 2, message = "最低分数最多保留两位小数")
+        private BigDecimal minScore;
+
+        @Schema(description = "最高分数", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+        @NotNull(message = "最高分数不能为空")
+        @DecimalMin(value = "0", message = "最高分数不能小于 0")
+        @DecimalMax(value = "100", message = "最高分数不能大于 100")
+        @Digits(integer = 3, fraction = 2, message = "最高分数最多保留两位小数")
+        private BigDecimal maxScore;
+
+        @Schema(description = "绩效系数", requiredMode = Schema.RequiredMode.REQUIRED, example = "1.2")
+        @NotNull(message = "绩效系数不能为空")
+        @DecimalMin(value = "0", message = "绩效系数不能小于 0")
+        @Digits(integer = 8, fraction = 2, message = "绩效系数最多保留两位小数")
+        private BigDecimal coefficient;
+
+        @AssertTrue(message = "最低分数不能大于最高分数")
+        @JsonIgnore
+        public boolean isScoreRangeValid() {
+            return minScore == null || maxScore == null || minScore.compareTo(maxScore) <= 0;
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceClockController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceClockController.java
new file mode 100644
index 0000000..fd8e47a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceClockController.java
@@ -0,0 +1,128 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceClockService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.time.format.DateTimeFormatter;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端考勤打卡")
+@RestController
+@RequestMapping("/hrm/portal/attendance/clock")
+@Validated
+public class HrmPortalAttendanceClockController {
+
+    private static final DateTimeFormatter SHIFT_TIME_FORMATTER = DateTimeFormatter.ofPattern("HH:mm");
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmAttendanceClockService attendanceClockService;
+
+    @GetMapping("/get-detail")
+    @Operation(summary = "获得我的打卡详情")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmPortalAttendanceClockDetailRespVO> getAttendanceClockDetail() {
+        HrmPortalAttendanceClockDetailRespVO detail =
+                attendanceClockService.getMyAttendanceClockDetail(getLoginUserId());
+        return success(buildAttendanceClockDetailRespVO(detail));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "手机端打卡")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<Long> createAttendanceClock(
+            @Valid @RequestBody HrmPortalAttendanceClockCreateReqVO createReqVO) {
+        return success(attendanceClockService.createMyAttendanceClock(getLoginUserId(), createReqVO));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的考勤记录")
+    @Parameters({
+            @Parameter(name = "year", description = "年份", example = "2026"),
+            @Parameter(name = "month", description = "月份", example = "8")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmPortalAttendanceRecordRespVO>> getAttendanceRecordList(
+            @RequestParam(value = "year", required = false) Integer year,
+            @RequestParam(value = "month", required = false) Integer month) {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        // 1. 计算所选月份的闭区间
+        YearMonth queryMonth = year == null || month == null
+                ? YearMonth.now() : YearMonth.of(year, month);
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(
+                queryMonth.getYear(), queryMonth.getMonthValue());
+        // 2. 查询当前员工在所选月份的打卡记录
+        List<HrmAttendanceClockDO> list = attendanceClockService.getAttendanceClockListByEmployeeIdAndClockTime(
+                        employee.getId(), monthTimes);
+        return success(BeanUtils.toBean(list, HrmPortalAttendanceRecordRespVO.class));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmPortalAttendanceClockDetailRespVO buildAttendanceClockDetailRespVO(
+            HrmPortalAttendanceClockDetailRespVO detail) {
+        HrmAttendanceGroupDO group = detail.getGroup();
+        detail.setGroupName(group.getName())
+                .setOpenPointCard(Boolean.TRUE.equals(group.getOpenPointCard()))
+                .setOpenWifiCard(Boolean.TRUE.equals(group.getOpenWifiCard()))
+                .setShiftTitle(buildShiftTitle(detail.getShift()))
+                .setPoints(Boolean.TRUE.equals(group.getOpenPointCard())
+                        ? BeanUtils.toBean(CollUtil.emptyIfNull(group.getPoints()),
+                        HrmPortalAttendanceClockDetailRespVO.Point.class) : Collections.emptyList())
+                .setWifis(Boolean.TRUE.equals(group.getOpenWifiCard())
+                        ? BeanUtils.toBean(CollUtil.emptyIfNull(group.getWifis()),
+                        HrmPortalAttendanceClockDetailRespVO.Wifi.class) : Collections.emptyList());
+        return detail;
+    }
+
+    /**
+     * 构建班次展示标题
+     *
+     * @param shift 班次配置
+     * @return 班次标题
+     */
+    private String buildShiftTitle(HrmAttendanceGroupDO.Shift shift) {
+        if (shift == null || shift.getStartTime() == null || shift.getEndTime() == null) {
+            return "休息";
+        }
+        String title = shift.getStartTime().format(SHIFT_TIME_FORMATTER)
+                + "-" + shift.getEndTime().format(SHIFT_TIME_FORMATTER);
+        if (shift.getRestStartTime() != null && shift.getRestEndTime() != null) {
+            title = title + " 休息:" + shift.getRestStartTime().format(SHIFT_TIME_FORMATTER)
+                    + "-" + shift.getRestEndTime().format(SHIFT_TIME_FORMATTER);
+        }
+        return title;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceLeaveController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceLeaveController.java
new file mode 100644
index 0000000..f122401
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceLeaveController.java
@@ -0,0 +1,62 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCancelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceLeaveService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端请假")
+@RestController
+@RequestMapping("/hrm/portal/attendance/leave")
+@Validated
+public class HrmPortalAttendanceLeaveController {
+
+    @Resource
+    private HrmAttendanceLeaveService attendanceLeaveService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的请假申请列表")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmAttendanceLeaveRespVO>> getAttendanceLeaveList() {
+        List<HrmAttendanceLeaveDO> list = attendanceLeaveService.getMyAttendanceLeaveList(getLoginUserId());
+        return success(BeanUtils.toBean(list, HrmAttendanceLeaveRespVO.class));
+    }
+
+    @PostMapping("/create")
+    @Operation(summary = "创建我的请假申请")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:attendance:leave')")
+    public CommonResult<Long> createAttendanceLeave(
+            @Valid @RequestBody HrmAttendanceLeaveCreateReqVO reqVO) {
+        return success(attendanceLeaveService.createLeave(getLoginUserId(), reqVO));
+    }
+
+    @PutMapping("/cancel")
+    @Operation(summary = "取消我的请假申请")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:attendance:leave')")
+    public CommonResult<Boolean> cancelAttendanceLeave(
+            @Valid @RequestBody HrmAttendanceLeaveCancelReqVO reqVO) {
+        attendanceLeaveService.cancelLeave(getLoginUserId(), reqVO);
+        return success(true);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceStatisticsController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceStatisticsController.java
new file mode 100644
index 0000000..51d4958
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/HrmPortalAttendanceStatisticsController.java
@@ -0,0 +1,73 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthDetailRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.statistics.HrmAttendanceStatisticsService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.YearMonth;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端考勤统计")
+@RestController
+@RequestMapping("/hrm/portal/attendance/statistics")
+@Validated
+public class HrmPortalAttendanceStatisticsController {
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmAttendanceStatisticsService attendanceStatisticsService;
+
+    @GetMapping("/month-detail")
+    @Operation(summary = "获得我的月度考勤详情")
+    @Parameters({
+            @Parameter(name = "year", description = "年份", example = "2026"),
+            @Parameter(name = "month", description = "月份", example = "8")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmAttendanceMonthDetailRespVO> getAttendanceMonthDetail(
+            @RequestParam(value = "year", required = false) Integer year,
+            @RequestParam(value = "month", required = false) Integer month) {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        YearMonth queryMonth = year == null || month == null
+                ? YearMonth.now() : YearMonth.of(year, month);
+        return success(attendanceStatisticsService.getAttendanceMonthDetail(
+                employee.getId(), queryMonth.getYear(), queryMonth.getMonthValue()));
+    }
+
+    @GetMapping("/export-excel")
+    @Operation(summary = "导出我的月度考勤日报")
+    @Parameters({
+            @Parameter(name = "year", description = "年份", required = true, example = "2026"),
+            @Parameter(name = "month", description = "月份", required = true, example = "8")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public void exportAttendanceMonthDetail(
+            @RequestParam("year") Integer year, @RequestParam("month") Integer month,
+            HttpServletResponse response) throws Exception {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        HrmAttendanceMonthDetailRespVO detail = attendanceStatisticsService.getAttendanceMonthDetail(
+                employee.getId(), year, month);
+        ExcelUtils.write(response, year + "年" + month + "月个人考勤日报.xls", "考勤日报",
+                HrmAttendanceDailyDetailRespVO.class, detail.getDailyDetails());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceClockCreateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceClockCreateReqVO.java
new file mode 100644
index 0000000..8a7b6d2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceClockCreateReqVO.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.DecimalMax;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工端手机打卡 Request VO")
+@Data
+public class HrmPortalAttendanceClockCreateReqVO {
+
+    @Schema(description = "打卡地址", example = "上海市浦东新区")
+    @Size(max = 255, message = "打卡地址不能超过 255 个字符")
+    private String address;
+
+    @Schema(description = "经度", example = "121.473701")
+    @DecimalMin(value = "-180", message = "经度必须在 -180 到 180 之间")
+    @DecimalMax(value = "180", message = "经度必须在 -180 到 180 之间")
+    private BigDecimal longitude;
+
+    @Schema(description = "纬度", example = "31.230416")
+    @DecimalMin(value = "-90", message = "纬度必须在 -90 到 90 之间")
+    @DecimalMax(value = "90", message = "纬度必须在 -90 到 90 之间")
+    private BigDecimal latitude;
+
+    @Schema(description = "WiFi 名称", example = "office_wifi")
+    @Size(max = 50, message = "WiFi 名称不能超过 50 个字符")
+    private String ssid;
+
+    @Schema(description = "WiFi MAC 地址", example = "00:11:22:33:44:55")
+    @Size(max = 50, message = "WiFi MAC 地址不能超过 50 个字符")
+    private String mac;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceClockDetailRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceClockDetailRespVO.java
new file mode 100644
index 0000000..6dca4b0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceClockDetailRespVO.java
@@ -0,0 +1,147 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock;
+
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.TimeRange;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端打卡详情 Response VO")
+@Data
+public class HrmPortalAttendanceClockDetailRespVO {
+
+    @Schema(description = "考勤组名称")
+    private String groupName;
+
+    @Schema(description = "是否启用定位打卡")
+    private Boolean openPointCard;
+
+    @Schema(description = "是否启用 WiFi 打卡")
+    private Boolean openWifiCard;
+
+    @Schema(description = "班次所属考勤日")
+    private LocalDate attendanceDate;
+
+    @Schema(description = "班次标题，例如 09:00-18:00")
+    private String shiftTitle;
+
+    @Schema(description = "是否休息日")
+    private Boolean restDay;
+
+    @Schema(description = "上班应打卡时间")
+    private LocalDateTime onDutyAttendanceTime;
+
+    @Schema(description = "下班应打卡时间")
+    private LocalDateTime offDutyAttendanceTime;
+
+    @Schema(description = "打卡地点列表")
+    private List<Point> points;
+
+    @Schema(description = "WiFi 列表")
+    private List<Wifi> wifis;
+
+    @Schema(description = "下一次可打卡动作")
+    private NextClock nextClock;
+
+    @Schema(description = "当日打卡时间线")
+    private List<TimelineItem> timeline;
+
+    // ==================== 内部计算字段 ====================
+
+    @JsonIgnore
+    @Schema(hidden = true)
+    private HrmAttendanceGroupDO group;
+
+    @JsonIgnore
+    @Schema(hidden = true)
+    private HrmAttendanceGroupDO.Shift shift;
+
+    @JsonIgnore
+    @Schema(hidden = true)
+    private TimeRange clockInRange;
+
+    @JsonIgnore
+    @Schema(hidden = true)
+    private TimeRange clockOutRange;
+
+    @Schema(description = "打卡地点")
+    @Data
+    public static class Point {
+
+        @Schema(description = "地点名称")
+        private String name;
+
+        @Schema(description = "定位地址")
+        private String address;
+
+        @Schema(description = "纬度")
+        private BigDecimal latitude;
+
+        @Schema(description = "经度")
+        private BigDecimal longitude;
+
+        @Schema(description = "有效半径（米）")
+        private Integer radius;
+
+    }
+
+    @Schema(description = "WiFi 配置")
+    @Data
+    public static class Wifi {
+
+        @Schema(description = "WiFi 名称")
+        private String ssid;
+
+        @Schema(description = "MAC 地址")
+        private String mac;
+
+    }
+
+    @Schema(description = "下一次打卡动作")
+    @Data
+    public static class NextClock {
+
+        @Schema(description = "打卡类型")
+        private Integer type;
+
+        @Schema(description = "打卡阶段")
+        private Integer stage;
+
+        @Schema(description = "应打卡时间")
+        private LocalDateTime attendanceTime;
+
+        @Schema(description = "按钮状态：0 未到时间 1 正常 2 更新 3 迟到 4 早退")
+        private Integer buttonStatus;
+
+    }
+
+    @Schema(description = "当日打卡时间线条目")
+    @Data
+    public static class TimelineItem {
+
+        @Schema(description = "打卡类型")
+        private Integer type;
+
+        @Schema(description = "应打卡时间")
+        private LocalDateTime attendanceTime;
+
+        @Schema(description = "实际打卡时间；缺卡时为空")
+        private LocalDateTime clockTime;
+
+        @Schema(description = "打卡状态")
+        private Integer status;
+
+        @Schema(description = "是否缺卡")
+        private Boolean missCard;
+
+        @Schema(description = "打卡地址")
+        private String address;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceRecordRespVO.java
new file mode 100644
index 0000000..e63f4bc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/attendance/vo/clock/HrmPortalAttendanceRecordRespVO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工端考勤记录 Response VO")
+@Data
+public class HrmPortalAttendanceRecordRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "打卡时间")
+    private LocalDateTime clockTime;
+
+    @Schema(description = "员工端考勤记录类型")
+    private Integer type;
+
+    @Schema(description = "应打卡时间")
+    private LocalDateTime attendanceTime;
+
+    @Schema(description = "来源类型")
+    private Integer sourceType;
+
+    @Schema(description = "员工端考勤记录状态")
+    private Integer status;
+
+    @Schema(description = "阶段")
+    private Integer stage;
+
+    @Schema(description = "地址")
+    private String address;
+
+    @Schema(description = "经度")
+    private BigDecimal longitude;
+
+    @Schema(description = "纬度")
+    private BigDecimal latitude;
+
+    @Schema(description = "WiFi 名称")
+    private String ssid;
+
+    @Schema(description = "WiFi MAC 地址")
+    private String mac;
+
+    @Schema(description = "备注")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeCertificateController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeCertificateController.java
new file mode 100644
index 0000000..9f0702c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeCertificateController.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate.HrmEmployeeCertificateRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeCertificateDO;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeCertificateService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端证书")
+@RestController
+@RequestMapping("/hrm/portal/employee/certificate")
+@Validated
+public class HrmPortalEmployeeCertificateController {
+
+    @Resource
+    private HrmEmployeeCertificateService certificateService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的证书列表")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmEmployeeCertificateRespVO>> getCertificateList() {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        List<HrmEmployeeCertificateDO> certificates =
+                certificateService.getCertificateListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(certificates, HrmEmployeeCertificateRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeContactController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeContactController.java
new file mode 100644
index 0000000..ec941b3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeContactController.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact.HrmEmployeeContactRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeContactDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeContactService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端联系人")
+@RestController
+@RequestMapping("/hrm/portal/employee/contact")
+@Validated
+public class HrmPortalEmployeeContactController {
+
+    @Resource
+    private HrmEmployeeContactService contactService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的联系人列表")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmEmployeeContactRespVO>> getContactList() {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        List<HrmEmployeeContactDO> contacts = contactService.getContactListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(contacts, HrmEmployeeContactRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeController.java
new file mode 100644
index 0000000..d4e770f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeController.java
@@ -0,0 +1,142 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.employee.vo.employee.HrmPortalEmployeeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.employee.vo.employee.HrmPortalEmployeeUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeArchiveFieldEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.config.HrmEmployeeFieldConfigService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDate;
+import java.time.temporal.ChronoUnit;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getYearsBetween;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端档案")
+@RestController
+@RequestMapping("/hrm/portal/employee")
+@Validated
+public class HrmPortalEmployeeController {
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmEmployeeFieldConfigService employeeFieldConfigService;
+    @Resource
+    private DeptApi deptApi;
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @GetMapping("/get-bind-status")
+    @Operation(summary = "获得当前账号的员工绑定状态")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<Boolean> getEmployeeBindStatus() {
+        return success(employeeService.getEmployeeByUserId(getLoginUserId()) != null);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得我的员工档案")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmPortalEmployeeRespVO> getEmployee() {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        // 拼接 VO
+        HrmPortalEmployeeRespVO respVO = BeanUtils.toBean(employee, HrmPortalEmployeeRespVO.class);
+        LocalDate today = LocalDate.now();
+        if (employee.getBirthday() != null) {
+            respVO.setAge(getYearsBetween(employee.getBirthday().toLocalDate(), today));
+        }
+        if (employee.getCompanyAgeStartTime() != null) {
+            respVO.setCompanyAge(getYearsBetween(employee.getCompanyAgeStartTime().toLocalDate(), today));
+        }
+        respVO.setEntryDay(employee.getEntryTime() == null ? 0L
+                : Math.max(0L, ChronoUnit.DAYS.between(employee.getEntryTime().toLocalDate(), today) + 1));
+        if (employee.getUserId() != null) {
+            AdminUserRespDTO user = adminUserApi.getUser(employee.getUserId());
+            respVO.setAvatar(user == null ? null : user.getAvatar());
+        }
+        if (employee.getDeptId() != null) {
+            DeptRespDTO dept = deptApi.getDept(employee.getDeptId());
+            respVO.setDeptName(dept == null ? null : dept.getName());
+        }
+        if (employee.getLeaderEmployeeId() != null) {
+            HrmEmployeeDO leader = employeeService.getEmployee(employee.getLeaderEmployeeId());
+            respVO.setLeaderEmployeeName(leader == null ? null : leader.getName());
+        }
+        hideInvisibleArchiveFields(respVO, employeeFieldConfigService.getVisibleArchiveFieldNames());
+        return success(respVO);
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新我的员工档案")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:employee:update')")
+    public CommonResult<Boolean> updateEmployee(
+            @Valid @RequestBody HrmPortalEmployeeUpdateReqVO reqVO) {
+        employeeService.updateEmployeeBySelf(getLoginUserId(), reqVO);
+        return success(true);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private void hideInvisibleArchiveFields(HrmPortalEmployeeRespVO respVO, Set<String> visibleFields) {
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.NAME.getName())) {
+            respVO.setName(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.COUNTRY.getName())) {
+            respVO.setCountry(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.NATION.getName())) {
+            respVO.setNation(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.ID_TYPE.getName())) {
+            respVO.setIdType(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.ID_NUMBER.getName())) {
+            respVO.setIdNumber(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.SEX.getName())) {
+            respVO.setSex(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.NATIVE_PLACE.getName())) {
+            respVO.setNativePlace(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.BIRTHDAY.getName())) {
+            respVO.setBirthday(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.AGE.getName())) {
+            respVO.setAge(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.HIGHEST_EDUCATION.getName())) {
+            respVO.setHighestEducation(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.MOBILE.getName())) {
+            respVO.setMobile(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.EMAIL.getName())) {
+            respVO.setEmail(null);
+        }
+        if (!visibleFields.contains(HrmEmployeeArchiveFieldEnum.ADDRESS.getName())) {
+            respVO.setAddress(null);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeEducationExperienceController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeEducationExperienceController.java
new file mode 100644
index 0000000..fc8cec3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeEducationExperienceController.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience.HrmEmployeeEducationExperienceRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeEducationExperienceDO;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeEducationExperienceService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端教育经历")
+@RestController
+@RequestMapping("/hrm/portal/employee/education-experience")
+@Validated
+public class HrmPortalEmployeeEducationExperienceController {
+
+    @Resource
+    private HrmEmployeeEducationExperienceService educationExperienceService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的教育经历列表")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmEmployeeEducationExperienceRespVO>> getEducationExperienceList() {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        List<HrmEmployeeEducationExperienceDO> educationExperiences =
+                educationExperienceService.getEducationExperienceListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(
+                educationExperiences, HrmEmployeeEducationExperienceRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeFieldConfigController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeFieldConfigController.java
new file mode 100644
index 0000000..eb00fb9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeFieldConfigController.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigRespVO;
+import cn.iocoder.yudao.module.hrm.service.employee.config.HrmEmployeeFieldConfigService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 员工端档案字段配置")
+@RestController
+@RequestMapping("/hrm/portal/employee/field-config")
+@Validated
+public class HrmPortalEmployeeFieldConfigController {
+
+    @Resource
+    private HrmEmployeeFieldConfigService employeeFieldConfigService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的员工档案字段配置")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmEmployeeFieldConfigRespVO>> getEmployeeFieldConfigList() {
+        return success(employeeFieldConfigService.getEmployeeArchiveFieldConfigList());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeQuitInfoController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeQuitInfoController.java
new file mode 100644
index 0000000..1fae541
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeQuitInfoController.java
@@ -0,0 +1,41 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo.HrmEmployeeQuitInfoRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeQuitInfoService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端离职信息")
+@RestController
+@RequestMapping("/hrm/portal/employee/quit-info")
+@Validated
+public class HrmPortalEmployeeQuitInfoController {
+
+    @Resource
+    private HrmEmployeeQuitInfoService quitInfoService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得我的离职信息")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmEmployeeQuitInfoRespVO> getQuitInfo() {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        HrmEmployeeQuitInfoDO quitInfo = quitInfoService.getQuitInfoByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(quitInfo, HrmEmployeeQuitInfoRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeTrainingExperienceController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeTrainingExperienceController.java
new file mode 100644
index 0000000..e67400f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeTrainingExperienceController.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience.HrmEmployeeTrainingExperienceRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeTrainingExperienceDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeTrainingExperienceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端培训经历")
+@RestController
+@RequestMapping("/hrm/portal/employee/training-experience")
+@Validated
+public class HrmPortalEmployeeTrainingExperienceController {
+
+    @Resource
+    private HrmEmployeeTrainingExperienceService trainingExperienceService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的培训经历列表")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmEmployeeTrainingExperienceRespVO>> getTrainingExperienceList() {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        List<HrmEmployeeTrainingExperienceDO> trainingExperiences =
+                trainingExperienceService.getTrainingExperienceListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(
+                trainingExperiences, HrmEmployeeTrainingExperienceRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeWorkExperienceController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeWorkExperienceController.java
new file mode 100644
index 0000000..aa8c4b9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/HrmPortalEmployeeWorkExperienceController.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience.HrmEmployeeWorkExperienceRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeWorkExperienceDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.employee.experience.HrmEmployeeWorkExperienceService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端工作经历")
+@RestController
+@RequestMapping("/hrm/portal/employee/work-experience")
+@Validated
+public class HrmPortalEmployeeWorkExperienceController {
+
+    @Resource
+    private HrmEmployeeWorkExperienceService workExperienceService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的工作经历列表")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmEmployeeWorkExperienceRespVO>> getWorkExperienceList() {
+        Long employeeId = employeeService.validateEmployeeBySelf(getLoginUserId()).getId();
+        List<HrmEmployeeWorkExperienceDO> workExperiences =
+                workExperienceService.getWorkExperienceListByEmployeeId(employeeId);
+        return success(BeanUtils.toBean(
+                workExperiences, HrmEmployeeWorkExperienceRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/vo/employee/HrmPortalEmployeeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/vo/employee/HrmPortalEmployeeRespVO.java
new file mode 100644
index 0000000..c803184
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/vo/employee/HrmPortalEmployeeRespVO.java
@@ -0,0 +1,117 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee.vo.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工端员工档案 Response VO")
+@Data
+public class HrmPortalEmployeeRespVO {
+
+    @Schema(description = "员工档案编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "员工姓名", example = "张三")
+    private String name;
+
+    @Schema(description = "员工头像")
+    private String avatar;
+
+    @Schema(description = "工号", example = "HRM001")
+    private String jobNumber;
+
+    @Schema(description = "手机号", example = "15601691300")
+    private String mobile;
+
+    @Schema(description = "国家或地区", example = "中国")
+    private String country;
+
+    @Schema(description = "民族", example = "汉族")
+    private String nation;
+
+    @Schema(description = "证件类型", example = "1")
+    private Integer idType;
+
+    @Schema(description = "证件号码", example = "310101199001011234")
+    private String idNumber;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "邮箱", example = "hrm@example.com")
+    private String email;
+
+    @Schema(description = "籍贯", example = "浙江杭州")
+    private String nativePlace;
+
+    @Schema(description = "出生日期")
+    private LocalDateTime birthday;
+
+    @Schema(description = "年龄", example = "28")
+    private Integer age;
+
+    @Schema(description = "户籍地址", example = "杭州市西湖区")
+    private String address;
+
+    @Schema(description = "最高学历", example = "8")
+    private Integer highestEducation;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "部门名称", example = "研发部")
+    private String deptName;
+
+    @Schema(description = "直属上级员工编号", example = "1")
+    private Long leaderEmployeeId;
+
+    @Schema(description = "直属上级员工姓名", example = "李四")
+    private String leaderEmployeeName;
+
+    @Schema(description = "入职状态", example = "1")
+    private Integer entryStatus;
+
+    @Schema(description = "员工状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "聘用形式", example = "1")
+    private Integer type;
+
+    @Schema(description = "入职时间")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "入职天数", requiredMode = Schema.RequiredMode.REQUIRED, example = "100")
+    private Long entryDay;
+
+    @Schema(description = "试用期，单位月；0 表示无试用期", example = "3")
+    private Integer probation;
+
+    @Schema(description = "转正时间")
+    private LocalDateTime regularTime;
+
+    @Schema(description = "离职时间")
+    private LocalDateTime leaveTime;
+
+    @Schema(description = "职位名称", example = "Java 工程师")
+    private String postName;
+
+    @Schema(description = "岗位职级", example = "P6")
+    private String postLevel;
+
+    @Schema(description = "工作城市", example = "上海")
+    private String workCity;
+
+    @Schema(description = "工作地点", example = "浦东新区")
+    private String workAddress;
+
+    @Schema(description = "工作详细地址", example = "张江高科 1 号楼")
+    private String workDetailAddress;
+
+    @Schema(description = "司龄开始时间")
+    private LocalDateTime companyAgeStartTime;
+
+    @Schema(description = "司龄，单位年", example = "2")
+    private Integer companyAge;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/vo/employee/HrmPortalEmployeeUpdateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/vo/employee/HrmPortalEmployeeUpdateReqVO.java
new file mode 100644
index 0000000..3c541ba
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/employee/vo/employee/HrmPortalEmployeeUpdateReqVO.java
@@ -0,0 +1,79 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.employee.vo.employee;
+
+import cn.hutool.core.util.IdcardUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.framework.common.validation.Mobile;
+import cn.iocoder.yudao.module.hrm.enums.employee.experience.HrmEmployeeEducationEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeIdTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.PastOrPresent;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工端档案更新 Request VO")
+@Data
+public class HrmPortalEmployeeUpdateReqVO {
+
+    @Schema(description = "员工姓名", example = "张三")
+    @Size(max = 255, message = "员工姓名不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "手机号", example = "15601691300")
+    @Mobile
+    private String mobile;
+
+    @Schema(description = "国家或地区", example = "中国")
+    @Size(max = 64, message = "国家或地区不能超过 64 个字符")
+    private String country;
+
+    @Schema(description = "民族", example = "汉族")
+    @Size(max = 64, message = "民族不能超过 64 个字符")
+    private String nation;
+
+    @Schema(description = "证件类型", example = "1")
+    @InEnum(value = HrmEmployeeIdTypeEnum.class, message = "证件类型必须是 {value}")
+    private Integer idType;
+
+    @Schema(description = "证件号码", example = "310101199001011234")
+    @Size(max = 255, message = "证件号码不能超过 255 个字符")
+    private String idNumber;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "邮箱", example = "hrm@example.com")
+    @Email(message = "邮箱格式不正确")
+    @Size(max = 255, message = "邮箱不能超过 255 个字符")
+    private String email;
+
+    @Schema(description = "籍贯", example = "浙江杭州")
+    @Size(max = 128, message = "籍贯不能超过 128 个字符")
+    private String nativePlace;
+
+    @Schema(description = "出生日期")
+    @PastOrPresent(message = "出生日期不能晚于当前时间")
+    private LocalDateTime birthday;
+
+    @Schema(description = "户籍地址", example = "杭州市西湖区")
+    @Size(max = 255, message = "户籍地址不能超过 255 个字符")
+    private String address;
+
+    @Schema(description = "最高学历", example = "8")
+    @InEnum(value = HrmEmployeeEducationEnum.class, message = "最高学历必须是 {value}")
+    private Integer highestEducation;
+
+    @AssertTrue(message = "身份证号码格式不正确")
+    @JsonIgnore
+    public boolean isIdNumberValid() {
+        return ObjUtil.notEqual(HrmEmployeeIdTypeEnum.ID_CARD.getType(), idType)
+                || StrUtil.isBlank(idNumber) || IdcardUtil.isValidCard(idNumber);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/home/HrmPortalHomeController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/home/HrmPortalHomeController.java
new file mode 100644
index 0000000..e6ebe27
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/home/HrmPortalHomeController.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.home;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHomeCalendarItemRespVO;
+import cn.iocoder.yudao.module.hrm.service.home.HrmHomeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.format.annotation.DateTimeFormat;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDate;
+import java.util.List;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端首页")
+@RestController
+@RequestMapping("/hrm/portal/home")
+@Validated
+public class HrmPortalHomeController {
+
+    @Resource
+    private HrmHomeService homeService;
+
+    @GetMapping("/calendar")
+    @Operation(summary = "获得员工端首页日历")
+    @Parameters({
+            @Parameter(name = "startDate", description = "开始日期", required = true, example = "2026-08-01"),
+            @Parameter(name = "endDate", description = "结束日期", required = true, example = "2026-08-31")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmHomeCalendarItemRespVO>> getEmployeeHomeCalendar(
+            @RequestParam("startDate") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate startDate,
+            @RequestParam("endDate") @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate endDate) {
+        return success(homeService.getEmployeeCalendar(getLoginUserId(), startDate, endDate));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/HrmPortalInsuranceController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/HrmPortalInsuranceController.java
new file mode 100644
index 0000000..c76b3ef
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/HrmPortalInsuranceController.java
@@ -0,0 +1,117 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.insurance;
+
+import cn.hutool.core.util.BooleanUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.insurance.vo.HrmPortalInsuranceRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_EMP_RECORD_NOT_EXISTS;
+
+@Tag(name = "管理后台 - HRM 员工端社保")
+@RestController
+@RequestMapping("/hrm/portal/insurance/record")
+@Validated
+public class HrmPortalInsuranceController {
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordService insuranceMonthEmployeeRecordService;
+    @Resource
+    private HrmInsuranceSchemeService insuranceSchemeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的社保记录")
+    @Parameter(name = "year", description = "年份", example = "2026")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmPortalInsuranceRecordRespVO>> getInsuranceRecordList(
+            @RequestParam(value = "year", required = false) Integer year) {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        List<HrmInsuranceMonthEmployeeRecordDO> records =
+                insuranceMonthEmployeeRecordService.getMonthEmployeeRecordListByEmployeeIdAndYear(
+                        employee.getId(), year);
+        // 拼接 VO
+        return success(buildInsuranceRecordRespVOList(records));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得我的社保记录详情")
+    @Parameter(name = "id", description = "社保记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmPortalInsuranceRecordRespVO> getInsuranceRecord(@RequestParam("id") Long id) {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        HrmInsuranceMonthEmployeeRecordDO record = insuranceMonthEmployeeRecordService.getMonthEmployeeRecord(id);
+        if (record == null || notEqual(record.getEmployeeId(), employee.getId())) {
+            throw exception(INSURANCE_MONTH_EMP_RECORD_NOT_EXISTS);
+        }
+        // 拼接 VO
+        return success(buildInsuranceRecordRespVO(
+                record, insuranceSchemeService.getScheme(record.getSchemeId()), true));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    /**
+     * 构建社保记录响应列表
+     *
+     * @param records 社保记录列表
+     * @return 社保记录响应列表
+     */
+    private List<HrmPortalInsuranceRecordRespVO> buildInsuranceRecordRespVOList(
+            List<HrmInsuranceMonthEmployeeRecordDO> records) {
+        Map<Long, HrmInsuranceSchemeDO> schemeMap = insuranceSchemeService.getSchemeMap(
+                convertSet(records, HrmInsuranceMonthEmployeeRecordDO::getSchemeId));
+        return convertList(records, record ->
+                buildInsuranceRecordRespVO(record, schemeMap.get(record.getSchemeId()), false));
+    }
+
+    /**
+     * 构建社保记录响应
+     *
+     * @param record 社保记录
+     * @param scheme 社保方案
+     * @param includeProjects 是否返回社保项目
+     * @return 社保记录响应
+     */
+    private HrmPortalInsuranceRecordRespVO buildInsuranceRecordRespVO(
+            HrmInsuranceMonthEmployeeRecordDO record, HrmInsuranceSchemeDO scheme,
+            boolean includeProjects) {
+        HrmPortalInsuranceRecordRespVO respVO = BeanUtils.toBean(record, HrmPortalInsuranceRecordRespVO.class);
+        if (scheme != null) {
+            respVO.setSchemeName(scheme.getName()).setSchemeType(scheme.getType())
+                    .setSchemeCity(AreaUtils.format(scheme.getAreaId()));
+        }
+        if (BooleanUtil.isFalse(includeProjects)) {
+            respVO.setProjects(null);
+        }
+        return respVO;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/vo/HrmPortalInsuranceProjectRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/vo/HrmPortalInsuranceProjectRespVO.java
new file mode 100644
index 0000000..45b10c5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/vo/HrmPortalInsuranceProjectRespVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.insurance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工端社保项目 Response VO")
+@Data
+public class HrmPortalInsuranceProjectRespVO {
+
+    @Schema(description = "社保项目编号")
+    private Long schemeProjectId;
+
+    @Schema(description = "员工端社保项目类型")
+    private Integer type;
+
+    @Schema(description = "社保项目名称")
+    private String name;
+
+    @Schema(description = "默认缴纳金额")
+    private BigDecimal baseAmount;
+
+    @Schema(description = "公司缴纳比例")
+    private BigDecimal corporateRate;
+
+    @Schema(description = "个人缴纳比例")
+    private BigDecimal personalRate;
+
+    @Schema(description = "公司缴纳金额")
+    private BigDecimal corporateAmount;
+
+    @Schema(description = "个人缴纳金额")
+    private BigDecimal personalAmount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/vo/HrmPortalInsuranceRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/vo/HrmPortalInsuranceRecordRespVO.java
new file mode 100644
index 0000000..c5ce6a8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/insurance/vo/HrmPortalInsuranceRecordRespVO.java
@@ -0,0 +1,62 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.insurance.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端社保记录 Response VO")
+@Data
+public class HrmPortalInsuranceRecordRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "月度社保记录编号")
+    private Long monthRecordId;
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "社保方案编号")
+    private Long schemeId;
+
+    @Schema(description = "社保方案名称")
+    private String schemeName;
+
+    @Schema(description = "社保方案类型")
+    private Integer schemeType;
+
+    @Schema(description = "参保城市")
+    private String schemeCity;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "个人社保金额")
+    private BigDecimal personalInsuranceAmount;
+
+    @Schema(description = "个人公积金金额")
+    private BigDecimal personalProvidentFundAmount;
+
+    @Schema(description = "公司社保金额")
+    private BigDecimal corporateInsuranceAmount;
+
+    @Schema(description = "公司公积金金额")
+    private BigDecimal corporateProvidentFundAmount;
+
+    @Schema(description = "员工端社保记录状态")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "社保项目列表")
+    private List<HrmPortalInsuranceProjectRespVO> projects;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/HrmPortalPerformanceAssessmentController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/HrmPortalPerformanceAssessmentController.java
new file mode 100644
index 0000000..0306757
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/HrmPortalPerformanceAssessmentController.java
@@ -0,0 +1,354 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceProcessRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment.HrmPortalPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment.HrmPortalPerformanceAssessmentRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment.HrmPortalPerformanceTaskCountRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceAppealReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceConfirmReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceHandleStageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceProcessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceFillQuotaReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceReviewRejectReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScorePreviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScoreReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentProcessService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentQueryService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentReviewService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端绩效考核")
+@RestController
+@RequestMapping("/hrm/portal/performance/assessment")
+@Validated
+public class HrmPortalPerformanceAssessmentController {
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmPerformanceAssessmentService performanceAssessmentService;
+    @Resource
+    private HrmPerformanceAssessmentProcessService performanceAssessmentProcessService;
+    @Resource
+    private HrmPerformanceAssessmentReviewService performanceAssessmentReviewService;
+    @Resource
+    private HrmPerformanceAssessmentQueryService performanceAssessmentQueryService;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得我的绩效分页")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<PageResult<HrmPortalPerformanceAssessmentRespVO>> getPerformanceAssessmentPage(
+            @Valid HrmPortalPerformanceAssessmentPageReqVO reqVO) {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        PageResult<HrmPerformanceAssessmentDO> pageResult =
+                performanceAssessmentService.getPortalPerformanceAssessmentPage(reqVO, employee.getId());
+        // 拼接 VO
+        return success(buildPortalAssessmentRespVOPage(pageResult));
+    }
+
+    @GetMapping("/task-count")
+    @Operation(summary = "获得我的绩效任务数量")
+    @Parameter(name = "search", description = "员工姓名或工号", example = "张三")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmPortalPerformanceTaskCountRespVO> getPerformanceAssessmentTaskCount(
+            @RequestParam(value = "search", required = false) String search) {
+        Long loginUserId = getLoginUserId();
+        employeeService.validateEmployeeBySelf(loginUserId);
+        Map<Integer, Map<Integer, Long>> taskCountMap =
+                performanceAssessmentProcessService.getMyTaskCountMap(loginUserId, search);
+        // 拼接 VO
+        return success(buildTaskCountRespVO(taskCountMap));
+    }
+
+    @GetMapping("/fill-quota-task-page")
+    @Operation(summary = "获得我的绩效指标填写任务分页")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentFillQuotaTaskPage(
+            @Valid HrmPortalPerformanceTaskPageReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        PageResult<HrmPerformanceAssessmentStageDO> pageResult =
+                performanceAssessmentReviewService.getMyFillQuotaTaskPage(loginUserId, reqVO);
+        return success(performanceAssessmentQueryService
+                .getPerformanceAssessmentTaskRespVOPage(pageResult, loginUserId));
+    }
+
+    @GetMapping("/target-confirmation-task-page")
+    @Operation(summary = "获得我的绩效目标确认任务分页")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentTargetConfirmationTaskPage(
+            @Valid HrmPortalPerformanceTaskPageReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        PageResult<HrmPerformanceAssessmentStageDO> pageResult =
+                performanceAssessmentProcessService.getMyTargetConfirmationTaskPage(loginUserId, reqVO);
+        return success(performanceAssessmentQueryService
+                .getPerformanceAssessmentTaskRespVOPage(pageResult, loginUserId));
+    }
+
+    @GetMapping("/review-task-page")
+    @Operation(summary = "获得我的绩效评分任务分页")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentReviewTaskPage(
+            @Valid HrmPortalPerformanceTaskPageReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        PageResult<HrmPerformanceAssessmentStageDO> pageResult =
+                performanceAssessmentReviewService.getMyReviewTaskPage(loginUserId, reqVO);
+        return success(performanceAssessmentQueryService
+                .getPerformanceAssessmentTaskRespVOPage(pageResult, loginUserId));
+    }
+
+    @GetMapping("/result-audit-task-page")
+    @Operation(summary = "获得我的绩效结果审核任务分页")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentResultAuditTaskPage(
+            @Valid HrmPortalPerformanceTaskPageReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        PageResult<HrmPerformanceAssessmentStageDO> pageResult =
+                performanceAssessmentProcessService.getMyResultAuditTaskPage(loginUserId, reqVO);
+        return success(performanceAssessmentQueryService
+                .getPerformanceAssessmentTaskRespVOPage(pageResult, loginUserId));
+    }
+
+    @GetMapping("/result-confirmation-task-page")
+    @Operation(summary = "获得我的绩效结果确认任务分页")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentResultConfirmationTaskPage(
+            @Valid HrmPortalPerformanceTaskPageReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        PageResult<HrmPerformanceAssessmentStageDO> pageResult =
+                performanceAssessmentProcessService.getMyResultConfirmationTaskPage(loginUserId, reqVO);
+        return success(performanceAssessmentQueryService
+                .getPerformanceAssessmentTaskRespVOPage(pageResult, loginUserId));
+    }
+
+    @GetMapping("/appeal-task-page")
+    @Operation(summary = "获得我的绩效申诉处理任务分页")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<PageResult<HrmPerformanceAssessmentRespVO>> getPerformanceAssessmentAppealTaskPage(
+            @Valid HrmPortalPerformanceTaskPageReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        PageResult<HrmPerformanceAssessmentStageDO> pageResult =
+                performanceAssessmentProcessService.getMyAppealTaskPage(loginUserId, reqVO);
+        return success(performanceAssessmentQueryService
+                .getPerformanceAssessmentTaskRespVOPage(pageResult, loginUserId));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得我的员工绩效考核明细")
+    @Parameter(name = "id", description = "员工绩效考核编号", required = true, example = "1")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmPerformanceAssessmentRespVO> getPerformanceAssessment(
+            @RequestParam("id") Long id,
+            @RequestParam(value = "stageId", required = false) Long stageId) {
+        Long loginUserId = getLoginUserId();
+        HrmPerformanceAssessmentDO assessment = validateReadablePerformanceAssessment(loginUserId, id, stageId);
+        // 拼接 VO
+        if (stageId != null) {
+            return success(performanceAssessmentQueryService
+                    .getPerformanceAssessmentTaskRespVO(assessment, stageId, loginUserId));
+        }
+        return success(performanceAssessmentQueryService
+                .getPerformanceAssessmentProcessRespVO(assessment, loginUserId));
+    }
+
+    @GetMapping("/process-record-list")
+    @Operation(summary = "获得我的绩效流程记录")
+    @Parameter(name = "id", description = "员工绩效考核编号", required = true, example = "1")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmPerformanceProcessRecordRespVO>> getPerformanceAssessmentProcessRecordList(
+            @RequestParam("id") Long id,
+            @RequestParam(value = "stageId", required = false) Long stageId) {
+        Long loginUserId = getLoginUserId();
+        HrmPerformanceAssessmentDO assessment = validateReadablePerformanceAssessment(loginUserId, id, stageId);
+        return success(performanceAssessmentQueryService.getPerformanceAssessmentProcessRecordList(assessment, loginUserId));
+    }
+
+    @PutMapping("/fill-quota")
+    @Operation(summary = "填写我的绩效指标")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<Boolean> fillPerformanceAssessmentQuota(
+            @Valid @RequestBody HrmPortalPerformanceFillQuotaReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        validateOwnPerformanceAssessment(loginUserId, reqVO.getAssessmentId());
+        performanceAssessmentReviewService.fillQuota(loginUserId, reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/confirm-target")
+    @Operation(summary = "确认我的绩效目标")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<Boolean> confirmPerformanceAssessmentTarget(
+            @Valid @RequestBody HrmPortalPerformanceConfirmReqVO reqVO) {
+        performanceAssessmentProcessService.confirmTarget(getLoginUserId(), reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/score-preview")
+    @Operation(summary = "试算绩效评分")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<HrmPortalPerformanceScorePreviewRespVO> previewPerformanceAssessmentScore(
+            @Valid @RequestBody HrmPortalPerformanceScoreReqVO reqVO) {
+        return success(performanceAssessmentReviewService.previewScore(getLoginUserId(), reqVO));
+    }
+
+    @PutMapping("/score")
+    @Operation(summary = "提交绩效自评或他评")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<HrmPortalPerformanceProcessRespVO> scorePerformanceAssessment(
+            @Valid @RequestBody HrmPortalPerformanceScoreReqVO reqVO) {
+        return success(performanceAssessmentReviewService.scoreAssessment(getLoginUserId(), reqVO));
+    }
+
+    @PutMapping("/reject-review-stage")
+    @Operation(summary = "驳回上一绩效评分阶段")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<Boolean> rejectPerformanceAssessmentReviewStage(
+            @Valid @RequestBody HrmPortalPerformanceReviewRejectReqVO reqVO) {
+        performanceAssessmentReviewService.rejectReviewStage(getLoginUserId(), reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/handle-result-audit")
+    @Operation(summary = "处理绩效结果审核")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<Boolean> handlePerformanceAssessmentResultAudit(
+            @Valid @RequestBody HrmPortalPerformanceHandleStageReqVO reqVO) {
+        performanceAssessmentProcessService.handleResultAudit(getLoginUserId(), reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/confirm-result")
+    @Operation(summary = "确认我的绩效结果")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<Boolean> confirmPerformanceAssessmentResult(
+            @Valid @RequestBody HrmPortalPerformanceConfirmReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        validateOwnPerformanceAssessment(loginUserId, reqVO.getAssessmentId());
+        performanceAssessmentProcessService.confirmResult(loginUserId, reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/submit-appeal")
+    @Operation(summary = "提交我的绩效申诉")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<HrmPortalPerformanceProcessRespVO> submitPerformanceAssessmentAppeal(
+            @Valid @RequestBody HrmPortalPerformanceAppealReqVO reqVO) {
+        Long loginUserId = getLoginUserId();
+        validateOwnPerformanceAssessment(loginUserId, reqVO.getAssessmentId());
+        return success(performanceAssessmentProcessService.submitAppeal(loginUserId, reqVO));
+    }
+
+    @PutMapping("/handle-appeal")
+    @Operation(summary = "处理绩效申诉")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:performance:action')")
+    public CommonResult<Boolean> handlePerformanceAssessmentAppeal(
+            @Valid @RequestBody HrmPortalPerformanceHandleStageReqVO reqVO) {
+        performanceAssessmentProcessService.handleAppeal(getLoginUserId(), reqVO);
+        return success(true);
+    }
+
+    private HrmPerformanceAssessmentDO validateOwnPerformanceAssessment(Long loginUserId, Long assessmentId) {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(loginUserId);
+        return performanceAssessmentService.validatePerformanceAssessmentByEmployeeId(assessmentId, employee.getId());
+    }
+
+    private HrmPerformanceAssessmentDO validateReadablePerformanceAssessment(
+            Long loginUserId, Long assessmentId, Long stageId) {
+        if (stageId == null) {
+            return validateOwnPerformanceAssessment(loginUserId, assessmentId);
+        }
+        performanceAssessmentProcessService.validateTaskStage(loginUserId, assessmentId, stageId);
+        return performanceAssessmentService.getPerformanceAssessment(assessmentId);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private PageResult<HrmPortalPerformanceAssessmentRespVO> buildPortalAssessmentRespVOPage(
+            PageResult<HrmPerformanceAssessmentDO> pageResult) {
+        PageResult<HrmPerformanceAssessmentRespVO> respVOPage =
+                performanceAssessmentQueryService.getPerformanceAssessmentRespVOPage(pageResult);
+        return new PageResult<>(
+                BeanUtils.toBean(respVOPage.getList(), HrmPortalPerformanceAssessmentRespVO.class),
+                respVOPage.getTotal());
+    }
+
+    private HrmPortalPerformanceTaskCountRespVO buildTaskCountRespVO(
+            Map<Integer, Map<Integer, Long>> taskCountMap) {
+        Integer pendingStatus = HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus();
+        Integer completedStatus = HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus();
+        // 按流程类型和处理状态组装员工端各页签的待办、已办数量
+        return new HrmPortalPerformanceTaskCountRespVO()
+                .setFillPendingCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.FILL_QUOTA.getType(), pendingStatus))
+                .setFillCompletedCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.FILL_QUOTA.getType(), completedStatus))
+                .setTargetPendingCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(), pendingStatus))
+                .setTargetCompletedCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(), completedStatus))
+                .setReviewPendingCount(getTaskCount(taskCountMap, HrmPerformanceStageTypeEnum.REVIEW_TYPES, pendingStatus))
+                .setReviewCompletedCount(getTaskCount(taskCountMap, HrmPerformanceStageTypeEnum.REVIEW_TYPES, completedStatus))
+                .setResultAuditPendingCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(), pendingStatus))
+                .setResultAuditCompletedCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(), completedStatus))
+                .setResultConfirmationPendingCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), pendingStatus))
+                .setResultConfirmationCompletedCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), completedStatus))
+                .setResultConfirmationAppealedCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                        HrmPerformanceAssessmentStageStatusEnum.APPEALED.getStatus()))
+                .setAppealPendingCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(), pendingStatus))
+                .setAppealCompletedCount(getTaskCount(
+                        taskCountMap, HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(), completedStatus));
+    }
+
+    private long getTaskCount(Map<Integer, Map<Integer, Long>> countMap, Integer type, Integer status) {
+        return countMap.getOrDefault(type, Collections.emptyMap()).getOrDefault(status, 0L);
+    }
+
+    @SuppressWarnings("SameParameterValue")
+    private long getTaskCount(Map<Integer, Map<Integer, Long>> countMap,
+                              Collection<Integer> types, Integer status) {
+        long count = 0L;
+        for (Integer type : types) {
+            count += getTaskCount(countMap, type, status);
+        }
+        return count;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceAssessmentPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceAssessmentPageReqVO.java
new file mode 100644
index 0000000..75e1dae
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceAssessmentPageReqVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 员工端我的绩效分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPortalPerformanceAssessmentPageReqVO extends PageParam {
+
+    @Schema(description = "绩效计划名称", example = "2026 年第三季度绩效计划")
+    private String search;
+
+    @Schema(description = "是否已归档", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    @NotNull(message = "是否已归档不能为空")
+    private Boolean archived;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceAssessmentRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceAssessmentRespVO.java
new file mode 100644
index 0000000..8d43217
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceAssessmentRespVO.java
@@ -0,0 +1,67 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 员工端绩效考核 Response VO")
+@Data
+public class HrmPortalPerformanceAssessmentRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "绩效计划编号")
+    private Long planId;
+
+    @Schema(description = "绩效计划名称")
+    private String name;
+
+    @Schema(description = "考核状态")
+    private Integer status;
+
+    @Schema(description = "阶段状态")
+    private Integer stageType;
+
+    @Schema(description = "得分")
+    private BigDecimal score;
+
+    @Schema(description = "结果等级")
+    private String resultLevel;
+
+    @Schema(description = "绩效系数")
+    private BigDecimal coefficient;
+
+    @Schema(description = "结果审核状态")
+    private Integer resultAuditStatus;
+
+    @Schema(description = "结果审核时间")
+    private LocalDateTime resultAuditTime;
+
+    @Schema(description = "结果审核意见")
+    private String resultAuditReason;
+
+    @Schema(description = "申诉原因")
+    private String appealReason;
+
+    @Schema(description = "申诉状态")
+    private Integer appealStatus;
+
+    @Schema(description = "申诉处理时间")
+    private LocalDateTime appealTime;
+
+    @Schema(description = "申诉处理意见")
+    private String appealComment;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "归档时间")
+    private LocalDateTime archiveTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceTaskCountRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceTaskCountRespVO.java
new file mode 100644
index 0000000..5ffd548
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/assessment/HrmPortalPerformanceTaskCountRespVO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+@Schema(description = "管理后台 - HRM 员工端绩效任务数量 Response VO")
+@Data
+@Accessors(chain = true)
+public class HrmPortalPerformanceTaskCountRespVO {
+
+    @Schema(description = "待填写指标数量")
+    private Long fillPendingCount;
+
+    @Schema(description = "已填写指标数量")
+    private Long fillCompletedCount;
+
+    @Schema(description = "待确认目标数量")
+    private Long targetPendingCount;
+
+    @Schema(description = "已确认目标数量")
+    private Long targetCompletedCount;
+
+    @Schema(description = "待评分数量")
+    private Long reviewPendingCount;
+
+    @Schema(description = "已评分数量")
+    private Long reviewCompletedCount;
+
+    @Schema(description = "待审核结果数量")
+    private Long resultAuditPendingCount;
+
+    @Schema(description = "已审核结果数量")
+    private Long resultAuditCompletedCount;
+
+    @Schema(description = "待确认结果数量")
+    private Long resultConfirmationPendingCount;
+
+    @Schema(description = "已确认结果数量")
+    private Long resultConfirmationCompletedCount;
+
+    @Schema(description = "已申诉结果数量")
+    private Long resultConfirmationAppealedCount;
+
+    @Schema(description = "待处理申诉数量")
+    private Long appealPendingCount;
+
+    @Schema(description = "已处理申诉数量")
+    private Long appealCompletedCount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceAppealReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceAppealReqVO.java
new file mode 100644
index 0000000..1f7e1c2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceAppealReqVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端绩效申诉 Request VO")
+@Data
+public class HrmPortalPerformanceAppealReqVO {
+
+    @Schema(description = "员工绩效考核编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工绩效考核不能为空")
+    private Long assessmentId;
+
+    @Schema(description = "申诉原因", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "实际完成结果与评分依据不一致")
+    @NotBlank(message = "申诉原因不能为空")
+    @Size(max = 500, message = "申诉原因不能超过 500 个字符")
+    private String appealReason;
+
+    @Schema(description = "申诉附件地址列表", example = "[https://example.com/appeal.pdf]")
+    private List<String> appealFileUrls;
+
+    @Schema(description = "退回评分节点编号列表", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "[1024, 2048]")
+    @NotNull(message = "退回评分节点不能为空")
+    private List<Long> reviewStageIds;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceConfirmReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceConfirmReqVO.java
new file mode 100644
index 0000000..d1da2f7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceConfirmReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceConfirmationResultEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工端绩效确认 Request VO")
+@Data
+public class HrmPortalPerformanceConfirmReqVO {
+
+    @Schema(description = "员工绩效考核编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工绩效考核不能为空")
+    private Long assessmentId;
+
+    @Schema(description = "是否通过", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "确认结果不能为空")
+    @InEnum(value = HrmPerformanceConfirmationResultEnum.class, message = "确认结果必须是 {value}")
+    private Integer pass;
+
+    @Schema(description = "说明", example = "确认考核目标")
+    @Size(max = 1000, message = "说明不能超过 1000 个字符")
+    private String comment;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceHandleStageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceHandleStageReqVO.java
new file mode 100644
index 0000000..7018643
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceHandleStageReqVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceConfirmationResultEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端绩效运行阶段处理 Request VO")
+@Data
+public class HrmPortalPerformanceHandleStageReqVO {
+
+    @Schema(description = "员工绩效考核编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工绩效考核不能为空")
+    private Long assessmentId;
+
+    @Schema(description = "运行阶段编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
+    @NotNull(message = "运行阶段不能为空")
+    private Long stageId;
+
+    @Schema(description = "是否通过", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "处理结果不能为空")
+    @InEnum(value = HrmPerformanceConfirmationResultEnum.class, message = "处理结果必须是 {value}")
+    private Integer pass;
+
+    @Schema(description = "处理意见", example = "审核通过")
+    @Size(max = 500, message = "处理意见不能超过 500 个字符")
+    private String comment;
+
+    @Schema(description = "退回评分阶段编号列表", example = "[1024, 1025]")
+    private List<Long> reviewStageIds;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceProcessRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceProcessRespVO.java
new file mode 100644
index 0000000..d8813ab
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/process/HrmPortalPerformanceProcessRespVO.java
@@ -0,0 +1,16 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工端绩效处理 Response VO")
+@Data
+public class HrmPortalPerformanceProcessRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "下一运行阶段编号")
+    private Long nextStageId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceFillQuotaReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceFillQuotaReqVO.java
new file mode 100644
index 0000000..896f5f9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceFillQuotaReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端绩效指标填写 Request VO")
+@Data
+public class HrmPortalPerformanceFillQuotaReqVO {
+
+    @Schema(description = "员工绩效考核编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工绩效考核不能为空")
+    private Long assessmentId;
+
+    @Schema(description = "指标列表")
+    @Valid
+    private List<HrmPortalPerformanceQuotaSaveReqVO> quotas;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceQuotaSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceQuotaSaveReqVO.java
new file mode 100644
index 0000000..3840070
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceQuotaSaveReqVO.java
@@ -0,0 +1,61 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工绩效指标保存 Request VO")
+@Data
+public class HrmPortalPerformanceQuotaSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工绩效维度编号", example = "2048")
+    private Long dimensionId;
+
+    @Schema(description = "指标名称", example = "销售目标达成率")
+    @Size(max = 255, message = "指标名称不能超过 255 个字符")
+    private String name;
+
+    @Schema(description = "指标说明", example = "按季度销售目标计算")
+    @Size(max = 1000, message = "指标说明不能超过 1000 个字符")
+    private String description;
+
+    @Schema(description = "标准值", example = "完成率达到 100% 得满分")
+    @Size(max = 1000, message = "标准值不能超过 1000 个字符")
+    private String standard;
+
+    @Schema(description = "指标权重", example = "50")
+    private BigDecimal weight;
+
+    @Schema(description = "分数类型", example = "1")
+    private Integer scoreType;
+
+    @Schema(description = "目标值", example = "100%")
+    @Size(max = 1000, message = "目标值不能超过 1000 个字符")
+    private String targetValue;
+
+    @Schema(description = "实际值", example = "95%")
+    @Size(max = 1000, message = "实际值不能超过 1000 个字符")
+    private String actualValue;
+
+    @Schema(description = "自评分数", example = "90")
+    private BigDecimal selfScore;
+
+    @Schema(description = "评分人得分", example = "88")
+    private BigDecimal reviewerScore;
+
+    @Schema(description = "最终得分", example = "89")
+    private BigDecimal finalScore;
+
+    @Schema(description = "说明", example = "目标基本达成")
+    @Size(max = 1000, message = "说明不能超过 1000 个字符")
+    private String comment;
+
+    @Schema(description = "排序", example = "1")
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceReviewRejectReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceReviewRejectReqVO.java
new file mode 100644
index 0000000..72c1321
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceReviewRejectReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 员工端绩效评分阶段驳回 Request VO")
+@Data
+public class HrmPortalPerformanceReviewRejectReqVO {
+
+    @Schema(description = "员工绩效考核编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工绩效考核不能为空")
+    private Long assessmentId;
+
+    @Schema(description = "评分阶段编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
+    @NotNull(message = "当前评分阶段不能为空")
+    private Long reviewStageId;
+
+    @Schema(description = "绩效评审驳回原因", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "评分依据不完整，请补充说明")
+    @NotBlank(message = "驳回原因不能为空")
+    @Size(max = 1000, message = "驳回原因不能超过 1000 个字符")
+    private String reason;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceScorePreviewRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceScorePreviewRespVO.java
new file mode 100644
index 0000000..9c07933
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceScorePreviewRespVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 员工端绩效评分试算 Response VO")
+@Data
+public class HrmPortalPerformanceScorePreviewRespVO {
+
+    @Schema(description = "阶段得分")
+    private BigDecimal stageScore;
+
+    @Schema(description = "阶段结果等级")
+    private String stageResultLevel;
+
+    @Schema(description = "当前累计得分")
+    private BigDecimal cumulativeScore;
+
+    @Schema(description = "当前累计结果等级；全部评分阶段完成时返回")
+    private String cumulativeResultLevel;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceScoreReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceScoreReqVO.java
new file mode 100644
index 0000000..22d19a6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/review/HrmPortalPerformanceScoreReqVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端绩效评分 Request VO")
+@Data
+public class HrmPortalPerformanceScoreReqVO {
+
+    @Schema(description = "员工绩效考核编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工绩效考核不能为空")
+    private Long assessmentId;
+
+    @Schema(description = "评分阶段编号", example = "2048")
+    private Long reviewStageId;
+
+    @Schema(description = "说明", example = "本阶段评分完成")
+    @Size(max = 2000, message = "说明不能超过 2000 个字符")
+    private String comment;
+
+    @Schema(description = "自评说明", example = "已完成本季度目标")
+    @Size(max = 2000, message = "自评说明不能超过 2000 个字符")
+    private String selfComment;
+
+    @Schema(description = "评分人说明", example = "目标完成情况良好")
+    @Size(max = 2000, message = "评分人说明不能超过 2000 个字符")
+    private String reviewerComment;
+
+    @Schema(description = "指标列表")
+    @Valid
+    private List<HrmPortalPerformanceQuotaSaveReqVO> quotas;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/task/HrmPortalPerformanceTaskPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/task/HrmPortalPerformanceTaskPageReqVO.java
new file mode 100644
index 0000000..abcce5c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/performance/vo/task/HrmPortalPerformanceTaskPageReqVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 员工端绩效任务分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmPortalPerformanceTaskPageReqVO extends PageParam {
+
+    @Schema(description = "绩效计划名称、员工姓名或工号", example = "张三")
+    private String search;
+
+    @Schema(description = "阶段处理状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "阶段处理状态不能为空")
+    @InEnum(value = HrmPerformanceAssessmentStageStatusEnum.class,
+            message = "阶段处理状态必须是 {value}")
+    private Integer stageStatus;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/HrmPortalSalarySlipController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/HrmPortalSalarySlipController.java
new file mode 100644
index 0000000..d433267
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/HrmPortalSalarySlipController.java
@@ -0,0 +1,130 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.salary;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.salary.vo.HrmPortalSalarySlipListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.salary.vo.HrmPortalSalarySlipRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.salary.vo.HrmPortalSalarySlipUnreadSummaryRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.salary.slip.HrmSalarySlipService;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipReadStatusEnum;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.YearMonth;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.security.core.util.SecurityFrameworkUtils.getLoginUserId;
+
+@Tag(name = "管理后台 - HRM 员工端工资条")
+@RestController
+@RequestMapping("/hrm/portal/salary/slip")
+@Validated
+public class HrmPortalSalarySlipController {
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmSalarySlipService salarySlipService;
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @GetMapping("/unread-summary")
+    @Operation(summary = "获得我的未读工资条概况")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmPortalSalarySlipUnreadSummaryRespVO> getUnreadSalarySlipSummary() {
+        // 1. 获得当前员工的未读工资条
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        List<HrmSalarySlipDO> unreadSalarySlips = filterList(
+                salarySlipService.getSalarySlipListByEmployeeId(
+                        employee.getId(), null, null, null, null),
+                salarySlip -> HrmSalarySlipReadStatusEnum.UNREAD.getStatus().equals(salarySlip.getReadStatus()));
+
+        // 2. 构建未读工资条概况
+        return success(new HrmPortalSalarySlipUnreadSummaryRespVO(
+                (long) unreadSalarySlips.size(),
+                buildSalarySlipReminder(CollUtil.getFirst(unreadSalarySlips))));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得我的工资条列表")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<List<HrmPortalSalarySlipRespVO>> getSalarySlipList(
+            @Valid HrmPortalSalarySlipListReqVO reqVO) {
+        // 1.1 获得当前员工和月份范围
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        YearMonth startMonth = reqVO.getStartMonth() == null ? null : YearMonth.parse(reqVO.getStartMonth());
+        YearMonth endMonth = reqVO.getEndMonth() == null ? null : YearMonth.parse(reqVO.getEndMonth());
+        // 1.2 查询工资条列表
+        List<HrmSalarySlipDO> salarySlips = salarySlipService.getSalarySlipListByEmployeeId(
+                employee.getId(), startMonth, endMonth, reqVO.getOrderType(), reqVO.getOrder());
+
+        // 2. 构建工资条响应
+        return success(BeanUtils.toBean(salarySlips, HrmPortalSalarySlipRespVO.class));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得我的工资条详情")
+    @Parameter(name = "id", description = "工资条编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<HrmPortalSalarySlipRespVO> getSalarySlip(@RequestParam("id") Long id) {
+        // 1. 获得当前员工，并校验工资条归属本人
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        HrmSalarySlipDO salarySlip = salarySlipService.getSalarySlipByIdAndEmployeeId(id, employee.getId());
+        // 2. 构建工资条响应
+        return success(BeanUtils.toBean(salarySlip, HrmPortalSalarySlipRespVO.class));
+    }
+
+    @PutMapping("/read")
+    @Operation(summary = "标记我的工资条为已读")
+    @Parameter(name = "ids", description = "工资条编号列表", required = true, example = "1024,1025")
+    @PreAuthorize("@ss.hasPermission('hrm:portal:query')")
+    public CommonResult<Boolean> markSalarySlipRead(
+            @RequestParam("ids") @NotEmpty(message = "工资条编号列表不能为空") List<Long> ids) {
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(getLoginUserId());
+        salarySlipService.markSalarySlipListRead(employee.getId(), ids);
+        return success(true);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    /**
+     * 构建最新未读工资条提醒
+     *
+     * @param salarySlip 工资条
+     * @return 工资条提醒
+     */
+    private String buildSalarySlipReminder(HrmSalarySlipDO salarySlip) {
+        if (salarySlip == null) {
+            return null;
+        }
+        String creator = salarySlip.getCreator();
+        String publisherName = StrUtil.blankToDefault(creator, "HR");
+        if (StrUtil.isNotBlank(creator) && StrUtil.isNumeric(creator)) {
+            AdminUserRespDTO user = adminUserApi.getUser(Long.valueOf(creator));
+            publisherName = user == null ? "HR" : user.getNickname();
+        }
+        return publisherName + "更新了您" + salarySlip.getMonth() + "月的工资条，前往查看";
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipListReqVO.java
new file mode 100644
index 0000000..9c3ea7e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipListReqVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.salary.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Pattern;
+import lombok.Data;
+import org.hibernate.validator.constraints.Range;
+
+@Schema(description = "管理后台 - HRM 员工端工资条列表 Request VO")
+@Data
+public class HrmPortalSalarySlipListReqVO {
+
+    @Schema(description = "开始月份", example = "2026-01")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "开始月份格式必须为 yyyy-MM")
+    private String startMonth;
+
+    @Schema(description = "结束月份", example = "2026-12")
+    @Pattern(regexp = "\\d{4}-(0[1-9]|1[0-2])", message = "结束月份格式必须为 yyyy-MM")
+    private String endMonth;
+
+    @Schema(description = "排序类型", example = "1")
+    @Range(min = 1, max = 2, message = "排序类型必须在 1 到 2 之间")
+    private Integer orderType;
+
+    @Schema(description = "排序方向", example = "1")
+    @Range(min = 1, max = 2, message = "排序方向必须在 1 到 2 之间")
+    private Integer order;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipOptionRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipOptionRespVO.java
new file mode 100644
index 0000000..7e88b8a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipOptionRespVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.salary.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端工资条项 Response VO")
+@Data
+public class HrmPortalSalarySlipOptionRespVO {
+
+    @Schema(description = "员工端薪资工资条选项名称")
+    private String name;
+
+    @Schema(description = "员工端薪资工资条选项类型")
+    private Integer type;
+
+    @Schema(description = "编码")
+    private Integer code;
+
+    @Schema(description = "值")
+    private BigDecimal value;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "排序")
+    private Integer sort;
+
+    @Schema(description = "子工资条项")
+    private List<HrmPortalSalarySlipOptionRespVO> children;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipRespVO.java
new file mode 100644
index 0000000..ad85104
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipRespVO.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.salary.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工端工资条 Response VO")
+@Data
+public class HrmPortalSalarySlipRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "工资条记录编号")
+    private Long sendRecordId;
+
+    @Schema(description = "员工工资记录编号")
+    private Long monthEmployeeRecordId;
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "已读状态")
+    private Integer readStatus;
+
+    @Schema(description = "实际工资")
+    private BigDecimal realPaySalary;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "选项列表")
+    private List<HrmPortalSalarySlipOptionRespVO> options;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipUnreadSummaryRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipUnreadSummaryRespVO.java
new file mode 100644
index 0000000..a3281c9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/portal/salary/vo/HrmPortalSalarySlipUnreadSummaryRespVO.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.portal.salary.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - HRM 员工端未读工资条概况 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmPortalSalarySlipUnreadSummaryRespVO {
+
+    @Schema(description = "未读工资条数量", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Long unreadCount;
+
+    @Schema(description = "最新未读工资条提醒")
+    private String reminder;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitCandidateController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitCandidateController.java
new file mode 100644
index 0000000..e5794db
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitCandidateController.java
@@ -0,0 +1,259 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.NumberUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.HrmRecruitStatusCountRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateChannelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateCleanReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateEliminateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdatePostReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitInterviewService;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getFirst;
+
+@Tag(name = "管理后台 - HRM 招聘候选人")
+@RestController
+@RequestMapping("/hrm/recruit/candidate")
+@Validated
+public class HrmRecruitCandidateController {
+
+    @Resource
+    private HrmRecruitCandidateService recruitCandidateService;
+    @Resource
+    private HrmRecruitPostService recruitPostService;
+    @Resource
+    private HrmRecruitChannelService recruitChannelService;
+    @Resource
+    private HrmRecruitInterviewService recruitInterviewService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+    @Resource
+    private AdminUserApi adminUserApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建招聘候选人")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:create')")
+    public CommonResult<Long> createRecruitCandidate(@Valid @RequestBody HrmRecruitCandidateSaveReqVO createReqVO) {
+        return success(recruitCandidateService.createRecruitCandidate(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新招聘候选人")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:update')")
+    public CommonResult<Boolean> updateRecruitCandidate(@Valid @RequestBody HrmRecruitCandidateSaveReqVO updateReqVO) {
+        recruitCandidateService.updateRecruitCandidate(updateReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/update-status")
+    @Operation(summary = "更新招聘候选人状态")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:update')")
+    public CommonResult<Boolean> updateRecruitCandidateStatus(@Valid @RequestBody HrmRecruitCandidateUpdateStatusReqVO reqVO) {
+        recruitCandidateService.updateRecruitCandidateStatus(reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/update-post")
+    @Operation(summary = "更新招聘候选人应聘职位")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:update')")
+    public CommonResult<Boolean> updateRecruitCandidatePost(@Valid @RequestBody HrmRecruitCandidateUpdatePostReqVO reqVO) {
+        recruitCandidateService.updateRecruitCandidatePost(reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/update-channel")
+    @Operation(summary = "更新招聘候选人渠道")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:update')")
+    public CommonResult<Boolean> updateRecruitCandidateChannel(
+            @Valid @RequestBody HrmRecruitCandidateUpdateChannelReqVO reqVO) {
+        recruitCandidateService.updateRecruitCandidateChannel(reqVO);
+        return success(true);
+    }
+
+    @PutMapping("/eliminate")
+    @Operation(summary = "淘汰招聘候选人")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:update')")
+    public CommonResult<Boolean> eliminateRecruitCandidate(@Valid @RequestBody HrmRecruitCandidateUpdateEliminateReqVO reqVO) {
+        recruitCandidateService.eliminateRecruitCandidate(reqVO);
+        return success(true);
+    }
+
+    @PostMapping("/convert-employee")
+    @Operation(summary = "候选人转员工档案")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:update')")
+    public CommonResult<Long> convertRecruitCandidateToEmployee(
+            @Valid @RequestBody HrmRecruitCandidateEntryReqVO reqVO) {
+        return success(recruitCandidateService.convertRecruitCandidateToEmployee(reqVO));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除招聘候选人")
+    @Parameter(name = "id", description = "候选人编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:delete')")
+    public CommonResult<Boolean> deleteRecruitCandidate(@RequestParam("id") Long id) {
+        recruitCandidateService.deleteRecruitCandidate(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得招聘候选人")
+    @Parameter(name = "id", description = "候选人编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:query')")
+    public CommonResult<HrmRecruitCandidateRespVO> getRecruitCandidate(@RequestParam("id") Long id) {
+        return success(buildRecruitCandidateRespVO(recruitCandidateService.getRecruitCandidate(id)));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得招聘候选人分页")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:query')")
+    public CommonResult<PageResult<HrmRecruitCandidateRespVO>> getRecruitCandidatePage(
+            @Validated HrmRecruitCandidatePageReqVO pageReqVO) {
+        PageResult<HrmRecruitCandidateDO> pageResult = recruitCandidateService.getRecruitCandidatePage(pageReqVO);
+        return success(new PageResult<>(buildRecruitCandidateRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/clean-ids")
+    @Operation(summary = "获得待清理候选人编号")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:delete')")
+    public CommonResult<List<Long>> getCleanRecruitCandidateIdList(@Valid HrmRecruitCandidateCleanReqVO reqVO) {
+        List<HrmRecruitCandidateDO> list = recruitCandidateService.getRecruitCandidateList(
+                reqVO.getStatuses(), LocalDateTime.now().minusDays(reqVO.getDays()));
+        return success(convertList(list, HrmRecruitCandidateDO::getId));
+    }
+
+    @GetMapping("/status-count")
+    @Operation(summary = "获得候选人状态数量")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:candidate:query')")
+    public CommonResult<List<HrmRecruitStatusCountRespVO>> getRecruitCandidateStatusCount(
+            @Validated HrmRecruitCandidatePageReqVO pageReqVO) {
+        Map<Integer, Long> countMap = recruitCandidateService.getRecruitCandidateStatusCount(pageReqVO);
+        return success(convertList(Arrays.asList(HrmRecruitCandidateStatusEnum.values()),
+                status -> new HrmRecruitStatusCountRespVO(status.getStatus(),
+                        countMap.getOrDefault(status.getStatus(), 0L))));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmRecruitCandidateRespVO buildRecruitCandidateRespVO(HrmRecruitCandidateDO recruitCandidate) {
+        if (recruitCandidate == null) {
+            return null;
+        }
+        return getFirst(buildRecruitCandidateRespVOList(Collections.singletonList(recruitCandidate)));
+    }
+
+    private List<HrmRecruitCandidateRespVO> buildRecruitCandidateRespVOList(List<HrmRecruitCandidateDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1.1 招聘职位、部门和招聘渠道信息
+        Map<Long, HrmRecruitPostDO> recruitPostMap = recruitPostService.getRecruitPostMap(
+                convertSet(list, HrmRecruitCandidateDO::getPostId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(recruitPostMap.values(), HrmRecruitPostDO::getDeptId));
+        Map<Long, HrmRecruitChannelDO> recruitChannelMap = recruitChannelService.getRecruitChannelMap(
+                convertSet(list, HrmRecruitCandidateDO::getChannelId));
+        // 1.2 当前面试和员工信息
+        Set<Long> candidateIds = convertSet(list, HrmRecruitCandidateDO::getId);
+        Map<Long, HrmRecruitInterviewDO> recruitInterviewMap = recruitInterviewService
+                .getLatestRecruitInterviewMapByCandidateIds(candidateIds);
+        Set<Long> employeeIds = convertSet(recruitPostMap.values(), HrmRecruitPostDO::getOwnerEmployeeId);
+        employeeIds.addAll(convertSet(recruitInterviewMap.values(), HrmRecruitInterviewDO::getInterviewEmployeeId));
+        employeeIds.addAll(convertSetByFlatMap(recruitInterviewMap.values(),
+                HrmRecruitInterviewDO::getOtherInterviewEmployeeIds,
+                Collection::stream));
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        Map<Long, HrmEmployeeDO> candidateEmployeeMap = employeeService.getEmployeeMapByCandidateIds(candidateIds);
+        // 1.3 创建人信息
+        Map<Long, AdminUserRespDTO> userMap = adminUserApi.getUserMap(
+                convertSet(list, candidate -> NumberUtil.parseLong(candidate.getCreator())));
+
+        // 2. 拼接响应
+        return BeanUtils.toBean(list, HrmRecruitCandidateRespVO.class, vo -> {
+            // 2.1 拼接招聘职位、部门和招聘渠道信息
+            MapUtils.findAndThen(recruitPostMap, vo.getPostId(), post -> {
+                vo.setPostName(post.getPostName()).setPostStatus(post.getStatus())
+                        .setDeptId(post.getDeptId()).setOwnerEmployeeId(post.getOwnerEmployeeId());
+                MapUtils.findAndThen(deptMap, post.getDeptId(), dept -> vo.setDeptName(dept.getName()));
+                MapUtils.findAndThen(employeeMap, post.getOwnerEmployeeId(),
+                        employee -> vo.setOwnerEmployeeName(employee.getName()));
+            });
+            MapUtils.findAndThen(recruitChannelMap, vo.getChannelId(),
+                    channel -> vo.setChannelName(channel.getName()));
+            // 2.2 拼接面试信息
+            if (HrmRecruitCandidateStatusEnum.INTERVIEW_RELATED_STATUSES.contains(vo.getStatus())) {
+                MapUtils.findAndThen(recruitInterviewMap, vo.getId(), interview -> {
+                    vo.setInterviewId(interview.getId()).setInterviewType(interview.getType())
+                            .setInterviewEmployeeId(interview.getInterviewEmployeeId())
+                            .setOtherInterviewEmployeeIds(interview.getOtherInterviewEmployeeIds())
+                            .setInterviewTime(interview.getInterviewTime()).setInterviewAddress(interview.getAddress())
+                            .setInterviewResult(interview.getResult())
+                            .setOtherInterviewEmployeeNames(convertList(
+                                    convertList(interview.getOtherInterviewEmployeeIds(), employeeMap::get),
+                                    HrmEmployeeDO::getName));
+                    MapUtils.findAndThen(employeeMap, interview.getInterviewEmployeeId(),
+                            employee -> vo.setInterviewEmployeeName(employee.getName()));
+                });
+            } else {
+                vo.setStageNumber(0);
+            }
+            // 2.3 拼接员工和创建人信息
+            MapUtils.findAndThen(candidateEmployeeMap, vo.getId(), employee -> vo.setEmployeeId(employee.getId()));
+            MapUtils.findAndThen(userMap, NumberUtil.parseLong(vo.getCreator()),
+                    creator -> vo.setCreatorName(creator.getNickname()));
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitChannelController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitChannelController.java
new file mode 100644
index 0000000..d45f827
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitChannelController.java
@@ -0,0 +1,99 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelDeleteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - HRM 招聘渠道")
+@RestController
+@RequestMapping("/hrm/recruit/channel")
+@Validated
+public class HrmRecruitChannelController {
+
+    @Resource
+    private HrmRecruitChannelService recruitChannelService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建招聘渠道")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:channel:create')")
+    public CommonResult<Long> createRecruitChannel(@Valid @RequestBody HrmRecruitChannelSaveReqVO createReqVO) {
+        return success(recruitChannelService.createRecruitChannel(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新招聘渠道")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:channel:update')")
+    public CommonResult<Boolean> updateRecruitChannel(@Valid @RequestBody HrmRecruitChannelSaveReqVO updateReqVO) {
+        recruitChannelService.updateRecruitChannel(updateReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/update-status")
+    @Operation(summary = "更新招聘渠道状态")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:channel:update')")
+    public CommonResult<Boolean> updateRecruitChannelStatus(
+            @Valid @RequestBody HrmRecruitChannelStatusReqVO statusReqVO) {
+        recruitChannelService.updateRecruitChannelStatus(statusReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除招聘渠道")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:channel:delete')")
+    public CommonResult<Boolean> deleteRecruitChannel(@Valid @RequestBody HrmRecruitChannelDeleteReqVO deleteReqVO) {
+        recruitChannelService.deleteRecruitChannel(deleteReqVO);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得招聘渠道")
+    @Parameter(name = "id", description = "招聘渠道编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:channel:query')")
+    public CommonResult<HrmRecruitChannelRespVO> getRecruitChannel(@RequestParam("id") Long id) {
+        HrmRecruitChannelDO recruitChannel = recruitChannelService.getRecruitChannel(id);
+        return success(BeanUtils.toBean(recruitChannel, HrmRecruitChannelRespVO.class));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得招聘渠道分页")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:channel:query')")
+    public CommonResult<PageResult<HrmRecruitChannelRespVO>> getRecruitChannelPage(@Validated HrmRecruitChannelPageReqVO pageReqVO) {
+        PageResult<HrmRecruitChannelDO> pageResult = recruitChannelService.getRecruitChannelPage(pageReqVO);
+        return success(BeanUtils.toBean(pageResult, HrmRecruitChannelRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得招聘渠道精简列表", description = "用于招聘职位、候选人等表单的下拉选项")
+    public CommonResult<List<HrmRecruitChannelRespVO>> getRecruitChannelSimpleList() {
+        return success(convertList(recruitChannelService.getRecruitChannelSimpleList(), channel ->
+                new HrmRecruitChannelRespVO().setId(channel.getId()).setName(channel.getName()).setStatus(channel.getStatus())));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitConfigController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitConfigController.java
new file mode 100644
index 0000000..f50147d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitConfigController.java
@@ -0,0 +1,48 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.config.HrmRecruitEliminateReasonSaveReqVO;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitConfigService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 招聘设置")
+@RestController
+@RequestMapping("/hrm/recruit/config")
+@Validated
+public class HrmRecruitConfigController {
+
+    @Resource
+    private HrmRecruitConfigService recruitConfigService;
+
+    @PostMapping("/eliminate-reason/save")
+    @Operation(summary = "保存招聘淘汰原因")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:config:update')")
+    public CommonResult<Boolean> saveRecruitEliminateReason(
+            @Valid @RequestBody HrmRecruitEliminateReasonSaveReqVO saveReqVO) {
+        recruitConfigService.saveRecruitEliminateReason(saveReqVO);
+        return success(true);
+    }
+
+    @GetMapping("/eliminate-reason/list")
+    @Operation(summary = "获得招聘淘汰原因列表")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:config:query') "
+            + "or @ss.hasPermission('hrm:recruit:candidate:update')")
+    public CommonResult<List<String>> getRecruitEliminateReasonList() {
+        return success(recruitConfigService.getRecruitEliminateReasonList());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitInterviewController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitInterviewController.java
new file mode 100644
index 0000000..17257ac
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitInterviewController.java
@@ -0,0 +1,132 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewResultReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitInterviewService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getFirst;
+
+@Tag(name = "管理后台 - HRM 招聘面试")
+@RestController
+@RequestMapping("/hrm/recruit/interview")
+@Validated
+public class HrmRecruitInterviewController {
+
+    @Resource
+    private HrmRecruitInterviewService recruitInterviewService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建招聘面试")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:interview:create')")
+    public CommonResult<Long> createRecruitInterview(@Valid @RequestBody HrmRecruitInterviewSaveReqVO createReqVO) {
+        return success(recruitInterviewService.createRecruitInterview(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新招聘面试")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:interview:update')")
+    public CommonResult<Boolean> updateRecruitInterview(@Valid @RequestBody HrmRecruitInterviewSaveReqVO updateReqVO) {
+        recruitInterviewService.updateRecruitInterview(updateReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/update-result")
+    @Operation(summary = "更新招聘面试结果")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:interview:update')")
+    public CommonResult<Boolean> updateRecruitInterviewResult(@Valid @RequestBody HrmRecruitInterviewResultReqVO reqVO) {
+        recruitInterviewService.updateRecruitInterviewResult(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除招聘面试")
+    @Parameter(name = "id", description = "面试编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:interview:delete')")
+    public CommonResult<Boolean> deleteRecruitInterview(@RequestParam("id") Long id) {
+        recruitInterviewService.deleteRecruitInterview(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得招聘面试")
+    @Parameter(name = "id", description = "面试编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:interview:query')")
+    public CommonResult<HrmRecruitInterviewRespVO> getRecruitInterview(@RequestParam("id") Long id) {
+        return success(buildRecruitInterviewRespVO(recruitInterviewService.getRecruitInterview(id)));
+    }
+
+    @GetMapping("/list-by-candidate")
+    @Operation(summary = "获得候选人的招聘面试列表")
+    @Parameter(name = "candidateId", description = "候选人编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:interview:query')")
+    public CommonResult<List<HrmRecruitInterviewRespVO>> getRecruitInterviewListByCandidate(
+            @RequestParam("candidateId") Long candidateId) {
+        return success(buildRecruitInterviewRespVOList(
+                recruitInterviewService.getRecruitInterviewListByCandidateId(candidateId)));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmRecruitInterviewRespVO buildRecruitInterviewRespVO(HrmRecruitInterviewDO recruitInterview) {
+        if (recruitInterview == null) {
+            return null;
+        }
+        return getFirst(buildRecruitInterviewRespVOList(Collections.singletonList(recruitInterview)));
+    }
+
+    private List<HrmRecruitInterviewRespVO> buildRecruitInterviewRespVOList(List<HrmRecruitInterviewDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1. 获得面试官信息
+        Set<Long> employeeIds = convertSet(list, HrmRecruitInterviewDO::getInterviewEmployeeId);
+        employeeIds.addAll(convertSetByFlatMap(list, HrmRecruitInterviewDO::getOtherInterviewEmployeeIds,
+                Collection::stream));
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+
+        // 2. 拼接响应
+        return BeanUtils.toBean(list, HrmRecruitInterviewRespVO.class, vo -> {
+            MapUtils.findAndThen(employeeMap, vo.getInterviewEmployeeId(),
+                    employee -> vo.setInterviewEmployeeName(employee.getName()));
+            vo.setOtherInterviewEmployeeNames(convertList(
+                    convertList(vo.getOtherInterviewEmployeeIds(), employeeMap::get),
+                    HrmEmployeeDO::getName));
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitPostController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitPostController.java
new file mode 100644
index 0000000..2251e2a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitPostController.java
@@ -0,0 +1,181 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.HrmRecruitStatusCountRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostTypeDO;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostService;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostTypeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getFirst;
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 招聘职位")
+@RestController
+@RequestMapping("/hrm/recruit/post")
+@Validated
+public class HrmRecruitPostController {
+
+    @Resource
+    private HrmRecruitPostService recruitPostService;
+    @Resource
+    private HrmRecruitCandidateService recruitCandidateService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmRecruitPostTypeService recruitPostTypeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建招聘职位")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:create')")
+    public CommonResult<Long> createRecruitPost(@Valid @RequestBody HrmRecruitPostSaveReqVO createReqVO) {
+        return success(recruitPostService.createRecruitPost(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新招聘职位")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:update')")
+    public CommonResult<Boolean> updateRecruitPost(@Valid @RequestBody HrmRecruitPostSaveReqVO updateReqVO) {
+        recruitPostService.updateRecruitPost(updateReqVO);
+        return success(true);
+    }
+
+    @PutMapping("/update-status")
+    @Operation(summary = "更新招聘职位状态")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:update')")
+    public CommonResult<Boolean> updateRecruitPostStatus(@Valid @RequestBody HrmRecruitPostStatusReqVO reqVO) {
+        recruitPostService.updateRecruitPostStatus(reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得招聘职位")
+    @Parameter(name = "id", description = "招聘职位编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:query')")
+    public CommonResult<HrmRecruitPostRespVO> getRecruitPost(@RequestParam("id") Long id) {
+        return success(buildRecruitPostRespVO(recruitPostService.getRecruitPost(id)));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得招聘职位分页")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:query')")
+    public CommonResult<PageResult<HrmRecruitPostRespVO>> getRecruitPostPage(
+            @Validated HrmRecruitPostPageReqVO pageReqVO) {
+        PageResult<HrmRecruitPostDO> pageResult = recruitPostService.getRecruitPostPage(pageReqVO);
+        return success(new PageResult<>(buildRecruitPostRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得招聘职位精简列表")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:query')")
+    public CommonResult<List<HrmRecruitPostRespVO>> getRecruitPostSimpleList() {
+        return success(convertList(recruitPostService.getRecruitPostSimpleList(), post ->
+                new HrmRecruitPostRespVO().setId(post.getId()).setPostName(post.getPostName())
+                        .setStatus(post.getStatus())));
+    }
+
+    @GetMapping("/status-count")
+    @Operation(summary = "获得招聘职位状态数量")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:query')")
+    public CommonResult<List<HrmRecruitStatusCountRespVO>> getRecruitPostStatusCount(
+            @Validated HrmRecruitPostPageReqVO pageReqVO) {
+        Map<Integer, Long> countMap = recruitPostService.getRecruitPostStatusCount(pageReqVO);
+        return success(convertList(Arrays.asList(HrmRecruitPostStatusEnum.values()),
+                status -> new HrmRecruitStatusCountRespVO(status.getStatus(),
+                        countMap.getOrDefault(status.getStatus(), 0L))));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmRecruitPostRespVO buildRecruitPostRespVO(HrmRecruitPostDO recruitPost) {
+        if (recruitPost == null) {
+            return null;
+        }
+        return getFirst(buildRecruitPostRespVOList(Collections.singletonList(recruitPost)));
+    }
+
+    private List<HrmRecruitPostRespVO> buildRecruitPostRespVOList(List<HrmRecruitPostDO> list) {
+        if (CollUtil.isEmpty(list)) {
+            return Collections.emptyList();
+        }
+        // 1.1 员工信息
+        Set<Long> employeeIds = convertSet(list, HrmRecruitPostDO::getOwnerEmployeeId);
+        employeeIds.addAll(convertSetByFlatMap(list, HrmRecruitPostDO::getInterviewEmployeeIds,
+                Collection::stream));
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        // 1.2 部门信息
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(convertSet(list, HrmRecruitPostDO::getDeptId));
+        // 1.3 职位类型信息
+        Map<Long, HrmRecruitPostTypeDO> postTypeMap = recruitPostTypeService.getRecruitPostTypeMap(
+                convertSet(list, HrmRecruitPostDO::getPostTypeId));
+        // 1.4 已入职人数
+        Map<Long, Long> joinedCountMap = recruitCandidateService.getJoinedCandidateCountMap(
+                convertSet(list, HrmRecruitPostDO::getId));
+        // 2. 拼接响应
+        return BeanUtils.toBean(list, HrmRecruitPostRespVO.class, vo -> {
+            vo.setAreaName(AreaUtils.format(vo.getAreaId()));
+            MapUtils.findAndThen(deptMap, vo.getDeptId(), dept -> vo.setDeptName(dept.getName()));
+            MapUtils.findAndThen(employeeMap, vo.getOwnerEmployeeId(),
+                    employee -> vo.setOwnerEmployeeName(employee.getName()));
+            vo.setInterviewEmployeeNames(convertList(vo.getInterviewEmployeeIds(),
+                    employeeId -> employeeMap.containsKey(employeeId)
+                            ? employeeMap.get(employeeId).getName() : null));
+            MapUtils.findAndThen(postTypeMap, vo.getPostTypeId(),
+                    postType -> vo.setPostTypeName(postType.getName()));
+            fillRecruitPostProgress(vo, joinedCountMap.getOrDefault(vo.getId(), 0L));
+        });
+    }
+
+    private void fillRecruitPostProgress(HrmRecruitPostRespVO recruitPost, Long hasEntryNum) {
+        recruitPost.setHasEntryNum(hasEntryNum);
+        if (recruitPost.getRecruitNum() != null && recruitPost.getRecruitNum() != 0) {
+            recruitPost.setRecruitSchedule(BigDecimal.valueOf(hasEntryNum).multiply(BigDecimal.valueOf(100))
+                    .divide(BigDecimal.valueOf(recruitPost.getRecruitNum()), 2, RoundingMode.HALF_UP));
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitPostTypeController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitPostTypeController.java
new file mode 100644
index 0000000..bd1ad14
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/HrmRecruitPostTypeController.java
@@ -0,0 +1,41 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.type.HrmRecruitPostTypeRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostTypeDO;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostTypeService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 招聘职位类型")
+@RestController
+@RequestMapping("/hrm/recruit/post-type")
+@Validated
+public class HrmRecruitPostTypeController {
+
+    @Resource
+    private HrmRecruitPostTypeService recruitPostTypeService;
+
+    @GetMapping("/list")
+    @Operation(summary = "获得招聘职位类型列表")
+    @Parameter(name = "status", description = "状态", example = "0")
+    @PreAuthorize("@ss.hasPermission('hrm:recruit:post:query')")
+    public CommonResult<List<HrmRecruitPostTypeRespVO>> getRecruitPostTypeList(@RequestParam(value = "status", required = false) Integer status) {
+        List<HrmRecruitPostTypeDO> postTypes = recruitPostTypeService.getRecruitPostTypeList(status);
+        return success(BeanUtils.toBean(postTypes, HrmRecruitPostTypeRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/HrmRecruitStatusCountRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/HrmRecruitStatusCountRespVO.java
new file mode 100644
index 0000000..52f714d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/HrmRecruitStatusCountRespVO.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Schema(description = "管理后台 - HRM 招聘状态数量 Response VO")
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmRecruitStatusCountRespVO {
+
+    @Schema(description = "状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "数量", example = "12")
+    private Long count;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateCleanReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateCleanReqVO.java
new file mode 100644
index 0000000..4ef3fcd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateCleanReqVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Positive;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 招聘候选人清理 Request VO")
+@Data
+public class HrmRecruitCandidateCleanReqVO {
+
+    @Schema(description = "候选人状态数组", requiredMode = Schema.RequiredMode.REQUIRED,
+            example = "[1, 2, 3, 4]")
+    @NotEmpty(message = "候选人状态不能为空")
+    private List<@NotNull(message = "候选人状态不能为空")
+            @InEnum(value = HrmRecruitCandidateStatusEnum.class, message = "候选人状态必须是 {value}") Integer> statuses;
+
+    @Schema(description = "状态持续天数", requiredMode = Schema.RequiredMode.REQUIRED, example = "30")
+    @NotNull(message = "状态持续天数不能为空")
+    @Positive(message = "状态持续天数必须大于 0")
+    private Integer days;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateEntryReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateEntryReqVO.java
new file mode 100644
index 0000000..dc2a7cc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateEntryReqVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 招聘候选人转员工 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmRecruitCandidateEntryReqVO extends HrmEmployeeSaveReqVO {
+
+    @AssertTrue(message = "候选人编号不能为空")
+    @JsonIgnore
+    public boolean isCandidateIdValid() {
+        return getCandidateId() != null;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidatePageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidatePageReqVO.java
new file mode 100644
index 0000000..f84f00b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidatePageReqVO.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 招聘候选人分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmRecruitCandidatePageReqVO extends PageParam {
+
+    @Schema(description = "姓名、手机号码或邮箱，模糊匹配", example = "张三")
+    private String search;
+
+    @Schema(description = "职位编号", example = "1024")
+    private Long postId;
+
+    @Schema(description = "招聘负责人员工编号", example = "1")
+    private Long ownerEmployeeId;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "最小年龄", example = "20")
+    private Integer minAge;
+
+    @Schema(description = "最大年龄", example = "35")
+    private Integer maxAge;
+
+    @Schema(description = "最小工作年限", example = "1")
+    private Integer minWorkTime;
+
+    @Schema(description = "最大工作年限", example = "5")
+    private Integer maxWorkTime;
+
+    @Schema(description = "学历", example = "5")
+    private Integer education;
+
+    @Schema(description = "毕业院校，模糊匹配", example = "浙江大学")
+    private String graduateSchool;
+
+    @Schema(description = "最近工作单位，模糊匹配", example = "某科技公司")
+    private String latestWorkPlace;
+
+    @Schema(description = "渠道编号", example = "1")
+    private Long channelId;
+
+    @Schema(description = "面试官员工编号", example = "1")
+    private Long interviewEmployeeId;
+
+    @Schema(description = "面试时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] interviewTime;
+
+    @Schema(description = "创建人用户编号", example = "1")
+    private Long creator;
+
+    @Schema(description = "候选人状态", example = "1")
+    @InEnum(value = HrmRecruitCandidateStatusEnum.class, message = "候选人状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateRespVO.java
new file mode 100644
index 0000000..16f22fb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateRespVO.java
@@ -0,0 +1,135 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.experimental.Accessors;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 招聘候选人 Response VO")
+@Data
+@Accessors(chain = true)
+public class HrmRecruitCandidateRespVO {
+
+    @Schema(description = "候选人编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "候选人姓名", example = "张三")
+    private String name;
+
+    @Schema(description = "手机号码", example = "15601691399")
+    private String mobile;
+
+    @Schema(description = "性别", example = "1")
+    private Integer sex;
+
+    @Schema(description = "年龄", example = "28")
+    private Integer age;
+
+    @Schema(description = "邮箱", example = "candidate@example.com")
+    private String email;
+
+    @Schema(description = "应聘职位编号", example = "1024")
+    private Long postId;
+
+    @Schema(description = "应聘职位名称", example = "Java 开发工程师")
+    private String postName;
+
+    @Schema(description = "应聘职位状态", example = "1")
+    private Integer postStatus;
+
+    @Schema(description = "用人部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "用人部门名称", example = "研发部")
+    private String deptName;
+
+    @Schema(description = "招聘负责人员工编号", example = "1")
+    private Long ownerEmployeeId;
+
+    @Schema(description = "招聘负责人姓名", example = "李四")
+    private String ownerEmployeeName;
+
+    @Schema(description = "面试轮次", example = "1")
+    private Integer stageNumber;
+
+    @Schema(description = "工作年限", example = "5")
+    private Integer workTime;
+
+    @Schema(description = "学历", example = "5")
+    private Integer education;
+
+    @Schema(description = "毕业院校", example = "浙江大学")
+    private String graduateSchool;
+
+    @Schema(description = "最近工作单位", example = "某科技公司")
+    private String latestWorkPlace;
+
+    @Schema(description = "招聘渠道编号", example = "1")
+    private Long channelId;
+
+    @Schema(description = "招聘渠道名称", example = "BOSS 直聘")
+    private String channelName;
+
+    @Schema(description = "备注", example = "沟通意向强")
+    private String remark;
+
+    @Schema(description = "候选人状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "淘汰原因", example = "技能不匹配")
+    private String eliminate;
+
+    @Schema(description = "状态更新时间")
+    private LocalDateTime statusUpdateTime;
+
+    @Schema(description = "入职时间")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "简历附件地址数组", example = "[\"https://example.com/resume.pdf\"]")
+    private List<String> resumeUrls;
+
+    @Schema(description = "当前面试编号", example = "1024")
+    private Long interviewId;
+
+    @Schema(description = "面试方式", example = "3")
+    private Integer interviewType;
+
+    @Schema(description = "主面试官员工编号", example = "1")
+    private Long interviewEmployeeId;
+
+    @Schema(description = "主面试官姓名", example = "王五")
+    private String interviewEmployeeName;
+
+    @Schema(description = "其他面试官员工编号数组", example = "[2, 3]")
+    private List<Long> otherInterviewEmployeeIds;
+
+    @Schema(description = "其他面试官姓名数组", example = "[\"赵六\", \"钱七\"]")
+    private List<String> otherInterviewEmployeeNames;
+
+    @Schema(description = "面试时间")
+    private LocalDateTime interviewTime;
+
+    @Schema(description = "面试地址", example = "上海市浦东新区")
+    private String interviewAddress;
+
+    @Schema(description = "面试结果", example = "1")
+    private Integer interviewResult;
+
+    @Schema(description = "转入的员工编号", example = "100")
+    private Long employeeId;
+
+    @Schema(description = "创建人", example = "1")
+    private String creator;
+
+    @Schema(description = "创建人名称", example = "管理员")
+    private String creatorName;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+    @Schema(description = "更新时间")
+    private LocalDateTime updateTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateSaveReqVO.java
new file mode 100644
index 0000000..796f19c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateSaveReqVO.java
@@ -0,0 +1,93 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Email;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Pattern;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 招聘候选人新增/修改 Request VO")
+@Data
+public class HrmRecruitCandidateSaveReqVO {
+
+    @Schema(description = "候选人编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "候选人姓名", requiredMode = Schema.RequiredMode.REQUIRED, example = "张三")
+    @NotBlank(message = "候选人姓名不能为空")
+    @Size(max = 255, message = "候选人姓名长度不能超过 255 个字符")
+    @DiffLogField(name = "候选人姓名")
+    private String name;
+
+    @Schema(description = "手机号码", requiredMode = Schema.RequiredMode.REQUIRED, example = "15601691399")
+    @NotBlank(message = "手机号码不能为空")
+    @Size(max = 18, message = "手机号码长度不能超过 18 个字符")
+    @Pattern(regexp = "^(\\+?0?\\d{2,4}-?)?\\d{6,11}$", message = "手机号码格式不正确")
+    @DiffLogField(name = "手机号码")
+    private String mobile;
+
+    @Schema(description = "性别", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "性别不能为空")
+    @DiffLogField(name = "性别")
+    private Integer sex;
+
+    @Schema(description = "年龄", example = "28")
+    @Min(value = 0, message = "年龄不能小于 0")
+    @Max(value = 99, message = "年龄不能大于 99")
+    @DiffLogField(name = "年龄")
+    private Integer age;
+
+    @Schema(description = "邮箱", example = "candidate@example.com")
+    @Email(message = "邮箱格式不正确")
+    @Size(max = 255, message = "邮箱长度不能超过 255 个字符")
+    @DiffLogField(name = "邮箱")
+    private String email;
+
+    @Schema(description = "应聘职位编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "应聘职位不能为空")
+    @DiffLogField(name = "应聘职位")
+    private Long postId;
+
+    @Schema(description = "工作年限", example = "5")
+    @Min(value = 0, message = "工作年限不能小于 0")
+    @Max(value = 60, message = "工作年限不能大于 60")
+    @DiffLogField(name = "工作年限")
+    private Integer workTime;
+
+    @Schema(description = "学历", requiredMode = Schema.RequiredMode.REQUIRED, example = "5")
+    @NotNull(message = "学历不能为空")
+    @DiffLogField(name = "学历")
+    private Integer education;
+
+    @Schema(description = "毕业院校", example = "浙江大学")
+    @Size(max = 255, message = "毕业院校长度不能超过 255 个字符")
+    @DiffLogField(name = "毕业院校")
+    private String graduateSchool;
+
+    @Schema(description = "最近工作单位", example = "某科技公司")
+    @Size(max = 255, message = "最近工作单位长度不能超过 255 个字符")
+    @DiffLogField(name = "最近工作单位")
+    private String latestWorkPlace;
+
+    @Schema(description = "招聘渠道编号", example = "1")
+    @DiffLogField(name = "招聘渠道")
+    private Long channelId;
+
+    @Schema(description = "备注", example = "沟通意向强")
+    @Size(max = 255, message = "备注长度不能超过 255 个字符")
+    @DiffLogField(name = "备注")
+    private String remark;
+
+    @Schema(description = "简历附件地址数组", example = "[\"https://example.com/resume.pdf\"]")
+    @Size(max = 5, message = "简历附件不能超过 5 个")
+    @DiffLogField(name = "简历附件")
+    private List<@Size(max = 512, message = "简历附件地址长度不能超过 512 个字符") String> resumeUrls;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateChannelReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateChannelReqVO.java
new file mode 100644
index 0000000..9b1443c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateChannelReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘候选人渠道修改 Request VO")
+@Data
+public class HrmRecruitCandidateUpdateChannelReqVO {
+
+    @Schema(description = "候选人编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "候选人编号不能为空")
+    private Long id;
+
+    @Schema(description = "招聘渠道编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "招聘渠道编号不能为空")
+    private Long channelId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateEliminateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateEliminateReqVO.java
new file mode 100644
index 0000000..e1da481
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateEliminateReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘候选人淘汰 Request VO")
+@Data
+public class HrmRecruitCandidateUpdateEliminateReqVO {
+
+    @Schema(description = "候选人编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "候选人编号不能为空")
+    private Long id;
+
+    @Schema(description = "淘汰原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "技能不匹配")
+    @NotBlank(message = "淘汰原因不能为空")
+    @Size(max = 255, message = "淘汰原因长度不能超过 255 个字符")
+    private String eliminate;
+
+    @Schema(description = "备注", example = "二面未通过")
+    @Size(max = 255, message = "备注长度不能超过 255 个字符")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdatePostReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdatePostReqVO.java
new file mode 100644
index 0000000..d756236
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdatePostReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘候选人职位修改 Request VO")
+@Data
+public class HrmRecruitCandidateUpdatePostReqVO {
+
+    @Schema(description = "候选人编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "候选人编号不能为空")
+    private Long id;
+
+    @Schema(description = "职位编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "2048")
+    @NotNull(message = "职位编号不能为空")
+    private Long postId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateStatusReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateStatusReqVO.java
new file mode 100644
index 0000000..850b84e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/candidate/HrmRecruitCandidateUpdateStatusReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘候选人状态修改 Request VO")
+@Data
+public class HrmRecruitCandidateUpdateStatusReqVO {
+
+    @Schema(description = "候选人编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "候选人编号不能为空")
+    private Long id;
+
+    @Schema(description = "候选人状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "候选人状态不能为空")
+    @InEnum(value = HrmRecruitCandidateStatusEnum.class, message = "候选人状态必须是 {value}")
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelDeleteReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelDeleteReqVO.java
new file mode 100644
index 0000000..888380a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelDeleteReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘渠道删除 Request VO")
+@Data
+public class HrmRecruitChannelDeleteReqVO {
+
+    @Schema(description = "待删除招聘渠道编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "待删除招聘渠道编号不能为空")
+    private Long id;
+
+    @Schema(description = "承接招聘渠道编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1025")
+    @NotNull(message = "承接招聘渠道编号不能为空")
+    private Long transferChannelId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelPageReqVO.java
new file mode 100644
index 0000000..a6e1f8d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelPageReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 招聘渠道分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmRecruitChannelPageReqVO extends PageParam {
+
+    @Schema(description = "渠道名称，模糊匹配", example = "BOSS")
+    private String name;
+
+    @Schema(description = "状态", example = "0")
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelRespVO.java
new file mode 100644
index 0000000..ccbd668
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelRespVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 招聘渠道 Response VO")
+@Data
+public class HrmRecruitChannelRespVO {
+
+    @Schema(description = "招聘渠道编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "是否系统内置", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    private Boolean systemFlag;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    private Integer status;
+
+    @Schema(description = "渠道名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "BOSS 直聘")
+    private String name;
+
+    @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    private Integer sort;
+
+    @Schema(description = "备注", example = "常用渠道")
+    private String remark;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelSaveReqVO.java
new file mode 100644
index 0000000..baadd03
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelSaveReqVO.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘渠道新增/修改 Request VO")
+@Data
+public class HrmRecruitChannelSaveReqVO {
+
+    @Schema(description = "招聘渠道编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "渠道名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "BOSS 直聘")
+    @NotBlank(message = "渠道名称不能为空")
+    @Size(max = 255, message = "渠道名称不能超过 255 个字符")
+    @DiffLogField(name = "渠道名称")
+    private String name;
+
+    @Schema(description = "显示顺序", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @NotNull(message = "显示顺序不能为空")
+    @Min(value = 0, message = "显示顺序不能小于 0")
+    @DiffLogField(name = "显示顺序")
+    private Integer sort;
+
+    @Schema(description = "备注", example = "常用渠道")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    @DiffLogField(name = "备注")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelStatusReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelStatusReqVO.java
new file mode 100644
index 0000000..e09122c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/channel/HrmRecruitChannelStatusReqVO.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘渠道状态修改 Request VO")
+@Data
+public class HrmRecruitChannelStatusReqVO {
+
+    @Schema(description = "招聘渠道编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "招聘渠道编号不能为空")
+    private Long id;
+
+    @Schema(description = "状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "状态不能为空")
+    @InEnum(value = CommonStatusEnum.class, message = "状态必须是 {value}")
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/config/HrmRecruitEliminateReasonSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/config/HrmRecruitEliminateReasonSaveReqVO.java
new file mode 100644
index 0000000..dfc0dc5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/config/HrmRecruitEliminateReasonSaveReqVO.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.config;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 招聘淘汰原因保存 Request VO")
+@Data
+public class HrmRecruitEliminateReasonSaveReqVO {
+
+    @Schema(description = "淘汰原因列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "淘汰原因不能为空")
+    @DiffLogField(name = "淘汰原因")
+    private List<@NotBlank(message = "淘汰原因不能为空") String> reasons;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewRespVO.java
new file mode 100644
index 0000000..7cbb6c3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewRespVO.java
@@ -0,0 +1,58 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 招聘面试 Response VO")
+@Data
+public class HrmRecruitInterviewRespVO {
+
+    @Schema(description = "面试编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "候选人编号", example = "1024")
+    private Long candidateId;
+
+    @Schema(description = "面试方式", example = "1")
+    private Integer type;
+
+    @Schema(description = "面试轮次", example = "1")
+    private Integer stageNumber;
+
+    @Schema(description = "主面试官员工编号", example = "1")
+    private Long interviewEmployeeId;
+
+    @Schema(description = "主面试官姓名", example = "张三")
+    private String interviewEmployeeName;
+
+    @Schema(description = "其他面试官员工编号数组", example = "[2, 3]")
+    private List<Long> otherInterviewEmployeeIds;
+
+    @Schema(description = "其他面试官姓名数组", example = "[\"李四\", \"王五\"]")
+    private List<String> otherInterviewEmployeeNames;
+
+    @Schema(description = "面试时间")
+    private LocalDateTime interviewTime;
+
+    @Schema(description = "面试地址", example = "上海会议室 A")
+    private String address;
+
+    @Schema(description = "备注", example = "请带作品集")
+    private String remark;
+
+    @Schema(description = "面试结果", example = "1")
+    private Integer result;
+
+    @Schema(description = "评价")
+    private String evaluate;
+
+    @Schema(description = "取消原因")
+    private String cancelReason;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewResultReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewResultReqVO.java
new file mode 100644
index 0000000..90d4b10
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewResultReqVO.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview;
+
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.equalsAny;
+
+@Schema(description = "管理后台 - HRM 招聘面试结果 Request VO")
+@Data
+public class HrmRecruitInterviewResultReqVO {
+
+    @Schema(description = "面试编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "面试编号不能为空")
+    private Long id;
+
+    @Schema(description = "面试结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "2")
+    @NotNull(message = "面试结果不能为空")
+    private Integer result;
+
+    @Schema(description = "评价", example = "基础扎实")
+    @Size(max = 255, message = "评价长度不能超过 255 个字符")
+    private String evaluate;
+
+    @Schema(description = "取消原因", example = "候选人临时改期")
+    @Size(max = 255, message = "取消原因长度不能超过 255 个字符")
+    private String cancelReason;
+
+    @AssertTrue(message = "面试结果必须是通过、未通过或取消")
+    @JsonIgnore
+    public boolean isResultValid() {
+        return equalsAny(result, null, HrmRecruitInterviewResultEnum.PASS.getResult(),
+                HrmRecruitInterviewResultEnum.NOT_PASS.getResult(), HrmRecruitInterviewResultEnum.CANCEL.getResult());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewSaveReqVO.java
new file mode 100644
index 0000000..947c639
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/interview/HrmRecruitInterviewSaveReqVO.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview;
+
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 招聘面试新增/修改 Request VO")
+@Data
+public class HrmRecruitInterviewSaveReqVO {
+
+    @Schema(description = "面试编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "候选人编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "候选人编号不能为空")
+    private Long candidateId;
+
+    @Schema(description = "面试方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "面试方式不能为空")
+    @DiffLogField(name = "面试方式")
+    private Integer type;
+
+    @Schema(description = "面试轮次", example = "1")
+    private Integer stageNumber;
+
+    @Schema(description = "主面试官员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "主面试官不能为空")
+    @DiffLogField(name = "主面试官")
+    private Long interviewEmployeeId;
+
+    @Schema(description = "其他面试官员工编号数组", example = "[2, 3]")
+    @DiffLogField(name = "其他面试官")
+    private List<Long> otherInterviewEmployeeIds;
+
+    @Schema(description = "面试时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "面试时间不能为空")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    @DiffLogField(name = "面试时间")
+    private LocalDateTime interviewTime;
+
+    @Schema(description = "面试地址", example = "上海会议室 A")
+    @Size(max = 255, message = "面试地址长度不能超过 255 个字符")
+    @DiffLogField(name = "面试地址")
+    private String address;
+
+    @Schema(description = "备注", example = "请带作品集")
+    @Size(max = 255, message = "备注长度不能超过 255 个字符")
+    @DiffLogField(name = "备注")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostPageReqVO.java
new file mode 100644
index 0000000..70839dc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostPageReqVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import org.springframework.format.annotation.DateTimeFormat;
+
+import java.time.LocalDateTime;
+
+import static cn.iocoder.yudao.framework.common.util.date.DateUtils.FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND;
+
+@Schema(description = "管理后台 - HRM 招聘职位分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmRecruitPostPageReqVO extends PageParam {
+
+    @Schema(description = "职位名称，模糊匹配", example = "Java")
+    private String postName;
+
+    @Schema(description = "工作性质", example = "1")
+    private Integer jobNature;
+
+    @Schema(description = "工作城市地区编号", example = "310115")
+    private Integer areaId;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "招聘负责人员工编号", example = "200")
+    private Long ownerEmployeeId;
+
+    @Schema(description = "职位类型编号", example = "100")
+    private Long postTypeId;
+
+    @Schema(description = "职位状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    @DateTimeFormat(pattern = FORMAT_YEAR_MONTH_DAY_HOUR_MINUTE_SECOND)
+    private LocalDateTime[] createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostRespVO.java
new file mode 100644
index 0000000..fbe016b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostRespVO.java
@@ -0,0 +1,104 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 招聘职位 Response VO")
+@Data
+public class HrmRecruitPostRespVO {
+
+    @Schema(description = "招聘职位编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "职位名称", example = "Java 开发工程师")
+    private String postName;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "用人部门名称", example = "研发部")
+    private String deptName;
+
+    @Schema(description = "工作性质", example = "1")
+    private Integer jobNature;
+
+    @Schema(description = "工作城市地区编号", example = "310115")
+    private Integer areaId;
+
+    @Schema(description = "工作城市地区名称", example = "上海 上海市 浦东新区")
+    private String areaName;
+
+    @Schema(description = "招聘人数", example = "3")
+    private Integer recruitNum;
+
+    @Schema(description = "招聘原因", example = "团队扩编")
+    private String reason;
+
+    @Schema(description = "工作经验", example = "3")
+    private Integer workTime;
+
+    @Schema(description = "学历要求", example = "4")
+    private Integer educationRequire;
+
+    @Schema(description = "最低薪资", example = "20000")
+    private BigDecimal minSalary;
+
+    @Schema(description = "最高薪资", example = "30000")
+    private BigDecimal maxSalary;
+
+    @Schema(description = "薪资单位", example = "2")
+    private Integer salaryUnit;
+
+    @Schema(description = "最小年龄", example = "22")
+    private Integer minAge;
+
+    @Schema(description = "最大年龄", example = "35")
+    private Integer maxAge;
+
+    @Schema(description = "最迟到岗时间")
+    private LocalDateTime latestEntryTime;
+
+    @Schema(description = "招聘负责人员工编号", example = "1")
+    private Long ownerEmployeeId;
+
+    @Schema(description = "招聘负责人姓名", example = "张三")
+    private String ownerEmployeeName;
+
+    @Schema(description = "面试官员工编号数组", example = "[1, 2]")
+    private List<Long> interviewEmployeeIds;
+
+    @Schema(description = "面试官姓名数组", example = "[\"张三\", \"李四\"]")
+    private List<String> interviewEmployeeNames;
+
+    @Schema(description = "职位描述")
+    private String description;
+
+    @Schema(description = "紧急程度", example = "1")
+    private Integer emergencyLevel;
+
+    @Schema(description = "职位类型编号", example = "100")
+    private Long postTypeId;
+
+    @Schema(description = "职位类型名称", example = "研发")
+    private String postTypeName;
+
+    @Schema(description = "职位状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "停止原因", example = "岗位暂停")
+    private String stopReason;
+
+    @Schema(description = "已入职人数", example = "2")
+    private Long hasEntryNum;
+
+    @Schema(description = "招聘进度百分比", example = "40.00")
+    private BigDecimal recruitSchedule;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostSaveReqVO.java
new file mode 100644
index 0000000..910e5ff
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostSaveReqVO.java
@@ -0,0 +1,144 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post;
+
+import cn.iocoder.yudao.module.system.framework.operatelog.core.AreaParseFunction;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO.AGE_UNLIMITED_VALUE;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO.SALARY_NEGOTIABLE_UNIT_VALUE;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO.SALARY_NEGOTIABLE_VALUE;
+
+@Schema(description = "管理后台 - HRM 招聘职位新增/修改 Request VO")
+@Data
+public class HrmRecruitPostSaveReqVO {
+
+    @Schema(description = "招聘职位编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "职位名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "Java 开发工程师")
+    @NotBlank(message = "职位名称不能为空")
+    @Size(max = 255, message = "职位名称不能超过 255 个字符")
+    @DiffLogField(name = "职位名称")
+    private String postName;
+
+    @Schema(description = "部门编号", example = "100")
+    @DiffLogField(name = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "工作性质", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "工作性质不能为空")
+    @DiffLogField(name = "工作性质")
+    private Integer jobNature;
+
+    @Schema(description = "工作城市地区编号", example = "310115")
+    @DiffLogField(name = "工作城市", function = AreaParseFunction.NAME)
+    private Integer areaId;
+
+    @Schema(description = "招聘人数", example = "3")
+    @Min(value = 0, message = "招聘人数不能小于 0")
+    @DiffLogField(name = "招聘人数")
+    private Integer recruitNum;
+
+    @Schema(description = "招聘原因", example = "团队扩编")
+    @Size(max = 255, message = "招聘原因不能超过 255 个字符")
+    @DiffLogField(name = "招聘原因")
+    private String reason;
+
+    @Schema(description = "工作经验", example = "3")
+    @DiffLogField(name = "工作经验")
+    private Integer workTime;
+
+    @Schema(description = "学历要求", example = "4")
+    @DiffLogField(name = "学历要求")
+    private Integer educationRequire;
+
+    @Schema(description = "最低薪资", example = "20000")
+    @Digits(integer = 8, fraction = 2, message = "最低薪资最多 8 位整数和 2 位小数")
+    @DiffLogField(name = "最低薪资")
+    private BigDecimal minSalary;
+
+    @Schema(description = "最高薪资", example = "30000")
+    @Digits(integer = 8, fraction = 2, message = "最高薪资最多 8 位整数和 2 位小数")
+    @DiffLogField(name = "最高薪资")
+    private BigDecimal maxSalary;
+
+    @Schema(description = "薪资单位", example = "2")
+    @DiffLogField(name = "薪资单位")
+    private Integer salaryUnit;
+
+    @Schema(description = "最小年龄", example = "22")
+    @DiffLogField(name = "最小年龄")
+    private Integer minAge;
+
+    @Schema(description = "最大年龄", example = "35")
+    @DiffLogField(name = "最大年龄")
+    private Integer maxAge;
+
+    @Schema(description = "最迟到岗时间")
+    @DiffLogField(name = "最迟到岗时间")
+    private LocalDateTime latestEntryTime;
+
+    @Schema(description = "负责人员工编号", example = "1")
+    @DiffLogField(name = "负责人")
+    private Long ownerEmployeeId;
+
+    @Schema(description = "面试官员工编号数组", example = "[1, 2]")
+    @DiffLogField(name = "面试官")
+    private List<Long> interviewEmployeeIds;
+
+    @Schema(description = "职位描述", example = "负责核心业务系统设计与开发")
+    @Size(max = 4000, message = "职位描述不能超过 4000 个字符")
+    @DiffLogField(name = "职位描述")
+    private String description;
+
+    @Schema(description = "紧急程度", example = "1")
+    @DiffLogField(name = "紧急程度")
+    private Integer emergencyLevel;
+
+    @Schema(description = "职位类型编号", example = "100")
+    @DiffLogField(name = "职位类型编号")
+    private Long postTypeId;
+
+    @AssertTrue(message = "薪资范围不正确")
+    @JsonIgnore
+    public boolean isSalaryRangeValid() {
+        boolean hasNegotiableValue = SALARY_NEGOTIABLE_VALUE.equals(getMinSalary())
+                || SALARY_NEGOTIABLE_VALUE.equals(getMaxSalary()) || SALARY_NEGOTIABLE_UNIT_VALUE.equals(getSalaryUnit());
+        if (hasNegotiableValue) {
+            return SALARY_NEGOTIABLE_VALUE.equals(getMinSalary())
+                    && SALARY_NEGOTIABLE_VALUE.equals(getMaxSalary())
+                    && SALARY_NEGOTIABLE_UNIT_VALUE.equals(getSalaryUnit());
+        }
+        if ((getMinSalary() != null && getMinSalary().signum() < 0)
+                || (getMaxSalary() != null && getMaxSalary().signum() < 0)) {
+            return false;
+        }
+        return getMinSalary() == null || getMaxSalary() == null || getMinSalary().compareTo(getMaxSalary()) <= 0;
+    }
+
+    @AssertTrue(message = "年龄范围不正确")
+    @JsonIgnore
+    public boolean isAgeRangeValid() {
+        boolean hasUnlimitedValue = AGE_UNLIMITED_VALUE.equals(getMinAge()) || AGE_UNLIMITED_VALUE.equals(getMaxAge());
+        if (hasUnlimitedValue) {
+            return AGE_UNLIMITED_VALUE.equals(getMinAge()) && AGE_UNLIMITED_VALUE.equals(getMaxAge());
+        }
+        if ((getMinAge() != null && getMinAge() < 0) || (getMaxAge() != null && getMaxAge() < 0)) {
+            return false;
+        }
+        return getMinAge() == null || getMaxAge() == null || getMinAge() <= getMaxAge();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostStatusReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostStatusReqVO.java
new file mode 100644
index 0000000..2eab16b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/HrmRecruitPostStatusReqVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 招聘职位状态修改 Request VO")
+@Data
+public class HrmRecruitPostStatusReqVO {
+
+    @Schema(description = "招聘职位编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "招聘职位编号不能为空")
+    private Long id;
+
+    @Schema(description = "职位状态", requiredMode = Schema.RequiredMode.REQUIRED, example = "0")
+    @NotNull(message = "职位状态不能为空")
+    @InEnum(value = HrmRecruitPostStatusEnum.class, message = "职位状态必须是 {value}")
+    private Integer status;
+
+    @Schema(description = "停止原因", example = "岗位暂停")
+    @Size(max = 255, message = "停止原因不能超过 255 个字符")
+    private String stopReason;
+
+    @AssertTrue(message = "停止招聘时，停止原因不能为空")
+    @JsonIgnore
+    public boolean isStopReasonValid() {
+        return ObjUtil.notEqual(HrmRecruitPostStatusEnum.STOPPED.getStatus(), status)
+                || StrUtil.isNotBlank(stopReason);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/type/HrmRecruitPostTypeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/type/HrmRecruitPostTypeRespVO.java
new file mode 100644
index 0000000..f2482f2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/recruit/vo/post/type/HrmRecruitPostTypeRespVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.type;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 招聘职位类型 Response VO")
+@Data
+public class HrmRecruitPostTypeRespVO {
+
+    @Schema(description = "职位类型编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "类型名称", example = "后端开发")
+    private String name;
+
+    @Schema(description = "父类型编号", example = "0")
+    private Long parentId;
+
+    @Schema(description = "排序", example = "10")
+    private Integer sort;
+
+    @Schema(description = "状态，参见 common_status", example = "0")
+    private Integer status;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryChangeRecordController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryChangeRecordController.java
new file mode 100644
index 0000000..f8f7fcc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryChangeRecordController.java
@@ -0,0 +1,89 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changerecord.HrmSalaryChangeRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.salary.employee.HrmSalaryChangeRecordService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - HRM 定薪/调薪记录")
+@RestController
+@RequestMapping("/hrm/salary/change-record")
+@Validated
+public class HrmSalaryChangeRecordController {
+
+    @Resource
+    private HrmSalaryChangeRecordService salaryChangeRecordService;
+
+    @GetMapping("/get")
+    @Operation(summary = "获得定薪/调薪记录")
+    @Parameter(name = "id", description = "记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:query')")
+    public CommonResult<HrmSalaryChangeRecordRespVO> getSalaryChangeRecord(@RequestParam("id") Long id) {
+        return success(buildSalaryChangeRecordRespVO(
+                salaryChangeRecordService.getSalaryChangeRecord(id)));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得定薪/调薪记录列表")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:query')")
+    public CommonResult<List<HrmSalaryChangeRecordRespVO>> getSalaryChangeRecordList(
+            @RequestParam("employeeId") Long employeeId) {
+        return success(convertList(salaryChangeRecordService.getSalaryChangeRecordList(employeeId),
+                this::buildSalaryChangeRecordRespVO));
+    }
+
+    @PutMapping("/cancel")
+    @Operation(summary = "取消定薪/调薪记录")
+    @Parameter(name = "id", description = "记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:update')")
+    public CommonResult<Boolean> cancelSalaryChangeRecord(@RequestParam("id") Long id) {
+        salaryChangeRecordService.cancelSalaryChangeRecord(id);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除定薪/调薪记录")
+    @Parameter(name = "id", description = "记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:change-record:delete')")
+    public CommonResult<Boolean> deleteSalaryChangeRecord(@RequestParam("id") Long id) {
+        salaryChangeRecordService.deleteSalaryChangeRecord(id);
+        return success(true);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmSalaryChangeRecordRespVO buildSalaryChangeRecordRespVO(
+            HrmSalaryChangeRecordDO changeRecord) {
+        if (changeRecord == null) {
+            return null;
+        }
+        HrmSalaryChangeRecordRespVO respVO = BeanUtils.toBean(changeRecord, HrmSalaryChangeRecordRespVO.class);
+        respVO.setRecordType(changeRecord.getType());
+        respVO.setChangeReason(changeRecord.getReason());
+        HrmSalaryChangeRecordTypeEnum recordType =
+                HrmSalaryChangeRecordTypeEnum.valueOf(changeRecord.getType());
+        respVO.setRecordTypeName(recordType == null ? null : recordType.getName());
+        return respVO;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryChangeTemplateController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryChangeTemplateController.java
new file mode 100644
index 0000000..eaf16f7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryChangeTemplateController.java
@@ -0,0 +1,82 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate.HrmSalaryChangeTemplateRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate.HrmSalaryChangeTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryChangeTemplateDO;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryChangeTemplateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 调薪模板")
+@RestController
+@RequestMapping("/hrm/salary/change-template")
+@Validated
+public class HrmSalaryChangeTemplateController {
+
+    @Resource
+    private HrmSalaryChangeTemplateService salaryChangeTemplateService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建调薪模板")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:change-template:create')")
+    public CommonResult<Long> createSalaryChangeTemplate(
+            @Valid @RequestBody HrmSalaryChangeTemplateSaveReqVO createReqVO) {
+        return success(salaryChangeTemplateService.createSalaryChangeTemplate(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新调薪模板")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:change-template:update')")
+    public CommonResult<Boolean> updateSalaryChangeTemplate(
+            @Valid @RequestBody HrmSalaryChangeTemplateSaveReqVO updateReqVO) {
+        salaryChangeTemplateService.updateSalaryChangeTemplate(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除调薪模板")
+    @Parameter(name = "id", description = "调薪模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:change-template:delete')")
+    public CommonResult<Boolean> deleteSalaryChangeTemplate(@RequestParam("id") Long id) {
+        salaryChangeTemplateService.deleteSalaryChangeTemplate(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得调薪模板")
+    @Parameter(name = "id", description = "调薪模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:change-template:query')")
+    public CommonResult<HrmSalaryChangeTemplateRespVO> getSalaryChangeTemplate(@RequestParam("id") Long id) {
+        HrmSalaryChangeTemplateDO template = salaryChangeTemplateService.getSalaryChangeTemplate(id);
+        return success(BeanUtils.toBean(template, HrmSalaryChangeTemplateRespVO.class));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得调薪模板列表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:change-template:query') "
+            + "or @ss.hasPermission('hrm:salary:employee-info:query')")
+    public CommonResult<List<HrmSalaryChangeTemplateRespVO>> getSalaryChangeTemplateList() {
+        List<HrmSalaryChangeTemplateDO> list = salaryChangeTemplateService.getSalaryChangeTemplateList();
+        return success(BeanUtils.toBean(list, HrmSalaryChangeTemplateRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryConfigController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryConfigController.java
new file mode 100644
index 0000000..5e5d28c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryConfigController.java
@@ -0,0 +1,57 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryConfigDO;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryConfigService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+
+@Tag(name = "管理后台 - HRM 薪资配置")
+@RestController
+@RequestMapping("/hrm/salary/config")
+@Validated
+public class HrmSalaryConfigController {
+
+    @Resource
+    private HrmSalaryConfigService salaryConfigService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建薪资配置")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:config:update')")
+    public CommonResult<Long> createSalaryConfig(@Valid @RequestBody HrmSalaryConfigCreateReqVO reqVO) {
+        return success(salaryConfigService.createSalaryConfig(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新薪资配置")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:config:update')")
+    public CommonResult<Boolean> updateSalaryConfig(@Valid @RequestBody HrmSalaryConfigUpdateReqVO reqVO) {
+        salaryConfigService.updateSalaryConfig(reqVO);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得薪资配置")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:config:query')")
+    public CommonResult<HrmSalaryConfigRespVO> getSalaryConfig() {
+        HrmSalaryConfigDO config = salaryConfigService.getSalaryConfig();
+        return success(BeanUtils.toBean(config, HrmSalaryConfigRespVO.class));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryEmployeeInfoController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryEmployeeInfoController.java
new file mode 100644
index 0000000..287d94d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryEmployeeInfoController.java
@@ -0,0 +1,343 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeStatusCountRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateListRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoImportRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.salary.employee.HrmSalaryEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeInfoChangeTypeEnum;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 员工薪资信息")
+@RestController
+@RequestMapping("/hrm/salary/employee-info")
+@Validated
+public class HrmSalaryEmployeeInfoController {
+
+    @Resource
+    private HrmSalaryEmployeeInfoService salaryEmployeeInfoService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得员工薪资信息分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:query')")
+    public CommonResult<PageResult<HrmSalaryEmployeeInfoRespVO>> getSalaryEmployeeInfoPage(
+            @Validated HrmSalaryEmployeeInfoPageReqVO reqVO) {
+        PageResult<HrmEmployeeDO> pageResult = salaryEmployeeInfoService.getSalaryEmployeeInfoPage(reqVO);
+        return success(buildSalaryEmployeeInfoRespVOPageResult(pageResult));
+    }
+
+    @GetMapping("/status-count")
+    @Operation(summary = "获得员工薪资信息状态数量")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:query')")
+    public CommonResult<List<HrmEmployeeStatusCountRespVO>> getSalaryEmployeeInfoStatusCount(
+            @Validated HrmSalaryEmployeeInfoPageReqVO reqVO) {
+        Map<Integer, Long> countMap = salaryEmployeeInfoService.getSalaryEmployeeInfoStatusCount(reqVO);
+        return success(convertList(Arrays.asList(HrmEmployeeStatusTabEnum.values()),
+                status -> new HrmEmployeeStatusCountRespVO(status.getStatus(),
+                        countMap.getOrDefault(status.getStatus(), 0L))));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得员工薪资信息")
+    @Parameter(name = "employeeId", description = "员工编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:query')")
+    public CommonResult<HrmSalaryEmployeeInfoRespVO> getSalaryEmployeeInfo(
+            @RequestParam("employeeId") Long employeeId) {
+        HrmEmployeeDO employee = employeeService.getEmployee(employeeId);
+        if (employee == null) {
+            return success(null);
+        }
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                salaryEmployeeInfoService.getSalaryEmployeeInfoByEmployeeId(employeeId);
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(Collections.singleton(employee.getDeptId()));
+        return success(buildSalaryEmployeeInfoRespVO(employee, salaryEmployeeInfo, deptMap));
+    }
+
+    @GetMapping("/get-adjustment-min-effect-date")
+    @Operation(summary = "获得最早调薪生效日期")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:update')")
+    public CommonResult<LocalDate> getSalaryAdjustmentMinEffectDate() {
+        return success(getSalaryAdjustmentMinEffectDateValue());
+    }
+
+    private LocalDate getSalaryAdjustmentMinEffectDateValue() {
+        HrmSalaryMonthRecordDO monthRecord = salaryMonthRecordService.getLastMonthRecord();
+        if (monthRecord == null || monthRecord.getYear() == null || monthRecord.getMonth() == null) {
+            return null;
+        }
+        return YearMonth.of(monthRecord.getYear(), monthRecord.getMonth()).atDay(1);
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改员工薪资信息")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:update')")
+    public CommonResult<Long> updateSalaryEmployeeInfo(
+            @Valid @RequestBody HrmSalaryEmployeeInfoUpdateReqVO reqVO) {
+        return success(salaryEmployeeInfoService.updateSalaryEmployeeInfo(reqVO));
+    }
+
+    @PutMapping("/update-list")
+    @Operation(summary = "批量调薪")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:update')")
+    public CommonResult<HrmSalaryEmployeeInfoUpdateListRespVO> updateSalaryEmployeeInfoList(
+            @Valid @RequestBody HrmSalaryEmployeeInfoUpdateListReqVO reqVO) {
+        return success(salaryEmployeeInfoService.updateSalaryEmployeeInfoList(reqVO));
+    }
+
+    @GetMapping("/get-fix-import-template")
+    @Operation(summary = "获得薪资档案定薪导入模板")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getFixImportTemplate(HttpServletResponse response) throws IOException {
+        List<HrmSalaryOptionDO> options = salaryEmployeeInfoService.getSalaryImportOptionList();
+        List<List<String>> head = buildFixSalaryImportHead(options);
+        List<List<Object>> data = buildFixSalaryImportTemplateData(options);
+        ExcelUtils.write(response, "薪资档案定薪导入模板.xls", "薪资档案", head, data);
+    }
+
+    @PostMapping("/import-fix")
+    @Operation(summary = "导入薪资档案定薪")
+    @Parameter(name = "file", description = "Excel 文件", required = true)
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<HrmSalaryEmployeeInfoImportRespVO> importFixExcel(@RequestParam("file") MultipartFile file)
+            throws IOException {
+        return success(salaryEmployeeInfoService.importFixSalaryList(ExcelUtils.read(file)));
+    }
+
+    @GetMapping("/get-change-import-template")
+    @Operation(summary = "获得薪资档案调薪导入模板")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getChangeImportTemplate(HttpServletResponse response) throws IOException {
+        List<HrmSalaryOptionDO> options = salaryEmployeeInfoService.getSalaryImportOptionList();
+        List<List<String>> head = buildChangeSalaryImportHead(options);
+        List<List<Object>> data = buildChangeSalaryImportTemplateData(options);
+        ExcelUtils.write(response, "薪资档案调薪导入模板.xls", "薪资档案", head, data);
+    }
+
+    @PostMapping("/import-change")
+    @Operation(summary = "导入薪资档案调薪")
+    @Parameter(name = "file", description = "Excel 文件", required = true)
+    @PreAuthorize("@ss.hasPermission('hrm:salary:employee-info:import')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<HrmSalaryEmployeeInfoImportRespVO> importChangeExcel(@RequestParam("file") MultipartFile file)
+            throws IOException {
+        return success(salaryEmployeeInfoService.importChangeSalaryList(ExcelUtils.read(file)));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private PageResult<HrmSalaryEmployeeInfoRespVO> buildSalaryEmployeeInfoRespVOPageResult(
+            PageResult<HrmEmployeeDO> pageResult) {
+        if (CollUtil.isEmpty(pageResult.getList())) {
+            return PageResult.empty(pageResult.getTotal());
+        }
+        // 1. 获取关联数据
+        Map<Long, HrmSalaryEmployeeInfoDO> salaryEmployeeInfoMap =
+                salaryEmployeeInfoService.getSalaryEmployeeInfoMap(
+                        convertSet(pageResult.getList(), HrmEmployeeDO::getId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(pageResult.getList(), HrmEmployeeDO::getDeptId));
+
+        // 2. 拼接响应
+        return new PageResult<>(convertList(pageResult.getList(), employee -> buildSalaryEmployeeInfoRespVO(
+                employee, salaryEmployeeInfoMap.get(employee.getId()), deptMap)), pageResult.getTotal());
+    }
+
+    private HrmSalaryEmployeeInfoRespVO buildSalaryEmployeeInfoRespVO(
+            HrmEmployeeDO employee, HrmSalaryEmployeeInfoDO salaryEmployeeInfo, Map<Long, DeptRespDTO> deptMap) {
+        // 1. 拼接员工基础信息
+        HrmSalaryEmployeeInfoRespVO respVO = salaryEmployeeInfo == null
+                ? new HrmSalaryEmployeeInfoRespVO()
+                : BeanUtils.toBean(salaryEmployeeInfo, HrmSalaryEmployeeInfoRespVO.class);
+        respVO.setEmployeeId(employee.getId()).setEmployeeName(employee.getName())
+                .setJobNumber(employee.getJobNumber()).setMobile(employee.getMobile())
+                .setDeptId(employee.getDeptId()).setPostName(employee.getPostName())
+                .setEntryStatus(employee.getEntryStatus()).setStatus(employee.getStatus())
+                .setEntryTime(employee.getEntryTime()).setRegularTime(employee.getRegularTime());
+        MapUtils.findAndThen(deptMap, employee.getDeptId(),
+                dept -> respVO.setDeptName(dept.getName()));
+
+        // 2. 拼接当前薪资信息
+        if (salaryEmployeeInfo == null) {
+            respVO.setChangeType(HrmSalaryEmployeeInfoChangeTypeEnum.UNSET.getType())
+                    .setSalaryOptions(Collections.emptyList()).setProbationSalaryOptions(Collections.emptyList());
+            return respVO;
+        }
+        return respVO;
+    }
+
+    // ==================== Excel 导入导出 ====================
+
+    private List<List<String>> buildFixSalaryImportHead(List<HrmSalaryOptionDO> options) {
+        List<List<String>> head = buildSalaryImportEmployeeHead();
+        options.forEach(option -> head.add(Collections.singletonList("试用期-" + option.getName())));
+        options.forEach(option -> head.add(Collections.singletonList("正式-" + option.getName())));
+        head.add(Collections.singletonList("备注"));
+        return head;
+    }
+
+    private List<List<Object>> buildFixSalaryImportTemplateData(List<HrmSalaryOptionDO> options) {
+        List<HrmEmployeeDO> employees = getActiveEmployeeList();
+        List<List<Object>> rows = convertList(employees, employee -> {
+            List<Object> row = buildSalaryImportEmployeeRow(employee);
+            options.forEach(option -> row.add(BigDecimal.ZERO));
+            options.forEach(option -> row.add(BigDecimal.ZERO));
+            row.add("");
+            return row;
+        });
+        if (CollUtil.isEmpty(rows)) {
+            List<Object> row = new ArrayList<>(Arrays.asList(
+                    "张三", "HRM001", 100L, "Java 工程师"));
+            options.forEach(option -> row.add(BigDecimal.ZERO));
+            options.forEach(option -> row.add(BigDecimal.ZERO));
+            row.add("示例定薪");
+            rows.add(row);
+        }
+        return rows;
+    }
+
+    private List<List<String>> buildChangeSalaryImportHead(List<HrmSalaryOptionDO> options) {
+        List<List<String>> head = buildSalaryImportBaseHead("调薪原因");
+        options.forEach(option -> {
+            head.add(Collections.singletonList("试用期-" + option.getName() + "-调整前"));
+            head.add(Collections.singletonList("试用期-" + option.getName() + "-调整后"));
+        });
+        options.forEach(option -> {
+            head.add(Collections.singletonList("正式-" + option.getName() + "-调整前"));
+            head.add(Collections.singletonList("正式-" + option.getName() + "-调整后"));
+        });
+        head.add(Collections.singletonList("备注"));
+        return head;
+    }
+
+    private List<List<Object>> buildChangeSalaryImportTemplateData(List<HrmSalaryOptionDO> options) {
+        List<HrmEmployeeDO> employees = getActiveEmployeeList();
+        Map<Long, HrmSalaryEmployeeInfoDO> salaryEmployeeInfoMap =
+                salaryEmployeeInfoService.getSalaryEmployeeInfoMap(convertSet(employees, HrmEmployeeDO::getId));
+        LocalDate effectDate = getSalaryAdjustmentMinEffectDateValue();
+        if (effectDate == null || effectDate.isBefore(LocalDate.now())) {
+            effectDate = LocalDate.now();
+        }
+        LocalDate finalEffectDate = effectDate;
+        return convertList(employees, employee -> {
+            HrmSalaryEmployeeInfoDO salaryEmployeeInfo = salaryEmployeeInfoMap.get(employee.getId());
+            List<Object> row = buildSalaryImportBaseRow(employee, finalEffectDate, "转正");
+            appendChangeOptionTemplateValues(row, options,
+                    buildSalaryOptionValueMap(salaryEmployeeInfo == null
+                            ? Collections.emptyList() : salaryEmployeeInfo.getProbationSalaryOptions()));
+            appendChangeOptionTemplateValues(row, options,
+                    buildSalaryOptionValueMap(salaryEmployeeInfo == null
+                            ? Collections.emptyList() : salaryEmployeeInfo.getSalaryOptions()));
+            row.add("");
+            return row;
+        });
+    }
+
+    private List<HrmEmployeeDO> getActiveEmployeeList() {
+        return employeeService.getEmployeeList(new HrmEmployeeListReqVO()
+                .setStatusCategory(HrmEmployeeStatusTabEnum.ACTIVE.getStatus()));
+    }
+
+    private List<List<String>> buildSalaryImportBaseHead(String reasonName) {
+        List<List<String>> head = buildSalaryImportEmployeeHead();
+        head.add(Collections.singletonList("生效日期"));
+        head.add(Collections.singletonList(reasonName));
+        return head;
+    }
+
+    private List<List<String>> buildSalaryImportEmployeeHead() {
+        return new ArrayList<>(Arrays.asList(
+                Collections.singletonList("员工姓名"),
+                Collections.singletonList("工号"),
+                Collections.singletonList("部门编号"),
+                Collections.singletonList("岗位")));
+    }
+
+    private List<Object> buildSalaryImportEmployeeRow(HrmEmployeeDO employee) {
+        return new ArrayList<>(Arrays.asList(
+                employee.getName(), employee.getJobNumber(), employee.getDeptId(), employee.getPostName()));
+    }
+
+    private List<Object> buildSalaryImportBaseRow(HrmEmployeeDO employee, LocalDate effectDate, String changeReason) {
+        List<Object> row = buildSalaryImportEmployeeRow(employee);
+        row.add(effectDate.toString());
+        row.add(changeReason);
+        return row;
+    }
+
+    private Map<Integer, BigDecimal> buildSalaryOptionValueMap(
+            List<HrmSalaryEmployeeInfoDO.SalaryOption> options) {
+        return convertMap(options, HrmSalaryEmployeeInfoDO.SalaryOption::getCode,
+                option -> option.getValue() == null ? BigDecimal.ZERO : option.getValue());
+    }
+
+    private void appendChangeOptionTemplateValues(List<Object> row, List<HrmSalaryOptionDO> options,
+                                                  Map<Integer, BigDecimal> valueMap) {
+        for (HrmSalaryOptionDO option : options) {
+            BigDecimal value = valueMap.getOrDefault(option.getCode(), BigDecimal.ZERO);
+            row.add(value);
+            row.add(value);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryGroupController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryGroupController.java
new file mode 100644
index 0000000..0dae418
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryGroupController.java
@@ -0,0 +1,141 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryGroupService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryTaxRuleService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+
+@Tag(name = "管理后台 - HRM 薪资组")
+@RestController
+@RequestMapping("/hrm/salary/group")
+@Validated
+public class HrmSalaryGroupController {
+
+    @Resource
+    private HrmSalaryGroupService salaryGroupService;
+    @Resource
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private DeptApi deptApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建薪资组")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:group:create')")
+    public CommonResult<Long> createSalaryGroup(@Valid @RequestBody HrmSalaryGroupSaveReqVO reqVO) {
+        return success(salaryGroupService.createSalaryGroup(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改薪资组")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:group:update')")
+    public CommonResult<Boolean> updateSalaryGroup(@Valid @RequestBody HrmSalaryGroupSaveReqVO reqVO) {
+        salaryGroupService.updateSalaryGroup(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除薪资组")
+    @Parameter(name = "id", description = "薪资组编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:group:delete')")
+    public CommonResult<Boolean> deleteSalaryGroup(@RequestParam("id") Long id) {
+        salaryGroupService.deleteSalaryGroup(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得薪资组")
+    @Parameter(name = "id", description = "薪资组编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:group:query')")
+    public CommonResult<HrmSalaryGroupRespVO> getSalaryGroup(@RequestParam("id") Long id) {
+        return success(buildSalaryGroupRespVO(salaryGroupService.getSalaryGroup(id)));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得薪资组分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:group:query')")
+    public CommonResult<PageResult<HrmSalaryGroupRespVO>> getSalaryGroupPage(
+            @Validated HrmSalaryGroupPageReqVO reqVO) {
+        PageResult<HrmSalaryGroupDO> pageResult = salaryGroupService.getSalaryGroupPage(reqVO);
+        return success(new PageResult<>(buildSalaryGroupRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得薪资组精简列表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:group:query')")
+    public CommonResult<List<HrmSalaryGroupRespVO>> getSalaryGroupSimpleList() {
+        return success(convertList(salaryGroupService.getSalaryGroupList(),
+                salaryGroup -> new HrmSalaryGroupRespVO().setId(salaryGroup.getId())
+                        .setName(salaryGroup.getName()).setTaxRuleId(salaryGroup.getTaxRuleId())));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmSalaryGroupRespVO buildSalaryGroupRespVO(HrmSalaryGroupDO group) {
+        if (group == null) {
+            return null;
+        }
+        return CollUtil.getFirst(buildSalaryGroupRespVOList(Collections.singletonList(group)));
+    }
+
+    private List<HrmSalaryGroupRespVO> buildSalaryGroupRespVOList(List<HrmSalaryGroupDO> salaryGroups) {
+        if (CollUtil.isEmpty(salaryGroups)) {
+            return Collections.emptyList();
+        }
+        // 1.1 批量查询计税规则
+        Map<Long, HrmSalaryTaxRuleDO> taxRuleMap = salaryTaxRuleService.getSalaryTaxRuleMap(
+                convertSet(salaryGroups, HrmSalaryGroupDO::getTaxRuleId));
+        // 1.2 批量查询部门和员工
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSetByFlatMap(salaryGroups, HrmSalaryGroupDO::getDeptIds, Collection::stream));
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSetByFlatMap(salaryGroups, HrmSalaryGroupDO::getEmployeeIds, Collection::stream));
+
+        // 2. 拼接响应
+        return BeanUtils.toBean(salaryGroups, HrmSalaryGroupRespVO.class, vo -> {
+            MapUtils.findAndThen(taxRuleMap, vo.getTaxRuleId(), taxRule -> vo.setTaxRuleName(taxRule.getName()));
+            vo.setDeptNames(convertList(convertList(vo.getDeptIds(), deptMap::get), DeptRespDTO::getName));
+            vo.setEmployeeNames(convertList(convertList(vo.getEmployeeIds(), employeeMap::get),
+                    HrmEmployeeDO::getName));
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryMonthEmployeeRecordController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryMonthEmployeeRecordController.java
new file mode 100644
index 0000000..03bd06b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryMonthEmployeeRecordController.java
@@ -0,0 +1,153 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryEmployeeMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryPerformanceCoefficientReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotEmpty;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 员工月度工资")
+@RestController
+@RequestMapping("/hrm/salary/month-employee-record")
+@Validated
+public class HrmSalaryMonthEmployeeRecordController {
+
+    @Resource
+    private HrmSalaryMonthEmployeeRecordService monthEmployeeRecordService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private DeptApi deptApi;
+
+    @PutMapping("/update-list")
+    @Operation(summary = "批量修改员工工资项")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:update')")
+    public CommonResult<Boolean> updateMonthEmployeeRecordList(
+            @NotEmpty(message = "员工工资记录不能为空")
+            @RequestBody List<@Valid HrmSalaryMonthEmployeeRecordUpdateReqVO> reqVOs) {
+        monthEmployeeRecordService.updateMonthEmployeeRecordList(reqVOs);
+        return success(true);
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得员工月度工资分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<PageResult<HrmSalaryMonthEmployeeRecordRespVO>> getMonthEmployeeRecordPage(
+            @Valid HrmSalaryMonthEmployeeRecordPageReqVO reqVO) {
+        PageResult<HrmSalaryMonthEmployeeRecordDO> pageResult =
+                monthEmployeeRecordService.getMonthEmployeeRecordPage(reqVO);
+        return success(new PageResult<>(buildMonthEmployeeRecordRespVOList(pageResult.getList()),
+                pageResult.getTotal()));
+    }
+
+    @GetMapping("/employee-page")
+    @Operation(summary = "获得指定员工的月度工资分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<PageResult<HrmSalaryMonthEmployeeRecordRespVO>> getEmployeeMonthRecordPage(
+            @Valid HrmSalaryEmployeeMonthRecordPageReqVO reqVO) {
+        PageResult<HrmSalaryMonthEmployeeRecordDO> pageResult =
+                monthEmployeeRecordService.getEmployeeMonthRecordPage(reqVO);
+        return success(new PageResult<>(buildMonthEmployeeRecordRespVOList(pageResult.getList()),
+                pageResult.getTotal()));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得员工月度工资列表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<List<HrmSalaryMonthEmployeeRecordRespVO>> getMonthEmployeeRecordList(
+            @Valid HrmSalaryMonthEmployeeRecordListReqVO reqVO) {
+        return success(buildMonthEmployeeRecordRespVOList(
+                monthEmployeeRecordService.getMonthEmployeeRecordList(reqVO)));
+    }
+
+    @GetMapping("/change-count")
+    @Operation(summary = "获得工资表员工异动分类数量")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<Map<Integer, Long>> getMonthEmployeeChangeCount(
+            @Valid HrmSalaryMonthEmployeeRecordPageReqVO reqVO) {
+        return success(monthEmployeeRecordService.getMonthEmployeeChangeCount(reqVO));
+    }
+
+    @PostMapping("/performance-coefficients")
+    @Operation(summary = "获得员工绩效系数")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<Map<Long, BigDecimal>> getPerformanceCoefficientMap(
+            @Valid @RequestBody HrmSalaryPerformanceCoefficientReqVO reqVO) {
+        return success(monthEmployeeRecordService.getPerformanceCoefficientMap(reqVO));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<HrmSalaryMonthEmployeeRecordRespVO> buildMonthEmployeeRecordRespVOList(
+            List<HrmSalaryMonthEmployeeRecordDO> employeeRecords) {
+        if (CollUtil.isEmpty(employeeRecords)) {
+            return Collections.emptyList();
+        }
+
+        // 1.1 批量查询员工和部门
+        Set<Long> employeeIds = convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId));
+        // 1.2 批量查询绩效系数和薪资项
+        HrmSalaryMonthEmployeeRecordDO firstRecord = CollUtil.getFirst(employeeRecords);
+        boolean sameMonth = employeeRecords.stream().allMatch(record ->
+                Objects.equals(record.getYear(), firstRecord.getYear())
+                        && Objects.equals(record.getMonth(), firstRecord.getMonth()));
+        Map<Long, BigDecimal> coefficientMap = sameMonth
+                ? monthEmployeeRecordService.getPerformanceCoefficientMap(
+                        new HrmSalaryPerformanceCoefficientReqVO().setYear(firstRecord.getYear())
+                                .setMonth(firstRecord.getMonth()).setEmployeeIds(new ArrayList<>(employeeIds)))
+                : Collections.emptyMap();
+        // 2. 拼接响应
+        List<HrmSalaryMonthEmployeeRecordRespVO> respVOs = BeanUtils.toBean(
+                employeeRecords, HrmSalaryMonthEmployeeRecordRespVO.class);
+        for (HrmSalaryMonthEmployeeRecordRespVO respVO : respVOs) {
+            MapUtils.findAndThen(employeeMap, respVO.getEmployeeId(), employee -> {
+                respVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                        .setDeptId(employee.getDeptId()).setPostName(employee.getPostName());
+                MapUtils.findAndThen(deptMap, employee.getDeptId(),
+                        dept -> respVO.setDeptName(dept.getName()));
+            });
+            respVO.setPerformanceCoefficient(coefficientMap.get(respVO.getEmployeeId()));
+        }
+        return respVOs;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryMonthRecordController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryMonthRecordController.java
new file mode 100644
index 0000000..ece5bb9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryMonthRecordController.java
@@ -0,0 +1,352 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.apilog.core.annotation.ApiAccessLog;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.excel.core.util.ExcelUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryPayrollReadinessRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.service.attendance.statistics.HrmAttendanceStatisticsService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryGroupService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryTaxRuleService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.framework.apilog.core.enums.OperateTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxTypeEnum;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.Parameters;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.servlet.http.HttpServletResponse;
+import jakarta.validation.Valid;
+import org.springframework.http.MediaType;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+import org.springframework.web.multipart.MultipartFile;
+
+import java.io.IOException;
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 月度工资表")
+@RestController
+@RequestMapping("/hrm/salary/month-record")
+@Validated
+public class HrmSalaryMonthRecordController {
+
+    @Resource
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+    @Resource
+    private HrmSalaryMonthEmployeeRecordService monthEmployeeRecordService;
+    @Resource
+    private HrmSalaryGroupService salaryGroupService;
+    @Resource
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmAttendanceStatisticsService attendanceStatisticsService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @PostMapping("/create-next")
+    @Operation(summary = "创建下月工资表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:create')")
+    public CommonResult<Long> createNextMonthRecord() {
+        return success(salaryMonthRecordService.createNextMonthRecord());
+    }
+
+    @PostMapping("/compute")
+    @Operation(summary = "核算工资表")
+    @Parameter(name = "id", description = "工资表编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:compute')")
+    public CommonResult<Boolean> computeMonthRecord(@RequestParam("id") Long id) {
+        salaryMonthRecordService.computeMonthRecord(id);
+        return success(true);
+    }
+
+    @PostMapping(value = "/compute-import", consumes = MediaType.MULTIPART_FORM_DATA_VALUE)
+    @Operation(summary = "带导入文件核算工资表")
+    @Parameters({
+            @Parameter(name = "id", description = "工资表编号", required = true, example = "1024"),
+            @Parameter(name = "syncInsuranceData", description = "是否同步社保数据", example = "true"),
+            @Parameter(name = "syncAttendanceData", description = "是否同步考勤数据", example = "false"),
+            @Parameter(name = "attendanceFile", description = "考勤数据文件"),
+            @Parameter(name = "additionalDeductionFile", description = "专项附加扣除数据文件"),
+            @Parameter(name = "cumulativeTaxFile", description = "上月个税累计数据文件")
+    })
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:compute')")
+    @ApiAccessLog(operateType = OperateTypeEnum.IMPORT)
+    public CommonResult<Boolean> computeMonthRecordWithImport(
+            @RequestParam("id") Long id,
+            @RequestParam(value = "syncInsuranceData", defaultValue = "true") boolean syncInsuranceData,
+            @RequestParam(value = "syncAttendanceData", defaultValue = "false") boolean syncAttendanceData,
+            @RequestParam(value = "attendanceFile", required = false) MultipartFile attendanceFile,
+            @RequestParam(value = "additionalDeductionFile", required = false) MultipartFile additionalDeductionFile,
+            @RequestParam(value = "cumulativeTaxFile", required = false) MultipartFile cumulativeTaxFile)
+            throws IOException {
+        salaryMonthRecordService.computeMonthRecord(id, syncInsuranceData, syncAttendanceData,
+                ExcelUtils.read(attendanceFile),
+                ExcelUtils.read(additionalDeductionFile),
+                ExcelUtils.read(cumulativeTaxFile));
+        return success(true);
+    }
+
+    @GetMapping("/get-attendance-import-template")
+    @Operation(summary = "获得工资表考勤导入模板")
+    @Parameter(name = "monthRecordId", description = "月度工资表编号", example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:compute')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getAttendanceImportTemplate(
+            @RequestParam(value = "monthRecordId", required = false) Long monthRecordId,
+            HttpServletResponse response) throws IOException {
+        List<HrmEmployeeDO> employees = getPayrollImportEmployeeList(monthRecordId, false);
+        List<List<Object>> data;
+        if (monthRecordId == null) {
+            data = buildImportTemplateData(employees, 8);
+        } else {
+            HrmSalaryMonthRecordDO monthRecord = salaryMonthRecordService.getMonthRecord(monthRecordId);
+            if (monthRecord == null) {
+                data = buildImportTemplateData(employees, 8);
+            } else {
+                Map<Long, HrmAttendanceMonthRecordRespVO> attendanceMap = convertMap(
+                        attendanceStatisticsService.getAttendanceMonthRecordList(monthRecord.getYear(),
+                                monthRecord.getMonth(), convertList(employees, HrmEmployeeDO::getId)),
+                        HrmAttendanceMonthRecordRespVO::getEmployeeId);
+                data = convertList(employees, employee -> {
+                    List<Object> row = buildImportEmployeeRow(employee);
+                    HrmAttendanceMonthRecordRespVO attendance = attendanceMap.get(employee.getId());
+                    row.add(BigDecimal.ZERO);
+                    row.add(attendance == null ? BigDecimal.ZERO : attendance.getLateDeductAmount());
+                    row.add(attendance == null ? BigDecimal.ZERO : attendance.getEarlyDeductAmount());
+                    row.add(attendance == null ? BigDecimal.ZERO : attendance.getAbsenteeismDeductAmount());
+                    row.add(BigDecimal.ZERO);
+                    row.add(attendance == null ? BigDecimal.ZERO : attendance.getMisscardDeductAmount());
+                    row.add(BigDecimal.ZERO);
+                    row.add(attendance == null ? BigDecimal.ZERO : attendance.getActualDays());
+                    return row;
+                });
+            }
+        }
+        List<List<String>> head = buildImportHead(Arrays.asList(
+                "加班工资", "迟到扣款", "早退扣款", "旷工扣款", "假期扣款",
+                "缺卡扣款", "综合扣款", "实际计薪天数"));
+        ExcelUtils.write(response, "月度工资考勤导入模板.xls", "月度工资", head, data);
+    }
+
+    @GetMapping("/get-cumulative-tax-import-template")
+    @Operation(summary = "获得工资表上月个税累计导入模板")
+    @Parameter(name = "monthRecordId", description = "月度工资表编号", example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:compute')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getCumulativeTaxImportTemplate(
+            @RequestParam(value = "monthRecordId", required = false) Long monthRecordId,
+            HttpServletResponse response) throws IOException {
+        List<List<String>> head = buildImportHead(Arrays.asList(
+                "累计收入额（截至上月）", "累计减除费用（截至上月）",
+                "累计专项扣除（截至上月）", "累计已预缴税额"));
+        List<HrmEmployeeDO> employees = getPayrollImportEmployeeList(monthRecordId, true);
+        List<List<Object>> data = buildImportTemplateData(employees, 4);
+        ExcelUtils.write(response, "月度工资上月个税累计导入模板.xls", "月度工资", head, data);
+    }
+
+    @GetMapping("/get-additional-deduction-import-template")
+    @Operation(summary = "获得工资表专项附加扣除导入模板")
+    @Parameter(name = "monthRecordId", description = "月度工资表编号", example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:compute')")
+    @ApiAccessLog(operateType = OperateTypeEnum.EXPORT)
+    public void getAdditionalDeductionImportTemplate(
+            @RequestParam(value = "monthRecordId", required = false) Long monthRecordId,
+            HttpServletResponse response) throws IOException {
+        List<List<String>> head = buildImportHead(Arrays.asList(
+                "累计子女教育", "累计住房租金", "累计住房贷款利息", "累计赡养老人", "累计继续教育"));
+        List<HrmEmployeeDO> employees = getPayrollImportEmployeeList(monthRecordId, true);
+        List<List<Object>> data = buildImportTemplateData(employees, 5);
+        ExcelUtils.write(response, "月度工资专项附加扣除导入模板.xls", "月度工资", head, data);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除月度工资表")
+    @Parameter(name = "id", description = "工资表编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:delete')")
+    public CommonResult<Boolean> deleteMonthRecord(@RequestParam("id") Long id) {
+        salaryMonthRecordService.deleteMonthRecord(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得月度工资表")
+    @Parameter(name = "id", description = "月度工资表编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<HrmSalaryMonthRecordRespVO> getMonthRecord(@RequestParam("id") Long id) {
+        HrmSalaryMonthRecordDO monthRecord = salaryMonthRecordService.getMonthRecord(id);
+        return success(buildMonthRecordRespVO(monthRecord));
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得月度工资表分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<PageResult<HrmSalaryMonthRecordRespVO>> getMonthRecordPage(
+            @Valid HrmSalaryMonthRecordPageReqVO reqVO) {
+        PageResult<HrmSalaryMonthRecordDO> pageResult = salaryMonthRecordService.getMonthRecordPage(reqVO);
+        return success(BeanUtils.toBean(pageResult, HrmSalaryMonthRecordRespVO.class));
+    }
+
+    @GetMapping("/last")
+    @Operation(summary = "获得最近月度工资表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<HrmSalaryMonthRecordRespVO> getLastMonthRecord() {
+        HrmSalaryMonthRecordDO monthRecord = salaryMonthRecordService.getLastMonthRecord();
+        return success(buildMonthRecordRespVO(monthRecord));
+    }
+
+    @GetMapping("/payroll-readiness")
+    @Operation(summary = "获得工资核算准备情况")
+    @Parameter(name = "monthRecordId", description = "月度工资表编号", example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<HrmSalaryPayrollReadinessRespVO> getPayrollReadiness(
+            @RequestParam(value = "monthRecordId", required = false) Long monthRecordId) {
+        HrmSalaryPayrollReadinessRespVO readiness =
+                salaryMonthRecordService.getPayrollReadiness(monthRecordId);
+        if (readiness == null) {
+            return success(null);
+        }
+        fillPayrollReadinessEmployeeDeptName(readiness.getNoSalaryEmployees());
+        fillPayrollReadinessEmployeeDeptName(readiness.getNoSalaryGroupEmployees());
+        return success(readiness);
+    }
+
+    @GetMapping("/option-summary")
+    @Operation(summary = "获得工资项汇总")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:month-record:query')")
+    public CommonResult<List<HrmSalaryOptionValueVO>> getMonthOptionSummary(
+            @Valid HrmSalaryMonthEmployeeRecordListReqVO reqVO) {
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords =
+                monthEmployeeRecordService.getMonthEmployeeRecordList(reqVO);
+        List<HrmSalaryMonthEmployeeRecordDO.OptionValue> optionSummary =
+                monthEmployeeRecordService.getMonthOptionSummary(employeeRecords);
+        return success(BeanUtils.toBean(optionSummary, HrmSalaryOptionValueVO.class));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmSalaryMonthRecordRespVO buildMonthRecordRespVO(HrmSalaryMonthRecordDO monthRecord) {
+        if (monthRecord == null) {
+            return null;
+        }
+        return BeanUtils.toBean(monthRecord, HrmSalaryMonthRecordRespVO.class);
+    }
+
+    private void fillPayrollReadinessEmployeeDeptName(
+            List<HrmSalaryPayrollReadinessRespVO.Employee> employees) {
+        if (CollUtil.isEmpty(employees)) {
+            return;
+        }
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(employees, HrmSalaryPayrollReadinessRespVO.Employee::getDeptId));
+        employees.forEach(employee -> MapUtils.findAndThen(deptMap, employee.getDeptId(),
+                dept -> employee.setDeptName(dept.getName())));
+    }
+
+    // ==================== Excel 导入导出 ====================
+
+    private List<HrmEmployeeDO> getPayrollImportEmployeeList(Long monthRecordId, boolean salaryTaxOnly) {
+        // 1. 获得指定或最近月度工资表
+        HrmSalaryMonthRecordDO monthRecord = monthRecordId == null
+                ? salaryMonthRecordService.getLastMonthRecord()
+                : salaryMonthRecordService.getMonthRecord(monthRecordId);
+        if (monthRecord == null) {
+            return Collections.emptyList();
+        }
+
+        // 2. 获得指定工资表已有员工，或尚未核算时的计薪员工
+        List<HrmEmployeeDO> employees;
+        if (monthRecordId != null) {
+            List<HrmSalaryMonthEmployeeRecordDO> employeeRecords =
+                    monthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(monthRecordId);
+            if (CollUtil.isNotEmpty(employeeRecords)) {
+                Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                        convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId));
+                employees = convertList(employeeRecords, record -> employeeMap.get(record.getEmployeeId()),
+                        Objects::nonNull);
+            } else {
+                employees = salaryMonthRecordService.getPayrollEmployeeList(monthRecord);
+            }
+        } else {
+            employees = salaryMonthRecordService.getPayrollEmployeeList(monthRecord);
+        }
+
+        // 3. 筛选已配置薪资组的员工
+        Map<Long, HrmSalaryGroupDO> salaryGroupMap = salaryGroupService.getEmployeeSalaryGroupMap(employees);
+        if (!salaryTaxOnly) {
+            return convertList(employees, employee -> employee,
+                    employee -> salaryGroupMap.containsKey(employee.getId()));
+        }
+
+        // 4. 个税累计模板只包含使用工资薪金计税规则的员工
+        Set<Long> taxRuleIds = convertSet(salaryGroupMap.values(), HrmSalaryGroupDO::getTaxRuleId,
+                salaryGroup -> salaryGroup.getTaxRuleId() != null);
+        Map<Long, HrmSalaryTaxRuleDO> taxRuleMap = salaryTaxRuleService.getSalaryTaxRuleMap(taxRuleIds);
+        return convertList(employees, employee -> employee, employee -> {
+            HrmSalaryGroupDO salaryGroup = salaryGroupMap.get(employee.getId());
+            HrmSalaryTaxRuleDO taxRule = salaryGroup == null ? null
+                    : taxRuleMap.get(salaryGroup.getTaxRuleId());
+            return taxRule != null && Objects.equals(taxRule.getType(), HrmSalaryTaxTypeEnum.SALARY.getType());
+        });
+    }
+
+    private List<List<String>> buildImportHead(List<String> businessHeaders) {
+        List<String> headers = Arrays.asList("员工名称", "岗位", "工号", "部门编号");
+        return convertList(CollUtil.union(headers, businessHeaders), Collections::singletonList);
+    }
+
+    private List<List<Object>> buildImportTemplateData(List<HrmEmployeeDO> employees, int blankColumnSize) {
+        return convertList(employees, employee -> {
+            List<Object> row = buildImportEmployeeRow(employee);
+            for (int i = 0; i < blankColumnSize; i++) {
+                row.add("");
+            }
+            return row;
+        });
+    }
+
+    private List<Object> buildImportEmployeeRow(HrmEmployeeDO employee) {
+        return new ArrayList<>(Arrays.asList(
+                employee.getName(), employee.getPostName(), employee.getJobNumber(), employee.getDeptId()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryOptionController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryOptionController.java
new file mode 100644
index 0000000..ffd3ec8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryOptionController.java
@@ -0,0 +1,103 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionUpdateEnabledReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionUpdateVisibleReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Tag(name = "管理后台 - HRM 薪资项")
+@RestController
+@RequestMapping("/hrm/salary/option")
+@Validated
+public class HrmSalaryOptionController {
+
+    @Resource
+    private HrmSalaryOptionService salaryOptionService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建薪资项")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:option:create')")
+    public CommonResult<Long> createSalaryOption(@Valid @RequestBody HrmSalaryOptionSaveReqVO reqVO) {
+        return success(salaryOptionService.createSalaryOption(reqVO));
+    }
+
+    @PutMapping("/update-enabled")
+    @Operation(summary = "更新薪资项启用状态")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:option:update')")
+    public CommonResult<Boolean> updateSalaryOptionEnabled(
+            @Valid @RequestBody HrmSalaryOptionUpdateEnabledReqVO reqVO) {
+        salaryOptionService.updateSalaryOptionEnabled(reqVO.getId(), reqVO.getEnabled());
+        return success(true);
+    }
+
+    @PutMapping("/update-visible")
+    @Operation(summary = "更新薪资项显示状态")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:option:update')")
+    public CommonResult<Boolean> updateSalaryOptionVisible(
+            @Valid @RequestBody HrmSalaryOptionUpdateVisibleReqVO reqVO) {
+        salaryOptionService.updateSalaryOptionVisible(reqVO.getId(), reqVO.getVisible());
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除薪资项")
+    @Parameter(name = "id", description = "薪资项编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:option:delete')")
+    public CommonResult<Boolean> deleteSalaryOption(@RequestParam("id") Long id) {
+        salaryOptionService.deleteSalaryOption(id);
+        return success(true);
+    }
+
+    @PutMapping("/sync")
+    @Operation(summary = "同步标准薪资项")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:option:update')")
+    public CommonResult<Boolean> syncSalaryOption() {
+        salaryOptionService.syncSalaryOption();
+        return success(true);
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得薪资项列表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:option:query')")
+    public CommonResult<List<HrmSalaryOptionRespVO>> getSalaryOptionList() {
+        List<HrmSalaryOptionDO> list = salaryOptionService.getSalaryOptionList();
+        return success(BeanUtils.toBean(list, HrmSalaryOptionRespVO.class));
+    }
+
+    @GetMapping("/simple-list")
+    @Operation(summary = "获得薪资项精简列表", description = "只包含已启用的薪资项")
+    @Parameter(name = "adjustable", description = "是否可调薪", example = "true")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:option:query')")
+    public CommonResult<List<HrmSalaryOptionRespVO>> getSalaryOptionSimpleList(
+            @RequestParam(value = "adjustable", required = false) Boolean adjustable) {
+        List<HrmSalaryOptionDO> list = salaryOptionService.getSalaryOptionList(adjustable);
+        return success(convertList(list, option -> new HrmSalaryOptionRespVO()
+                .setCode(option.getCode()).setParentCode(option.getParentCode())
+                .setName(option.getName()).setCalculateEnabled(option.getCalculateEnabled())));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipController.java
new file mode 100644
index 0000000..7d9b03d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipController.java
@@ -0,0 +1,135 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipOptionRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipRemarkReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.salary.slip.HrmSalarySlipService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 工资条")
+@RestController
+@RequestMapping("/hrm/salary/slip")
+@Validated
+public class HrmSalarySlipController {
+
+    @Resource
+    private HrmSalarySlipService salarySlipService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @GetMapping("/page")
+    @Operation(summary = "获得工资条分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:query')")
+    public CommonResult<PageResult<HrmSalarySlipRespVO>> getSalarySlipPage(
+            @Validated HrmSalarySlipPageReqVO reqVO) {
+        // 1. 根据员工展示条件获得员工编号
+        if (StrUtil.isNotBlank(reqVO.getSearch()) || reqVO.getDeptId() != null) {
+            HrmEmployeeListReqVO employeeReqVO = new HrmEmployeeListReqVO();
+            employeeReqVO.setSearch(reqVO.getSearch());
+            employeeReqVO.setDeptId(reqVO.getDeptId());
+            Set<Long> employeeIds = convertSet(
+                    employeeService.getEmployeeList(employeeReqVO), HrmEmployeeDO::getId);
+            if (CollUtil.isNotEmpty(reqVO.getEmployeeIds())) {
+                employeeIds.retainAll(reqVO.getEmployeeIds());
+            }
+            if (CollUtil.isEmpty(employeeIds)) {
+                return success(PageResult.empty());
+            }
+            reqVO.setEmployeeIds(new ArrayList<>(employeeIds));
+        }
+
+        // 2. 查询工资条并拼接响应
+        PageResult<HrmSalarySlipDO> pageResult = salarySlipService.getSalarySlipPage(reqVO);
+        return success(new PageResult<>(buildSalarySlipRespVOList(pageResult.getList()), pageResult.getTotal()));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得工资条")
+    @Parameter(name = "id", description = "工资条编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:query')")
+    public CommonResult<HrmSalarySlipRespVO> getSalarySlip(@RequestParam("id") Long id) {
+        return success(buildSalarySlipRespVO(salarySlipService.getSalarySlip(id)));
+    }
+
+    @PutMapping("/remark")
+    @Operation(summary = "修改工资条备注")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:update')")
+    public CommonResult<Boolean> updateSalarySlipRemark(
+            @Valid @RequestBody HrmSalarySlipRemarkReqVO reqVO) {
+        salarySlipService.updateSalarySlipRemark(reqVO);
+        return success(true);
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmSalarySlipRespVO buildSalarySlipRespVO(HrmSalarySlipDO salarySlip) {
+        if (salarySlip == null) {
+            return null;
+        }
+        return CollUtil.getFirst(buildSalarySlipRespVOList(Collections.singletonList(salarySlip)));
+    }
+
+    private List<HrmSalarySlipRespVO> buildSalarySlipRespVOList(List<HrmSalarySlipDO> salarySlips) {
+        if (CollUtil.isEmpty(salarySlips)) {
+            return Collections.emptyList();
+        }
+        // 1. 获取员工、部门信息
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(salarySlips, HrmSalarySlipDO::getEmployeeId));
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId));
+
+        // 2. 拼接响应
+        return convertList(salarySlips, salarySlip -> {
+            HrmSalarySlipRespVO respVO = BeanUtils.toBean(salarySlip, HrmSalarySlipRespVO.class);
+            HrmEmployeeDO employee = employeeMap.get(salarySlip.getEmployeeId());
+            if (employee != null) {
+                respVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                        .setMobile(employee.getMobile()).setDeptId(employee.getDeptId())
+                        .setPostName(employee.getPostName());
+                MapUtils.findAndThen(deptMap, employee.getDeptId(), dept -> respVO.setDeptName(dept.getName()));
+            }
+            respVO.setOptions(BeanUtils.toBean(salarySlip.getOptions(), HrmSalarySlipOptionRespVO.class));
+            return respVO;
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipSendRecordController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipSendRecordController.java
new file mode 100644
index 0000000..40a57c9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipSendRecordController.java
@@ -0,0 +1,182 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.NumberUtil;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendEmployeeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendEmployeeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipSendRecordDO;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.salary.slip.HrmSalarySlipService;
+import cn.iocoder.yudao.module.hrm.service.salary.slip.HrmSalarySlipSendRecordService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 工资条发放记录")
+@RestController
+@RequestMapping("/hrm/salary/slip-send-record")
+@Validated
+public class HrmSalarySlipSendRecordController {
+
+    @Resource
+    private HrmSalarySlipSendRecordService salarySlipSendRecordService;
+    @Resource
+    private HrmSalarySlipService salarySlipService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private DeptApi deptApi;
+
+    @PostMapping("/create")
+    @Operation(summary = "发放工资条")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:create')")
+    public CommonResult<Long> sendSalarySlip(@Valid @RequestBody HrmSalarySlipSendReqVO reqVO) {
+        return success(salarySlipSendRecordService.sendSalarySlip(reqVO));
+    }
+
+    @GetMapping("/employee-page")
+    @Operation(summary = "获得工资条待发员工分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:query')")
+    public CommonResult<PageResult<HrmSalarySlipSendEmployeeRespVO>> getSalarySlipSendEmployeePage(
+            @Valid HrmSalarySlipSendEmployeeReqVO reqVO) {
+        // 1. 获得员工月度工资分页
+        PageResult<HrmSalaryMonthEmployeeRecordDO> pageResult =
+                salarySlipSendRecordService.getSalarySlipSendEmployeePage(reqVO);
+        if (CollUtil.isEmpty(pageResult.getList())) {
+            return success(PageResult.empty(pageResult.getTotal()));
+        }
+
+        // 2.1 获取员工和发放状态
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(pageResult.getList(), HrmSalaryMonthEmployeeRecordDO::getEmployeeId));
+        Set<Long> sentMonthEmployeeRecordIds = salarySlipService.getSentMonthEmployeeRecordIdSet(
+                convertSet(pageResult.getList(), HrmSalaryMonthEmployeeRecordDO::getId));
+        // 2.2 拼接响应
+        return success(new PageResult<>(buildSalarySlipSendEmployeeRespVOList(
+                pageResult.getList(), employeeMap, sentMonthEmployeeRecordIds), pageResult.getTotal()));
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除工资条发放记录")
+    @Parameter(name = "id", description = "发放记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:delete')")
+    public CommonResult<Boolean> deleteSalarySlipSendRecord(@RequestParam("id") Long id) {
+        salarySlipSendRecordService.deleteSalarySlipSendRecord(id);
+        return success(true);
+    }
+
+    @GetMapping("/page")
+    @Operation(summary = "获得工资条发放记录分页")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:query')")
+    public CommonResult<PageResult<HrmSalarySlipSendRecordRespVO>> getSalarySlipSendRecordPage(
+            @Validated HrmSalarySlipSendRecordPageReqVO reqVO) {
+        PageResult<HrmSalarySlipSendRecordDO> pageResult =
+                salarySlipSendRecordService.getSalarySlipSendRecordPage(reqVO);
+        return success(new PageResult<>(buildSalarySlipSendRecordRespVOList(pageResult.getList()),
+                pageResult.getTotal()));
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得工资条发放记录")
+    @Parameter(name = "id", description = "发放记录编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:query')")
+    public CommonResult<HrmSalarySlipSendRecordRespVO> getSalarySlipSendRecord(@RequestParam("id") Long id) {
+        HrmSalarySlipSendRecordDO slipSendRecord =
+                salarySlipSendRecordService.getSalarySlipSendRecord(id);
+        if (slipSendRecord == null) {
+            return success(null);
+        }
+        return success(CollUtil.getFirst(buildSalarySlipSendRecordRespVOList(
+                Collections.singletonList(slipSendRecord))));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private List<HrmSalarySlipSendRecordRespVO> buildSalarySlipSendRecordRespVOList(
+            List<HrmSalarySlipSendRecordDO> slipSendRecords) {
+        if (CollUtil.isEmpty(slipSendRecords)) {
+            return Collections.emptyList();
+        }
+        // 1. 获取关联数据
+        Map<Long, Long> readCountMap = salarySlipService.getSalarySlipReadCountMap(
+                convertSet(slipSendRecords, HrmSalarySlipSendRecordDO::getId));
+        Map<Long, AdminUserRespDTO> creatorMap = adminUserApi.getUserMap(
+                convertSet(slipSendRecords, record -> NumberUtil.isNumber(record.getCreator())
+                        ? NumberUtils.parseLong(record.getCreator()) : null));
+
+        // 2. 拼接响应
+        return BeanUtils.toBean(slipSendRecords, HrmSalarySlipSendRecordRespVO.class, record -> {
+            record.setReadCount(readCountMap.getOrDefault(record.getId(), 0L).intValue())
+                    .setCreatorName(record.getCreator());
+            MapUtils.findAndThen(creatorMap, NumberUtil.isNumber(record.getCreator())
+                            ? NumberUtils.parseLong(record.getCreator()) : null,
+                    creator -> record.setCreatorName(creator.getNickname()));
+        });
+    }
+
+    private List<HrmSalarySlipSendEmployeeRespVO> buildSalarySlipSendEmployeeRespVOList(
+            List<HrmSalaryMonthEmployeeRecordDO> employeeRecords,
+            Map<Long, HrmEmployeeDO> employeeMap, Set<Long> sentMonthEmployeeRecordIds) {
+        if (CollUtil.isEmpty(employeeRecords)) {
+            return Collections.emptyList();
+        }
+        // 1. 获取部门信息
+        Set<Long> deptIds = convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId);
+        Map<Long, DeptRespDTO> deptMap = CollUtil.isEmpty(deptIds)
+                ? Collections.emptyMap() : deptApi.getDeptMap(deptIds);
+
+        // 2. 拼接响应
+        return convertList(employeeRecords, employeeRecord -> {
+            HrmSalarySlipSendEmployeeRespVO respVO =
+                    BeanUtils.toBean(employeeRecord, HrmSalarySlipSendEmployeeRespVO.class);
+            respVO.setMonthEmployeeRecordId(employeeRecord.getId());
+            respVO.setSent(sentMonthEmployeeRecordIds.contains(employeeRecord.getId()));
+            MapUtils.findAndThen(employeeMap, employeeRecord.getEmployeeId(), employee -> {
+                respVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                        .setMobile(employee.getMobile()).setDeptId(employee.getDeptId())
+                        .setPostName(employee.getPostName());
+                MapUtils.findAndThen(deptMap, employee.getDeptId(),
+                        dept -> respVO.setDeptName(dept.getName()));
+            });
+            return respVO;
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipTemplateController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipTemplateController.java
new file mode 100644
index 0000000..e7dba6a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalarySlipTemplateController.java
@@ -0,0 +1,109 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateOptionVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import cn.iocoder.yudao.module.hrm.service.salary.slip.HrmSalarySlipTemplateService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ROOT_PARENT_CODE;
+
+@Tag(name = "管理后台 - HRM 工资条模板")
+@RestController
+@RequestMapping("/hrm/salary/slip-template")
+@Validated
+public class HrmSalarySlipTemplateController {
+
+    @Resource
+    private HrmSalarySlipTemplateService salarySlipTemplateService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建工资条模板")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:update')")
+    public CommonResult<Long> createSalarySlipTemplate(
+            @Valid @RequestBody HrmSalarySlipTemplateSaveReqVO createReqVO) {
+        return success(salarySlipTemplateService.createSalarySlipTemplate(createReqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "更新工资条模板")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:update')")
+    public CommonResult<Boolean> updateSalarySlipTemplate(
+            @Valid @RequestBody HrmSalarySlipTemplateSaveReqVO updateReqVO) {
+        salarySlipTemplateService.updateSalarySlipTemplate(updateReqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除工资条模板")
+    @Parameter(name = "id", description = "模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:delete')")
+    public CommonResult<Boolean> deleteSalarySlipTemplate(@RequestParam("id") Long id) {
+        salarySlipTemplateService.deleteSalarySlipTemplate(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得工资条模板")
+    @Parameter(name = "id", description = "工资条模板编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:query')")
+    public CommonResult<HrmSalarySlipTemplateRespVO> getSalarySlipTemplate(@RequestParam("id") Long id) {
+        return success(buildSalarySlipTemplateRespVO(
+                salarySlipTemplateService.getSalarySlipTemplate(id)));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得工资条模板列表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:slip:query')")
+    public CommonResult<List<HrmSalarySlipTemplateRespVO>> getSalarySlipTemplateList() {
+        return success(convertList(salarySlipTemplateService.getSalarySlipTemplateList(),
+                this::buildSalarySlipTemplateRespVO));
+    }
+
+    // ==================== 拼接 VO ====================
+
+    private HrmSalarySlipTemplateRespVO buildSalarySlipTemplateRespVO(HrmSalarySlipTemplateDO template) {
+        if (template == null) {
+            return null;
+        }
+        return BeanUtils.toBean(template, HrmSalarySlipTemplateRespVO.class)
+                .setOptions(buildSalarySlipTemplateOptionRespVOList(template.getOptions()));
+    }
+
+    private List<HrmSalarySlipTemplateOptionVO> buildSalarySlipTemplateOptionRespVOList(
+            List<HrmSalarySlipTemplateDO.Option> options) {
+        List<HrmSalarySlipTemplateOptionVO> result = new ArrayList<>(convertList(options,
+                option -> BeanUtils.toBean(option, HrmSalarySlipTemplateOptionVO.class)
+                        .setParentCode(ROOT_PARENT_CODE)));
+        for (HrmSalarySlipTemplateDO.Option option : options) {
+            result.addAll(convertList(option.getChildren(), child ->
+                    BeanUtils.toBean(child, HrmSalarySlipTemplateOptionVO.class)
+                            .setParentCode(option.getCode())));
+        }
+        return result;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryTaxRuleController.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryTaxRuleController.java
new file mode 100644
index 0000000..cb2ff66
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/HrmSalaryTaxRuleController.java
@@ -0,0 +1,90 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary;
+
+import cn.iocoder.yudao.framework.common.pojo.CommonResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.taxrule.HrmSalaryTaxRuleRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.taxrule.HrmSalaryTaxRuleSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryGroupService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryTaxRuleService;
+import io.swagger.v3.oas.annotations.Operation;
+import io.swagger.v3.oas.annotations.Parameter;
+import io.swagger.v3.oas.annotations.tags.Tag;
+import jakarta.annotation.Resource;
+import jakarta.validation.Valid;
+import org.springframework.security.access.prepost.PreAuthorize;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.DeleteMapping;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.pojo.CommonResult.success;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+
+@Tag(name = "管理后台 - HRM 计税规则")
+@RestController
+@RequestMapping("/hrm/salary/tax-rule")
+@Validated
+public class HrmSalaryTaxRuleController {
+
+    @Resource
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+    @Resource
+    private HrmSalaryGroupService salaryGroupService;
+
+    @PostMapping("/create")
+    @Operation(summary = "创建计税规则")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:tax-rule:create')")
+    public CommonResult<Long> createSalaryTaxRule(@Valid @RequestBody HrmSalaryTaxRuleSaveReqVO reqVO) {
+        return success(salaryTaxRuleService.createSalaryTaxRule(reqVO));
+    }
+
+    @PutMapping("/update")
+    @Operation(summary = "修改计税规则")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:tax-rule:update')")
+    public CommonResult<Boolean> updateSalaryTaxRule(@Valid @RequestBody HrmSalaryTaxRuleSaveReqVO reqVO) {
+        salaryTaxRuleService.updateSalaryTaxRule(reqVO);
+        return success(true);
+    }
+
+    @DeleteMapping("/delete")
+    @Operation(summary = "删除计税规则")
+    @Parameter(name = "id", description = "计税规则编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:tax-rule:delete')")
+    public CommonResult<Boolean> deleteSalaryTaxRule(@RequestParam("id") Long id) {
+        salaryTaxRuleService.deleteSalaryTaxRule(id);
+        return success(true);
+    }
+
+    @GetMapping("/get")
+    @Operation(summary = "获得计税规则")
+    @Parameter(name = "id", description = "计税规则编号", required = true, example = "1024")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:tax-rule:query')")
+    public CommonResult<HrmSalaryTaxRuleRespVO> getSalaryTaxRule(@RequestParam("id") Long id) {
+        HrmSalaryTaxRuleDO taxRule = salaryTaxRuleService.getSalaryTaxRule(id);
+        return success(BeanUtils.toBean(taxRule, HrmSalaryTaxRuleRespVO.class));
+    }
+
+    @GetMapping("/list")
+    @Operation(summary = "获得计税规则列表")
+    @PreAuthorize("@ss.hasPermission('hrm:salary:tax-rule:query')")
+    public CommonResult<List<HrmSalaryTaxRuleRespVO>> getSalaryTaxRuleList() {
+        // 1. 获得计税规则及其使用数量
+        List<HrmSalaryTaxRuleDO> taxRules = salaryTaxRuleService.getSalaryTaxRuleList();
+        Map<Long, Long> usedGroupCountMap = salaryGroupService.getSalaryGroupCountMapByTaxRuleIds(
+                convertSet(taxRules, HrmSalaryTaxRuleDO::getId));
+
+        // 2. 拼接响应
+        return success(BeanUtils.toBean(taxRules, HrmSalaryTaxRuleRespVO.class,
+                rule -> rule.setUsedGroupCount(usedGroupCountMap.getOrDefault(rule.getId(), 0L))));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changerecord/HrmSalaryChangeRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changerecord/HrmSalaryChangeRecordRespVO.java
new file mode 100644
index 0000000..c02b1f5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changerecord/HrmSalaryChangeRecordRespVO.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changerecord;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 定薪/调薪记录 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class HrmSalaryChangeRecordRespVO {
+
+    @ExcelProperty(value = "记录编号", index = 0)
+    @Schema(description = "记录编号")
+    private Long id;
+
+    @ExcelProperty(value = "员工编号", index = 1)
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "记录类型")
+    private Integer recordType;
+
+    @ExcelProperty(value = "记录类型", index = 2)
+    @Schema(description = "记录类型")
+    private String recordTypeName;
+
+    @ExcelProperty(value = "调整原因", index = 3, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_SALARY_CHANGE_REASON)
+    @Schema(description = "调整原因")
+    private Integer changeReason;
+
+    @ExcelProperty(value = "生效日期", index = 4)
+    @Schema(description = "生效日期")
+    private LocalDateTime effectTime;
+
+    @ExcelProperty(value = "调整前正式工资", index = 5)
+    @Schema(description = "调整前正式工资")
+    private BigDecimal beforeTotal;
+
+    @ExcelProperty(value = "调整后正式工资", index = 6)
+    @Schema(description = "调整后正式工资")
+    private BigDecimal afterTotal;
+
+    @ExcelProperty(value = "调整前试用期工资", index = 7)
+    @Schema(description = "调整前试用期工资")
+    private BigDecimal probationBeforeTotal;
+
+    @ExcelProperty(value = "调整后试用期工资", index = 8)
+    @Schema(description = "调整后试用期工资")
+    private BigDecimal probationAfterTotal;
+
+    @ExcelProperty(value = "状态", index = 9, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_SALARY_CHANGE_RECORD_STATUS)
+    @Schema(description = "状态")
+    private Integer status;
+
+    @ExcelProperty(value = "备注", index = 10)
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "薪资项列表")
+    private List<HrmSalaryOptionValueVO> salaryOptions;
+
+    @Schema(description = "试用期薪资项列表")
+    private List<HrmSalaryOptionValueVO> probationSalaryOptions;
+
+    @ExcelProperty(value = "创建时间", index = 11)
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeOptionVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeOptionVO.java
new file mode 100644
index 0000000..175d310
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeOptionVO.java
@@ -0,0 +1,18 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 调薪项 VO")
+@Data
+public class HrmSalaryChangeOptionVO {
+
+    @Schema(description = "薪资项名称", example = "基本工资")
+    private String name;
+
+    @Schema(description = "薪资项编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "10101")
+    @NotNull(message = "薪资项编码不能为空")
+    private Integer code;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeTemplateRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeTemplateRespVO.java
new file mode 100644
index 0000000..7be2224
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeTemplateRespVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 调薪模板 Response VO")
+@Data
+public class HrmSalaryChangeTemplateRespVO {
+
+    @Schema(description = "调薪模板编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "研发调薪模板")
+    private String name;
+
+    @Schema(description = "是否默认模板", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean defaultStatus;
+
+    @Schema(description = "调薪项配置")
+    private List<HrmSalaryChangeOptionVO> options;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeTemplateSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeTemplateSaveReqVO.java
new file mode 100644
index 0000000..696c1b7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/changetemplate/HrmSalaryChangeTemplateSaveReqVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 调薪模板新增/修改 Request VO")
+@Data
+public class HrmSalaryChangeTemplateSaveReqVO {
+
+    @Schema(description = "调薪模板编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "研发调薪模板")
+    @NotBlank(message = "模板名称不能为空")
+    @Size(max = 64, message = "模板名称不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "是否默认模板", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否默认模板不能为空")
+    private Boolean defaultStatus;
+
+    @Schema(description = "调薪项配置", requiredMode = Schema.RequiredMode.REQUIRED)
+    @Valid
+    @NotEmpty(message = "调薪项配置不能为空")
+    private List<HrmSalaryChangeOptionVO> options;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigCreateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigCreateReqVO.java
new file mode 100644
index 0000000..c532123
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigCreateReqVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalarySocialSecurityMonthTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 计薪配置创建 Request VO")
+@Data
+public class HrmSalaryConfigCreateReqVO {
+
+    @Schema(description = "计薪周期开始日", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "计薪周期开始日不能为空")
+    @Min(value = 1, message = "计薪周期开始日必须在 1 到 31 之间")
+    @Max(value = 31, message = "计薪周期开始日必须在 1 到 31 之间")
+    private Integer cycleStartDay;
+
+    @Schema(description = "社保对应月份类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "社保对应月份类型不能为空")
+    @InEnum(value = HrmSalarySocialSecurityMonthTypeEnum.class, message = "社保对应月份类型必须是 {value}")
+    private Integer socialSecurityMonthType;
+
+    @Schema(description = "工资开始年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    @NotNull(message = "工资开始年份不能为空")
+    @Min(value = 2000, message = "工资开始年份不能小于 2000")
+    @Max(value = 2100, message = "工资开始年份不能大于 2100")
+    private Integer startYear;
+
+    @Schema(description = "工资开始月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    @NotNull(message = "工资开始月份不能为空")
+    @Min(value = 1, message = "工资开始月份必须在 1 到 12 之间")
+    @Max(value = 12, message = "工资开始月份必须在 1 到 12 之间")
+    private Integer startMonth;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigRespVO.java
new file mode 100644
index 0000000..33a329a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigRespVO.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 计薪配置 Response VO")
+@Data
+public class HrmSalaryConfigRespVO {
+
+    @Schema(description = "配置编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Long id;
+
+    @Schema(description = "计薪周期开始日", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer cycleStartDay;
+
+    @Schema(description = "计薪周期结束日", requiredMode = Schema.RequiredMode.REQUIRED, example = "31")
+    private Integer cycleEndDay;
+
+    @Schema(description = "社保对应月份类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer socialSecurityMonthType;
+
+    @Schema(description = "工资开始年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    private Integer startYear;
+
+    @Schema(description = "工资开始月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    private Integer startMonth;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigUpdateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigUpdateReqVO.java
new file mode 100644
index 0000000..b6c181b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/config/HrmSalaryConfigUpdateReqVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalarySocialSecurityMonthTypeEnum;
+import cn.iocoder.yudao.module.hrm.framework.operatelog.core.HrmSalarySocialSecurityMonthTypeParseFunction;
+import com.mzt.logapi.starter.annotation.DiffLogField;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 计薪配置更新 Request VO")
+@Data
+public class HrmSalaryConfigUpdateReqVO {
+
+    @Schema(description = "社保对应月份类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "社保对应月份类型不能为空")
+    @InEnum(value = HrmSalarySocialSecurityMonthTypeEnum.class, message = "社保对应月份类型必须是 {value}")
+    @DiffLogField(name = "社保对应月份", function = HrmSalarySocialSecurityMonthTypeParseFunction.NAME)
+    private Integer socialSecurityMonthType;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoImportRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoImportRespVO.java
new file mode 100644
index 0000000..60b9c7b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoImportRespVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Builder;
+import lombok.Data;
+
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - HRM 员工薪资信息导入 Response VO")
+@Data
+@Builder
+public class HrmSalaryEmployeeInfoImportRespVO {
+
+    @Schema(description = "导入成功的工号数组", requiredMode = Schema.RequiredMode.REQUIRED)
+    private List<String> successJobNumbers;
+
+    @Schema(description = "导入失败的员工集合，key 为工号或行号，value 为失败原因", requiredMode = Schema.RequiredMode.REQUIRED)
+    private Map<String, String> failureJobNumbers;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoPageReqVO.java
new file mode 100644
index 0000000..2601ef5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoPageReqVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工薪资信息分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalaryEmployeeInfoPageReqVO extends PageParam {
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "员工编号列表", example = "[1024, 1025]")
+    private List<Long> employeeIds;
+
+    @Schema(description = "调整类型", example = "1")
+    private Integer changeType;
+
+    @Schema(description = "员工姓名或工号", example = "张三")
+    private String search;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "岗位名称", example = "Java 工程师")
+    private String postName;
+
+    @Schema(description = "员工状态", example = "1")
+    private Integer status;
+
+    @Schema(description = "入职状态", example = "1")
+    private Integer entryStatus;
+
+    @Schema(description = "员工状态页签", example = "1")
+    private Integer statusCategory;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoRespVO.java
new file mode 100644
index 0000000..c1969c0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoRespVO.java
@@ -0,0 +1,97 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo;
+
+import cn.idev.excel.annotation.ExcelIgnoreUnannotated;
+import cn.idev.excel.annotation.ExcelProperty;
+import cn.iocoder.yudao.framework.excel.core.annotations.DictFormat;
+import cn.iocoder.yudao.framework.excel.core.convert.DictConvert;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工薪资信息 Response VO")
+@Data
+@ExcelIgnoreUnannotated
+public class HrmSalaryEmployeeInfoRespVO {
+
+    @ExcelProperty(value = "员工薪资编号", index = 0)
+    @Schema(description = "员工薪资编号")
+    private Long id;
+
+    @ExcelProperty(value = "员工编号", index = 1)
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @ExcelProperty(value = "员工姓名", index = 2)
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @ExcelProperty(value = "工号", index = 3)
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "手机号")
+    private String mobile;
+
+    @ExcelProperty(value = "部门编号", index = 4)
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "部门名称")
+    private String deptName;
+
+    @Schema(description = "岗位名称")
+    private String postName;
+
+    @Schema(description = "入职状态")
+    private Integer entryStatus;
+
+    @Schema(description = "员工状态")
+    private Integer status;
+
+    @Schema(description = "入职时间")
+    private LocalDateTime entryTime;
+
+    @Schema(description = "转正时间")
+    private LocalDateTime regularTime;
+
+    @ExcelProperty(value = "调整原因", index = 6, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_SALARY_CHANGE_REASON)
+    @Schema(description = "调整原因")
+    private Integer changeReason;
+
+    @ExcelProperty(value = "生效日期", index = 7)
+    @Schema(description = "生效日期")
+    private LocalDateTime effectTime;
+
+    @ExcelProperty(value = "薪资状态", index = 5, converter = DictConvert.class)
+    @DictFormat(DictTypeConstants.HRM_SALARY_CHANGE_TYPE)
+    @Schema(description = "薪资状态")
+    private Integer changeType;
+
+    @ExcelProperty(value = "试用期工资", index = 9)
+    @Schema(description = "试用期工资")
+    private BigDecimal probationSalary;
+
+    @ExcelProperty(value = "正式工资", index = 8)
+    @Schema(description = "正式工资")
+    private BigDecimal regularSalary;
+
+    @ExcelProperty(value = "备注", index = 10)
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "薪资项列表")
+    private List<HrmSalaryOptionValueVO> salaryOptions;
+
+    @Schema(description = "试用期薪资项列表")
+    private List<HrmSalaryOptionValueVO> probationSalaryOptions;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateListReqVO.java
new file mode 100644
index 0000000..a114d72
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateListReqVO.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryBatchAdjustTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeReasonEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotEmpty;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 批量调薪 Request VO")
+@Data
+public class HrmSalaryEmployeeInfoUpdateListReqVO {
+
+    @Schema(description = "员工编号列表", example = "[1024, 1025]")
+    private List<@NotNull(message = "员工不能为空") Long> employeeIds;
+
+    @Schema(description = "部门编号列表", example = "[100, 101]")
+    private List<@NotNull(message = "部门不能为空") Long> deptIds;
+
+    @Schema(description = "调薪方式", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "调薪方式不能为空")
+    @InEnum(value = HrmSalaryBatchAdjustTypeEnum.class, message = "调薪方式必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "调整原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "调薪原因不能为空")
+    @InEnum(value = HrmSalaryChangeReasonEnum.class, message = "调薪原因必须是 {value}")
+    private Integer changeReason;
+
+    @Schema(description = "生效日期", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotNull(message = "调薪生效日期不能为空")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "年度统一调薪")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @Schema(description = "薪资项列表", requiredMode = Schema.RequiredMode.REQUIRED)
+    @NotEmpty(message = "调薪项不能为空")
+    @Valid
+    private List<HrmSalaryOptionValueVO> salaryOptions;
+
+    @AssertTrue(message = "至少需要选择一个部门或员工")
+    @JsonIgnore
+    public boolean isScopeValid() {
+        return CollUtil.isNotEmpty(deptIds) || CollUtil.isNotEmpty(employeeIds);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateListRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateListRespVO.java
new file mode 100644
index 0000000..4f8e576
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateListRespVO.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - HRM 批量调薪 Response VO")
+@Data
+public class HrmSalaryEmployeeInfoUpdateListRespVO {
+
+    @Schema(description = "成功员工编号列表")
+    private List<Long> successEmployeeIds = new ArrayList<>();
+
+    @Schema(description = "失败员工及原因")
+    private Map<Long, String> failureEmployeeReasons = new LinkedHashMap<>();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateReqVO.java
new file mode 100644
index 0000000..20bd1a0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/employeeinfo/HrmSalaryEmployeeInfoUpdateReqVO.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工薪资信息修改 Request VO")
+@Data
+public class HrmSalaryEmployeeInfoUpdateReqVO {
+
+    @Schema(description = "定薪/调薪记录编号；编辑待生效或已取消记录时传入", example = "1024")
+    private Long id;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工不能为空")
+    private Long employeeId;
+
+    @Schema(description = "记录类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "记录类型不能为空")
+    @InEnum(value = HrmSalaryChangeRecordTypeEnum.class, message = "记录类型必须是 {value}")
+    private Integer recordType;
+
+    @Schema(description = "调整原因", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "调整原因不能为空")
+    @InEnum(value = HrmSalaryChangeReasonEnum.class, message = "调整原因必须是 {value}")
+    private Integer changeReason;
+
+    @Schema(description = "生效日期")
+    private LocalDateTime effectTime;
+
+    @Schema(description = "备注", example = "年度调薪")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+    @Schema(description = "薪资项列表")
+    @Valid
+    private List<HrmSalaryOptionValueVO> salaryOptions;
+
+    @Schema(description = "试用期薪资项列表")
+    @Valid
+    private List<HrmSalaryOptionValueVO> probationSalaryOptions;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupPageReqVO.java
new file mode 100644
index 0000000..92cba98
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupPageReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 薪资组分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalaryGroupPageReqVO extends PageParam {
+
+    @Schema(description = "薪资组名称", example = "总部薪资组")
+    private String name;
+
+    @Schema(description = "计税规则编号", example = "1024")
+    private Long taxRuleId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupRespVO.java
new file mode 100644
index 0000000..f01bd56
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupRespVO.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 薪资组 Response VO")
+@Data
+public class HrmSalaryGroupRespVO {
+
+    @Schema(description = "薪资组编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "薪资组名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "总部薪资组")
+    private String name;
+
+    @Schema(description = "月计薪标准", example = "21.75")
+    private BigDecimal salaryStandard;
+
+    @Schema(description = "转正、调薪月规则")
+    private String changeRule;
+
+    @Schema(description = "计税规则编号", example = "1024")
+    private Long taxRuleId;
+
+    @Schema(description = "计税规则名称", example = "工资薪金所得税")
+    private String taxRuleName;
+
+    @Schema(description = "适用部门编号列表")
+    private List<Long> deptIds;
+
+    @Schema(description = "适用部门名称列表")
+    private List<String> deptNames;
+
+    @Schema(description = "适用员工编号列表")
+    private List<Long> employeeIds;
+
+    @Schema(description = "适用员工名称列表")
+    private List<String> employeeNames;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupSaveReqVO.java
new file mode 100644
index 0000000..b8711ae
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/group/HrmSalaryGroupSaveReqVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group;
+
+import cn.hutool.core.collection.CollUtil;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 薪资组保存 Request VO")
+@Data
+public class HrmSalaryGroupSaveReqVO {
+
+    @Schema(description = "薪资组编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "薪资组名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "总部薪资组")
+    @NotBlank(message = "薪资组名称不能为空")
+    @Size(max = 64, message = "薪资组名称不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "计税规则编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "计税规则不能为空")
+    private Long taxRuleId;
+
+    @Schema(description = "适用部门编号列表", example = "[100, 101]")
+    private List<Long> deptIds;
+
+    @Schema(description = "适用员工编号列表", example = "[1024, 1025]")
+    private List<Long> employeeIds;
+
+    @AssertTrue(message = "适用部门和适用员工不能同时为空")
+    @JsonIgnore
+    public boolean isScopeValid() {
+        return CollUtil.isNotEmpty(deptIds) || CollUtil.isNotEmpty(employeeIds);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordCreateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordCreateReqVO.java
new file mode 100644
index 0000000..d15e4c3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordCreateReqVO.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 月度工资表创建 Request VO")
+@Data
+public class HrmSalaryMonthRecordCreateReqVO {
+
+    @Schema(description = "年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    @NotNull(message = "年份不能为空")
+    @Min(value = 2000, message = "年份不能小于 2000")
+    @Max(value = 2100, message = "年份不能大于 2100")
+    private Integer year;
+
+    @Schema(description = "月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    @NotNull(message = "月份不能为空")
+    @Min(value = 1, message = "月份必须在 1 到 12 之间")
+    @Max(value = 12, message = "月份必须在 1 到 12 之间")
+    private Integer month;
+
+    @Schema(description = "标题", example = "2026 年 7 月工资表")
+    @Size(max = 128, message = "标题不能超过 128 个字符")
+    private String title;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordPageReqVO.java
new file mode 100644
index 0000000..1e6eb7e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordPageReqVO.java
@@ -0,0 +1,25 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 月度工资表分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalaryMonthRecordPageReqVO extends PageParam {
+
+    @Schema(description = "年份", example = "2026")
+    private Integer year;
+
+    @Schema(description = "月份", example = "7")
+    private Integer month;
+
+    @Schema(description = "核算状态", example = "1")
+    @InEnum(value = HrmSalaryMonthRecordStatusEnum.class, message = "月度工资表状态必须是 {value}")
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordRespVO.java
new file mode 100644
index 0000000..5a8a6f5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryMonthRecordRespVO.java
@@ -0,0 +1,66 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionNodeRespVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 月度工资表 Response VO")
+@Data
+public class HrmSalaryMonthRecordRespVO {
+
+    @Schema(description = "编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    private Integer year;
+
+    @Schema(description = "月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    private Integer month;
+
+    @Schema(description = "标题", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026 年 7 月工资表")
+    private String title;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "员工数量")
+    private Integer employeeCount;
+
+    @Schema(description = "应发工资")
+    private BigDecimal expectedPaySalary;
+
+    @Schema(description = "个人社保金额")
+    private BigDecimal personalInsuranceAmount;
+
+    @Schema(description = "个人公积金金额")
+    private BigDecimal personalProvidentFundAmount;
+
+    @Schema(description = "个人所得税")
+    private BigDecimal personalTax;
+
+    @Schema(description = "实发工资")
+    private BigDecimal realPaySalary;
+
+    @Schema(description = "公司社保金额")
+    private BigDecimal corporateInsuranceAmount;
+
+    @Schema(description = "公司公积金金额")
+    private BigDecimal corporateProvidentFundAmount;
+
+    @Schema(description = "核算状态")
+    private Integer status;
+
+    @Schema(description = "薪资项表头")
+    private List<HrmSalaryOptionNodeRespVO> optionHeaders;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryPayrollReadinessRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryPayrollReadinessRespVO.java
new file mode 100644
index 0000000..6a844df
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/HrmSalaryPayrollReadinessRespVO.java
@@ -0,0 +1,91 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+@Schema(description = "管理后台 - HRM 薪资核算准备 Response VO")
+@Data
+public class HrmSalaryPayrollReadinessRespVO {
+
+    @Schema(description = "工资表编号")
+    private Long monthRecordId;
+
+    @Schema(description = "标题")
+    private String title;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "开始日期")
+    private LocalDateTime startTime;
+
+    @Schema(description = "结束日期")
+    private LocalDateTime endTime;
+
+    @Schema(description = "社保年月")
+    private String socialSecurityYearMonth;
+
+    @Schema(description = "计薪员工人数")
+    private Long payrollEmployeeCount;
+
+    @Schema(description = "已定薪员工人数")
+    private Long salaryEmployeeCount;
+
+    @Schema(description = "未定薪员工人数")
+    private Long noSalaryEmployeeCount;
+
+    @Schema(description = "未分配薪资组员工人数")
+    private Long noSalaryGroupEmployeeCount;
+
+    @Schema(description = "异动员工人数")
+    private Long changeEmployeeCount;
+
+    @Schema(description = "变更类型数量映射")
+    private Map<Integer, Long> changeTypeCountMap;
+
+    @Schema(description = "未定薪员工列表")
+    private List<Employee> noSalaryEmployees;
+    @Schema(description = "未分配薪资组员工列表")
+    private List<Employee> noSalaryGroupEmployees;
+
+    @Schema(description = "管理后台 - HRM 薪资核算准备员工 Response VO")
+    @Data
+    public static class Employee {
+
+        @Schema(description = "员工编号")
+        private Long employeeId;
+
+        @Schema(description = "员工姓名")
+        private String employeeName;
+
+        @Schema(description = "工号")
+        private String jobNumber;
+
+        @Schema(description = "部门编号")
+        private Long deptId;
+
+        @Schema(description = "部门名称")
+        private String deptName;
+
+        @Schema(description = "职位名称")
+        private String postName;
+
+        @Schema(description = "入职状态")
+        private Integer entryStatus;
+
+        @Schema(description = "员工状态")
+        private Integer status;
+
+        @Schema(description = "入职时间")
+        private LocalDateTime entryTime;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryEmployeeMonthRecordPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryEmployeeMonthRecordPageReqVO.java
new file mode 100644
index 0000000..b7b9773
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryEmployeeMonthRecordPageReqVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 员工月度工资分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalaryEmployeeMonthRecordPageReqVO extends PageParam {
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工编号不能为空")
+    private Long employeeId;
+
+    @Schema(description = "月度工资表状态", example = "10")
+    @InEnum(value = HrmSalaryMonthRecordStatusEnum.class, message = "月度工资表状态必须是 {value}")
+    private Integer monthRecordStatus;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordListReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordListReqVO.java
new file mode 100644
index 0000000..6be8ad2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordListReqVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee;
+
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeChangeTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.Collection;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工工资列表 Request VO")
+@Data
+public class HrmSalaryMonthEmployeeRecordListReqVO {
+
+    @Schema(description = "工资表编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "工资表编号不能为空")
+    private Long monthRecordId;
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名", example = "张三")
+    private String employeeName;
+
+    @Schema(description = "工号", example = "HRM001")
+    private String jobNumber;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "员工异动类型", example = "1")
+    @InEnum(value = HrmSalaryEmployeeChangeTypeEnum.class, message = "员工异动分类必须是 {value}")
+    private Integer employeeChangeType;
+
+    @Schema(hidden = true)
+    private Collection<Long> employeeIds;
+
+    @Schema(hidden = true)
+    private Boolean salarySlipSent;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordPageReqVO.java
new file mode 100644
index 0000000..65bf102
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordPageReqVO.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeChangeTypeEnum;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工工资表分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalaryMonthEmployeeRecordPageReqVO extends PageParam {
+
+    @Schema(description = "工资表编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "工资表编号不能为空")
+    private Long monthRecordId;
+
+    @Schema(description = "员工编号", example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名", example = "张三")
+    private String employeeName;
+
+    @Schema(description = "工号", example = "HRM001")
+    private String jobNumber;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "员工异动类型", example = "1")
+    @InEnum(value = HrmSalaryEmployeeChangeTypeEnum.class, message = "员工异动分类必须是 {value}")
+    private Integer employeeChangeType;
+
+    @Schema(description = "员工编号列表", example = "[1024, 1025]")
+    private List<Long> employeeIds;
+
+    @Schema(hidden = true)
+    private Boolean salarySlipSent;
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordRespVO.java
new file mode 100644
index 0000000..578ac76
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordRespVO.java
@@ -0,0 +1,68 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工月度工资 Response VO")
+@Data
+public class HrmSalaryMonthEmployeeRecordRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "工资表编号")
+    private Long monthRecordId;
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "部门")
+    private String deptName;
+
+    @Schema(description = "职位名称")
+    private String postName;
+
+    @Schema(description = "计薪出勤天数")
+    private BigDecimal actualWorkDay;
+
+    @Schema(description = "应出勤天数")
+    private BigDecimal needWorkDay;
+
+    @Schema(description = "应发工资")
+    private BigDecimal expectedPaySalary;
+
+    @Schema(description = "应税工资")
+    private BigDecimal taxableSalary;
+
+    @Schema(description = "个人所得税")
+    private BigDecimal personalTax;
+
+    @Schema(description = "实发工资")
+    private BigDecimal realPaySalary;
+
+    @Schema(description = "绩效系数")
+    private BigDecimal performanceCoefficient;
+
+    @Schema(description = "薪资项值列表")
+    private List<HrmSalaryOptionValueVO> optionValues;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordUpdateReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordUpdateReqVO.java
new file mode 100644
index 0000000..8c4a103
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryMonthEmployeeRecordUpdateReqVO.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 员工工资项修改 Request VO")
+@Data
+public class HrmSalaryMonthEmployeeRecordUpdateReqVO {
+
+    @Schema(description = "员工月度工资记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "员工工资记录编号不能为空")
+    private Long id;
+
+    @Schema(description = "薪资项值列表")
+    @Valid
+    private List<HrmSalaryOptionValueVO> optionValues;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryPerformanceCoefficientReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryPerformanceCoefficientReqVO.java
new file mode 100644
index 0000000..a49f75b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/monthrecord/employee/HrmSalaryPerformanceCoefficientReqVO.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 绩效系数查询 Request VO")
+@Data
+public class HrmSalaryPerformanceCoefficientReqVO {
+
+    @Schema(description = "年份", requiredMode = Schema.RequiredMode.REQUIRED, example = "2026")
+    @NotNull(message = "年份不能为空")
+    private Integer year;
+
+    @Schema(description = "月份", requiredMode = Schema.RequiredMode.REQUIRED, example = "7")
+    @NotNull(message = "月份不能为空")
+    private Integer month;
+
+    @Schema(description = "员工编号列表", example = "[1024, 1025]")
+    private List<Long> employeeIds;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionNodeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionNodeRespVO.java
new file mode 100644
index 0000000..26bf3b4
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionNodeRespVO.java
@@ -0,0 +1,17 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 工资表薪资项节点 Response VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalaryOptionNodeRespVO extends HrmSalaryOptionRespVO {
+
+    @Schema(description = "子薪资项")
+    private List<HrmSalaryOptionNodeRespVO> children;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionRespVO.java
new file mode 100644
index 0000000..4e821a2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionRespVO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 工资表薪资项 Response VO")
+@Data
+public class HrmSalaryOptionRespVO {
+
+    @Schema(description = "薪资项编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "薪资项编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "10101")
+    private Integer code;
+
+    @Schema(description = "父薪资项编码", example = "10")
+    private Integer parentCode;
+
+    @Schema(description = "薪资项名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "基本工资")
+    private String name;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "是否系统默认项", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean systemFlag;
+
+    @Schema(description = "薪资项类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    private Integer type;
+
+    @Schema(description = "是否计税", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean taxEnabled;
+
+    @Schema(description = "是否显示", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean visible;
+
+    @Schema(description = "是否参与计算", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean calculateEnabled;
+
+    @Schema(description = "是否启用", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    private Boolean enabled;
+
+    @Schema(description = "标准薪资项目录编号", example = "1024")
+    private Long templateId;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionSaveReqVO.java
new file mode 100644
index 0000000..a393e57
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionSaveReqVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 工资表薪资项保存 Request VO")
+@Data
+public class HrmSalaryOptionSaveReqVO {
+
+    @Schema(description = "父薪资项编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "10")
+    @NotNull(message = "薪资项分类不能为空")
+    private Integer parentCode;
+
+    @Schema(description = "薪资项名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "基本工资")
+    @NotBlank(message = "薪资项名称不能为空")
+    @Size(max = 64, message = "薪资项名称长度不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "备注", example = "固定薪资项")
+    @Size(max = 255, message = "备注长度不能超过 255 个字符")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionUpdateEnabledReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionUpdateEnabledReqVO.java
new file mode 100644
index 0000000..ecca90e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionUpdateEnabledReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 薪资项更新启用状态 Request VO")
+@Data
+public class HrmSalaryOptionUpdateEnabledReqVO {
+
+    @Schema(description = "薪资项编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "薪资项编号不能为空")
+    private Long id;
+
+    @Schema(description = "是否启用", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "启用状态不能为空")
+    private Boolean enabled;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionUpdateVisibleReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionUpdateVisibleReqVO.java
new file mode 100644
index 0000000..e38b9e0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionUpdateVisibleReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 薪资项更新显示状态 Request VO")
+@Data
+public class HrmSalaryOptionUpdateVisibleReqVO {
+
+    @Schema(description = "薪资项编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "薪资项编号不能为空")
+    private Long id;
+
+    @Schema(description = "是否显示", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "显示状态不能为空")
+    private Boolean visible;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionValueVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionValueVO.java
new file mode 100644
index 0000000..d816ced
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/option/HrmSalaryOptionValueVO.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 薪资项值 VO")
+@Data
+public class HrmSalaryOptionValueVO {
+
+    @Schema(description = "编码", requiredMode = Schema.RequiredMode.REQUIRED, example = "10101")
+    @NotNull(message = "薪资项编码不能为空")
+    private Integer code;
+
+    @Schema(description = "薪资选项值名称")
+    private String name;
+
+    @Schema(description = "值", requiredMode = Schema.RequiredMode.REQUIRED, example = "10000.00")
+    @NotNull(message = "薪资项值不能为空")
+    @Digits(integer = 10, fraction = 2, message = "薪资项值最多 10 位整数和 2 位小数")
+    private BigDecimal value;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipOptionRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipOptionRespVO.java
new file mode 100644
index 0000000..04b19f6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipOptionRespVO.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 工资条项 Response VO")
+@Data
+public class HrmSalarySlipOptionRespVO {
+
+    @Schema(description = "薪资工资条选项名称")
+    private String name;
+
+    @Schema(description = "薪资工资条选项类型")
+    private Integer type;
+
+    @Schema(description = "编码")
+    private Integer code;
+
+    @Schema(description = "值")
+    private BigDecimal value;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "排序")
+    private Integer sort;
+
+    @Schema(description = "子工资条项")
+    private List<HrmSalarySlipOptionRespVO> children;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipPageReqVO.java
new file mode 100644
index 0000000..b48d36c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipPageReqVO.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 工资条分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalarySlipPageReqVO extends PageParam {
+    @Schema(description = "工资条记录编号", example = "1024")
+    private Long sendRecordId;
+    @Schema(description = "员工编号", example = "2048")
+    private Long employeeId;
+    @Schema(description = "员工编号列表", example = "[2048, 2049]")
+    private List<Long> employeeIds;
+    @Schema(description = "搜索关键字", example = "张三")
+    private String search;
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+    @Schema(description = "已读状态", example = "1")
+    private Integer readStatus;
+    @Schema(description = "备注", example = "7 月工资条")
+    private String remark;
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipRemarkReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipRemarkReqVO.java
new file mode 100644
index 0000000..2a4616e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipRemarkReqVO.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 工资条备注 Request VO")
+@Data
+public class HrmSalarySlipRemarkReqVO {
+
+    @Schema(description = "工资条编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "工资条编号不能为空")
+    private Long id;
+
+    @Schema(description = "备注", example = "本月绩效奖金已计入")
+    @Size(max = 500, message = "备注不能超过 500 个字符")
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipRespVO.java
new file mode 100644
index 0000000..86b98fb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/HrmSalarySlipRespVO.java
@@ -0,0 +1,65 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 工资条 Response VO")
+@Data
+public class HrmSalarySlipRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "工资条记录编号")
+    private Long sendRecordId;
+
+    @Schema(description = "员工工资记录编号")
+    private Long monthEmployeeRecordId;
+
+    @Schema(description = "员工编号")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名")
+    private String employeeName;
+
+    @Schema(description = "工号")
+    private String jobNumber;
+
+    @Schema(description = "手机号码")
+    private String mobile;
+
+    @Schema(description = "部门编号")
+    private Long deptId;
+
+    @Schema(description = "部门名称")
+    private String deptName;
+
+    @Schema(description = "岗位名称")
+    private String postName;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "已读状态")
+    private Integer readStatus;
+
+    @Schema(description = "实际工资")
+    private BigDecimal realPaySalary;
+
+    @Schema(description = "备注")
+    private String remark;
+
+    @Schema(description = "选项列表")
+    private List<HrmSalarySlipOptionRespVO> options;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendEmployeeReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendEmployeeReqVO.java
new file mode 100644
index 0000000..199d48e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendEmployeeReqVO.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 工资条待发员工 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalarySlipSendEmployeeReqVO extends PageParam {
+
+    @Schema(description = "月度工资表编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "月度工资表编号不能为空")
+    private Long monthRecordId;
+
+    @Schema(description = "员工姓名、工号或手机号", example = "张三")
+    private String search;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "是否已发送", example = "false")
+    private Boolean sent;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendEmployeeRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendEmployeeRespVO.java
new file mode 100644
index 0000000..27359dd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendEmployeeRespVO.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+@Schema(description = "管理后台 - HRM 工资条待发员工 Response VO")
+@Data
+public class HrmSalarySlipSendEmployeeRespVO {
+
+    @Schema(description = "员工月度工资记录编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long monthEmployeeRecordId;
+
+    @Schema(description = "员工编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long employeeId;
+
+    @Schema(description = "员工姓名", example = "张三")
+    private String employeeName;
+
+    @Schema(description = "工号", example = "HRM001")
+    private String jobNumber;
+
+    @Schema(description = "手机号码", example = "13800138000")
+    private String mobile;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "部门名称", example = "研发部")
+    private String deptName;
+
+    @Schema(description = "岗位名称", example = "Java 工程师")
+    private String postName;
+
+    @Schema(description = "应发工资", example = "10000")
+    private BigDecimal expectedPaySalary;
+
+    @Schema(description = "实发工资", example = "8500")
+    private BigDecimal realPaySalary;
+
+    @Schema(description = "是否已发送", example = "false")
+    private Boolean sent;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendRecordPageReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendRecordPageReqVO.java
new file mode 100644
index 0000000..c7ca7a2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendRecordPageReqVO.java
@@ -0,0 +1,19 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageParam;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+@Schema(description = "管理后台 - HRM 工资条发放记录分页 Request VO")
+@Data
+@EqualsAndHashCode(callSuper = true)
+public class HrmSalarySlipSendRecordPageReqVO extends PageParam {
+
+    @Schema(description = "年份", example = "2026")
+    private Integer year;
+
+    @Schema(description = "月份", example = "7")
+    private Integer month;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendRecordRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendRecordRespVO.java
new file mode 100644
index 0000000..5741c81
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendRecordRespVO.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 工资条发放记录 Response VO")
+@Data
+public class HrmSalarySlipSendRecordRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "工资表编号")
+    private Long monthRecordId;
+
+    @Schema(description = "计薪人数")
+    private Integer employeeCount;
+
+    @Schema(description = "发薪人数")
+    private Integer sendEmployeeCount;
+
+    @Schema(description = "已读人数")
+    private Integer readCount;
+
+    @Schema(description = "年份")
+    private Integer year;
+
+    @Schema(description = "月份")
+    private Integer month;
+
+    @Schema(description = "创建人编号")
+    private String creator;
+
+    @Schema(description = "创建人姓名")
+    private String creatorName;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendReqVO.java
new file mode 100644
index 0000000..e4557f8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/sendrecord/HrmSalarySlipSendReqVO.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateOptionVO;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 工资条发放 Request VO")
+@Data
+public class HrmSalarySlipSendReqVO {
+
+    @Schema(description = "工资表编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    @NotNull(message = "工资表编号不能为空")
+    private Long monthRecordId;
+
+    @Schema(description = "是否隐藏空值项", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    @NotNull(message = "是否隐藏空值项不能为空")
+    private Boolean hideEmpty;
+
+    @Schema(description = "工资条模板项列表")
+    @Valid
+    private List<HrmSalarySlipTemplateOptionVO> options;
+
+    @Schema(description = "是否发放全部筛选结果", requiredMode = Schema.RequiredMode.REQUIRED, example = "false")
+    @NotNull(message = "是否发放全部筛选结果不能为空")
+    private Boolean all;
+
+    @Schema(description = "员工编号列表", example = "[1024, 1025]")
+    private List<Long> employeeIds;
+
+    @Schema(description = "员工姓名、工号或手机号", example = "张三")
+    private String search;
+
+    @Schema(description = "部门编号", example = "100")
+    private Long deptId;
+
+    @Schema(description = "是否已发送", example = "false")
+    private Boolean sent;
+
+    @AssertTrue(message = "发放已选员工时，员工不能为空")
+    @JsonIgnore
+    public boolean isEmployeeIdsValid() {
+        return Boolean.TRUE.equals(all) || CollUtil.isNotEmpty(employeeIds);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateOptionVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateOptionVO.java
new file mode 100644
index 0000000..035b941
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateOptionVO.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+@Schema(description = "管理后台 - HRM 工资条模板项 VO")
+@Data
+public class HrmSalarySlipTemplateOptionVO {
+
+    @Schema(description = "薪资工资条模板选项名称")
+    @NotBlank(message = "工资条模板项名称不能为空")
+    @Size(max = 64, message = "工资条模板项名称不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "薪资工资条模板选项类型")
+    private Integer type;
+
+    @Schema(description = "编码")
+    private Integer code;
+
+    @Schema(description = "备注")
+    @Size(max = 255, message = "备注不能超过 255 个字符")
+    private String remark;
+
+    @Schema(description = "父级编码")
+    private Integer parentCode;
+
+    @Schema(description = "是否隐藏")
+    private Boolean hidden;
+
+    @Schema(description = "排序")
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateRespVO.java
new file mode 100644
index 0000000..deae0e7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateRespVO.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 工资条模板 Response VO")
+@Data
+public class HrmSalarySlipTemplateRespVO {
+
+    @Schema(description = "编号")
+    private Long id;
+
+    @Schema(description = "模板名称")
+    private String name;
+
+    @Schema(description = "是否隐藏空值项")
+    private Boolean hideEmpty;
+
+    @Schema(description = "是否默认选项")
+    private Boolean defaultStatus;
+
+    @Schema(description = "选项列表")
+    private List<HrmSalarySlipTemplateOptionVO> options;
+
+    @Schema(description = "创建时间")
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateSaveReqVO.java
new file mode 100644
index 0000000..e0885a8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/slip/template/HrmSalarySlipTemplateSaveReqVO.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.Valid;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "管理后台 - HRM 工资条模板新增/修改 Request VO")
+@Data
+public class HrmSalarySlipTemplateSaveReqVO {
+
+    @Schema(description = "编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "模板名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "标准工资条模板")
+    @NotBlank(message = "模板名称不能为空")
+    @Size(max = 64, message = "模板名称不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "是否隐藏空值项", example = "true")
+    private Boolean hideEmpty;
+
+    @Schema(description = "选项列表")
+    @Valid
+    private List<HrmSalarySlipTemplateOptionVO> options;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/taxrule/HrmSalaryTaxRuleRespVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/taxrule/HrmSalaryTaxRuleRespVO.java
new file mode 100644
index 0000000..c93b6fe
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/taxrule/HrmSalaryTaxRuleRespVO.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.taxrule;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+@Schema(description = "管理后台 - HRM 计税规则 Response VO")
+@Data
+public class HrmSalaryTaxRuleRespVO {
+
+    @Schema(description = "计税规则编号", requiredMode = Schema.RequiredMode.REQUIRED, example = "1024")
+    private Long id;
+
+    @Schema(description = "计税规则名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "工资薪金所得税")
+    private String name;
+
+    @Schema(description = "计税类型", example = "1")
+    private Integer type;
+
+    @Schema(description = "是否计税", example = "true")
+    private Boolean taxEnabled;
+
+    @Schema(description = "起征阈值", example = "5000")
+    private BigDecimal threshold;
+
+    @Schema(description = "小数位数", example = "2")
+    private Integer decimalScale;
+
+    @Schema(description = "计税周期类型", example = "1")
+    private Integer cycleType;
+
+    @Schema(description = "使用该规则的薪资组数量", example = "2")
+    private Long usedGroupCount;
+
+    @Schema(description = "创建时间", requiredMode = Schema.RequiredMode.REQUIRED)
+    private LocalDateTime createTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/taxrule/HrmSalaryTaxRuleSaveReqVO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/taxrule/HrmSalaryTaxRuleSaveReqVO.java
new file mode 100644
index 0000000..63a6b6f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/admin/salary/vo/taxrule/HrmSalaryTaxRuleSaveReqVO.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.taxrule;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.validation.InEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxTypeEnum;
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.AssertTrue;
+import jakarta.validation.constraints.DecimalMin;
+import jakarta.validation.constraints.Digits;
+import jakarta.validation.constraints.Max;
+import jakarta.validation.constraints.Min;
+import jakarta.validation.constraints.NotBlank;
+import jakarta.validation.constraints.NotNull;
+import jakarta.validation.constraints.Size;
+import lombok.Data;
+
+import java.math.BigDecimal;
+
+
+@Schema(description = "管理后台 - HRM 计税规则保存 Request VO")
+@Data
+public class HrmSalaryTaxRuleSaveReqVO {
+
+    @Schema(description = "计税规则编号", example = "1024")
+    private Long id;
+
+    @Schema(description = "计税规则名称", requiredMode = Schema.RequiredMode.REQUIRED, example = "工资薪金所得税")
+    @NotBlank(message = "计税规则名称不能为空")
+    @Size(max = 64, message = "计税规则名称长度不能超过 64 个字符")
+    private String name;
+
+    @Schema(description = "计税类型", requiredMode = Schema.RequiredMode.REQUIRED, example = "1")
+    @NotNull(message = "计税类型不能为空")
+    @InEnum(value = HrmSalaryTaxTypeEnum.class, message = "计税类型必须是 {value}")
+    private Integer type;
+
+    @Schema(description = "是否计税", requiredMode = Schema.RequiredMode.REQUIRED, example = "true")
+    @NotNull(message = "是否计税不能为空")
+    private Boolean taxEnabled;
+
+    @Schema(description = "起征阈值", example = "5000")
+    @DecimalMin(value = "0.00", message = "起征阈值不能小于 0")
+    @Digits(integer = 10, fraction = 2, message = "起征阈值最多 10 位整数和 2 位小数")
+    private BigDecimal threshold;
+
+    @Schema(description = "小数位数", example = "2")
+    @Min(value = 0, message = "小数位数不能小于 0")
+    @Max(value = 4, message = "小数位数不能大于 4")
+    private Integer decimalScale;
+
+    @Schema(description = "计税周期类型", example = "1")
+    @InEnum(value = HrmSalaryTaxCycleTypeEnum.class, message = "计税周期类型必须是 {value}")
+    private Integer cycleType;
+
+    @AssertTrue(message = "计税规则的起征阈值和小数位数不能为空")
+    @JsonIgnore
+    public boolean isTaxConfigValid() {
+        return HrmSalaryTaxTypeEnum.NONE.getType().equals(type) || threshold != null && decimalScale != null;
+    }
+
+    @AssertTrue(message = "工资薪金所得税的计税周期不能为空")
+    @JsonIgnore
+    public boolean isCycleTypeValid() {
+        return ObjUtil.notEqual(HrmSalaryTaxTypeEnum.SALARY.getType(), type) || cycleType != null;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/package-info.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/package-info.java
new file mode 100644
index 0000000..320cae4
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/controller/package-info.java
@@ -0,0 +1,7 @@
+/**
+ * 提供 RESTful API 给前端
+ *
+ * 1. admin 包：提供给管理后台 yudao-ui-admin 前端项目
+ * 2. admin.portal 包：提供给 HRM 员工自助端
+ */
+package cn.iocoder.yudao.module.hrm.controller;
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/config/HrmAttendanceGroupDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/config/HrmAttendanceGroupDO.java
new file mode 100644
index 0000000..1f4273d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/config/HrmAttendanceGroupDO.java
@@ -0,0 +1,290 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.mybatis.core.type.LongListTypeHandler;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceAbsenteeismDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceLateEarlyDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceHolidayTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceMisscardDeductMethodEnum;
+import cn.iocoder.yudao.module.system.dal.dataobject.dept.DeptDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import com.fasterxml.jackson.annotation.JsonFormat;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.List;
+
+/**
+ * HRM 考勤组 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_attendance_group", autoResultMap = true)
+@KeySequence("hrm_attendance_group_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmAttendanceGroupDO extends BaseDO {
+
+    /**
+     * 考勤组编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 考勤组名称
+     */
+    private String name;
+    /**
+     * 适用部门编号
+     *
+     * 关联 {@link DeptDO#getId()}
+     */
+    @TableField(typeHandler = LongListTypeHandler.class)
+    private List<Long> deptIds;
+    /**
+     * 适用员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    @TableField(typeHandler = LongListTypeHandler.class)
+    private List<Long> employeeIds;
+    /**
+     * 是否启用 WiFi 打卡
+     */
+    private Boolean openWifiCard;
+    /**
+     * 是否启用定位打卡
+     */
+    private Boolean openPointCard;
+    /**
+     * 班次配置
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Shift> shifts;
+    /**
+     * 是否法定节假日休息
+     */
+    private Boolean rest;
+    /**
+     * 特殊日期设置数组
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<SpecialDate> specialDates;
+    /**
+     * 打卡地点配置
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Point> points;
+    /**
+     * WiFi 打卡配置
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Wifi> wifis;
+    /**
+     * 扣款规则
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private DeductRule deductRule;
+    /**
+     * 是否默认考勤组
+     */
+    private Boolean defaultStatus;
+
+    /**
+     * 特殊日期设置
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class SpecialDate {
+
+        /**
+         * 日期类型
+         *
+         * 枚举 {@link HrmAttendanceHolidayTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 特殊日期
+         */
+        private LocalDateTime date;
+    }
+
+    /**
+     * 考勤班次配置
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Shift {
+
+        /**
+         * 工作日数组
+         */
+        private List<Integer> weeks;
+        /**
+         * 上班时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime startTime;
+        /**
+         * 下班时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime endTime;
+        /**
+         * 上班打卡开始时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockInStartTime;
+        /**
+         * 上班打卡结束时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockInEndTime;
+        /**
+         * 下班打卡开始时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockOutStartTime;
+        /**
+         * 下班打卡结束时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime clockOutEndTime;
+        /**
+         * 休息开始时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime restStartTime;
+        /**
+         * 休息结束时间
+         */
+        @JsonFormat(pattern = "HH:mm")
+        private LocalTime restEndTime;
+        /**
+         * 休息时间是否不计入工作时长
+         */
+        private Boolean excludeRestTime;
+    }
+
+    /**
+     * 打卡地点配置
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Point {
+
+        /**
+         * 地点名称
+         */
+        private String name;
+        /**
+         * 定位地址
+         */
+        private String address;
+        /**
+         * 纬度
+         */
+        private BigDecimal latitude;
+        /**
+         * 经度
+         */
+        private BigDecimal longitude;
+        /**
+         * 有效打卡半径，单位：米
+         */
+        private Integer radius;
+    }
+
+    /**
+     * WiFi 打卡配置
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Wifi {
+
+        /**
+         * WiFi 名称
+         */
+        private String ssid;
+        /**
+         * MAC 地址
+         */
+        private String mac;
+    }
+
+    /**
+     * 考勤扣款规则
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class DeductRule {
+
+        /**
+         * 迟到扣款方式
+         *
+         * 枚举 {@link HrmAttendanceLateEarlyDeductMethodEnum}
+         */
+        private Integer lateMethod;
+        /**
+         * 迟到扣款金额
+         */
+        private BigDecimal lateDeductMoney;
+        /**
+         * 早退扣款方式
+         *
+         * 枚举 {@link HrmAttendanceLateEarlyDeductMethodEnum}
+         */
+        private Integer earlyMethod;
+        /**
+         * 早退扣款金额
+         */
+        private BigDecimal earlyDeductMoney;
+        /**
+         * 旷工扣款方式
+         *
+         * 枚举 {@link HrmAttendanceAbsenteeismDeductMethodEnum}
+         */
+        private Integer absenteeismMethod;
+        /**
+         * 旷工扣款金额
+         */
+        private BigDecimal absenteeismDeductMoney;
+        /**
+         * 缺卡扣款方式
+         *
+         * 枚举 {@link HrmAttendanceMisscardDeductMethodEnum}
+         */
+        private Integer misscardMethod;
+        /**
+         * 缺卡扣款金额
+         */
+        private BigDecimal misscardDeductMoney;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/config/HrmAttendanceHolidayDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/config/HrmAttendanceHolidayDO.java
new file mode 100644
index 0000000..662f0a3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/config/HrmAttendanceHolidayDO.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceHolidayTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 考勤节假日 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_attendance_holiday")
+@KeySequence("hrm_attendance_holiday_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmAttendanceHolidayDO extends BaseDO {
+
+    /**
+     * 节假日编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 日期
+     */
+    private LocalDateTime date;
+    /**
+     * 日期类型
+     *
+     * 枚举 {@link HrmAttendanceHolidayTypeEnum}
+     * 字典 {@link DictTypeConstants#HRM_ATTENDANCE_HOLIDAY_TYPE}
+     */
+    private Integer type;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/record/HrmAttendanceClockDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/record/HrmAttendanceClockDO.java
new file mode 100644
index 0000000..aee355d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/record/HrmAttendanceClockDO.java
@@ -0,0 +1,109 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockSourceEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStageEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * HRM 考勤打卡记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_attendance_clock")
+@KeySequence("hrm_attendance_clock_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmAttendanceClockDO extends BaseDO {
+
+    /**
+     * 打卡记录编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 打卡时间
+     */
+    private LocalDateTime clockTime;
+    /**
+     * 打卡类型
+     *
+     * 枚举 {@link HrmAttendanceClockTypeEnum}
+     * 字典 {@link DictTypeConstants#HRM_ATTENDANCE_CLOCK_TYPE}
+     */
+    private Integer type;
+    /**
+     * 应打卡时间
+     */
+    private LocalDateTime attendanceTime;
+    /**
+     * 打卡来源
+     *
+     * 枚举 {@link HrmAttendanceClockSourceEnum}
+     * 字典 {@link DictTypeConstants#HRM_ATTENDANCE_CLOCK_SOURCE}
+     */
+    private Integer sourceType;
+    /**
+     * 打卡状态
+     *
+     * 枚举 {@link HrmAttendanceClockStatusEnum}
+     * 字典 {@link DictTypeConstants#HRM_ATTENDANCE_CLOCK_STATUS}
+     */
+    private Integer status;
+    /**
+     * 打卡阶段
+     *
+     * 枚举 {@link HrmAttendanceClockStageEnum}
+     */
+    private Integer stage;
+    /**
+     * 打卡地址
+     */
+    private String address;
+    /**
+     * 经度
+     */
+    private BigDecimal longitude;
+    /**
+     * 纬度
+     */
+    private BigDecimal latitude;
+    /**
+     * WiFi 名称
+     */
+    private String ssid;
+    /**
+     * WiFi MAC 地址
+     */
+    private String mac;
+    /**
+     * 备注
+     */
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/record/HrmAttendanceLeaveDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/record/HrmAttendanceLeaveDO.java
new file mode 100644
index 0000000..a1b0be8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/attendance/record/HrmAttendanceLeaveDO.java
@@ -0,0 +1,93 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * HRM 考勤请假 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_attendance_leave")
+@KeySequence("hrm_attendance_leave_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmAttendanceLeaveDO extends BaseDO {
+
+    /**
+     * 请假记录编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 请假类型
+     *
+     * 字典 {@link DictTypeConstants#HRM_ATTENDANCE_LEAVE_TYPE}
+     */
+    private String type;
+    /**
+     * 请假开始时间
+     */
+    private LocalDateTime startTime;
+    /**
+     * 请假结束时间
+     */
+    private LocalDateTime endTime;
+    /**
+     * 请假时长
+     */
+    private BigDecimal day;
+    /**
+     * 请假理由
+     */
+    private String reason;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 审批状态
+     *
+     * 枚举 {@link BpmProcessInstanceStatusEnum}
+     */
+    private Integer approvalStatus;
+    /**
+     * BPM 流程实例编号
+     *
+     * 关联 ProcessInstance 的 id 属性
+     */
+    private String processInstanceId;
+    /**
+     * 审批完成时间
+     */
+    private LocalDateTime approvalTime;
+    /**
+     * 审批或取消原因
+     */
+    private String approvalReason;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/config/HrmConfigDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/config/HrmConfigDO.java
new file mode 100644
index 0000000..48977a8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/config/HrmConfigDO.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.config.HrmConfigTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 通用业务配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_config")
+@KeySequence("hrm_config_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmConfigDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 配置类型
+     *
+     * 枚举 {@link HrmConfigTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 配置值
+     */
+    private String value;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeChangeRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeChangeRecordDO.java
new file mode 100644
index 0000000..69283eb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeChangeRecordDO.java
@@ -0,0 +1,123 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.system.dal.dataobject.dept.DeptDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工异动记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_change_record")
+@KeySequence("hrm_employee_change_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeChangeRecordDO extends BaseDO {
+
+    /**
+     * 异动记录编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 异动类型
+     *
+     * 枚举 {@link HrmEmployeeChangeTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 异动原因
+     *
+     * 枚举 {@link HrmEmployeeChangeReasonEnum}
+     */
+    private Integer reason;
+    /**
+     * 原部门编号
+     *
+     * 关联 {@link DeptDO#getId()}
+     */
+    private Long oldDeptId;
+    /**
+     * 新部门编号
+     *
+     * 关联 {@link DeptDO#getId()}
+     */
+    private Long newDeptId;
+    /**
+     * 原岗位
+     */
+    private String oldPostName;
+    /**
+     * 新岗位
+     */
+    private String newPostName;
+    /**
+     * 原职级
+     */
+    private String oldPostLevel;
+    /**
+     * 新职级
+     */
+    private String newPostLevel;
+    /**
+     * 原工作地点
+     */
+    private String oldWorkAddress;
+    /**
+     * 新工作地点
+     */
+    private String newWorkAddress;
+    /**
+     * 原直属上级员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long oldLeaderEmployeeId;
+    /**
+     * 新直属上级员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long newLeaderEmployeeId;
+    /**
+     * 试用期，单位：月
+     */
+    private Integer probation;
+    /**
+     * 生效日期
+     */
+    private LocalDateTime effectTime;
+    /**
+     * 实际生效时间
+     */
+    private LocalDateTime appliedTime;
+    /**
+     * 备注
+     */
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeContractDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeContractDO.java
new file mode 100644
index 0000000..0fdf476
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeContractDO.java
@@ -0,0 +1,103 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.mybatis.core.type.StringListTypeHandler;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeContractStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeContractTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 员工合同 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_employee_contract", autoResultMap = true)
+@KeySequence("hrm_employee_contract_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeContractDO extends BaseDO {
+
+    /**
+     * 合同编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 合同编号
+     */
+    private String no;
+    /**
+     * 合同类型
+     *
+     * 枚举 {@link HrmEmployeeContractTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 合同开始日期
+     */
+    private LocalDateTime startTime;
+    /**
+     * 合同结束日期
+     */
+    private LocalDateTime endTime;
+    /**
+     * 合同期限，单位：年
+     */
+    private Integer term;
+    /**
+     * 合同状态
+     *
+     * 枚举 {@link HrmEmployeeContractStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 签约公司
+     */
+    private String signCompany;
+    /**
+     * 合同签订日期
+     */
+    private LocalDateTime signTime;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否到期提醒
+     *
+     */
+    private Boolean expireRemind;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 附件地址数组
+     */
+    @TableField(typeHandler = StringListTypeHandler.class)
+    private List<String> fileUrls;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeQuitInfoDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeQuitInfoDO.java
new file mode 100644
index 0000000..24f40d9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeQuitInfoDO.java
@@ -0,0 +1,81 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeQuitReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeQuitTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工离职信息 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_quit_info")
+@KeySequence("hrm_employee_quit_info_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeQuitInfoDO extends BaseDO {
+
+    /**
+     * 离职信息编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 计划离职时间
+     */
+    private LocalDateTime planQuitTime;
+    /**
+     * 申请离职时间
+     */
+    private LocalDateTime applyQuitTime;
+    /**
+     * 薪资结算时间
+     */
+    private LocalDateTime salarySettlementTime;
+    /**
+     * 离职类型
+     *
+     * 枚举 {@link HrmEmployeeQuitTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 离职原因
+     *
+     * 枚举 {@link HrmEmployeeQuitReasonEnum}
+     */
+    private Integer reason;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 离职前员工状态
+     *
+     * 枚举 {@link HrmEmployeeStatusEnum}
+     */
+    private Integer oldEmployeeStatus;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeSalaryCardDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeSalaryCardDO.java
new file mode 100644
index 0000000..de9d2e5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/employment/HrmEmployeeSalaryCardDO.java
@@ -0,0 +1,58 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.ip.core.Area;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 员工工资卡 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_salary_card")
+@KeySequence("hrm_employee_salary_card_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeSalaryCardDO extends BaseDO {
+
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 银行卡号
+     */
+    private String bankCardNumber;
+    /**
+     * 开户地区编号
+     *
+     * 关联 {@link Area#getId()}
+     */
+    private Integer bankAreaId;
+    /**
+     * 银行名称
+     */
+    private String bankName;
+    /**
+     * 开户支行名称
+     */
+    private String bankBranchName;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeCertificateDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeCertificateDO.java
new file mode 100644
index 0000000..f8334c5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeCertificateDO.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工证书 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_certificate")
+@KeySequence("hrm_employee_certificate_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeCertificateDO extends BaseDO {
+
+    /**
+     * 证书编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 证书名称
+     */
+    private String name;
+    /**
+     * 证书级别
+     */
+    private String level;
+    /**
+     * 证书编号
+     */
+    private String no;
+    /**
+     * 有效开始日期
+     */
+    private LocalDateTime startTime;
+    /**
+     * 有效结束日期
+     */
+    private LocalDateTime endTime;
+    /**
+     * 发证机构
+     */
+    private String issuingAuthority;
+    /**
+     * 发证日期
+     */
+    private LocalDateTime issuingTime;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeEducationExperienceDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeEducationExperienceDO.java
new file mode 100644
index 0000000..c0d2de9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeEducationExperienceDO.java
@@ -0,0 +1,85 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.enums.employee.experience.HrmEmployeeEducationEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.experience.HrmEmployeeTeachingMethodEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工教育经历 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_education_experience")
+@KeySequence("hrm_employee_education_experience_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeEducationExperienceDO extends BaseDO {
+
+    /**
+     * 教育经历编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 学历
+     *
+     * 枚举 {@link HrmEmployeeEducationEnum}
+     * 字典 {@link DictTypeConstants#HRM_EMPLOYEE_EDUCATION}
+     */
+    private Integer education;
+    /**
+     * 毕业院校
+     */
+    private String graduateSchool;
+    /**
+     * 专业
+     */
+    private String major;
+    /**
+     * 入学日期
+     */
+    private LocalDateTime admissionTime;
+    /**
+     * 毕业日期
+     */
+    private LocalDateTime graduationTime;
+    /**
+     * 教学方式
+     *
+     * 枚举 {@link HrmEmployeeTeachingMethodEnum}
+     */
+    private Integer teachingMethods;
+    /**
+     * 是否第一学历
+     *
+     */
+    private Boolean firstDegree;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeTrainingExperienceDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeTrainingExperienceDO.java
new file mode 100644
index 0000000..afb4be1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeTrainingExperienceDO.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工培训经历 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_training_experience")
+@KeySequence("hrm_employee_training_experience_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeTrainingExperienceDO extends BaseDO {
+
+    /**
+     * 培训经历编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 培训课程
+     */
+    private String course;
+    /**
+     * 培训机构名称
+     */
+    private String organizationName;
+    /**
+     * 培训开始日期
+     */
+    private LocalDateTime startTime;
+    /**
+     * 培训结束日期
+     */
+    private LocalDateTime endTime;
+    /**
+     * 培训时长
+     */
+    private String duration;
+    /**
+     * 培训成绩
+     */
+    private String result;
+    /**
+     * 培训证书名称
+     */
+    private String certificateName;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeWorkExperienceDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeWorkExperienceDO.java
new file mode 100644
index 0000000..736ab55
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/experience/HrmEmployeeWorkExperienceDO.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工工作经历 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_work_experience")
+@KeySequence("hrm_employee_work_experience_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeWorkExperienceDO extends BaseDO {
+
+    /**
+     * 工作经历编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 工作单位
+     */
+    private String workUnit;
+    /**
+     * 职务
+     */
+    private String postName;
+    /**
+     * 工作开始日期
+     */
+    private LocalDateTime startTime;
+    /**
+     * 工作结束日期
+     */
+    private LocalDateTime endTime;
+    /**
+     * 离职原因
+     */
+    private String reason;
+    /**
+     * 证明人
+     */
+    private String witnessName;
+    /**
+     * 证明人手机号
+     */
+    private String witnessPhone;
+    /**
+     * 工作备注
+     */
+    private String remark;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeContactDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeContactDO.java
new file mode 100644
index 0000000..8f4a00e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeContactDO.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 员工联系人 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_contact")
+@KeySequence("hrm_employee_contact_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeContactDO extends BaseDO {
+
+    /**
+     * 联系人编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 联系人名称
+     */
+    private String name;
+    /**
+     * 与员工的关系
+     */
+    private String relation;
+    /**
+     * 联系人电话
+     */
+    private String phone;
+    /**
+     * 联系人工作单位
+     */
+    private String workUnit;
+    /**
+     * 联系人职务
+     */
+    private String postName;
+    /**
+     * 联系人地址
+     */
+    private String address;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeDO.java
new file mode 100644
index 0000000..ef63346
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeDO.java
@@ -0,0 +1,213 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.enums.employee.experience.HrmEmployeeEducationEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeIdTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.system.dal.dataobject.dept.DeptDO;
+import cn.iocoder.yudao.module.system.dal.dataobject.user.AdminUserDO;
+import cn.iocoder.yudao.module.system.enums.common.SexEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工档案 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee")
+@KeySequence("hrm_employee_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeDO extends BaseDO {
+
+    /**
+     * 员工编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工姓名
+     */
+    private String name;
+    /**
+     * 工号
+     */
+    private String jobNumber;
+    /**
+     * 后台用户编号
+     *
+     * 关联 {@link AdminUserDO#getId()}
+     * 允许为空，用于待入职、离职历史等没有登录账号的员工档案
+     */
+    private Long userId;
+    /**
+     * 手机号码
+     */
+    private String mobile;
+    /**
+     * 国家或地区
+     */
+    private String country;
+    /**
+     * 民族
+     */
+    private String nation;
+    /**
+     * 证件类型
+     *
+     * 枚举 {@link HrmEmployeeIdTypeEnum}
+     */
+    private Integer idType;
+    /**
+     * 证件号码
+     */
+    private String idNumber;
+    /**
+     * 性别
+     *
+     * 枚举 {@link SexEnum}
+     */
+    private Integer sex;
+    /**
+     * 邮箱
+     */
+    private String email;
+    /**
+     * 籍贯
+     */
+    private String nativePlace;
+    /**
+     * 出生时间
+     */
+    private LocalDateTime birthday;
+    /**
+     * 年龄
+     */
+    private Integer age;
+    /**
+     * 户籍地址
+     */
+    private String address;
+    /**
+     * 最高学历
+     *
+     * 枚举 {@link HrmEmployeeEducationEnum}
+     * 字典 {@link DictTypeConstants#HRM_EMPLOYEE_EDUCATION}
+     */
+    private Integer highestEducation;
+    /**
+     * 部门编号
+     *
+     * 关联 {@link DeptDO#getId()}
+     */
+    private Long deptId;
+    /**
+     * 直属上级员工编号
+     *
+     * 关联 {@link #id}
+     */
+    private Long leaderEmployeeId;
+    /**
+     * 入职状态
+     *
+     * 枚举 {@link HrmEmployeeEntryStatusEnum}
+     * 字典 {@link DictTypeConstants#HRM_EMPLOYEE_ENTRY_STATUS}
+     */
+    private Integer entryStatus;
+    /**
+     * 员工状态
+     *
+     * 枚举 {@link HrmEmployeeStatusEnum}
+     * 字典 {@link DictTypeConstants#HRM_EMPLOYEE_STATUS}
+     */
+    private Integer status;
+    /**
+     * 聘用形式
+     *
+     * 枚举 {@link HrmEmployeeTypeEnum}
+     * 字典 {@link DictTypeConstants#HRM_EMPLOYEE_TYPE}
+     */
+    private Integer type;
+    /**
+     * 入职时间
+     */
+    private LocalDateTime entryTime;
+    /**
+     * 试用期，单位：月
+     *
+     * 0 表示无试用期
+     */
+    private Integer probation;
+    /**
+     * 转正时间
+     */
+    private LocalDateTime regularTime;
+    /**
+     * 离职时间
+     */
+    private LocalDateTime leaveTime;
+    /**
+     * 职位名称
+     */
+    private String postName;
+    /**
+     * 岗位职级
+     */
+    private String postLevel;
+    /**
+     * 工作城市
+     */
+    private String workCity;
+    /**
+     * 工作地址
+     */
+    private String workAddress;
+    /**
+     * 工作详细地址
+     */
+    private String workDetailAddress;
+    /**
+     * 招聘渠道编号
+     *
+     * 关联 {@link HrmRecruitChannelDO#getId()}
+     */
+    private Long channelId;
+    /**
+     * 司龄开始时间
+     */
+    private LocalDateTime companyAgeStartTime;
+    /**
+     * 司龄，单位：年
+     */
+    private Integer companyAge;
+    /**
+     * 招聘候选人编号
+     *
+     * 关联 {@link HrmRecruitCandidateDO#getId()}
+     */
+    private Long candidateId;
+    /**
+     * 备注
+     */
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeFileDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeFileDO.java
new file mode 100644
index 0000000..637726f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeeFileDO.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeFileTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 员工材料附件 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_file")
+@KeySequence("hrm_employee_file_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeeFileDO extends BaseDO {
+
+    /**
+     * 附件编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 附件类型
+     *
+     * 枚举 {@link HrmEmployeeFileTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 附件地址
+     */
+    private String url;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeePersonalNoteDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeePersonalNoteDO.java
new file mode 100644
index 0000000..32b4696
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/employee/info/HrmEmployeePersonalNoteDO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工个人备忘 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_employee_personal_note")
+@KeySequence("hrm_employee_personal_note_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmEmployeePersonalNoteDO extends BaseDO {
+
+    @TableId
+    private Long id;
+
+    /**
+     * 所属员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+
+    /**
+     * 备忘内容
+     */
+    private String content;
+
+    /**
+     * 提醒时间
+     */
+    private LocalDateTime reminderTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/config/HrmInsuranceSchemeDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/config/HrmInsuranceSchemeDO.java
new file mode 100644
index 0000000..b3b3ecd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/config/HrmInsuranceSchemeDO.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceSchemeTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 社保方案 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_insurance_scheme")
+@KeySequence("hrm_insurance_scheme_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmInsuranceSchemeDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 方案名称
+     */
+    private String name;
+    /**
+     * 参保地区编号
+     */
+    private Integer areaId;
+    /**
+     * 户籍类型
+     */
+    private String householdType;
+    /**
+     * 方案类型
+     *
+     * 枚举 {@link HrmInsuranceSchemeTypeEnum}
+     */
+    private Integer type;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/config/HrmInsuranceSchemeProjectDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/config/HrmInsuranceSchemeProjectDO.java
new file mode 100644
index 0000000..3250653
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/config/HrmInsuranceSchemeProjectDO.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * HRM 社保方案项目 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_insurance_scheme_project")
+@KeySequence("hrm_insurance_scheme_project_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmInsuranceSchemeProjectDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 社保方案编号
+     *
+     * 关联 {@link HrmInsuranceSchemeDO#getId()}
+     */
+    private Long schemeId;
+    /**
+     * 项目类型
+     *
+     * 枚举 {@link HrmInsuranceProjectTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 项目名称
+     */
+    private String name;
+    /**
+     * 缴纳基数
+     */
+    private BigDecimal baseAmount;
+    /**
+     * 公司缴纳比例
+     */
+    private BigDecimal corporateRate;
+    /**
+     * 个人缴纳比例
+     */
+    private BigDecimal personalRate;
+    /**
+     * 公司缴纳金额
+     */
+    private BigDecimal corporateAmount;
+    /**
+     * 个人缴纳金额
+     */
+    private BigDecimal personalAmount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/employee/HrmInsuranceEmployeeInfoDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/employee/HrmInsuranceEmployeeInfoDO.java
new file mode 100644
index 0000000..d1af7fa
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/employee/HrmInsuranceEmployeeInfoDO.java
@@ -0,0 +1,68 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工参保信息 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_insurance_employee_info")
+@KeySequence("hrm_insurance_employee_info_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmInsuranceEmployeeInfoDO extends BaseDO {
+
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 是否首次参保
+     */
+    private Boolean firstSocialSecurity;
+    /**
+     * 是否首次缴纳公积金
+     */
+    private Boolean firstAccumulationFund;
+    /**
+     * 社保账号
+     */
+    private String socialSecurityNumber;
+    /**
+     * 公积金账号
+     */
+    private String accumulationFundNumber;
+    /**
+     * 社保起缴月份
+     */
+    private LocalDateTime socialSecurityStartMonth;
+    /**
+     * 社保方案编号
+     *
+     * 关联 {@link HrmInsuranceSchemeDO#getId()}
+     */
+    private Long schemeId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordDO.java
new file mode 100644
index 0000000..9cd25f7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordDO.java
@@ -0,0 +1,146 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.employee.HrmInsuranceEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * HRM 员工月度社保记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_insurance_month_employee_record", autoResultMap = true)
+@KeySequence("hrm_insurance_month_employee_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmInsuranceMonthEmployeeRecordDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 月度社保表编号
+     *
+     * 关联 {@link HrmInsuranceMonthRecordDO#getId()}
+     */
+    private Long monthRecordId;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 社保方案编号
+     *
+     * 关联 {@link HrmInsuranceSchemeDO#getId()}
+     */
+    private Long schemeId;
+    /**
+     * 年份
+     */
+    private Integer year;
+    /**
+     * 月份
+     */
+    private Integer month;
+    /**
+     * 个人社保金额
+     */
+    private BigDecimal personalInsuranceAmount;
+    /**
+     * 个人公积金金额
+     */
+    private BigDecimal personalProvidentFundAmount;
+    /**
+     * 公司社保金额
+     */
+    private BigDecimal corporateInsuranceAmount;
+    /**
+     * 公司公积金金额
+     */
+    private BigDecimal corporateProvidentFundAmount;
+    /**
+     * 参保状态
+     *
+     * 枚举 {@link HrmInsuranceEmployeeStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 参保项目快照
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Project> projects;
+
+    /**
+     * 参保项目快照
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Project {
+
+        /**
+         * 来源社保方案项目编号
+         *
+         * 关联 {@link HrmInsuranceSchemeProjectDO#getId()}
+         */
+        private Long schemeProjectId;
+        /**
+         * 项目类型
+         *
+         * 枚举 {@link HrmInsuranceProjectTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 项目名称
+         */
+        private String name;
+        /**
+         * 缴纳基数
+         */
+        private BigDecimal baseAmount;
+        /**
+         * 公司缴纳比例
+         */
+        private BigDecimal corporateRate;
+        /**
+         * 个人缴纳比例
+         */
+        private BigDecimal personalRate;
+        /**
+         * 公司缴纳金额
+         */
+        private BigDecimal corporateAmount;
+        /**
+         * 个人缴纳金额
+         */
+        private BigDecimal personalAmount;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/monthrecord/HrmInsuranceMonthRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/monthrecord/HrmInsuranceMonthRecordDO.java
new file mode 100644
index 0000000..3b57cc7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/insurance/monthrecord/HrmInsuranceMonthRecordDO.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.monthrecord.HrmInsuranceMonthStatusEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * HRM 月度社保表 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_insurance_month_record")
+@KeySequence("hrm_insurance_month_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmInsuranceMonthRecordDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 标题
+     */
+    private String title;
+    /**
+     * 年份
+     */
+    private Integer year;
+    /**
+     * 月份
+     */
+    private Integer month;
+    /**
+     * 参保人数
+     */
+    private Integer insuredEmployeeCount;
+    /**
+     * 停保人数
+     */
+    private Integer stoppedEmployeeCount;
+    /**
+     * 状态
+     *
+     * 枚举 {@link HrmInsuranceMonthStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 个人社保金额
+     */
+    private BigDecimal personalInsuranceAmount;
+    /**
+     * 个人公积金金额
+     */
+    private BigDecimal personalProvidentFundAmount;
+    /**
+     * 公司社保金额
+     */
+    private BigDecimal corporateInsuranceAmount;
+    /**
+     * 公司公积金金额
+     */
+    private BigDecimal corporateProvidentFundAmount;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentActionRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentActionRecordDO.java
new file mode 100644
index 0000000..5652b1f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentActionRecordDO.java
@@ -0,0 +1,79 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.util.List;
+
+/**
+ * HRM 员工绩效考核动作记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_performance_assessment_action_record", autoResultMap = true)
+@KeySequence("hrm_performance_assessment_action_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmPerformanceAssessmentActionRecordDO extends BaseDO {
+
+    /**
+     * 动作记录编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工绩效考核编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentDO#getId()}
+     */
+    private Long assessmentId;
+    /**
+     * 员工绩效考核阶段编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentStageDO#getId()}
+     */
+    private Long stageId;
+    /**
+     * 操作员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 动作类型
+     *
+     * 枚举 {@link HrmPerformanceAssessmentActionTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 动作标题
+     */
+    private String title;
+    /**
+     * 动作内容
+     */
+    private String content;
+    /**
+     * 附件地址列表
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<String> fileUrls;
+    /**
+     * 动作完成后的阶段状态
+     *
+     * 枚举 {@link HrmPerformanceAssessmentStageStatusEnum}
+     */
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentAppealRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentAppealRecordDO.java
new file mode 100644
index 0000000..8e8b466
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentAppealRecordDO.java
@@ -0,0 +1,48 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealRecordStatusEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+/**
+ * HRM 员工绩效考核申诉记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_performance_assessment_appeal_record")
+@KeySequence("hrm_performance_assessment_appeal_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmPerformanceAssessmentAppealRecordDO extends BaseDO {
+
+    /**
+     * 申诉记录编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工绩效考核编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentDO#getId()}
+     */
+    private Long assessmentId;
+    /**
+     * 员工绩效考核阶段编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentStageDO#getId()}
+     */
+    private Long stageId;
+    /**
+     * 处理状态
+     *
+     * 枚举 {@link HrmPerformanceAppealRecordStatusEnum}
+     */
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentDO.java
new file mode 100644
index 0000000..1d856b2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentDO.java
@@ -0,0 +1,171 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.mybatis.core.type.StringListTypeHandler;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceConfirmationResultEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentProcessStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceResultAuditStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 员工绩效考核 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_performance_assessment", autoResultMap = true)
+@KeySequence("hrm_performance_assessment_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmPerformanceAssessmentDO extends BaseDO {
+
+    /**
+     * 员工绩效考核编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 绩效计划编号
+     *
+     * 关联 {@link HrmPerformancePlanDO#getId()}
+     */
+    private Long planId;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 考核状态
+     *
+     * 枚举 {@link HrmPerformancePlanStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 流程处理状态
+     *
+     * 枚举 {@link HrmPerformanceAssessmentProcessStatusEnum}
+     */
+    private Integer processStatus;
+    /**
+     * 当前业务阶段类型
+     *
+     * 枚举 {@link HrmPerformanceStageTypeEnum}
+     */
+    private Integer stageType;
+    /**
+     * 当前阶段排序
+     */
+    private Integer stageSort;
+    /**
+     * 综合得分
+     */
+    private BigDecimal score;
+    /**
+     * 结果等级
+     */
+    private String resultLevel;
+    /**
+     * 绩效系数
+     */
+    private BigDecimal coefficient;
+    /**
+     * 目标确认结果
+     *
+     * 枚举 {@link HrmPerformanceConfirmationResultEnum}
+     */
+    private Integer targetConfirmationResult;
+    /**
+     * 目标确认意见
+     */
+    private String targetConfirmationComment;
+    /**
+     * 目标确认时间
+     */
+    private LocalDateTime targetConfirmationTime;
+    /**
+     * 自评说明
+     */
+    private String selfComment;
+    /**
+     * 他评说明
+     */
+    private String reviewerComment;
+    /**
+     * 结果说明
+     */
+    private String resultComment;
+    /**
+     * 结果确认时间
+     */
+    private LocalDateTime resultConfirmationTime;
+    /**
+     * 结果审核状态
+     *
+     * 枚举 {@link HrmPerformanceResultAuditStatusEnum}
+     */
+    private Integer resultAuditStatus;
+    /**
+     * 结果审核时间
+     */
+    private LocalDateTime resultAuditTime;
+    /**
+     * 结果审核意见
+     */
+    private String resultAuditReason;
+
+    /**
+     * 申诉原因
+     */
+    private String appealReason;
+    /**
+     * 申诉附件地址列表
+     */
+    @TableField(typeHandler = StringListTypeHandler.class)
+    private List<String> appealFileUrls;
+    /**
+     * 申诉提交时间
+     */
+    private LocalDateTime appealSubmitTime;
+    /**
+     * 申诉状态
+     *
+     * 枚举 {@link HrmPerformanceAppealStatusEnum}
+     */
+    private Integer appealStatus;
+    /**
+     * 申诉完成时间
+     */
+    private LocalDateTime appealTime;
+    /**
+     * 申诉处理意见
+     */
+    private String appealComment;
+    /**
+     * 归档时间
+     */
+    private LocalDateTime archiveTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentDimensionDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentDimensionDO.java
new file mode 100644
index 0000000..1ce4457
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentDimensionDO.java
@@ -0,0 +1,64 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceQuotaTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * HRM 员工绩效考核维度 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_performance_assessment_dimension")
+@KeySequence("hrm_performance_assessment_dimension_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmPerformanceAssessmentDimensionDO extends BaseDO {
+
+    /**
+     * 考核维度编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工绩效考核编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentDO#getId()}
+     */
+    private Long assessmentId;
+    /**
+     * 维度名称
+     */
+    private String name;
+    /**
+     * 指标类型
+     *
+     * 枚举 {@link HrmPerformanceQuotaTypeEnum}
+     */
+    private Integer quotaType;
+    /**
+     * 维度权重
+     */
+    private BigDecimal weight;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否允许员工编辑指标
+     */
+    private Boolean allowEdit;
+    /**
+     * 排序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentQuotaDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentQuotaDO.java
new file mode 100644
index 0000000..d958e6f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentQuotaDO.java
@@ -0,0 +1,100 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaScoreTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * HRM 员工绩效考核指标 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_performance_assessment_quota")
+@KeySequence("hrm_performance_assessment_quota_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmPerformanceAssessmentQuotaDO extends BaseDO {
+
+    /**
+     * 考核指标编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工绩效考核编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentDO#getId()}
+     */
+    private Long assessmentId;
+    /**
+     * 考核维度编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentDimensionDO#getId()}
+     */
+    private Long dimensionId;
+    /**
+     * 是否预置指标
+     */
+    private Boolean preset;
+    /**
+     * 指标名称
+     */
+    private String name;
+    /**
+     * 指标说明
+     */
+    private String description;
+    /**
+     * 评分标准
+     */
+    private String standard;
+    /**
+     * 指标权重
+     */
+    private BigDecimal weight;
+    /**
+     * 评分类型
+     *
+     * 枚举 {@link HrmPerformanceQuotaScoreTypeEnum}
+     */
+    private Integer scoreType;
+    /**
+     * 目标值
+     */
+    private String targetValue;
+    /**
+     * 实际值
+     */
+    private String actualValue;
+    /**
+     * 自评汇总分
+     */
+    private BigDecimal selfScore;
+    /**
+     * 他评汇总分
+     */
+    private BigDecimal reviewerScore;
+    /**
+     * 最终指标得分
+     */
+    private BigDecimal finalScore;
+    /**
+     * 排序
+     */
+    private Integer sort;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentQuotaScoreDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentQuotaScoreDO.java
new file mode 100644
index 0000000..de6c847
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentQuotaScoreDO.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * HRM 员工绩效考核指标评分 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_performance_assessment_quota_score")
+@KeySequence("hrm_performance_assessment_quota_score_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmPerformanceAssessmentQuotaScoreDO extends BaseDO {
+
+    /**
+     * 考核指标评分编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工绩效考核阶段编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentStageDO#getId()}
+     */
+    private Long assessmentStageId;
+    /**
+     * 员工绩效考核指标编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentQuotaDO#getId()}
+     */
+    private Long assessmentQuotaId;
+    /**
+     * 指标得分
+     */
+    private BigDecimal score;
+    /**
+     * 指标评语
+     */
+    private String comment;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentStageDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentStageDO.java
new file mode 100644
index 0000000..54cf5f4
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/assessment/HrmPerformanceAssessmentStageDO.java
@@ -0,0 +1,124 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewScoringTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewVisibleContentEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+
+/**
+ * HRM 员工绩效考核阶段 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_performance_assessment_stage")
+@KeySequence("hrm_performance_assessment_stage_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class HrmPerformanceAssessmentStageDO extends BaseDO {
+
+    /**
+     * 考核阶段编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工绩效考核编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentDO#getId()}
+     */
+    private Long assessmentId;
+    /**
+     * 业务阶段类型
+     *
+     * 枚举 {@link HrmPerformanceStageTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 阶段名称
+     */
+    private String name;
+    /**
+     * 实际处理员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long handlerEmployeeId;
+    /**
+     * 评分人类型
+     *
+     * 枚举 {@link HrmPerformanceRaterTypeEnum}
+     */
+    private Integer raterType;
+    /**
+     * 评分权重快照
+     */
+    private BigDecimal weight;
+    /**
+     * 评分方式快照
+     *
+     * 枚举 {@link HrmPerformanceReviewScoringTypeEnum}
+     */
+    private Integer scoringType;
+    /**
+     * 评分内容可见范围快照
+     *
+     * 枚举 {@link HrmPerformanceReviewVisibleContentEnum}
+     */
+    private Integer visibleContent;
+    /**
+     * 评语是否必填
+     */
+    private Boolean requiredSetting;
+    /**
+     * 是否允许驳回
+     */
+    private Boolean rejectAuthority;
+    /**
+     * 排序
+     */
+    private Integer sort;
+    /**
+     * 阶段处理状态
+     *
+     * 枚举 {@link HrmPerformanceAssessmentStageStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 阶段汇总得分
+     */
+    private BigDecimal score;
+    /**
+     * 阶段结果等级
+     */
+    private String resultLevel;
+    /**
+     * 阶段意见
+     */
+    private String comment;
+    /**
+     * 最近一次驳回原因
+     */
+    private String rejectReason;
+    /**
+     * 提交时间
+     */
+    private LocalDateTime submitTime;
+    /**
+     * 截止时间
+     */
+    private LocalDateTime deadlineTime;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/config/HrmPerformanceAssessmentTemplateDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/config/HrmPerformanceAssessmentTemplateDO.java
new file mode 100644
index 0000000..94a735c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/config/HrmPerformanceAssessmentTemplateDO.java
@@ -0,0 +1,194 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaScoreTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceQuotaTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceScoreCalculationEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceUpperLimitTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * HRM 绩效考核模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_performance_assessment_template", autoResultMap = true)
+@KeySequence("hrm_performance_assessment_template_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmPerformanceAssessmentTemplateDO extends BaseDO {
+
+    /**
+     * 绩效考核模板编号
+     */
+    @TableId
+    private Long id;
+
+    /**
+     * 模板名称
+     */
+    private String name;
+    /**
+     * 模板说明
+     */
+    private String illustrate;
+    /**
+     * 计分方式
+     *
+     * 枚举 {@link HrmPerformanceScoreCalculationEnum}
+     */
+    private Integer scoreCalculation;
+    /**
+     * 分数上限类型
+     *
+     * 枚举 {@link HrmPerformanceUpperLimitTypeEnum}
+     */
+    private Integer upperLimitType;
+    /**
+     * 分数上限
+     */
+    private BigDecimal upperLimitScore;
+    /**
+     * 维度数量
+     */
+    private Integer dimensionCount;
+    /**
+     * 指标数量
+     */
+    private Integer quotaCount;
+    /**
+     * 考核维度配置
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Dimension> dimensions;
+    /**
+     * 状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+
+    /**
+     * 绩效考核配置快照
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class AssessmentConfig {
+
+        /**
+         * 模板名称
+         */
+        private String name;
+        /**
+         * 计分方式
+         *
+         * 枚举 {@link HrmPerformanceScoreCalculationEnum}
+         */
+        private Integer scoreCalculation;
+        /**
+         * 分数上限类型
+         *
+         * 枚举 {@link HrmPerformanceUpperLimitTypeEnum}
+         */
+        private Integer upperLimitType;
+        /**
+         * 分数上限
+         */
+        private BigDecimal upperLimitScore;
+        /**
+         * 考核维度配置
+         */
+        private List<Dimension> dimensions;
+    }
+
+    /**
+     * 绩效考核维度
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Dimension {
+
+        /**
+         * 维度名称
+         */
+        private String name;
+        /**
+         * 指标类型
+         *
+         * 枚举 {@link HrmPerformanceQuotaTypeEnum}
+         */
+        private Integer quotaType;
+        /**
+         * 维度权重
+         */
+        private BigDecimal weight;
+        /**
+         * 备注
+         */
+        private String remark;
+        /**
+         * 是否允许员工编辑
+         */
+        private Boolean allowEdit;
+        /**
+         * 考核指标配置
+         */
+        private List<Quota> quotas;
+    }
+
+    /**
+     * 绩效考核指标
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Quota {
+
+        /**
+         * 指标名称
+         */
+        private String name;
+        /**
+         * 指标说明
+         */
+        private String illustrate;
+        /**
+         * 评分标准
+         */
+        private String standard;
+        /**
+         * 指标权重
+         */
+        private BigDecimal weight;
+        /**
+         * 评分类型
+         *
+         * 枚举 {@link HrmPerformanceQuotaScoreTypeEnum}
+         */
+        private Integer scoreType;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/config/HrmPerformanceResultTemplateDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/config/HrmPerformanceResultTemplateDO.java
new file mode 100644
index 0000000..f120c92
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/config/HrmPerformanceResultTemplateDO.java
@@ -0,0 +1,83 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * HRM 绩效结果模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_performance_result_template", autoResultMap = true)
+@KeySequence("hrm_performance_result_template_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmPerformanceResultTemplateDO extends BaseDO {
+
+    /**
+     * 绩效结果模板编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 模板名称
+     */
+    private String name;
+    /**
+     * 状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 结果等级配置
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Level> levels;
+
+    /**
+     * 绩效结果等级
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Level {
+
+        /**
+         * 等级名称
+         */
+        private String name;
+        /**
+         * 最低分数
+         */
+        private BigDecimal minScore;
+        /**
+         * 最高分数
+         */
+        private BigDecimal maxScore;
+        /**
+         * 绩效系数
+         */
+        private BigDecimal coefficient;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/plan/HrmPerformancePlanDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/plan/HrmPerformancePlanDO.java
new file mode 100644
index 0000000..971f930
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/performance/plan/HrmPerformancePlanDO.java
@@ -0,0 +1,338 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO.Level;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealTimeoutActionEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanOperationTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanScopeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuarterEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaSettingTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewScoringTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewVisibleContentEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.system.dal.dataobject.dept.DeptDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 绩效考核计划 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_performance_plan", autoResultMap = true)
+@KeySequence("hrm_performance_plan_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmPerformancePlanDO extends BaseDO {
+
+    /**
+     * 计划编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 计划状态
+     *
+     * 枚举 {@link HrmPerformancePlanStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 当前业务阶段类型
+     *
+     * 枚举 {@link HrmPerformanceStageTypeEnum}
+     */
+    private Integer stageType;
+    /**
+     * 当前可执行操作类型
+     *
+     * 枚举 {@link HrmPerformancePlanOperationTypeEnum}
+     */
+    private Integer operationType;
+    /**
+     * 终止时间
+     */
+    private LocalDateTime terminateTime;
+
+    // ==================== 1. 基础设置 ====================
+
+    /**
+     * 计划名称
+     */
+    private String name;
+    /**
+     * 考核周期类型
+     *
+     * 枚举 {@link HrmPerformanceCycleTypeEnum}
+     */
+    private Integer cycleType;
+    /**
+     * 考核周期
+     */
+    private String cycle;
+    /**
+     * 季度
+     *
+     * 枚举 {@link HrmPerformanceQuarterEnum}
+     */
+    private Integer quarter;
+    /**
+     * 开始时间
+     */
+    private LocalDateTime startTime;
+    /**
+     * 结束时间
+     */
+    private LocalDateTime endTime;
+    /**
+     * 考核说明
+     */
+    private String description;
+    /**
+     * 考评范围列表
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Scope> scopes;
+
+    // ==================== 2. 指标设置 ====================
+
+    /**
+     * 考核模板编号
+     *
+     * 关联 {@link HrmPerformanceAssessmentTemplateDO#getId()}
+     */
+    private Long assessmentTemplateId;
+    /**
+     * 考核配置快照
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private HrmPerformanceAssessmentTemplateDO.AssessmentConfig assessmentConfig;
+
+    // ==================== 3. 流程设置 ====================
+
+    /**
+     * 指标制定类型
+     *
+     * 枚举 {@link HrmPerformanceQuotaSettingTypeEnum}
+     */
+    private Integer quotaSettingType;
+    /**
+     * 是否开启目标确认
+     */
+    private Boolean targetConfirmation;
+    /**
+     * 目标确认节点
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private HandlerStage targetConfirmationStage;
+    /**
+     * 评分阶段列表
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<ReviewStage> reviewStages;
+    /**
+     * 是否开启结果审核
+     */
+    private Boolean resultAudit;
+    /**
+     * 结果审核节点列表
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<HandlerStage> resultAuditStages;
+    /**
+     * 是否开启结果确认
+     */
+    private Boolean resultConfirmation;
+    /**
+     * 申诉处理节点列表
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<HandlerStage> appealStages;
+    /**
+     * 申诉超期天数
+     */
+    private Integer appealTimeoutDays;
+    /**
+     * 申诉超期处理动作
+     *
+     * 枚举 {@link HrmPerformanceAppealTimeoutActionEnum}
+     */
+    private Integer appealTimeoutAction;
+
+    // ==================== 4. 结果设置 ====================
+
+    /**
+     * 结果模板编号
+     *
+     * 关联 {@link HrmPerformanceResultTemplateDO#getId()}
+     */
+    private Long resultTemplateId;
+    /**
+     * 结果配置快照
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private ResultConfig resultConfig;
+    /**
+     * 是否同步到薪资
+     */
+    private Boolean syncToSalary;
+    /**
+     * 计薪月份
+     */
+    private String paidForMonth;
+
+    /**
+     * 绩效计划考评范围
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Scope {
+
+        /**
+         * 范围类型
+         *
+         * 枚举 {@link HrmPerformancePlanScopeTypeEnum}
+         */
+        private Integer type;
+
+        /**
+         * 员工编号列表
+         *
+         * 关联 {@link HrmEmployeeDO#getId()}
+         */
+        private List<Long> employeeIds;
+        /**
+         * 部门编号列表
+         *
+         * 关联 {@link DeptDO#getId()}
+         */
+        private List<Long> deptIds;
+        /**
+         * 聘用形式
+         *
+         * 枚举 {@link HrmEmployeeTypeEnum}
+         */
+        private Integer employeeType;
+        /**
+         * 员工状态列表
+         *
+         * 枚举 {@link HrmEmployeeStatusEnum}
+         */
+        private List<Integer> employeeStatuses;
+    }
+
+    /**
+     * 绩效计划评分阶段
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class ReviewStage {
+
+        /**
+         * 评分阶段名称
+         */
+        private String name;
+        /**
+         * 评分人
+         */
+        private HandlerStage rater;
+        /**
+         * 评分权重
+         */
+        private BigDecimal weight;
+        /**
+         * 评分方式
+         *
+         * 枚举 {@link HrmPerformanceReviewScoringTypeEnum}
+         */
+        private Integer scoringType;
+        /**
+         * 评分内容可见范围
+         *
+         * 枚举 {@link HrmPerformanceReviewVisibleContentEnum}
+         */
+        private Integer visibleContent;
+        /**
+         * 评语是否必填
+         */
+        private Boolean requiredSetting;
+        /**
+         * 是否允许驳回
+         */
+        private Boolean rejectAuthority;
+    }
+
+    /**
+     * 绩效计划处理节点
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class HandlerStage {
+
+        /**
+         * 处理人类型
+         *
+         * 枚举 {@link HrmPerformanceRaterTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 上级或部门层级
+         */
+        private Integer level;
+        /**
+         * 指定处理员工编号
+         *
+         * 关联 {@link HrmEmployeeDO#getId()}
+         */
+        private Long employeeId;
+    }
+
+    /**
+     * 绩效结果配置快照
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class ResultConfig {
+
+        /**
+         * 模板名称
+         */
+        private String name;
+        /**
+         * 结果等级配置
+         */
+        private List<Level> levels;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/candidate/HrmRecruitCandidateDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/candidate/HrmRecruitCandidateDO.java
new file mode 100644
index 0000000..151b61f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/candidate/HrmRecruitCandidateDO.java
@@ -0,0 +1,129 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.mybatis.core.type.StringListTypeHandler;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.system.enums.common.SexEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 招聘候选人 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_recruit_candidate", autoResultMap = true)
+@KeySequence("hrm_recruit_candidate_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmRecruitCandidateDO extends BaseDO {
+
+    /**
+     * 候选人编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 候选人姓名
+     */
+    private String name;
+    /**
+     * 手机号码
+     */
+    private String mobile;
+    /**
+     * 性别
+     *
+     * 枚举 {@link SexEnum}
+     */
+    private Integer sex;
+    /**
+     * 年龄
+     */
+    private Integer age;
+    /**
+     * 邮箱
+     */
+    private String email;
+    /**
+     * 应聘职位编号
+     *
+     * 关联 {@link HrmRecruitPostDO#getId()}
+     */
+    private Long postId;
+    /**
+     * 面试轮次
+     */
+    private Integer stageNumber;
+    /**
+     * 工作年限，单位：年
+     */
+    private Integer workTime;
+    /**
+     * 学历
+     *
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_CANDIDATE_EDUCATION}
+     */
+    private Integer education;
+    /**
+     * 毕业院校
+     */
+    private String graduateSchool;
+    /**
+     * 最近工作单位
+     */
+    private String latestWorkPlace;
+    /**
+     * 招聘渠道编号
+     *
+     * 关联 {@link HrmRecruitChannelDO#getId()}
+     */
+    private Long channelId;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 候选人状态
+     *
+     * 枚举 {@link HrmRecruitCandidateStatusEnum}
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_CANDIDATE_STATUS}
+     */
+    private Integer status;
+    /**
+     * 淘汰原因
+     */
+    private String eliminate;
+    /**
+     * 状态更新时间
+     */
+    private LocalDateTime statusUpdateTime;
+    /**
+     * 入职时间
+     */
+    private LocalDateTime entryTime;
+    /**
+     * 简历附件地址数组
+     */
+    @TableField(typeHandler = StringListTypeHandler.class)
+    private List<String> resumeUrls;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/candidate/HrmRecruitInterviewDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/candidate/HrmRecruitInterviewDO.java
new file mode 100644
index 0000000..40beac0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/candidate/HrmRecruitInterviewDO.java
@@ -0,0 +1,99 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.mybatis.core.type.LongListTypeHandler;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 招聘面试记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_recruit_interview", autoResultMap = true)
+@KeySequence("hrm_recruit_interview_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmRecruitInterviewDO extends BaseDO {
+
+    /**
+     * 面试编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 候选人编号
+     *
+     * 关联 {@link HrmRecruitCandidateDO#getId()}
+     */
+    private Long candidateId;
+    /**
+     * 面试方式
+     *
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_INTERVIEW_TYPE}
+     */
+    private Integer type;
+    /**
+     * 面试轮次
+     */
+    private Integer stageNumber;
+    /**
+     * 主面试官员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long interviewEmployeeId;
+    /**
+     * 其他面试官员工编号数组
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    @TableField(typeHandler = LongListTypeHandler.class)
+    private List<Long> otherInterviewEmployeeIds;
+    /**
+     * 面试时间
+     */
+    private LocalDateTime interviewTime;
+    /**
+     * 面试地址
+     */
+    private String address;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 面试结果
+     *
+     * 枚举 {@link HrmRecruitInterviewResultEnum}
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_INTERVIEW_RESULT}
+     */
+    private Integer result;
+    /**
+     * 面试评价
+     */
+    private String evaluate;
+    /**
+     * 取消原因
+     */
+    private String cancelReason;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/config/HrmRecruitChannelDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/config/HrmRecruitChannelDO.java
new file mode 100644
index 0000000..bbcc17c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/config/HrmRecruitChannelDO.java
@@ -0,0 +1,58 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 招聘渠道 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_recruit_channel")
+@KeySequence("hrm_recruit_channel_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmRecruitChannelDO extends BaseDO {
+
+    /**
+     * 招聘渠道编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 是否系统内置
+     */
+    private Boolean systemFlag;
+    /**
+     * 状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 渠道名称
+     */
+    private String name;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 备注
+     */
+    private String remark;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/post/HrmRecruitPostDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/post/HrmRecruitPostDO.java
new file mode 100644
index 0000000..afee29f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/post/HrmRecruitPostDO.java
@@ -0,0 +1,175 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.mybatis.core.type.LongListTypeHandler;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.DictTypeConstants;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import cn.iocoder.yudao.module.system.dal.dataobject.dept.DeptDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 招聘职位 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_recruit_post", autoResultMap = true)
+@KeySequence("hrm_recruit_post_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmRecruitPostDO extends BaseDO {
+
+    /**
+     * 薪资 - 面议值
+     */
+    public static final BigDecimal SALARY_NEGOTIABLE_VALUE = BigDecimal.valueOf(-1);
+    /**
+     * 薪资 - 面议单位值
+     */
+    public static final Integer SALARY_NEGOTIABLE_UNIT_VALUE = -1;
+
+    /**
+     * 年龄 - 不限值
+     */
+    public static final Integer AGE_UNLIMITED_VALUE = -1;
+
+    /**
+     * 招聘职位编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 职位名称
+     */
+    private String postName;
+    /**
+     * 部门编号
+     *
+     * 关联 {@link DeptDO#getId()}
+     */
+    private Long deptId;
+    /**
+     * 工作性质
+     *
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_JOB_NATURE}
+     */
+    private Integer jobNature;
+    /**
+     * 工作城市地区编号
+     *
+     * 关联 {@link cn.iocoder.yudao.framework.ip.core.Area#getId()}
+     */
+    private Integer areaId;
+    /**
+     * 招聘人数
+     */
+    private Integer recruitNum;
+    /**
+     * 招聘原因
+     */
+    private String reason;
+    /**
+     * 工作经验要求
+     *
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_WORK_TIME}
+     */
+    private Integer workTime;
+    /**
+     * 学历要求
+     *
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_POST_EDUCATION}
+     */
+    private Integer educationRequire;
+    /**
+     * 最低薪资
+     *
+     * -1 表示面议
+     */
+    private BigDecimal minSalary;
+    /**
+     * 最高薪资
+     *
+     * -1 表示面议
+     */
+    private BigDecimal maxSalary;
+    /**
+     * 薪资单位
+     *
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_SALARY_UNIT}
+     */
+    private Integer salaryUnit;
+    /**
+     * 最小年龄
+     *
+     * -1 表示不限
+     */
+    private Integer minAge;
+    /**
+     * 最大年龄
+     *
+     * -1 表示不限
+     */
+    private Integer maxAge;
+    /**
+     * 最迟到岗时间
+     */
+    private LocalDateTime latestEntryTime;
+    /**
+     * 招聘负责人员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long ownerEmployeeId;
+    /**
+     * 面试官员工编号数组
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    @TableField(typeHandler = LongListTypeHandler.class)
+    private List<Long> interviewEmployeeIds;
+    /**
+     * 职位描述
+     */
+    private String description;
+    /**
+     * 紧急程度
+     *
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_EMERGENCY_LEVEL}
+     */
+    private Integer emergencyLevel;
+    /**
+     * 职位类型编号
+     *
+     * 关联 {@link HrmRecruitPostTypeDO#getId()}
+     */
+    private Long postTypeId;
+    /**
+     * 职位状态
+     *
+     * 枚举 {@link HrmRecruitPostStatusEnum}
+     * 字典 {@link DictTypeConstants#HRM_RECRUIT_POST_STATUS}
+     */
+    private Integer status;
+    /**
+     * 停止原因
+     */
+    private String stopReason;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/post/HrmRecruitPostTypeDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/post/HrmRecruitPostTypeDO.java
new file mode 100644
index 0000000..13944fc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/recruit/post/HrmRecruitPostTypeDO.java
@@ -0,0 +1,56 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 招聘职位类型 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_recruit_post_type")
+@KeySequence("hrm_recruit_post_type_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmRecruitPostTypeDO extends BaseDO {
+
+    /**
+     * 职位类型编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 类型名称
+     */
+    private String name;
+    /**
+     * 父类型编号
+     *
+     * 关联 {@link #id}
+     */
+    private Long parentId;
+    /**
+     * 显示顺序
+     */
+    private Integer sort;
+    /**
+     * 状态
+     *
+     * 枚举 {@link CommonStatusEnum}
+     */
+    private Integer status;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryChangeTemplateDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryChangeTemplateDO.java
new file mode 100644
index 0000000..58647c5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryChangeTemplateDO.java
@@ -0,0 +1,76 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.util.List;
+
+/**
+ * HRM 调薪模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_change_template", autoResultMap = true)
+@KeySequence("hrm_salary_change_template_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryChangeTemplateDO extends BaseDO {
+
+    /**
+     * 调薪模板编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 模板名称
+     */
+    private String name;
+    /**
+     * 是否默认模板
+     */
+    private Boolean defaultStatus;
+    /**
+     * 调薪项配置
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Option> options;
+
+    /**
+     * 调薪项配置
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Option {
+
+        /**
+         * 薪资项名称快照
+         *
+         * 关联 {@link HrmSalaryOptionDO#getName()}
+         */
+        private String name;
+        /**
+         * 薪资项编码
+         *
+         * 关联 {@link HrmSalaryOptionDO#getCode()}
+         */
+        private Integer code;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryConfigDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryConfigDO.java
new file mode 100644
index 0000000..30f7a69
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryConfigDO.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalarySocialSecurityMonthTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 计薪配置 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_salary_config")
+@KeySequence("hrm_salary_config_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryConfigDO extends BaseDO {
+
+    @TableId
+    private Long id;
+    /**
+     * 计薪周期开始日
+     */
+    private Integer cycleStartDay;
+    /**
+     * 计薪周期结束日
+     */
+    private Integer cycleEndDay;
+    /**
+     * 社保对应月份类型
+     *
+     * 枚举 {@link HrmSalarySocialSecurityMonthTypeEnum}
+     */
+    private Integer socialSecurityMonthType;
+    /**
+     * 工资开始年份
+     */
+    private Integer startYear;
+    /**
+     * 工资开始月份
+     */
+    private Integer startMonth;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryGroupDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryGroupDO.java
new file mode 100644
index 0000000..82a7a2a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryGroupDO.java
@@ -0,0 +1,80 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.system.dal.dataobject.dept.DeptDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * HRM 薪资组 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_group", autoResultMap = true)
+@KeySequence("hrm_salary_group_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryGroupDO extends BaseDO {
+
+    /**
+     * 默认月计薪天数
+     */
+    public static final BigDecimal DEFAULT_SALARY_STANDARD = BigDecimal.valueOf(21.75);
+    /**
+     * 默认薪资变更计算规则
+     */
+    public static final String DEFAULT_CHANGE_RULE = "按转正/调薪前后的工资混合计算";
+
+    @TableId
+    private Long id;
+    /**
+     * 薪资组名称
+     */
+    private String name;
+    /**
+     * 月计薪标准
+     */
+    private BigDecimal salaryStandard;
+    /**
+     * 转正、调薪月规则
+     */
+    private String changeRule;
+    /**
+     * 适用部门编号列表
+     *
+     * 关联 {@link DeptDO#getId()}
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Long> deptIds;
+    /**
+     * 适用员工编号列表
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Long> employeeIds;
+    /**
+     * 计税规则编号
+     *
+     * 关联 {@link HrmSalaryTaxRuleDO#getId()}
+     */
+    private Long taxRuleId;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryOptionDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryOptionDO.java
new file mode 100644
index 0000000..72395a2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryOptionDO.java
@@ -0,0 +1,107 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 工资表薪资项 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_salary_option")
+@KeySequence("hrm_salary_option_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryOptionDO extends BaseDO {
+
+    /**
+     * 根薪资项的父编码
+     */
+    public static final Integer ROOT_PARENT_CODE = 0;
+
+    /**
+     * 可调整薪资项的最小分类编码
+     */
+    public static final Integer ADJUSTABLE_CATEGORY_MIN_CODE = 10;
+    /**
+     * 可调整薪资项的最大分类编码
+     */
+    public static final Integer ADJUSTABLE_CATEGORY_MAX_CODE = 90;
+
+    /**
+     * 企业自定义薪资项编码起始值
+     *
+     * <p>预置目录编码均位于低位区间，自定义项使用独立高位区间，避免未来目录升级占用同一编码。</p>
+     */
+    public static final Integer CUSTOM_OPTION_CODE_BASE = 1_000_000_000;
+
+    /**
+     * 薪资项编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 标准薪资项目录编号（可选）
+     *
+     * 关联 {@link HrmSalaryOptionTemplateDO#getId()}
+     */
+    private Long templateId;
+    /**
+     * 薪资项编码
+     */
+    private Integer code;
+    /**
+     * 父薪资项编码
+     *
+     * 关联 {@link #code}
+     */
+    private Integer parentCode;
+    /**
+     * 薪资项名称
+     */
+    private String name;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否系统默认项
+     */
+    private Boolean systemFlag;
+    /**
+     * 薪资项类型
+     *
+     * 枚举 {@link HrmSalaryOptionTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 是否显示
+     */
+    private Boolean visible;
+    /**
+     * 是否启用
+     */
+    private Boolean enabled;
+    /**
+     * 是否计税
+     */
+    private Boolean taxEnabled;
+    /**
+     * 是否参与计算
+     */
+    private Boolean calculateEnabled;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryOptionTemplateDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryOptionTemplateDO.java
new file mode 100644
index 0000000..bc1daa7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryOptionTemplateDO.java
@@ -0,0 +1,78 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.framework.tenant.core.aop.TenantIgnore;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 标准薪资项目录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_salary_option_template")
+@KeySequence("hrm_salary_option_template_seq")
+@TenantIgnore
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryOptionTemplateDO extends BaseDO {
+
+    /**
+     * 标准薪资项编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 薪资项编码
+     */
+    private Integer code;
+    /**
+     * 父薪资项编码
+     *
+     * 关联 {@link #code}
+     */
+    private Integer parentCode;
+    /**
+     * 薪资项名称
+     */
+    private String name;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 是否系统默认项
+     */
+    private Boolean systemFlag;
+    /**
+     * 薪资项类型
+     *
+     * 枚举 {@link HrmSalaryOptionTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 是否显示
+     */
+    private Boolean visible;
+    /**
+     * 是否计税
+     */
+    private Boolean taxEnabled;
+    /**
+     * 是否参与计算
+     */
+    private Boolean calculateEnabled;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryTaxRuleDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryTaxRuleDO.java
new file mode 100644
index 0000000..cba6f5c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/config/HrmSalaryTaxRuleDO.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxTypeEnum;
+import com.baomidou.mybatisplus.annotation.FieldStrategy;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+
+/**
+ * HRM 计税规则 DO
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_salary_tax_rule")
+@KeySequence("hrm_salary_tax_rule_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryTaxRuleDO extends BaseDO {
+
+    @TableId
+    private Long id;
+    /**
+     * 计税规则名称
+     */
+    private String name;
+    /**
+     * 计税类型
+     *
+     * 枚举 {@link HrmSalaryTaxTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 是否计税
+     */
+    private Boolean taxEnabled;
+    /**
+     * 起征阈值
+     */
+    @TableField(updateStrategy = FieldStrategy.ALWAYS)
+    private BigDecimal threshold;
+    /**
+     * 小数位数
+     */
+    @TableField(updateStrategy = FieldStrategy.ALWAYS)
+    private Integer decimalScale;
+    /**
+     * 计税周期类型
+     *
+     * 枚举 {@link HrmSalaryTaxCycleTypeEnum}
+     */
+    @TableField(updateStrategy = FieldStrategy.ALWAYS)
+    private Integer cycleType;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/employee/HrmSalaryChangeRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/employee/HrmSalaryChangeRecordDO.java
new file mode 100644
index 0000000..4d3db62
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/employee/HrmSalaryChangeRecordDO.java
@@ -0,0 +1,131 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 定薪/调薪记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_change_record", autoResultMap = true)
+@KeySequence("hrm_salary_change_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryChangeRecordDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 记录类型
+     *
+     * 枚举 {@link HrmSalaryChangeRecordTypeEnum}
+     */
+    private Integer type;
+    /**
+     * 调整原因
+     *
+     * 枚举 {@link HrmSalaryChangeReasonEnum}
+     */
+    private Integer reason;
+    /**
+     * 生效时间
+     */
+    private LocalDateTime effectTime;
+    /**
+     * 调整前正式薪资
+     */
+    private BigDecimal beforeTotal;
+    /**
+     * 调整后正式薪资
+     */
+    private BigDecimal afterTotal;
+    /**
+     * 调整前试用期薪资
+     */
+    private BigDecimal probationBeforeTotal;
+    /**
+     * 调整后试用期薪资
+     */
+    private BigDecimal probationAfterTotal;
+    /**
+     * 正式薪资项后态快照
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<SalaryOption> salaryOptions;
+    /**
+     * 试用期薪资项后态快照
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<SalaryOption> probationSalaryOptions;
+    /**
+     * 状态
+     *
+     * 枚举 {@link HrmSalaryChangeRecordStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 备注
+     */
+    private String remark;
+
+    /**
+     * 薪资项快照
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class SalaryOption {
+
+        /**
+         * 薪资项编码
+         *
+         * 关联 {@link HrmSalaryOptionDO#getCode()}
+         */
+        private Integer code;
+        /**
+         * 薪资项名称
+         *
+         * 关联 {@link HrmSalaryOptionDO#getName()}
+         */
+        private String name;
+        /**
+         * 薪资项金额
+         */
+        private BigDecimal value;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/employee/HrmSalaryEmployeeInfoDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/employee/HrmSalaryEmployeeInfoDO.java
new file mode 100644
index 0000000..ce314de
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/employee/HrmSalaryEmployeeInfoDO.java
@@ -0,0 +1,120 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeInfoChangeTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 员工薪资信息 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_employee_info", autoResultMap = true)
+@KeySequence("hrm_salary_employee_info_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryEmployeeInfoDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 定薪、调薪原因
+     *
+     * 枚举 {@link HrmSalaryChangeReasonEnum}
+     */
+    private Integer changeReason;
+    /**
+     * 生效时间
+     */
+    private LocalDateTime effectTime;
+    /**
+     * 薪资信息变更类型
+     *
+     * 枚举 {@link HrmSalaryEmployeeInfoChangeTypeEnum}
+     */
+    private Integer changeType;
+    /**
+     * 试用期工资
+     */
+    private BigDecimal probationSalary;
+    /**
+     * 正式工资
+     */
+    private BigDecimal regularSalary;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 正式薪资项
+     *
+     * 薪资项随员工薪资信息整体维护
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<SalaryOption> salaryOptions;
+    /**
+     * 试用期薪资项
+     *
+     * 薪资项随员工薪资信息整体维护
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<SalaryOption> probationSalaryOptions;
+
+    /**
+     * 薪资项快照
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class SalaryOption {
+
+        /**
+         * 薪资项编码
+         *
+         * 关联 {@link HrmSalaryOptionDO#getCode()}
+         */
+        private Integer code;
+        /**
+         * 薪资项名称
+         *
+         * 关联 {@link HrmSalaryOptionDO#getName()}
+         */
+        private String name;
+        /**
+         * 薪资项金额
+         */
+        private BigDecimal value;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/monthrecord/HrmSalaryMonthEmployeeRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/monthrecord/HrmSalaryMonthEmployeeRecordDO.java
new file mode 100644
index 0000000..9794112
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/monthrecord/HrmSalaryMonthEmployeeRecordDO.java
@@ -0,0 +1,121 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * HRM 员工月度工资记录 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_month_employee_record", autoResultMap = true)
+@KeySequence("hrm_salary_month_employee_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryMonthEmployeeRecordDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 月度工资表编号
+     *
+     * 关联 {@link HrmSalaryMonthRecordDO#getId()}
+     */
+    private Long monthRecordId;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 实际工作天数
+     */
+    private BigDecimal actualWorkDay;
+    /**
+     * 应工作天数
+     */
+    private BigDecimal needWorkDay;
+    /**
+     * 年份
+     */
+    private Integer year;
+    /**
+     * 月份
+     */
+    private Integer month;
+    /**
+     * 应发工资
+     */
+    private BigDecimal expectedPaySalary;
+    /**
+     * 应税工资
+     */
+    private BigDecimal taxableSalary;
+    /**
+     * 个人所得税
+     */
+    private BigDecimal personalTax;
+    /**
+     * 实发工资
+     */
+    private BigDecimal realPaySalary;
+
+    /**
+     * 薪资项值快照
+     *
+     * 薪资项值随员工月度工资记录整体维护
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<OptionValue> optionValues;
+
+    /**
+     * 薪资项值
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class OptionValue {
+
+        /**
+         * 薪资项编码
+         *
+         * 关联 {@link HrmSalaryOptionDO#getCode()}
+         */
+        private Integer code;
+        /**
+         * 薪资项名称
+         *
+         * 关联 {@link HrmSalaryOptionDO#getName()}
+         */
+        private String name;
+        /**
+         * 薪资项金额
+         */
+        private BigDecimal value;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/monthrecord/HrmSalaryMonthRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/monthrecord/HrmSalaryMonthRecordDO.java
new file mode 100644
index 0000000..5c5c8c8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/monthrecord/HrmSalaryMonthRecordDO.java
@@ -0,0 +1,133 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 月度工资表 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_month_record", autoResultMap = true)
+@KeySequence("hrm_salary_month_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalaryMonthRecordDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 工资表标题
+     */
+    private String title;
+    /**
+     * 年份
+     */
+    private Integer year;
+    /**
+     * 月份
+     */
+    private Integer month;
+    /**
+     * 员工人数
+     */
+    private Integer employeeCount;
+    /**
+     * 计薪开始日期
+     */
+    private LocalDateTime startTime;
+    /**
+     * 计薪结束日期
+     */
+    private LocalDateTime endTime;
+    /**
+     * 应发工资
+     */
+    private BigDecimal expectedPaySalary;
+    /**
+     * 个人所得税
+     */
+    private BigDecimal personalTax;
+    /**
+     * 实发工资
+     */
+    private BigDecimal realPaySalary;
+    /**
+     * 个人社保金额
+     */
+    private BigDecimal personalInsuranceAmount;
+    /**
+     * 个人公积金金额
+     */
+    private BigDecimal personalProvidentFundAmount;
+    /**
+     * 公司社保金额
+     */
+    private BigDecimal corporateInsuranceAmount;
+    /**
+     * 公司公积金金额
+     */
+    private BigDecimal corporateProvidentFundAmount;
+    /**
+     * 薪资项表头快照
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<OptionHeader> optionHeaders;
+    /**
+     * 状态
+     *
+     * 枚举 {@link HrmSalaryMonthRecordStatusEnum}
+     */
+    private Integer status;
+    /**
+     * 薪资项表头快照
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class OptionHeader {
+
+        /**
+         * 薪资项编码
+         *
+         * 关联 {@link HrmSalaryOptionDO#getCode()}
+         */
+        private Integer code;
+        /**
+         * 薪资项名称
+         *
+         * 关联 {@link HrmSalaryOptionDO#getName()}
+         */
+        private String name;
+        /**
+         * 子薪资项
+         */
+        private List<OptionHeader> children;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipDO.java
new file mode 100644
index 0000000..b064b22
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipDO.java
@@ -0,0 +1,139 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipReadStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipTemplateOptionTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+/**
+ * HRM 工资条 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_slip", autoResultMap = true)
+@KeySequence("hrm_salary_slip_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalarySlipDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 工资条发放记录编号
+     *
+     * 关联 {@link HrmSalarySlipSendRecordDO#getId()}
+     */
+    private Long sendRecordId;
+    /**
+     * 员工月度工资记录编号
+     *
+     * 关联 {@link HrmSalaryMonthEmployeeRecordDO#getId()}
+     */
+    private Long monthEmployeeRecordId;
+    /**
+     * 员工编号
+     *
+     * 关联 {@link HrmEmployeeDO#getId()}
+     */
+    private Long employeeId;
+    /**
+     * 年份
+     */
+    private Integer year;
+    /**
+     * 月份
+     */
+    private Integer month;
+    /**
+     * 阅读状态
+     *
+     * 枚举 {@link HrmSalarySlipReadStatusEnum}
+     */
+    private Integer readStatus;
+    /**
+     * 实发工资
+     */
+    private BigDecimal realPaySalary;
+    /**
+     * 备注
+     */
+    private String remark;
+    /**
+     * 工资条项
+     *
+     * 工资条项随员工工资条整体维护，通过 {@link Option#getChildren()} 表达父子关系
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Option> options;
+
+    /**
+     * 工资条项快照
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Option {
+
+        /**
+         * 名称
+         *
+         * 关联 {@link HrmSalaryOptionDO#getName()}
+         */
+        private String name;
+        /**
+         * 类型
+         *
+         * 枚举 {@link HrmSalarySlipTemplateOptionTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 薪资项编码
+         *
+         * 关联 {@link HrmSalaryOptionDO#getCode()}
+         */
+        private Integer code;
+        /**
+         * 金额
+         */
+        private BigDecimal value;
+        /**
+         * 说明
+         */
+        private String remark;
+        /**
+         * 排序
+         *
+         * 来源 {@link HrmSalarySlipTemplateDO.Option#getSort()}
+         */
+        private Integer sort;
+        /**
+         * 子项
+         */
+        private List<Option> children;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipSendRecordDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipSendRecordDO.java
new file mode 100644
index 0000000..ce25be8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipSendRecordDO.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+/**
+ * HRM 工资条发放记录 DO
+ *
+ * 同一月度工资表可以分多批次发放工资条，因此发放记录保持独立实体。
+ *
+ * @author 芋道源码
+ */
+@TableName("hrm_salary_slip_send_record")
+@KeySequence("hrm_salary_slip_send_record_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalarySlipSendRecordDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 月度工资表编号
+     *
+     * 关联 {@link HrmSalaryMonthRecordDO#getId()}
+     */
+    private Long monthRecordId;
+    /**
+     * 工资表总人数
+     */
+    private Integer employeeCount;
+    /**
+     * 本批次发放人数
+     */
+    private Integer sendEmployeeCount;
+    /**
+     * 年份
+     */
+    private Integer year;
+    /**
+     * 月份
+     */
+    private Integer month;
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipTemplateDO.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipTemplateDO.java
new file mode 100644
index 0000000..b13ed40
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/dataobject/salary/slip/HrmSalarySlipTemplateDO.java
@@ -0,0 +1,105 @@
+package cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.framework.mybatis.core.dataobject.BaseDO;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipTemplateOptionTypeEnum;
+import com.baomidou.mybatisplus.annotation.KeySequence;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.baomidou.mybatisplus.extension.handlers.JacksonTypeHandler;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.util.List;
+
+/**
+ * HRM 工资条模板 DO
+ *
+ * @author 芋道源码
+ */
+@TableName(value = "hrm_salary_slip_template", autoResultMap = true)
+@KeySequence("hrm_salary_slip_template_seq")
+@Data
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+@Builder
+@NoArgsConstructor
+@AllArgsConstructor
+public class HrmSalarySlipTemplateDO extends BaseDO {
+
+    /**
+     * 编号
+     */
+    @TableId
+    private Long id;
+    /**
+     * 模板名称
+     */
+    private String name;
+    /**
+     * 是否隐藏空项
+     */
+    private Boolean hideEmpty;
+    /**
+     * 是否默认模板
+     */
+    private Boolean defaultStatus;
+    /**
+     * 工资条模板项
+     *
+     * 模板项随工资条模板整体维护，通过 {@link Option#getChildren()} 表达父子关系
+     */
+    @TableField(typeHandler = JacksonTypeHandler.class)
+    private List<Option> options;
+
+    /**
+     * 工资条模板项
+     */
+    @Data
+    @Builder
+    @NoArgsConstructor
+    @AllArgsConstructor
+    public static class Option {
+
+        /**
+         * 名称
+         *
+         * 关联 {@link HrmSalaryOptionDO#getName()}
+         */
+        private String name;
+        /**
+         * 类型
+         *
+         * 枚举 {@link HrmSalarySlipTemplateOptionTypeEnum}
+         */
+        private Integer type;
+        /**
+         * 薪资项编码
+         *
+         * 关联 {@link HrmSalaryOptionDO#getCode()}
+         */
+        private Integer code;
+        /**
+         * 说明
+         */
+        private String remark;
+        /**
+         * 是否隐藏
+         */
+        private Boolean hidden;
+        /**
+         * 排序
+         */
+        private Integer sort;
+        /**
+         * 子项
+         */
+        private List<Option> children;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/config/HrmAttendanceGroupMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/config/HrmAttendanceGroupMapper.java
new file mode 100644
index 0000000..31627da
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/config/HrmAttendanceGroupMapper.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.attendance.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmAttendanceGroupMapper extends BaseMapperX<HrmAttendanceGroupDO> {
+
+    default PageResult<HrmAttendanceGroupDO> selectPage(HrmAttendanceGroupPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmAttendanceGroupDO>()
+                .likeIfPresent(HrmAttendanceGroupDO::getName, reqVO.getName())
+                .eqIfPresent(HrmAttendanceGroupDO::getDefaultStatus, reqVO.getDefaultStatus())
+                .orderByDesc(HrmAttendanceGroupDO::getId));
+    }
+
+    default HrmAttendanceGroupDO selectByName(String name) {
+        return selectFirstOne(HrmAttendanceGroupDO::getName, name);
+    }
+
+    default List<HrmAttendanceGroupDO> selectListOrderByDefaultStatusAndId() {
+        return selectList(new LambdaQueryWrapperX<HrmAttendanceGroupDO>()
+                .orderByDesc(HrmAttendanceGroupDO::getDefaultStatus)
+                .orderByDesc(HrmAttendanceGroupDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/config/HrmAttendanceHolidayMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/config/HrmAttendanceHolidayMapper.java
new file mode 100644
index 0000000..f153c20
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/config/HrmAttendanceHolidayMapper.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.attendance.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidayPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Mapper
+public interface HrmAttendanceHolidayMapper extends BaseMapperX<HrmAttendanceHolidayDO> {
+
+    default PageResult<HrmAttendanceHolidayDO> selectPage(HrmAttendanceHolidayPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmAttendanceHolidayDO>()
+                .eqIfPresent(HrmAttendanceHolidayDO::getType, reqVO.getType())
+                .betweenIfPresent(HrmAttendanceHolidayDO::getDate, reqVO.getDate())
+                .orderByDesc(HrmAttendanceHolidayDO::getDate)
+                .orderByDesc(HrmAttendanceHolidayDO::getId));
+    }
+
+    default HrmAttendanceHolidayDO selectByDate(LocalDateTime date) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmAttendanceHolidayDO>()
+                .eq(HrmAttendanceHolidayDO::getDate, date)
+                .orderByAsc(HrmAttendanceHolidayDO::getId));
+    }
+
+    default List<HrmAttendanceHolidayDO> selectListByDateRange(LocalDateTime[] dateTimes) {
+        return selectList(new LambdaQueryWrapperX<HrmAttendanceHolidayDO>()
+                .betweenIfPresent(HrmAttendanceHolidayDO::getDate, dateTimes)
+                .orderByAsc(HrmAttendanceHolidayDO::getDate)
+                .orderByDesc(HrmAttendanceHolidayDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/record/HrmAttendanceClockMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/record/HrmAttendanceClockMapper.java
new file mode 100644
index 0000000..6815893
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/record/HrmAttendanceClockMapper.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.attendance.record;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmAttendanceClockMapper extends BaseMapperX<HrmAttendanceClockDO> {
+
+    default PageResult<HrmAttendanceClockDO> selectPage(HrmAttendanceClockPageReqVO reqVO) {
+        return selectPage(reqVO, buildQueryWrapper(reqVO)
+                .eqIfPresent(HrmAttendanceClockDO::getStatus, reqVO.getStatus())
+                .orderByDesc(HrmAttendanceClockDO::getClockTime)
+                .orderByDesc(HrmAttendanceClockDO::getId));
+    }
+
+    default List<HrmAttendanceClockDO> selectList(HrmAttendanceClockPageReqVO reqVO) {
+        return selectList(buildQueryWrapper(reqVO)
+                .eqIfPresent(HrmAttendanceClockDO::getStatus, reqVO.getStatus())
+                .orderByDesc(HrmAttendanceClockDO::getClockTime)
+                .orderByDesc(HrmAttendanceClockDO::getId));
+    }
+
+    default List<HrmAttendanceClockDO> selectListByEmployeeIdAndClockTime(
+            Long employeeId, LocalDateTime[] clockTimes) {
+        return selectList(new LambdaQueryWrapperX<HrmAttendanceClockDO>()
+                .eq(HrmAttendanceClockDO::getEmployeeId, employeeId)
+                .betweenIfPresent(HrmAttendanceClockDO::getClockTime, clockTimes)
+                .orderByAsc(HrmAttendanceClockDO::getClockTime));
+    }
+
+    default List<HrmAttendanceClockDO> selectListByEmployeeIdsAndClockTime(
+            Collection<Long> employeeIds, LocalDateTime[] clockTimes) {
+        return selectList(new LambdaQueryWrapperX<HrmAttendanceClockDO>()
+                .inIfPresent(HrmAttendanceClockDO::getEmployeeId, employeeIds)
+                .betweenIfPresent(HrmAttendanceClockDO::getClockTime, clockTimes)
+                .orderByAsc(HrmAttendanceClockDO::getClockTime));
+    }
+
+    private LambdaQueryWrapperX<HrmAttendanceClockDO> buildQueryWrapper(HrmAttendanceClockPageReqVO reqVO) {
+        return new LambdaQueryWrapperX<HrmAttendanceClockDO>()
+                .eqIfPresent(HrmAttendanceClockDO::getEmployeeId, reqVO.getEmployeeId())
+                .inIfPresent(HrmAttendanceClockDO::getEmployeeId, reqVO.getEmployeeIds())
+                .eqIfPresent(HrmAttendanceClockDO::getType, reqVO.getType())
+                .inIfPresent(HrmAttendanceClockDO::getSourceType, reqVO.getSourceTypes())
+                .likeIfPresent(HrmAttendanceClockDO::getAddress, reqVO.getAddress())
+                .betweenIfPresent(
+                        HrmAttendanceClockDO::getAttendanceTime, reqVO.getAttendanceTime())
+                .betweenIfPresent(HrmAttendanceClockDO::getClockTime, reqVO.getClockTime());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/record/HrmAttendanceLeaveMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/record/HrmAttendanceLeaveMapper.java
new file mode 100644
index 0000000..0c34f52
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/attendance/record/HrmAttendanceLeaveMapper.java
@@ -0,0 +1,91 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.attendance.record;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.util.MyBatisUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeavePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmAttendanceLeaveMapper extends BaseMapperX<HrmAttendanceLeaveDO> {
+
+    default PageResult<HrmAttendanceLeaveDO> selectPage(HrmAttendanceLeavePageReqVO reqVO) {
+        return selectPage(reqVO, buildQueryWrapper(reqVO));
+    }
+
+    default List<HrmAttendanceLeaveDO> selectList(HrmAttendanceLeavePageReqVO reqVO) {
+        LambdaQueryWrapperX<HrmAttendanceLeaveDO> queryWrapper = buildQueryWrapper(reqVO);
+        MyBatisUtils.addOrder(queryWrapper, reqVO.getSortingFields());
+        return selectList(queryWrapper);
+    }
+
+    private LambdaQueryWrapperX<HrmAttendanceLeaveDO> buildQueryWrapper(HrmAttendanceLeavePageReqVO reqVO) {
+        return new LambdaQueryWrapperX<HrmAttendanceLeaveDO>()
+                .inIfPresent(HrmAttendanceLeaveDO::getEmployeeId, reqVO.getEmployeeIds())
+                .inIfPresent(HrmAttendanceLeaveDO::getType, reqVO.getTypes())
+                .betweenIfPresent(HrmAttendanceLeaveDO::getStartTime, reqVO.getStartTime())
+                .eqIfPresent(HrmAttendanceLeaveDO::getApprovalStatus, reqVO.getApprovalStatus());
+    }
+
+    default List<HrmAttendanceLeaveDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmAttendanceLeaveDO>()
+                .eq(HrmAttendanceLeaveDO::getEmployeeId, employeeId)
+                .orderByDesc(HrmAttendanceLeaveDO::getStartTime)
+                .orderByDesc(HrmAttendanceLeaveDO::getId));
+    }
+
+    default List<HrmAttendanceLeaveDO> selectListByEmployeeIdAndApprovalStatus(Long employeeId,
+                                                                                Integer approvalStatus) {
+        return selectList(new LambdaQueryWrapperX<HrmAttendanceLeaveDO>()
+                .eq(HrmAttendanceLeaveDO::getEmployeeId, employeeId)
+                .eq(HrmAttendanceLeaveDO::getApprovalStatus, approvalStatus)
+                .orderByDesc(HrmAttendanceLeaveDO::getStartTime)
+                .orderByDesc(HrmAttendanceLeaveDO::getId));
+    }
+
+    default List<HrmAttendanceLeaveDO> selectListByEmployeeIdsAndTimeRangeAndApprovalStatus(
+            Collection<Long> employeeIds, LocalDateTime[] leaveTimes, Integer approvalStatus) {
+        return selectList(new LambdaQueryWrapperX<HrmAttendanceLeaveDO>()
+                .in(HrmAttendanceLeaveDO::getEmployeeId, employeeIds)
+                .betweenIfPresent(HrmAttendanceLeaveDO::getStartTime,
+                        HrmAttendanceLeaveDO::getEndTime, leaveTimes)
+                .eq(HrmAttendanceLeaveDO::getApprovalStatus, approvalStatus)
+                .orderByDesc(HrmAttendanceLeaveDO::getStartTime)
+                .orderByDesc(HrmAttendanceLeaveDO::getId));
+    }
+
+    default Long selectCountByEmployeeIdAndTimeRangeAndApprovalStatusIn(
+            Long employeeId, LocalDateTime[] leaveTimes, Collection<Integer> approvalStatuses) {
+        return selectCount(new LambdaQueryWrapperX<HrmAttendanceLeaveDO>()
+                .eq(HrmAttendanceLeaveDO::getEmployeeId, employeeId)
+                .betweenIfPresent(HrmAttendanceLeaveDO::getStartTime,
+                        HrmAttendanceLeaveDO::getEndTime, leaveTimes)
+                .in(HrmAttendanceLeaveDO::getApprovalStatus, approvalStatuses));
+    }
+
+    /**
+     * 在指定请假记录和审批流程处于指定状态时，更新审批结果
+     *
+     * @param id 请假记录编号
+     * @param processInstanceId 流程实例编号
+     * @param approvalStatus 审批状态
+     * @param updateObj 更新对象
+     * @return 更新条数
+     */
+    default int updateApprovalResultByIdAndProcessInstanceIdAndApprovalStatus(
+            Long id, String processInstanceId, Integer approvalStatus, HrmAttendanceLeaveDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmAttendanceLeaveDO>()
+                .eq(HrmAttendanceLeaveDO::getId, id)
+                .and(wrapper -> wrapper.isNull(HrmAttendanceLeaveDO::getProcessInstanceId)
+                        .or().eq(HrmAttendanceLeaveDO::getProcessInstanceId, processInstanceId))
+                .eq(HrmAttendanceLeaveDO::getApprovalStatus, approvalStatus));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/config/HrmConfigMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/config/HrmConfigMapper.java
new file mode 100644
index 0000000..712a596
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/config/HrmConfigMapper.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.config.HrmConfigDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmConfigMapper extends BaseMapperX<HrmConfigDO> {
+
+    default List<HrmConfigDO> selectListByType(Integer type) {
+        return selectList(new LambdaQueryWrapperX<HrmConfigDO>()
+                .eq(HrmConfigDO::getType, type)
+                .orderByAsc(HrmConfigDO::getSort)
+                .orderByAsc(HrmConfigDO::getId));
+    }
+
+    default void deleteByType(Integer type) {
+        delete(new LambdaQueryWrapperX<HrmConfigDO>().eq(HrmConfigDO::getType, type));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeChangeRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeChangeRecordMapper.java
new file mode 100644
index 0000000..2ce05bd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeChangeRecordMapper.java
@@ -0,0 +1,41 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeChangeRecordMapper extends BaseMapperX<HrmEmployeeChangeRecordDO> {
+
+    default List<HrmEmployeeChangeRecordDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeChangeRecordDO>()
+                .eq(HrmEmployeeChangeRecordDO::getEmployeeId, employeeId)
+                .orderByDesc(HrmEmployeeChangeRecordDO::getEffectTime)
+                .orderByDesc(HrmEmployeeChangeRecordDO::getId));
+    }
+
+    default List<HrmEmployeeChangeRecordDO> selectListByAppliedTimeNullAndEffectTimeBeforeOrEqual(
+            LocalDateTime deadlineTime, Collection<Integer> types) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeChangeRecordDO>()
+                .isNull(HrmEmployeeChangeRecordDO::getAppliedTime)
+                .le(HrmEmployeeChangeRecordDO::getEffectTime, deadlineTime)
+                .in(HrmEmployeeChangeRecordDO::getType, types)
+                .orderByAsc(HrmEmployeeChangeRecordDO::getEffectTime)
+                .orderByAsc(HrmEmployeeChangeRecordDO::getId));
+    }
+
+    default List<HrmEmployeeChangeRecordDO> selectListByEmployeeIdsAndEffectTimeBetween(Collection<Long> employeeIds,
+                                                                                       LocalDateTime[] effectTimes) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeChangeRecordDO>()
+                .in(HrmEmployeeChangeRecordDO::getEmployeeId, employeeIds)
+                .betweenIfPresent(HrmEmployeeChangeRecordDO::getEffectTime, effectTimes)
+                .orderByDesc(HrmEmployeeChangeRecordDO::getEffectTime)
+                .orderByDesc(HrmEmployeeChangeRecordDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeContractMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeContractMapper.java
new file mode 100644
index 0000000..8588fdd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeContractMapper.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.map.MapUtil;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeContractDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeContractStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface HrmEmployeeContractMapper extends BaseMapperX<HrmEmployeeContractDO> {
+
+    default List<HrmEmployeeContractDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeContractDO>()
+                .eq(HrmEmployeeContractDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeContractDO::getSort)
+                .orderByDesc(HrmEmployeeContractDO::getId));
+    }
+
+    default Long selectCountByEndTimeBetween(LocalDateTime[] endTimes) {
+        MPJLambdaWrapperX<HrmEmployeeContractDO> query = new MPJLambdaWrapperX<>();
+        query.innerJoin(HrmEmployeeDO.class, HrmEmployeeDO::getId,
+                HrmEmployeeContractDO::getEmployeeId);
+        query.eq(HrmEmployeeContractDO::getExpireRemind, true)
+                .eq(HrmEmployeeContractDO::getStatus,
+                        HrmEmployeeContractStatusEnum.IN_PROGRESS.getStatus())
+                .in(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES)
+                .betweenIfPresent(HrmEmployeeContractDO::getEndTime, endTimes);
+        query.selectFunc("COUNT(DISTINCT %s)",
+                arg -> arg.accept(HrmEmployeeContractDO::getEmployeeId), "count");
+        List<Map<String, Object>> result = selectMaps(query);
+        return MapUtil.getLong(CollUtil.getFirst(result), "count");
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateTermById(Long id, Integer term) {
+        return update(new LambdaUpdateWrapper<HrmEmployeeContractDO>()
+                .eq(HrmEmployeeContractDO::getId, id)
+                .set(HrmEmployeeContractDO::getTerm, term));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeQuitInfoMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeQuitInfoMapper.java
new file mode 100644
index 0000000..ec69d0b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeQuitInfoMapper.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeQuitInfoMapper extends BaseMapperX<HrmEmployeeQuitInfoDO> {
+
+    default HrmEmployeeQuitInfoDO selectByEmployeeId(Long employeeId) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmEmployeeQuitInfoDO>()
+                .eq(HrmEmployeeQuitInfoDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeQuitInfoDO::getId));
+    }
+
+    default List<HrmEmployeeQuitInfoDO> selectListByEmployeeIds(Collection<Long> employeeIds) {
+        return selectList(HrmEmployeeQuitInfoDO::getEmployeeId, employeeIds);
+    }
+
+    default void deleteByEmployeeId(Long employeeId) {
+        delete(HrmEmployeeQuitInfoDO::getEmployeeId, employeeId);
+    }
+
+    default List<HrmEmployeeQuitInfoDO> selectListByPlanQuitTimeBeforeOrEqual(LocalDateTime deadlineTime) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeQuitInfoDO>()
+                .le(HrmEmployeeQuitInfoDO::getPlanQuitTime, deadlineTime)
+                .orderByAsc(HrmEmployeeQuitInfoDO::getPlanQuitTime)
+                .orderByAsc(HrmEmployeeQuitInfoDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeSalaryCardMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeSalaryCardMapper.java
new file mode 100644
index 0000000..b407fbc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/employment/HrmEmployeeSalaryCardMapper.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeSalaryCardDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeSalaryCardMapper extends BaseMapperX<HrmEmployeeSalaryCardDO> {
+
+    default HrmEmployeeSalaryCardDO selectByEmployeeId(Long employeeId) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmEmployeeSalaryCardDO>()
+                .eq(HrmEmployeeSalaryCardDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeSalaryCardDO::getId));
+    }
+
+    default List<HrmEmployeeSalaryCardDO> selectListByEmployeeIds(Collection<Long> employeeIds) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeSalaryCardDO>()
+                .in(HrmEmployeeSalaryCardDO::getEmployeeId, employeeIds)
+                .orderByAsc(HrmEmployeeSalaryCardDO::getEmployeeId)
+                .orderByDesc(HrmEmployeeSalaryCardDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeCertificateMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeCertificateMapper.java
new file mode 100644
index 0000000..5a974d9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeCertificateMapper.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeCertificateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeCertificateMapper extends BaseMapperX<HrmEmployeeCertificateDO> {
+
+    default List<HrmEmployeeCertificateDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeCertificateDO>()
+                .eq(HrmEmployeeCertificateDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeCertificateDO::getSort)
+                .orderByDesc(HrmEmployeeCertificateDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeEducationExperienceMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeEducationExperienceMapper.java
new file mode 100644
index 0000000..251709b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeEducationExperienceMapper.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeEducationExperienceDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeEducationExperienceMapper extends BaseMapperX<HrmEmployeeEducationExperienceDO> {
+
+    default List<HrmEmployeeEducationExperienceDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeEducationExperienceDO>()
+                .eq(HrmEmployeeEducationExperienceDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeEducationExperienceDO::getSort)
+                .orderByDesc(HrmEmployeeEducationExperienceDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeTrainingExperienceMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeTrainingExperienceMapper.java
new file mode 100644
index 0000000..1255c42
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeTrainingExperienceMapper.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeTrainingExperienceDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeTrainingExperienceMapper extends BaseMapperX<HrmEmployeeTrainingExperienceDO> {
+
+    default List<HrmEmployeeTrainingExperienceDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeTrainingExperienceDO>()
+                .eq(HrmEmployeeTrainingExperienceDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeTrainingExperienceDO::getSort)
+                .orderByDesc(HrmEmployeeTrainingExperienceDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeWorkExperienceMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeWorkExperienceMapper.java
new file mode 100644
index 0000000..a3a65ed
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/experience/HrmEmployeeWorkExperienceMapper.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeWorkExperienceDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeWorkExperienceMapper extends BaseMapperX<HrmEmployeeWorkExperienceDO> {
+
+    default List<HrmEmployeeWorkExperienceDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeWorkExperienceDO>()
+                .eq(HrmEmployeeWorkExperienceDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeWorkExperienceDO::getSort)
+                .orderByDesc(HrmEmployeeWorkExperienceDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeContactMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeContactMapper.java
new file mode 100644
index 0000000..bfb69b7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeContactMapper.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.info;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeContactDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeContactMapper extends BaseMapperX<HrmEmployeeContactDO> {
+
+    default List<HrmEmployeeContactDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeContactDO>()
+                .eq(HrmEmployeeContactDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeContactDO::getSort)
+                .orderByDesc(HrmEmployeeContactDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeFileMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeFileMapper.java
new file mode 100644
index 0000000..7f3d1ea
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeFileMapper.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.info;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeFileDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeeFileMapper extends BaseMapperX<HrmEmployeeFileDO> {
+
+    default List<HrmEmployeeFileDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeFileDO>()
+                .eq(HrmEmployeeFileDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmEmployeeFileDO::getType)
+                .orderByAsc(HrmEmployeeFileDO::getId));
+    }
+
+    default List<HrmEmployeeFileDO> selectListByEmployeeIdAndType(Long employeeId, Integer type) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeFileDO>()
+                .eq(HrmEmployeeFileDO::getEmployeeId, employeeId)
+                .eq(HrmEmployeeFileDO::getType, type)
+                .orderByAsc(HrmEmployeeFileDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeMapper.java
new file mode 100644
index 0000000..0688622
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeeMapper.java
@@ -0,0 +1,373 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.info;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.PageUtils;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeContractDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeSurveyTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTodoTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeArchiveFieldEnum;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+
+@Mapper
+public interface HrmEmployeeMapper extends BaseMapperX<HrmEmployeeDO> {
+
+    default HrmEmployeeDO selectByIdForUpdate(Long id) {
+        return selectOneForUpdate(HrmEmployeeDO::getId, id);
+    }
+
+    default PageResult<HrmEmployeeDO> selectPage(HrmEmployeePageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmEmployeeDO> query = buildQueryWrapper(reqVO);
+        appendStatusCategory(query, reqVO);
+        appendSurveyType(query, reqVO);
+        appendTodoType(query, reqVO);
+        PageUtils.buildDefaultSortingField(reqVO, HrmEmployeeDO::getId);
+        return selectPage(reqVO, query);
+    }
+
+    default List<HrmEmployeeDO> selectList(HrmEmployeePageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmEmployeeDO> query = buildQueryWrapper(reqVO);
+        appendStatusCategory(query, reqVO);
+        appendSurveyType(query, reqVO);
+        appendTodoType(query, reqVO);
+        return selectList(query.orderByDesc(HrmEmployeeDO::getId));
+    }
+
+    default HrmEmployeeDO selectByJobNumber(String jobNumber) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getJobNumber, jobNumber)
+                .orderByAsc(HrmEmployeeDO::getId));
+    }
+
+    default List<HrmEmployeeDO> selectListByEntryStatus(Collection<Integer> entryStatuses) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .in(HrmEmployeeDO::getEntryStatus, entryStatuses)
+                .orderByDesc(HrmEmployeeDO::getId));
+    }
+
+    default List<HrmEmployeeDO> selectListByDeptIds(Collection<Long> deptIds) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .in(HrmEmployeeDO::getDeptId, deptIds)
+                .orderByDesc(HrmEmployeeDO::getId));
+    }
+
+    default List<HrmEmployeeDO> selectListByLeaderEmployeeId(Long leaderEmployeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getLeaderEmployeeId, leaderEmployeeId)
+                .orderByAsc(HrmEmployeeDO::getName)
+                .orderByDesc(HrmEmployeeDO::getId));
+    }
+
+    default HrmEmployeeDO selectByUserId(Long userId) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getUserId, userId)
+                .orderByAsc(HrmEmployeeDO::getId));
+    }
+
+    default List<HrmEmployeeDO> selectListWithUserId() {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .select(HrmEmployeeDO::getUserId)
+                .isNotNull(HrmEmployeeDO::getUserId));
+    }
+
+    default HrmEmployeeDO selectByMobile(String mobile) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getMobile, mobile)
+                .orderByAsc(HrmEmployeeDO::getId));
+    }
+
+    default HrmEmployeeDO selectByCandidateId(Long candidateId) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getCandidateId, candidateId)
+                .orderByAsc(HrmEmployeeDO::getId));
+    }
+
+    default List<HrmEmployeeDO> selectListByCandidateIds(Collection<Long> candidateIds) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .in(HrmEmployeeDO::getCandidateId, candidateIds));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateChannelIdByChannelId(Long channelId, Long newChannelId) {
+        return update(new LambdaUpdateWrapper<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getChannelId, channelId)
+                .set(HrmEmployeeDO::getChannelId, newChannelId));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateLeaveTimeById(Long id, LocalDateTime leaveTime) {
+        return update(new LambdaUpdateWrapper<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getId, id)
+                .set(HrmEmployeeDO::getLeaveTime, leaveTime));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updatePositionById(Long id, Long deptId, String postName, String postLevel,
+                                   String workAddress, Long leaderEmployeeId) {
+        return update(new LambdaUpdateWrapper<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getId, id)
+                .set(HrmEmployeeDO::getDeptId, deptId)
+                .set(HrmEmployeeDO::getPostName, postName)
+                .set(HrmEmployeeDO::getPostLevel, postLevel)
+                .set(HrmEmployeeDO::getWorkAddress, workAddress)
+                .set(HrmEmployeeDO::getLeaderEmployeeId, leaderEmployeeId));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateForEntryById(HrmEmployeeDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmEmployeeDO>()
+                .eq(HrmEmployeeDO::getId, updateObj.getId())
+                .set(updateObj.getDeptId() == null, HrmEmployeeDO::getDeptId, null)
+                .set(updateObj.getPostName() == null, HrmEmployeeDO::getPostName, null)
+                .set(updateObj.getPostLevel() == null, HrmEmployeeDO::getPostLevel, null)
+                .set(updateObj.getWorkAddress() == null, HrmEmployeeDO::getWorkAddress, null)
+                .set(updateObj.getLeaderEmployeeId() == null, HrmEmployeeDO::getLeaderEmployeeId, null)
+                .set(updateObj.getRegularTime() == null, HrmEmployeeDO::getRegularTime, null)
+                .set(HrmEmployeeDO::getLeaveTime, null));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateProfile(HrmEmployeeDO updateObj, Set<String> updateFields) {
+        return update(new LambdaUpdateWrapper<HrmEmployeeDO>()
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.NAME.getName()), HrmEmployeeDO::getName, updateObj.getName())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.MOBILE.getName()), HrmEmployeeDO::getMobile, updateObj.getMobile())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.COUNTRY.getName()), HrmEmployeeDO::getCountry, updateObj.getCountry())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.NATION.getName()), HrmEmployeeDO::getNation, updateObj.getNation())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.ID_TYPE.getName()), HrmEmployeeDO::getIdType, updateObj.getIdType())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.ID_NUMBER.getName()), HrmEmployeeDO::getIdNumber, updateObj.getIdNumber())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.SEX.getName()), HrmEmployeeDO::getSex, updateObj.getSex())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.EMAIL.getName()), HrmEmployeeDO::getEmail, updateObj.getEmail())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.NATIVE_PLACE.getName()), HrmEmployeeDO::getNativePlace, updateObj.getNativePlace())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.BIRTHDAY.getName()), HrmEmployeeDO::getBirthday, updateObj.getBirthday())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.AGE.getName()), HrmEmployeeDO::getAge, updateObj.getAge())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.ADDRESS.getName()), HrmEmployeeDO::getAddress, updateObj.getAddress())
+                .set(updateFields.contains(HrmEmployeeArchiveFieldEnum.HIGHEST_EDUCATION.getName()), HrmEmployeeDO::getHighestEducation, updateObj.getHighestEducation())
+                .eq(HrmEmployeeDO::getId, updateObj.getId()));
+    }
+
+    default List<Map<String, Object>> selectCountListByStatus(HrmEmployeePageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmEmployeeDO> query = buildQueryWrapper(reqVO);
+        appendSurveyType(query, reqVO);
+        appendTodoType(query, reqVO);
+        return selectMaps(query.selectAs(HrmEmployeeDO::getStatus, "status")
+                .selectAs(HrmEmployeeDO::getEntryStatus, "entryStatus")
+                .selectFunc("COUNT(DISTINCT %s)",
+                        arg -> arg.accept(HrmEmployeeDO::getId), "count")
+                .groupBy(HrmEmployeeDO::getStatus, HrmEmployeeDO::getEntryStatus));
+    }
+
+    default List<Map<String, Object>> selectCountListByDeptIdAndType(Collection<Integer> entryStatuses) {
+        return selectMaps(new MPJLambdaWrapperX<HrmEmployeeDO>()
+                .selectAs(HrmEmployeeDO::getDeptId, "deptId")
+                .selectAs(HrmEmployeeDO::getType, "type")
+                .selectCount(HrmEmployeeDO::getId, "count")
+                .in(HrmEmployeeDO::getEntryStatus, entryStatuses)
+                .groupBy(HrmEmployeeDO::getDeptId, HrmEmployeeDO::getType));
+    }
+
+    default List<Map<String, Object>> selectCountListByEntryStatusAndEntryTimeBetween(
+            LocalDateTime[] entryTimes) {
+        MPJLambdaWrapperX<HrmEmployeeDO> query = new MPJLambdaWrapperX<>();
+        query.selectAs(HrmEmployeeDO::getEntryStatus, "entryStatus")
+                .selectCount(HrmEmployeeDO::getId, "count")
+                .isNotNull(HrmEmployeeDO::getEntryStatus);
+        query.betweenIfPresent(HrmEmployeeDO::getEntryTime, entryTimes);
+        query.groupBy(HrmEmployeeDO::getEntryStatus);
+        return selectMaps(query);
+    }
+
+    default List<Map<String, Object>> selectCountListByEntryStatusAndLeaveTimeBetween(
+            LocalDateTime[] leaveTimes) {
+        MPJLambdaWrapperX<HrmEmployeeDO> query = new MPJLambdaWrapperX<>();
+        query.selectAs(HrmEmployeeDO::getEntryStatus, "entryStatus")
+                .selectCount(HrmEmployeeDO::getId, "count")
+                .in(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.LEFT.getStatus(), HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus());
+        query.betweenIfPresent(HrmEmployeeDO::getLeaveTime, leaveTimes);
+        query.groupBy(HrmEmployeeDO::getEntryStatus);
+        return selectMaps(query);
+    }
+
+    default List<Map<String, Object>> selectCountListByChangeTypeAndEffectTimeBetween(
+            LocalDateTime[] effectTimes) {
+        MPJLambdaWrapperX<HrmEmployeeDO> query = new MPJLambdaWrapperX<>();
+        query.selectAs(HrmEmployeeChangeRecordDO::getType, "changeType")
+                .selectFunc("COUNT(DISTINCT %s)",
+                        arg -> arg.accept(HrmEmployeeDO::getId), "count")
+                .innerJoin(HrmEmployeeChangeRecordDO.class, HrmEmployeeChangeRecordDO::getEmployeeId,
+                        HrmEmployeeDO::getId)
+                .in(HrmEmployeeChangeRecordDO::getType,
+                        HrmEmployeeChangeTypeEnum.REGULAR.getType(),
+                        HrmEmployeeChangeTypeEnum.TRANSFER.getType());
+        query.betweenIfPresent(HrmEmployeeChangeRecordDO::getEffectTime, effectTimes);
+        query.groupBy(HrmEmployeeChangeRecordDO::getType);
+        return selectMaps(query);
+    }
+
+    default List<HrmEmployeeDO> selectListByRegularTimeBeforeOrEqual(LocalDateTime deadlineTime) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeeDO>()
+                .le(HrmEmployeeDO::getRegularTime, deadlineTime)
+                .in(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES)
+                .eq(HrmEmployeeDO::getStatus, HrmEmployeeStatusEnum.PROBATION.getStatus())
+                .orderByAsc(HrmEmployeeDO::getRegularTime)
+                .orderByAsc(HrmEmployeeDO::getId));
+    }
+
+    /**
+     * 追加员工状态筛选条件。状态页签包含入职状态与员工状态的组合语义；
+     * 未选择页签时，使用请求中的原始入职状态和员工状态条件。
+     */
+    private void appendStatusCategory(MPJLambdaWrapperX<HrmEmployeeDO> queryWrapper, HrmEmployeePageReqVO reqVO) {
+        Integer statusCategory = reqVO.getStatusCategory();
+        if (statusCategory == null) {
+            queryWrapper.eqIfPresent(HrmEmployeeDO::getEntryStatus, reqVO.getEntryStatus())
+                    .eqIfPresent(HrmEmployeeDO::getStatus, reqVO.getStatus());
+            return;
+        }
+        HrmEmployeeStatusTabEnum statusTab = HrmEmployeeStatusTabEnum.valueOf(statusCategory);
+        if (HrmEmployeeStatusTabEnum.ACTIVE == statusTab) {
+            queryWrapper.in(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES);
+        } else if (HrmEmployeeStatusTabEnum.FULL_TIME == statusTab) {
+            queryWrapper.in(HrmEmployeeDO::getStatus, HrmEmployeeStatusEnum.FULL_TIME_STATUSES)
+                    .in(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES);
+        } else if (HrmEmployeeStatusTabEnum.PENDING_ENTRY == statusTab) {
+            queryWrapper.eq(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus());
+        } else if (HrmEmployeeStatusTabEnum.PENDING_LEAVE == statusTab) {
+            queryWrapper.eq(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus());
+        } else if (HrmEmployeeStatusTabEnum.LEFT == statusTab) {
+            queryWrapper.eq(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.LEFT.getStatus());
+        } else {
+            queryWrapper.eq(HrmEmployeeDO::getStatus, statusCategory)
+                    .in(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES);
+        }
+    }
+
+    /**
+     * 追加当月员工待办筛选条件。
+     */
+    private void appendTodoType(MPJLambdaWrapperX<HrmEmployeeDO> query, HrmEmployeePageReqVO reqVO) {
+        Integer todoType = reqVO.getTodoType();
+        if (todoType == null) {
+            return;
+        }
+        LocalDate now = LocalDate.now();
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(
+                now.getYear(), now.getMonthValue());
+        if (HrmEmployeeTodoTypeEnum.PENDING_LEAVE.getType().equals(todoType)) {
+            query.betweenIfPresent(HrmEmployeeDO::getLeaveTime, monthTimes);
+        } else if (HrmEmployeeTodoTypeEnum.CONTRACT_EXPIRE.getType().equals(todoType)) {
+            query.innerJoin(HrmEmployeeContractDO.class, HrmEmployeeContractDO::getEmployeeId,
+                    HrmEmployeeDO::getId).distinct();
+            query.betweenIfPresent(HrmEmployeeContractDO::getEndTime, monthTimes);
+        } else if (HrmEmployeeTodoTypeEnum.REGULAR.getType().equals(todoType)) {
+            query.eq(HrmEmployeeDO::getStatus, HrmEmployeeStatusEnum.PROBATION.getStatus());
+            query.betweenIfPresent(HrmEmployeeDO::getRegularTime, monthTimes);
+        } else if (HrmEmployeeTodoTypeEnum.PENDING_ENTRY.getType().equals(todoType)) {
+            query.betweenIfPresent(HrmEmployeeDO::getEntryTime, monthTimes);
+        } else if (HrmEmployeeTodoTypeEnum.BIRTHDAY.getType().equals(todoType)) {
+            // MySQL 和 H2 MySQL 模式均支持 MONTH，用于跨年筛选当月生日。
+            query.apply("MONTH(birthday) = {0}", now.getMonthValue());
+            if (now.getMonthValue() == 2 && !now.isLeapYear()) {
+                // 非闰年不存在 2 月 29 日，与首页日历和年龄计算保持一致。
+                query.apply("DAYOFMONTH(birthday) <> 29");
+            }
+        }
+    }
+
+    /**
+     * 追加当月首页员工概览筛选条件。
+     */
+    private void appendSurveyType(MPJLambdaWrapperX<HrmEmployeeDO> query, HrmEmployeePageReqVO reqVO) {
+        Integer surveyType = reqVO.getSurveyType();
+        if (surveyType == null) {
+            return;
+        }
+        LocalDate now = LocalDate.now();
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(
+                now.getYear(), now.getMonthValue());
+        if (HrmEmployeeSurveyTypeEnum.ENTRY.getType().equals(surveyType)) {
+            query.ne(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus());
+            query.betweenIfPresent(HrmEmployeeDO::getEntryTime, monthTimes);
+        } else if (HrmEmployeeSurveyTypeEnum.LEAVE.getType().equals(surveyType)) {
+            query.eq(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.LEFT.getStatus());
+            query.betweenIfPresent(HrmEmployeeDO::getLeaveTime, monthTimes);
+        } else if (HrmEmployeeSurveyTypeEnum.REGULAR.getType().equals(surveyType)) {
+            appendChangeRecordSurvey(query, HrmEmployeeChangeTypeEnum.REGULAR.getType(), monthTimes);
+        } else if (HrmEmployeeSurveyTypeEnum.TRANSFER.getType().equals(surveyType)) {
+            appendChangeRecordSurvey(query, HrmEmployeeChangeTypeEnum.TRANSFER.getType(), monthTimes);
+        } else if (HrmEmployeeSurveyTypeEnum.PENDING_ENTRY.getType().equals(surveyType)) {
+            query.eq(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus());
+            query.betweenIfPresent(HrmEmployeeDO::getEntryTime, monthTimes);
+        } else if (HrmEmployeeSurveyTypeEnum.PENDING_LEAVE.getType().equals(surveyType)) {
+            query.eq(HrmEmployeeDO::getEntryStatus, HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus());
+            query.betweenIfPresent(HrmEmployeeDO::getLeaveTime, monthTimes);
+        }
+    }
+
+    /**
+     * 根据当月生效的指定异动记录筛选员工。
+     */
+    private void appendChangeRecordSurvey(MPJLambdaWrapperX<HrmEmployeeDO> query, Integer changeType,
+                                          LocalDateTime[] monthTimes) {
+        query.innerJoin(HrmEmployeeChangeRecordDO.class, HrmEmployeeChangeRecordDO::getEmployeeId,
+                        HrmEmployeeDO::getId)
+                .eq(HrmEmployeeChangeRecordDO::getType, changeType)
+                .distinct();
+        query.betweenIfPresent(HrmEmployeeChangeRecordDO::getEffectTime, monthTimes);
+    }
+
+    private MPJLambdaWrapperX<HrmEmployeeDO> buildQueryWrapper(HrmEmployeePageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmEmployeeDO> query = new MPJLambdaWrapperX<HrmEmployeeDO>()
+                .inIfPresent(HrmEmployeeDO::getId, reqVO.getIds())
+                .likeIfPresent(HrmEmployeeDO::getName, reqVO.getName())
+                .likeIfPresent(HrmEmployeeDO::getJobNumber, reqVO.getJobNumber())
+                .likeIfPresent(HrmEmployeeDO::getMobile, reqVO.getMobile())
+                .eqIfPresent(HrmEmployeeDO::getSex, reqVO.getSex())
+                .eqIfPresent(HrmEmployeeDO::getDeptId, reqVO.getDeptId())
+                .inIfPresent(HrmEmployeeDO::getDeptId, reqVO.getDeptIds())
+                .eqIfPresent(HrmEmployeeDO::getLeaderEmployeeId, reqVO.getLeaderEmployeeId())
+                .likeIfPresent(HrmEmployeeDO::getPostName, reqVO.getPostName())
+                .likeIfPresent(HrmEmployeeDO::getWorkAddress, reqVO.getWorkAddress())
+                .eqIfPresent(HrmEmployeeDO::getChannelId, reqVO.getChannelId())
+                .eqIfPresent(HrmEmployeeDO::getType, reqVO.getType());
+        if (CollUtil.isNotEmpty(reqVO.getExcludeIds())) {
+            query.notIn(HrmEmployeeDO::getId, reqVO.getExcludeIds());
+        }
+        query.betweenIfPresent(HrmEmployeeDO::getEntryTime, reqVO.getEntryTime());
+        query.betweenIfPresent(HrmEmployeeDO::getRegularTime, reqVO.getRegularTime());
+        query.leIfPresent(HrmEmployeeDO::getEntryTime, ArrayUtils.get(reqVO.getActiveTime(), 1));
+        LocalDateTime activeBeginTime = ArrayUtils.get(reqVO.getActiveTime(), 0);
+        if (activeBeginTime != null) {
+            query.and(wrapper -> wrapper.isNull(HrmEmployeeDO::getLeaveTime)
+                    .or().ge(HrmEmployeeDO::getLeaveTime, activeBeginTime));
+        }
+        if (StrUtil.isNotBlank(reqVO.getSearch())) {
+            query.and(wrapper -> wrapper.like(HrmEmployeeDO::getName, reqVO.getSearch())
+                    .or().like(HrmEmployeeDO::getJobNumber, reqVO.getSearch())
+                    .or().like(HrmEmployeeDO::getMobile, reqVO.getSearch()));
+        }
+        return query;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeePersonalNoteMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeePersonalNoteMapper.java
new file mode 100644
index 0000000..88c0c89
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/employee/info/HrmEmployeePersonalNoteMapper.java
@@ -0,0 +1,23 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.employee.info;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeePersonalNoteDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Mapper
+public interface HrmEmployeePersonalNoteMapper extends BaseMapperX<HrmEmployeePersonalNoteDO> {
+
+    default List<HrmEmployeePersonalNoteDO> selectListByEmployeeIdAndReminderTimeBetween(
+            Long employeeId, LocalDateTime[] reminderTimes) {
+        return selectList(new LambdaQueryWrapperX<HrmEmployeePersonalNoteDO>()
+                .eq(HrmEmployeePersonalNoteDO::getEmployeeId, employeeId)
+                .betweenIfPresent(HrmEmployeePersonalNoteDO::getReminderTime, reminderTimes)
+                .orderByAsc(HrmEmployeePersonalNoteDO::getReminderTime)
+                .orderByAsc(HrmEmployeePersonalNoteDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/config/HrmInsuranceSchemeMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/config/HrmInsuranceSchemeMapper.java
new file mode 100644
index 0000000..cf61056
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/config/HrmInsuranceSchemeMapper.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.insurance.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmInsuranceSchemeMapper extends BaseMapperX<HrmInsuranceSchemeDO> {
+
+    default HrmInsuranceSchemeDO selectByName(String name) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmInsuranceSchemeDO>()
+                .eq(HrmInsuranceSchemeDO::getName, name)
+                .orderByAsc(HrmInsuranceSchemeDO::getId));
+    }
+
+    default HrmInsuranceSchemeDO selectByIdForUpdate(Long id) {
+        return selectOneForUpdate(HrmInsuranceSchemeDO::getId, id);
+    }
+
+    default List<HrmInsuranceSchemeDO> selectListByIdDesc() {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceSchemeDO>().orderByDesc(HrmInsuranceSchemeDO::getId));
+    }
+
+    default List<HrmInsuranceSchemeDO> selectListByAreaId(Integer areaId) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceSchemeDO>()
+                .eq(HrmInsuranceSchemeDO::getAreaId, areaId)
+                .orderByDesc(HrmInsuranceSchemeDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/config/HrmInsuranceSchemeProjectMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/config/HrmInsuranceSchemeProjectMapper.java
new file mode 100644
index 0000000..a2e3327
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/config/HrmInsuranceSchemeProjectMapper.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.insurance.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmInsuranceSchemeProjectMapper extends BaseMapperX<HrmInsuranceSchemeProjectDO> {
+
+    default List<HrmInsuranceSchemeProjectDO> selectListBySchemeId(Long schemeId) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceSchemeProjectDO>()
+                .eq(HrmInsuranceSchemeProjectDO::getSchemeId, schemeId)
+                .orderByAsc(HrmInsuranceSchemeProjectDO::getType)
+                .orderByAsc(HrmInsuranceSchemeProjectDO::getId));
+    }
+
+    default List<HrmInsuranceSchemeProjectDO> selectListBySchemeIds(Collection<Long> schemeIds) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceSchemeProjectDO>()
+                .in(HrmInsuranceSchemeProjectDO::getSchemeId, schemeIds)
+                .orderByAsc(HrmInsuranceSchemeProjectDO::getSchemeId)
+                .orderByAsc(HrmInsuranceSchemeProjectDO::getType)
+                .orderByAsc(HrmInsuranceSchemeProjectDO::getId));
+    }
+
+    default void deleteBySchemeId(Long schemeId) {
+        delete(HrmInsuranceSchemeProjectDO::getSchemeId, schemeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/employee/HrmInsuranceEmployeeInfoMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/employee/HrmInsuranceEmployeeInfoMapper.java
new file mode 100644
index 0000000..29954bf
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/employee/HrmInsuranceEmployeeInfoMapper.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.insurance.employee;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmInsuranceEmployeeInfoMapper extends BaseMapperX<HrmInsuranceEmployeeInfoDO> {
+
+    default HrmInsuranceEmployeeInfoDO selectByEmployeeId(Long employeeId) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmInsuranceEmployeeInfoDO>()
+                .eq(HrmInsuranceEmployeeInfoDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmInsuranceEmployeeInfoDO::getId));
+    }
+
+    default List<HrmInsuranceEmployeeInfoDO> selectListByEmployeeIds(Collection<Long> employeeIds) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceEmployeeInfoDO>()
+                .in(HrmInsuranceEmployeeInfoDO::getEmployeeId, employeeIds)
+                .orderByDesc(HrmInsuranceEmployeeInfoDO::getId));
+    }
+
+    default List<HrmInsuranceEmployeeInfoDO> selectListByIdDesc() {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceEmployeeInfoDO>()
+                .orderByDesc(HrmInsuranceEmployeeInfoDO::getId));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateBySchemeId(Long schemeId, HrmInsuranceEmployeeInfoDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmInsuranceEmployeeInfoDO>()
+                .eq(HrmInsuranceEmployeeInfoDO::getSchemeId, schemeId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordMapper.java
new file mode 100644
index 0000000..94ab416
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordMapper.java
@@ -0,0 +1,99 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.insurance.monthrecord;
+
+import cn.hutool.core.map.MapUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface HrmInsuranceMonthEmployeeRecordMapper extends BaseMapperX<HrmInsuranceMonthEmployeeRecordDO> {
+
+    default HrmInsuranceMonthEmployeeRecordDO selectByMonthRecordIdAndEmployeeId(Long monthRecordId, Long employeeId) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmInsuranceMonthEmployeeRecordDO>()
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getMonthRecordId, monthRecordId)
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmInsuranceMonthEmployeeRecordDO::getId));
+    }
+
+    default List<HrmInsuranceMonthEmployeeRecordDO> selectListByMonthRecordId(Long monthRecordId) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceMonthEmployeeRecordDO>()
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getMonthRecordId, monthRecordId)
+                .orderByDesc(HrmInsuranceMonthEmployeeRecordDO::getId));
+    }
+
+    default List<HrmInsuranceMonthEmployeeRecordDO> selectListByEmployeeIdAndYear(
+            Long employeeId, Integer year) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceMonthEmployeeRecordDO>()
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getEmployeeId, employeeId)
+                .eqIfPresent(HrmInsuranceMonthEmployeeRecordDO::getYear, year)
+                .orderByDesc(HrmInsuranceMonthEmployeeRecordDO::getYear)
+                .orderByDesc(HrmInsuranceMonthEmployeeRecordDO::getMonth)
+                .orderByDesc(HrmInsuranceMonthEmployeeRecordDO::getId));
+    }
+
+    default List<HrmInsuranceMonthEmployeeRecordDO> selectListByMonthRecordIdAndStatus(Long monthRecordId,
+                                                                                        Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceMonthEmployeeRecordDO>()
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getMonthRecordId, monthRecordId)
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getStatus, status)
+                .orderByDesc(HrmInsuranceMonthEmployeeRecordDO::getId));
+    }
+
+    default List<HrmInsuranceMonthEmployeeRecordDO> selectListByYearAndMonthAndStatus(Integer year, Integer month,
+                                                                                       Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceMonthEmployeeRecordDO>()
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getYear, year)
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getMonth, month)
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getStatus, status)
+                .orderByDesc(HrmInsuranceMonthEmployeeRecordDO::getId));
+    }
+
+    default PageResult<HrmInsuranceMonthEmployeeRecordDO> selectPage(
+            HrmInsuranceMonthEmployeeRecordPageReqVO reqVO, Collection<Long> employeeIds,
+            Collection<Long> schemeIds) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmInsuranceMonthEmployeeRecordDO>()
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getMonthRecordId, reqVO.getMonthRecordId())
+                .eqIfPresent(HrmInsuranceMonthEmployeeRecordDO::getEmployeeId, reqVO.getEmployeeId())
+                .eqIfPresent(HrmInsuranceMonthEmployeeRecordDO::getSchemeId, reqVO.getSchemeId())
+                .eqIfPresent(HrmInsuranceMonthEmployeeRecordDO::getStatus, reqVO.getStatus())
+                .inIfPresent(HrmInsuranceMonthEmployeeRecordDO::getEmployeeId, employeeIds)
+                .inIfPresent(HrmInsuranceMonthEmployeeRecordDO::getSchemeId, schemeIds)
+                .orderByDesc(HrmInsuranceMonthEmployeeRecordDO::getId));
+    }
+
+    default Long selectCountBySchemeId(Long schemeId) {
+        return selectCount(HrmInsuranceMonthEmployeeRecordDO::getSchemeId, schemeId);
+    }
+
+    default Map<Long, Long> selectCountMapBySchemeIds(Collection<Long> schemeIds) {
+        List<Map<String, Object>> result = selectMaps(new MPJLambdaWrapperX<HrmInsuranceMonthEmployeeRecordDO>()
+                .selectAs(HrmInsuranceMonthEmployeeRecordDO::getSchemeId, "schemeId")
+                .selectCount(HrmInsuranceMonthEmployeeRecordDO::getId, "count")
+                .in(HrmInsuranceMonthEmployeeRecordDO::getSchemeId, schemeIds)
+                .groupBy(HrmInsuranceMonthEmployeeRecordDO::getSchemeId));
+        return CollectionUtils.convertMap(result,
+                record -> MapUtil.getLong(record, "schemeId"),
+                record -> MapUtil.getLong(record, "count"));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateBySchemeId(Long schemeId, HrmInsuranceMonthEmployeeRecordDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmInsuranceMonthEmployeeRecordDO>()
+                .eq(HrmInsuranceMonthEmployeeRecordDO::getSchemeId, schemeId));
+    }
+
+    default void deleteByMonthRecordId(Long monthRecordId) {
+        delete(HrmInsuranceMonthEmployeeRecordDO::getMonthRecordId, monthRecordId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/monthrecord/HrmInsuranceMonthRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/monthrecord/HrmInsuranceMonthRecordMapper.java
new file mode 100644
index 0000000..5955a21
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/insurance/monthrecord/HrmInsuranceMonthRecordMapper.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.insurance.monthrecord;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmInsuranceMonthRecordMapper extends BaseMapperX<HrmInsuranceMonthRecordDO> {
+
+    default HrmInsuranceMonthRecordDO selectByIdForUpdate(Long id) {
+        return selectOneForUpdate(HrmInsuranceMonthRecordDO::getId, id);
+    }
+
+    default HrmInsuranceMonthRecordDO selectByYearMonth(Integer year, Integer month) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmInsuranceMonthRecordDO>()
+                .eq(HrmInsuranceMonthRecordDO::getYear, year)
+                .eq(HrmInsuranceMonthRecordDO::getMonth, month)
+                .orderByAsc(HrmInsuranceMonthRecordDO::getId));
+    }
+
+    default HrmInsuranceMonthRecordDO selectLast() {
+        return selectLastOne(new LambdaQueryWrapperX<HrmInsuranceMonthRecordDO>()
+                .orderByAsc(HrmInsuranceMonthRecordDO::getYear)
+                .orderByAsc(HrmInsuranceMonthRecordDO::getMonth)
+                .orderByAsc(HrmInsuranceMonthRecordDO::getId));
+    }
+
+    default HrmInsuranceMonthRecordDO selectLastForUpdate() {
+        return selectFirstOneForUpdate(new LambdaQueryWrapperX<HrmInsuranceMonthRecordDO>()
+                .orderByDesc(HrmInsuranceMonthRecordDO::getYear)
+                .orderByDesc(HrmInsuranceMonthRecordDO::getMonth)
+                .orderByDesc(HrmInsuranceMonthRecordDO::getId));
+    }
+
+    default List<HrmInsuranceMonthRecordDO> selectListByYear(Integer year) {
+        return selectList(new LambdaQueryWrapperX<HrmInsuranceMonthRecordDO>()
+                .eqIfPresent(HrmInsuranceMonthRecordDO::getYear, year)
+                .orderByDesc(HrmInsuranceMonthRecordDO::getYear)
+                .orderByDesc(HrmInsuranceMonthRecordDO::getMonth));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentActionRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentActionRecordMapper.java
new file mode 100644
index 0000000..07f4a17
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentActionRecordMapper.java
@@ -0,0 +1,27 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentActionRecordDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmPerformanceAssessmentActionRecordMapper
+        extends BaseMapperX<HrmPerformanceAssessmentActionRecordDO> {
+
+    default List<HrmPerformanceAssessmentActionRecordDO> selectListByAssessmentId(Long assessmentId) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentActionRecordDO>()
+                .eq(HrmPerformanceAssessmentActionRecordDO::getAssessmentId, assessmentId)
+                .orderByAsc(HrmPerformanceAssessmentActionRecordDO::getCreateTime)
+                .orderByAsc(HrmPerformanceAssessmentActionRecordDO::getId));
+    }
+
+    default void deleteByAssessmentIds(Collection<Long> assessmentIds) {
+        delete(new LambdaQueryWrapperX<HrmPerformanceAssessmentActionRecordDO>()
+                .in(HrmPerformanceAssessmentActionRecordDO::getAssessmentId, assessmentIds));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentAppealRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentAppealRecordMapper.java
new file mode 100644
index 0000000..b0de604
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentAppealRecordMapper.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentAppealRecordDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+@Mapper
+public interface HrmPerformanceAssessmentAppealRecordMapper
+        extends BaseMapperX<HrmPerformanceAssessmentAppealRecordDO> {
+
+    default List<HrmPerformanceAssessmentAppealRecordDO> selectListByAssessmentIdAndStatus(
+            Long assessmentId, Integer status) {
+        return selectListByAssessmentIdsAndStatus(Collections.singleton(assessmentId), status);
+    }
+
+    default List<HrmPerformanceAssessmentAppealRecordDO> selectListByAssessmentIdsAndStatus(
+            Collection<Long> assessmentIds, Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentAppealRecordDO>()
+                .in(HrmPerformanceAssessmentAppealRecordDO::getAssessmentId, assessmentIds)
+                .eqIfPresent(HrmPerformanceAssessmentAppealRecordDO::getStatus, status)
+                .orderByAsc(HrmPerformanceAssessmentAppealRecordDO::getAssessmentId)
+                .orderByAsc(HrmPerformanceAssessmentAppealRecordDO::getId));
+    }
+
+    default void deleteByAssessmentId(Long assessmentId) {
+        delete(HrmPerformanceAssessmentAppealRecordDO::getAssessmentId, assessmentId);
+    }
+
+    default void deleteByAssessmentIds(Collection<Long> assessmentIds) {
+        delete(new LambdaQueryWrapperX<HrmPerformanceAssessmentAppealRecordDO>()
+                .in(HrmPerformanceAssessmentAppealRecordDO::getAssessmentId, assessmentIds));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentDimensionMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentDimensionMapper.java
new file mode 100644
index 0000000..60addf1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentDimensionMapper.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDimensionDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * HRM 绩效员工维度 Mapper
+ *
+ * @author 芋道源码
+ */
+@Mapper
+public interface HrmPerformanceAssessmentDimensionMapper
+        extends BaseMapperX<HrmPerformanceAssessmentDimensionDO> {
+
+    default List<HrmPerformanceAssessmentDimensionDO> selectListByAssessmentId(Long assessmentId) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDimensionDO>()
+                .eq(HrmPerformanceAssessmentDimensionDO::getAssessmentId, assessmentId)
+                .orderByAsc(HrmPerformanceAssessmentDimensionDO::getSort)
+                .orderByAsc(HrmPerformanceAssessmentDimensionDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentDimensionDO> selectListByAssessmentIds(
+            Collection<Long> assessmentIds) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDimensionDO>()
+                .in(HrmPerformanceAssessmentDimensionDO::getAssessmentId, assessmentIds)
+                .orderByAsc(HrmPerformanceAssessmentDimensionDO::getAssessmentId)
+                .orderByAsc(HrmPerformanceAssessmentDimensionDO::getSort)
+                .orderByAsc(HrmPerformanceAssessmentDimensionDO::getId));
+    }
+
+    default void deleteByAssessmentId(Long assessmentId) {
+        delete(HrmPerformanceAssessmentDimensionDO::getAssessmentId, assessmentId);
+    }
+
+    default void deleteByAssessmentIds(Collection<Long> assessmentIds) {
+        delete(new LambdaQueryWrapperX<HrmPerformanceAssessmentDimensionDO>()
+                .in(HrmPerformanceAssessmentDimensionDO::getAssessmentId, assessmentIds));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentMapper.java
new file mode 100644
index 0000000..f3cda90
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentMapper.java
@@ -0,0 +1,173 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment;
+
+import cn.hutool.core.map.MapUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchivePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment.HrmPortalPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.math.BigDecimal;
+import java.util.Collection;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+@Mapper
+public interface HrmPerformanceAssessmentMapper extends BaseMapperX<HrmPerformanceAssessmentDO> {
+
+    default List<HrmPerformanceAssessmentDO> selectListByPlanId(Long planId) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .eq(HrmPerformanceAssessmentDO::getPlanId, planId)
+                .orderByDesc(HrmPerformanceAssessmentDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentDO> selectListByPlanIds(Collection<Long> planIds) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .in(HrmPerformanceAssessmentDO::getPlanId, planIds)
+                .orderByDesc(HrmPerformanceAssessmentDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentDO> selectListByStatus(Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .eq(HrmPerformanceAssessmentDO::getStatus, status)
+                .orderByDesc(HrmPerformanceAssessmentDO::getArchiveTime)
+                .orderByDesc(HrmPerformanceAssessmentDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentDO> selectListByIdsAndStatus(
+            Collection<Long> ids, Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .in(HrmPerformanceAssessmentDO::getId, ids)
+                .eq(HrmPerformanceAssessmentDO::getStatus, status));
+    }
+
+    default List<HrmPerformanceAssessmentDO> selectListByPlanIdsAndEmployeeIdsAndStatus(Collection<Long> planIds,
+                                                                                          Collection<Long> employeeIds,
+                                                                                          Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .in(HrmPerformanceAssessmentDO::getPlanId, planIds)
+                .in(HrmPerformanceAssessmentDO::getEmployeeId, employeeIds)
+                .eqIfPresent(HrmPerformanceAssessmentDO::getStatus, status)
+                .orderByDesc(HrmPerformanceAssessmentDO::getArchiveTime)
+                .orderByDesc(HrmPerformanceAssessmentDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentDO> selectListByEmployeeIdsAndStatus(
+            Collection<Long> employeeIds, Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .in(HrmPerformanceAssessmentDO::getEmployeeId, employeeIds)
+                .eq(HrmPerformanceAssessmentDO::getStatus, status)
+                .orderByDesc(HrmPerformanceAssessmentDO::getArchiveTime)
+                .orderByDesc(HrmPerformanceAssessmentDO::getId));
+    }
+
+    default PageResult<HrmPerformanceAssessmentDO> selectPage(HrmPerformanceAssessmentPageReqVO reqVO) {
+        LambdaQueryWrapperX<HrmPerformanceAssessmentDO> query = new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .eqIfPresent(HrmPerformanceAssessmentDO::getPlanId, reqVO.getPlanId())
+                .eqIfPresent(HrmPerformanceAssessmentDO::getEmployeeId, reqVO.getEmployeeId())
+                .inIfPresent(HrmPerformanceAssessmentDO::getEmployeeId, reqVO.getEmployeeIds())
+                .eqIfPresent(HrmPerformanceAssessmentDO::getStatus, reqVO.getStatus())
+                .eqIfPresent(HrmPerformanceAssessmentDO::getStageType, reqVO.getStageType())
+                .eqIfPresent(HrmPerformanceAssessmentDO::getAppealStatus, reqVO.getAppealStatus())
+                .eqIfPresent(HrmPerformanceAssessmentDO::getResultLevel, reqVO.getResultLevel());
+        if (Boolean.TRUE.equals(reqVO.getResultLevelEmpty())) {
+            query.isNull(HrmPerformanceAssessmentDO::getResultLevel);
+        }
+        return selectPage(reqVO, query.orderByDesc(HrmPerformanceAssessmentDO::getId));
+    }
+
+    default PageResult<HrmPerformanceAssessmentDO> selectPortalPage(
+            HrmPortalPerformanceAssessmentPageReqVO reqVO, Long employeeId) {
+        MPJLambdaWrapperX<HrmPerformanceAssessmentDO> query = new MPJLambdaWrapperX<HrmPerformanceAssessmentDO>()
+                .selectAll(HrmPerformanceAssessmentDO.class)
+                .innerJoin(HrmPerformancePlanDO.class,
+                        HrmPerformancePlanDO::getId, HrmPerformanceAssessmentDO::getPlanId)
+                .eq(HrmPerformanceAssessmentDO::getEmployeeId, employeeId)
+                .likeIfPresent(HrmPerformancePlanDO::getName, reqVO.getSearch())
+                .orderByDesc(HrmPerformanceAssessmentDO::getId);
+        if (Boolean.TRUE.equals(reqVO.getArchived())) {
+            query.eq(HrmPerformanceAssessmentDO::getStatus,
+                    HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+        } else {
+            query.ne(HrmPerformanceAssessmentDO::getStatus,
+                    HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+        }
+        return selectJoinPage(reqVO, HrmPerformanceAssessmentDO.class, query);
+    }
+
+    default Map<Integer, Long> selectCountMapByEmployeeIdAndPlanName(
+            Long employeeId, String planName) {
+        List<Map<String, Object>> result = selectJoinMaps(
+                new MPJLambdaWrapperX<HrmPerformanceAssessmentDO>()
+                        .selectAs(HrmPerformanceAssessmentDO::getStatus, "status")
+                        .selectCount(HrmPerformanceAssessmentDO::getId, "count")
+                        .innerJoin(HrmPerformancePlanDO.class,
+                                HrmPerformancePlanDO::getId, HrmPerformanceAssessmentDO::getPlanId)
+                        .eq(HrmPerformanceAssessmentDO::getEmployeeId, employeeId)
+                        .likeIfPresent(HrmPerformancePlanDO::getName, planName)
+                        .groupBy(HrmPerformanceAssessmentDO::getStatus));
+        return convertMap(result, item -> MapUtil.getInt(item, "status"),
+                item -> MapUtil.getLong(item, "count"), (first, second) -> first,
+                LinkedHashMap::new);
+    }
+
+    default PageResult<HrmPerformanceAssessmentDO> selectPageByStatus(
+            HrmPerformanceArchivePageReqVO reqVO, Integer status) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmPerformanceAssessmentDO>()
+                .eqIfPresent(HrmPerformanceAssessmentDO::getPlanId, reqVO.getPlanId())
+                .eqIfPresent(HrmPerformanceAssessmentDO::getEmployeeId, reqVO.getEmployeeId())
+                .inIfPresent(HrmPerformanceAssessmentDO::getEmployeeId, reqVO.getEmployeeIds())
+                .eq(HrmPerformanceAssessmentDO::getStatus, status)
+                .orderByDesc(HrmPerformanceAssessmentDO::getArchiveTime)
+                .orderByDesc(HrmPerformanceAssessmentDO::getId));
+    }
+
+    default PageResult<HrmEmployeeDO> selectArchiveEmployeePage(
+            HrmPerformanceArchiveEmployeePageReqVO reqVO, Integer status) {
+        MPJLambdaWrapperX<HrmPerformanceAssessmentDO> query = new MPJLambdaWrapperX<>();
+        query.selectAll(HrmEmployeeDO.class)
+                .innerJoin(HrmEmployeeDO.class,
+                        HrmEmployeeDO::getId, HrmPerformanceAssessmentDO::getEmployeeId)
+                .eq(HrmPerformanceAssessmentDO::getStatus, status)
+                .orderByDesc(HrmEmployeeDO::getId);
+        query.distinct();
+        if (StrUtil.isNotBlank(reqVO.getSearch())) {
+            query.and(wrapper -> wrapper.like(HrmEmployeeDO::getName, reqVO.getSearch())
+                    .or().like(HrmEmployeeDO::getJobNumber, reqVO.getSearch()));
+        }
+        return selectJoinPage(reqVO, HrmEmployeeDO.class, query);
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateResultToClearById(Long id) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentDO>()
+                .eq(HrmPerformanceAssessmentDO::getId, id)
+                .set(HrmPerformanceAssessmentDO::getScore, null)
+                .set(HrmPerformanceAssessmentDO::getResultLevel, null)
+                .set(HrmPerformanceAssessmentDO::getCoefficient, BigDecimal.ONE)
+                .set(HrmPerformanceAssessmentDO::getSelfComment, null)
+                .set(HrmPerformanceAssessmentDO::getReviewerComment, null));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateAppealResultToClearById(Long id) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentDO>()
+                .eq(HrmPerformanceAssessmentDO::getId, id)
+                .set(HrmPerformanceAssessmentDO::getAppealTime, null)
+                .set(HrmPerformanceAssessmentDO::getAppealComment, null));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentQuotaMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentQuotaMapper.java
new file mode 100644
index 0000000..b5f43fd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentQuotaMapper.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmPerformanceAssessmentQuotaMapper extends BaseMapperX<HrmPerformanceAssessmentQuotaDO> {
+
+    default List<HrmPerformanceAssessmentQuotaDO> selectListByAssessmentId(Long assessmentId) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentQuotaDO>()
+                .eq(HrmPerformanceAssessmentQuotaDO::getAssessmentId, assessmentId)
+                .orderByAsc(HrmPerformanceAssessmentQuotaDO::getSort)
+                .orderByAsc(HrmPerformanceAssessmentQuotaDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentQuotaDO> selectListByAssessmentIds(
+            Collection<Long> assessmentIds) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentQuotaDO>()
+                .in(HrmPerformanceAssessmentQuotaDO::getAssessmentId, assessmentIds)
+                .orderByAsc(HrmPerformanceAssessmentQuotaDO::getAssessmentId)
+                .orderByAsc(HrmPerformanceAssessmentQuotaDO::getSort)
+                .orderByAsc(HrmPerformanceAssessmentQuotaDO::getId));
+    }
+
+    default void deleteByAssessmentIds(Collection<Long> assessmentIds) {
+        delete(new LambdaQueryWrapperX<HrmPerformanceAssessmentQuotaDO>()
+                .in(HrmPerformanceAssessmentQuotaDO::getAssessmentId, assessmentIds));
+    }
+
+    default int updateFinalScoreToNullByAssessmentId(Long assessmentId) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentQuotaDO>()
+                .eq(HrmPerformanceAssessmentQuotaDO::getAssessmentId, assessmentId)
+                .set(HrmPerformanceAssessmentQuotaDO::getFinalScore, null));
+    }
+
+    default int updateReviewScoreToNullByAssessmentId(Long assessmentId) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentQuotaDO>()
+                .eq(HrmPerformanceAssessmentQuotaDO::getAssessmentId, assessmentId)
+                .set(HrmPerformanceAssessmentQuotaDO::getSelfScore, null)
+                .set(HrmPerformanceAssessmentQuotaDO::getReviewerScore, null)
+                .set(HrmPerformanceAssessmentQuotaDO::getFinalScore, null));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentQuotaScoreMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentQuotaScoreMapper.java
new file mode 100644
index 0000000..425b486
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentQuotaScoreMapper.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmPerformanceAssessmentQuotaScoreMapper
+        extends BaseMapperX<HrmPerformanceAssessmentQuotaScoreDO> {
+
+    default List<HrmPerformanceAssessmentQuotaScoreDO> selectListByAssessmentStageIds(
+            Collection<Long> assessmentStageIds) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentQuotaScoreDO>()
+                .in(HrmPerformanceAssessmentQuotaScoreDO::getAssessmentStageId,
+                        assessmentStageIds));
+    }
+
+    default void deleteByAssessmentStageId(Long assessmentStageId) {
+        delete(new LambdaQueryWrapperX<HrmPerformanceAssessmentQuotaScoreDO>()
+                .eq(HrmPerformanceAssessmentQuotaScoreDO::getAssessmentStageId, assessmentStageId));
+    }
+
+    default void deleteByAssessmentStageIds(Collection<Long> assessmentStageIds) {
+        delete(new LambdaQueryWrapperX<HrmPerformanceAssessmentQuotaScoreDO>()
+                .in(HrmPerformanceAssessmentQuotaScoreDO::getAssessmentStageId,
+                        assessmentStageIds));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentStageMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentStageMapper.java
new file mode 100644
index 0000000..c8c9b8e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/assessment/HrmPerformanceAssessmentStageMapper.java
@@ -0,0 +1,207 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment;
+
+import cn.hutool.core.map.MapUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface HrmPerformanceAssessmentStageMapper
+        extends BaseMapperX<HrmPerformanceAssessmentStageDO> {
+
+    default List<HrmPerformanceAssessmentStageDO> selectListByAssessmentId(Long assessmentId) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentId)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getSort)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentStageDO> selectListByAssessmentIds(
+            Collection<Long> assessmentIds) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentStageDO>()
+                .in(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentIds)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getAssessmentId)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getSort));
+    }
+
+    default List<HrmPerformanceAssessmentStageDO> selectListByAssessmentIdAndType(
+            Long assessmentId, Integer type) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentId)
+                .eq(HrmPerformanceAssessmentStageDO::getType, type)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getSort)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getId));
+    }
+
+    default PageResult<HrmPerformanceAssessmentStageDO> selectPortalTaskPage(
+            HrmPortalPerformanceTaskPageReqVO reqVO, Long handlerEmployeeId,
+            Collection<Integer> types) {
+        MPJLambdaWrapperX<HrmPerformanceAssessmentStageDO> query =
+                new MPJLambdaWrapperX<HrmPerformanceAssessmentStageDO>()
+                        .selectAll(HrmPerformanceAssessmentStageDO.class)
+                        .innerJoin(HrmPerformanceAssessmentDO.class,
+                                HrmPerformanceAssessmentDO::getId,
+                                HrmPerformanceAssessmentStageDO::getAssessmentId)
+                        .innerJoin(HrmPerformancePlanDO.class,
+                                HrmPerformancePlanDO::getId,
+                                HrmPerformanceAssessmentDO::getPlanId)
+                        .eq(HrmPerformanceAssessmentStageDO::getHandlerEmployeeId, handlerEmployeeId)
+                        .in(HrmPerformanceAssessmentStageDO::getType, types)
+                        .eq(HrmPerformanceAssessmentStageDO::getStatus, reqVO.getStageStatus());
+        if (StrUtil.isNotBlank(reqVO.getSearch())) {
+            query.innerJoin(HrmEmployeeDO.class,
+                    HrmEmployeeDO::getId, HrmPerformanceAssessmentDO::getEmployeeId);
+            query.and(wrapper -> wrapper.like(HrmPerformancePlanDO::getName, reqVO.getSearch())
+                    .or().like(HrmEmployeeDO::getName, reqVO.getSearch())
+                    .or().like(HrmEmployeeDO::getJobNumber, reqVO.getSearch()));
+        }
+        if (HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()
+                .equals(reqVO.getStageStatus())) {
+            query.eq(HrmPerformancePlanDO::getStatus,
+                    HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                    .orderByAsc(HrmPerformanceAssessmentStageDO::getDeadlineTime);
+        } else {
+            query.orderByDesc(HrmPerformanceAssessmentStageDO::getSubmitTime);
+        }
+        query.orderByDesc(HrmPerformanceAssessmentStageDO::getId);
+        return selectJoinPage(reqVO, HrmPerformanceAssessmentStageDO.class, query);
+    }
+
+    default Map<Integer, Map<Integer, Long>> selectPortalTaskCountMap(
+            Long handlerEmployeeId, String search) {
+        MPJLambdaWrapperX<HrmPerformanceAssessmentStageDO> query =
+                new MPJLambdaWrapperX<>();
+        query.selectAs(HrmPerformanceAssessmentStageDO::getType, "type")
+                .selectAs(HrmPerformanceAssessmentStageDO::getStatus, "status")
+                .selectCount(HrmPerformanceAssessmentStageDO::getId, "count");
+        query.innerJoin(HrmPerformanceAssessmentDO.class,
+                        HrmPerformanceAssessmentDO::getId,
+                        HrmPerformanceAssessmentStageDO::getAssessmentId)
+                .innerJoin(HrmPerformancePlanDO.class,
+                        HrmPerformancePlanDO::getId,
+                        HrmPerformanceAssessmentDO::getPlanId)
+                .eq(HrmPerformanceAssessmentStageDO::getHandlerEmployeeId, handlerEmployeeId);
+        query.and(wrapper -> wrapper
+                .ne(HrmPerformanceAssessmentStageDO::getStatus,
+                        HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                .or().eq(HrmPerformancePlanDO::getStatus,
+                        HrmPerformancePlanStatusEnum.RUNNING.getStatus()));
+        query.groupBy(HrmPerformanceAssessmentStageDO::getType);
+        query.groupBy(HrmPerformanceAssessmentStageDO::getStatus);
+        if (StrUtil.isNotBlank(search)) {
+            query.innerJoin(HrmEmployeeDO.class,
+                    HrmEmployeeDO::getId, HrmPerformanceAssessmentDO::getEmployeeId);
+            query.and(wrapper -> wrapper.like(HrmPerformancePlanDO::getName, search)
+                    .or().like(HrmEmployeeDO::getName, search)
+                    .or().like(HrmEmployeeDO::getJobNumber, search));
+        }
+        Map<Integer, Map<Integer, Long>> countMap = new LinkedHashMap<>();
+        for (Map<String, Object> item : selectJoinMaps(query)) {
+            countMap.computeIfAbsent(MapUtil.getInt(item, "type"),
+                    key -> new LinkedHashMap<>())
+                    .put(MapUtil.getInt(item, "status"), MapUtil.getLong(item, "count"));
+        }
+        return countMap;
+    }
+
+    default List<HrmPerformanceAssessmentStageDO> selectListByAssessmentIdAndTypes(
+            Long assessmentId, Collection<Integer> types) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentId)
+                .in(HrmPerformanceAssessmentStageDO::getType, types)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getSort)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getId));
+    }
+
+    default List<HrmPerformanceAssessmentStageDO> selectListByTypeAndStatusAndDeadlineTimeBeforeOrEqual(
+            Integer type, Integer status, LocalDateTime deadlineTime) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getType, type)
+                .eq(HrmPerformanceAssessmentStageDO::getStatus, status)
+                .le(HrmPerformanceAssessmentStageDO::getDeadlineTime, deadlineTime)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getDeadlineTime)
+                .orderByAsc(HrmPerformanceAssessmentStageDO::getId));
+    }
+
+    default void deleteByAssessmentIds(Collection<Long> assessmentIds) {
+        delete(new LambdaQueryWrapperX<HrmPerformanceAssessmentStageDO>()
+                .in(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentIds));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateToResetByAssessmentIdAndType(Long assessmentId, Integer type, Integer status) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentId)
+                .eq(HrmPerformanceAssessmentStageDO::getType, type)
+                .set(HrmPerformanceAssessmentStageDO::getStatus, status)
+                .set(HrmPerformanceAssessmentStageDO::getComment, null)
+                .set(HrmPerformanceAssessmentStageDO::getRejectReason, null)
+                .set(HrmPerformanceAssessmentStageDO::getSubmitTime, null)
+                .set(HrmPerformanceAssessmentStageDO::getDeadlineTime, null));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateToResetByAssessmentIdAndTypeAndSortGreaterThanOrEqual(
+            Long assessmentId, Integer type, Integer sort, Integer status) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentId)
+                .eq(HrmPerformanceAssessmentStageDO::getType, type)
+                .ge(HrmPerformanceAssessmentStageDO::getSort, sort)
+                .set(HrmPerformanceAssessmentStageDO::getStatus, status)
+                .set(HrmPerformanceAssessmentStageDO::getComment, null)
+                .set(HrmPerformanceAssessmentStageDO::getRejectReason, null)
+                .set(HrmPerformanceAssessmentStageDO::getSubmitTime, null)
+                .set(HrmPerformanceAssessmentStageDO::getDeadlineTime, null));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateToResetByIds(Collection<Long> ids, Integer status) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentStageDO>()
+                .in(HrmPerformanceAssessmentStageDO::getId, ids)
+                .set(HrmPerformanceAssessmentStageDO::getStatus, status)
+                .set(HrmPerformanceAssessmentStageDO::getScore, null)
+                .set(HrmPerformanceAssessmentStageDO::getComment, null)
+                .set(HrmPerformanceAssessmentStageDO::getRejectReason, null)
+                .set(HrmPerformanceAssessmentStageDO::getSubmitTime, null));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateToResetForReject(Long id, Integer status, String rejectReason) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getId, id)
+                .set(HrmPerformanceAssessmentStageDO::getStatus, status)
+                .set(HrmPerformanceAssessmentStageDO::getScore, null)
+                .set(HrmPerformanceAssessmentStageDO::getComment, null)
+                .set(HrmPerformanceAssessmentStageDO::getRejectReason, rejectReason)
+                .set(HrmPerformanceAssessmentStageDO::getSubmitTime, null));
+    }
+
+    default int updateToProcessedByAssessmentIdAndTypeAndSortGreaterThan(
+            Long assessmentId, Integer type, Integer sort, LocalDateTime submitTime) {
+        return update(new LambdaUpdateWrapper<HrmPerformanceAssessmentStageDO>()
+                .eq(HrmPerformanceAssessmentStageDO::getAssessmentId, assessmentId)
+                .eq(HrmPerformanceAssessmentStageDO::getType, type)
+                .gt(HrmPerformanceAssessmentStageDO::getSort, sort)
+                .set(HrmPerformanceAssessmentStageDO::getStatus,
+                        HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus())
+                .set(HrmPerformanceAssessmentStageDO::getSubmitTime, submitTime));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/config/HrmPerformanceAssessmentTemplateMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/config/HrmPerformanceAssessmentTemplateMapper.java
new file mode 100644
index 0000000..4b20492
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/config/HrmPerformanceAssessmentTemplateMapper.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.config;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmPerformanceAssessmentTemplateMapper extends BaseMapperX<HrmPerformanceAssessmentTemplateDO> {
+
+    default PageResult<HrmPerformanceAssessmentTemplateDO> selectPage(
+            HrmPerformanceAssessmentTemplatePageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmPerformanceAssessmentTemplateDO>()
+                .likeIfPresent(HrmPerformanceAssessmentTemplateDO::getName, reqVO.getName())
+                .eq(HrmPerformanceAssessmentTemplateDO::getStatus, CommonStatusEnum.ENABLE.getStatus())
+                .orderByDesc(HrmPerformanceAssessmentTemplateDO::getUpdateTime)
+                .orderByDesc(HrmPerformanceAssessmentTemplateDO::getId));
+    }
+
+    default HrmPerformanceAssessmentTemplateDO selectByName(String name) {
+        return selectFirstOne(HrmPerformanceAssessmentTemplateDO::getName, name,
+                HrmPerformanceAssessmentTemplateDO::getStatus, CommonStatusEnum.ENABLE.getStatus());
+    }
+
+    default List<HrmPerformanceAssessmentTemplateDO> selectListByStatus(Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceAssessmentTemplateDO>()
+                .eq(HrmPerformanceAssessmentTemplateDO::getStatus, status)
+                .orderByDesc(HrmPerformanceAssessmentTemplateDO::getUpdateTime)
+                .orderByDesc(HrmPerformanceAssessmentTemplateDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/config/HrmPerformanceResultTemplateMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/config/HrmPerformanceResultTemplateMapper.java
new file mode 100644
index 0000000..d9cf3ca
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/config/HrmPerformanceResultTemplateMapper.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.config;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmPerformanceResultTemplateMapper extends BaseMapperX<HrmPerformanceResultTemplateDO> {
+
+    default PageResult<HrmPerformanceResultTemplateDO> selectPage(HrmPerformanceResultTemplatePageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmPerformanceResultTemplateDO>()
+                .likeIfPresent(HrmPerformanceResultTemplateDO::getName, reqVO.getName())
+                .eq(HrmPerformanceResultTemplateDO::getStatus, CommonStatusEnum.ENABLE.getStatus())
+                .orderByDesc(HrmPerformanceResultTemplateDO::getUpdateTime)
+                .orderByDesc(HrmPerformanceResultTemplateDO::getId));
+    }
+
+    default HrmPerformanceResultTemplateDO selectByName(String name) {
+        return selectFirstOne(HrmPerformanceResultTemplateDO::getName, name,
+                HrmPerformanceResultTemplateDO::getStatus, CommonStatusEnum.ENABLE.getStatus());
+    }
+
+    default List<HrmPerformanceResultTemplateDO> selectListByStatus(Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformanceResultTemplateDO>()
+                .eqIfPresent(HrmPerformanceResultTemplateDO::getStatus, status)
+                .orderByDesc(HrmPerformanceResultTemplateDO::getUpdateTime)
+                .orderByDesc(HrmPerformanceResultTemplateDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/plan/HrmPerformancePlanMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/plan/HrmPerformancePlanMapper.java
new file mode 100644
index 0000000..eb9e3f2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/performance/plan/HrmPerformancePlanMapper.java
@@ -0,0 +1,58 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.performance.plan;
+
+import cn.hutool.core.map.MapUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.QueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface HrmPerformancePlanMapper extends BaseMapperX<HrmPerformancePlanDO> {
+
+    default PageResult<HrmPerformancePlanDO> selectPage(HrmPerformancePlanPageReqVO reqVO) {
+        return selectPage(reqVO, buildQueryWrapper(reqVO)
+                .eqIfPresent("status", reqVO.getStatus())
+                .orderByDesc("id"));
+    }
+
+    default Map<Integer, Long> selectCountMapByStatus(HrmPerformancePlanPageReqVO reqVO) {
+        QueryWrapperX<HrmPerformancePlanDO> query = buildQueryWrapper(reqVO);
+        query.select("status", "COUNT(id) AS count").groupBy("status");
+        return CollectionUtils.convertMap(selectMaps(query),
+                record -> MapUtil.getInt(record, "status"),
+                record -> MapUtil.getLong(record, "count"));
+    }
+
+    default HrmPerformancePlanDO selectByName(String name) {
+        return selectFirstOne(HrmPerformancePlanDO::getName, name);
+    }
+
+    default List<HrmPerformancePlanDO> selectListByPaidForMonth(String paidForMonth) {
+        return selectList(new LambdaQueryWrapperX<HrmPerformancePlanDO>()
+                .eq(HrmPerformancePlanDO::getPaidForMonth, paidForMonth)
+                .orderByDesc(HrmPerformancePlanDO::getId));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateStageTypeAndOperationTypeById(Long id, Integer stageType, Integer operationType) {
+        return update(new LambdaUpdateWrapper<HrmPerformancePlanDO>()
+                .set(HrmPerformancePlanDO::getStageType, stageType)
+                .set(HrmPerformancePlanDO::getOperationType, operationType)
+                .eq(HrmPerformancePlanDO::getId, id));
+    }
+
+    static QueryWrapperX<HrmPerformancePlanDO> buildQueryWrapper(HrmPerformancePlanPageReqVO reqVO) {
+        return new QueryWrapperX<HrmPerformancePlanDO>()
+                .likeIfPresent("name", reqVO.getName())
+                .eqIfPresent("stage_type", reqVO.getStageType());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/candidate/HrmRecruitCandidateMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/candidate/HrmRecruitCandidateMapper.java
new file mode 100644
index 0000000..324bc2f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/candidate/HrmRecruitCandidateMapper.java
@@ -0,0 +1,151 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.recruit.candidate;
+
+import cn.hutool.core.map.MapUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.util.MyBatisUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidatePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface HrmRecruitCandidateMapper extends BaseMapperX<HrmRecruitCandidateDO> {
+
+    default HrmRecruitCandidateDO selectByIdForUpdate(Long id) {
+        return selectOneForUpdate(HrmRecruitCandidateDO::getId, id);
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateForEdit(HrmRecruitCandidateDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmRecruitCandidateDO>()
+                .eq(HrmRecruitCandidateDO::getId, updateObj.getId())
+                .set(updateObj.getAge() == null, HrmRecruitCandidateDO::getAge, null)
+                .set(updateObj.getEmail() == null, HrmRecruitCandidateDO::getEmail, null)
+                .set(updateObj.getWorkTime() == null, HrmRecruitCandidateDO::getWorkTime, null)
+                .set(updateObj.getGraduateSchool() == null, HrmRecruitCandidateDO::getGraduateSchool, null)
+                .set(updateObj.getLatestWorkPlace() == null, HrmRecruitCandidateDO::getLatestWorkPlace, null)
+                .set(updateObj.getChannelId() == null, HrmRecruitCandidateDO::getChannelId, null)
+                .set(updateObj.getRemark() == null, HrmRecruitCandidateDO::getRemark, null)
+                .set(updateObj.getResumeUrls() == null, HrmRecruitCandidateDO::getResumeUrls, null));
+    }
+
+    default PageResult<HrmRecruitCandidateDO> selectPage(HrmRecruitCandidatePageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmRecruitCandidateDO> query = buildQueryWrapper(reqVO)
+                .selectAll(HrmRecruitCandidateDO.class)
+                .eqIfPresent(HrmRecruitCandidateDO::getStatus, reqVO.getStatus())
+                .orderByDesc(HrmRecruitCandidateDO::getCreateTime)
+                .orderByDesc(HrmRecruitCandidateDO::getId);
+        return selectJoinPage(reqVO, HrmRecruitCandidateDO.class, query);
+    }
+
+    default List<HrmRecruitCandidateDO> selectListByStatusesAndStatusUpdateTimeBefore(
+            Collection<Integer> statuses, LocalDateTime statusUpdateTime) {
+        return selectList(new LambdaQueryWrapperX<HrmRecruitCandidateDO>()
+                .in(HrmRecruitCandidateDO::getStatus, statuses)
+                .lt(HrmRecruitCandidateDO::getStatusUpdateTime, statusUpdateTime)
+                .orderByDesc(HrmRecruitCandidateDO::getId));
+    }
+
+    default Long selectCountByStatusAndStatusUpdateTimeBetween(
+            Integer status, LocalDateTime[] statusUpdateTimes) {
+        return selectCount(new LambdaQueryWrapperX<HrmRecruitCandidateDO>()
+                .eq(HrmRecruitCandidateDO::getStatus, status)
+                .betweenIfPresent(HrmRecruitCandidateDO::getStatusUpdateTime, statusUpdateTimes));
+    }
+
+    default Long selectCountByStatusAndEntryTimeBetween(
+            Integer status, LocalDateTime[] entryTimes) {
+        return selectCount(new LambdaQueryWrapperX<HrmRecruitCandidateDO>()
+                .eq(HrmRecruitCandidateDO::getStatus, status)
+                .betweenIfPresent(HrmRecruitCandidateDO::getEntryTime, entryTimes));
+    }
+
+    default Map<Integer, Long> selectCountMapByStatus(HrmRecruitCandidatePageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmRecruitCandidateDO> query = buildQueryWrapper(reqVO)
+                .selectAs(HrmRecruitCandidateDO::getStatus, "status");
+        query.selectFunc("COUNT(DISTINCT %s)", arg -> arg.accept(HrmRecruitCandidateDO::getId), "count");
+        query.groupBy(HrmRecruitCandidateDO::getStatus);
+        return CollectionUtils.convertMap(selectJoinMaps(query),
+                record -> MapUtil.getInt(record, "status"),
+                record -> MapUtil.getLong(record, "count"));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateChannelIdByChannelId(Long channelId, Long newChannelId) {
+        return update(new LambdaUpdateWrapper<HrmRecruitCandidateDO>()
+                .eq(HrmRecruitCandidateDO::getChannelId, channelId)
+                .set(HrmRecruitCandidateDO::getChannelId, newChannelId));
+    }
+
+    default Map<Long, Long> selectCountMapByPostIdsAndStatus(Collection<Long> postIds, Integer status) {
+        List<Map<String, Object>> result = selectMaps(new MPJLambdaWrapperX<HrmRecruitCandidateDO>()
+                .selectAs(HrmRecruitCandidateDO::getPostId, "postId")
+                .selectCount(HrmRecruitCandidateDO::getId, "count")
+                .in(HrmRecruitCandidateDO::getPostId, postIds)
+                .eq(HrmRecruitCandidateDO::getStatus, status)
+                .groupBy(HrmRecruitCandidateDO::getPostId));
+        return CollectionUtils.convertMap(result,
+                record -> MapUtil.getLong(record, "postId"),
+                record -> MapUtil.getLong(record, "count"));
+    }
+
+    private MPJLambdaWrapperX<HrmRecruitCandidateDO> buildQueryWrapper(HrmRecruitCandidatePageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmRecruitCandidateDO> query = new MPJLambdaWrapperX<HrmRecruitCandidateDO>()
+                .eqIfPresent(HrmRecruitCandidateDO::getPostId, reqVO.getPostId())
+                .eqIfPresent(HrmRecruitCandidateDO::getSex, reqVO.getSex())
+                .geIfPresent(HrmRecruitCandidateDO::getAge, reqVO.getMinAge())
+                .leIfPresent(HrmRecruitCandidateDO::getAge, reqVO.getMaxAge())
+                .geIfPresent(HrmRecruitCandidateDO::getWorkTime, reqVO.getMinWorkTime())
+                .leIfPresent(HrmRecruitCandidateDO::getWorkTime, reqVO.getMaxWorkTime())
+                .eqIfPresent(HrmRecruitCandidateDO::getEducation, reqVO.getEducation())
+                .likeIfPresent(HrmRecruitCandidateDO::getGraduateSchool, reqVO.getGraduateSchool())
+                .likeIfPresent(HrmRecruitCandidateDO::getLatestWorkPlace, reqVO.getLatestWorkPlace())
+                .eqIfPresent(HrmRecruitCandidateDO::getChannelId, reqVO.getChannelId())
+                .eqIfPresent(HrmRecruitCandidateDO::getCreator, reqVO.getCreator())
+                .betweenIfPresent(HrmRecruitCandidateDO::getCreateTime, reqVO.getCreateTime());
+        // 拼接招聘负责人查询条件
+        if (reqVO.getOwnerEmployeeId() != null) {
+            query.innerJoin(HrmRecruitPostDO.class, HrmRecruitPostDO::getId, HrmRecruitCandidateDO::getPostId)
+                    .eq(HrmRecruitPostDO::getOwnerEmployeeId, reqVO.getOwnerEmployeeId());
+        }
+        // 拼接关键字查询条件
+        if (StrUtil.isNotBlank(reqVO.getSearch())) {
+            query.and(wrapper -> wrapper.like(HrmRecruitCandidateDO::getName, reqVO.getSearch())
+                    .or().like(HrmRecruitCandidateDO::getMobile, reqVO.getSearch())
+                    .or().like(HrmRecruitCandidateDO::getEmail, reqVO.getSearch()));
+        }
+        // 拼接面试查询条件
+        LocalDateTime[] interviewTimes = reqVO.getInterviewTime();
+        if (reqVO.getInterviewEmployeeId() != null
+                || LocalDateTimeUtils.isTimeRangePresent(interviewTimes)) {
+            query.innerJoin(HrmRecruitInterviewDO.class, "interview", on -> on
+                    .eq(HrmRecruitInterviewDO::getCandidateId, HrmRecruitCandidateDO::getId)
+                    .eq(HrmRecruitInterviewDO::getStageNumber, HrmRecruitCandidateDO::getStageNumber)
+                    .ne(HrmRecruitInterviewDO::getResult, HrmRecruitInterviewResultEnum.CANCEL.getResult()));
+            query.distinct(); // 避免当前轮次存在多条面试记录时，候选人重复
+            if (reqVO.getInterviewEmployeeId() != null) {
+                query.and(wrapper -> wrapper
+                        .eq(HrmRecruitInterviewDO::getInterviewEmployeeId, reqVO.getInterviewEmployeeId())
+                        .or().apply(MyBatisUtils.findInSet("interview.other_interview_employee_ids"),
+                                reqVO.getInterviewEmployeeId()));
+            }
+            query.betweenIfPresent(HrmRecruitInterviewDO::getInterviewTime, interviewTimes);
+        }
+        return query;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/candidate/HrmRecruitInterviewMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/candidate/HrmRecruitInterviewMapper.java
new file mode 100644
index 0000000..62e415d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/candidate/HrmRecruitInterviewMapper.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.recruit.candidate;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmRecruitInterviewMapper extends BaseMapperX<HrmRecruitInterviewDO> {
+
+    default List<HrmRecruitInterviewDO> selectListByCandidateId(Long candidateId) {
+        return selectList(new LambdaQueryWrapperX<HrmRecruitInterviewDO>()
+                .eq(HrmRecruitInterviewDO::getCandidateId, candidateId)
+                .orderByDesc(HrmRecruitInterviewDO::getStageNumber)
+                .orderByDesc(HrmRecruitInterviewDO::getId));
+    }
+
+    default HrmRecruitInterviewDO selectLatestByCandidateId(Long candidateId) {
+        return selectOne(new LambdaQueryWrapperX<HrmRecruitInterviewDO>()
+                .eq(HrmRecruitInterviewDO::getCandidateId, candidateId)
+                .orderByDesc(HrmRecruitInterviewDO::getStageNumber)
+                .orderByDesc(HrmRecruitInterviewDO::getId)
+                .last("LIMIT 1"));
+    }
+
+    default void deleteByCandidateId(Long candidateId) {
+        delete(new LambdaQueryWrapperX<HrmRecruitInterviewDO>()
+                .eq(HrmRecruitInterviewDO::getCandidateId, candidateId));
+    }
+
+    default List<HrmRecruitInterviewDO> selectListByCandidateIds(Collection<Long> candidateIds) {
+        return selectList(new LambdaQueryWrapperX<HrmRecruitInterviewDO>()
+                .in(HrmRecruitInterviewDO::getCandidateId, candidateIds)
+                .orderByAsc(HrmRecruitInterviewDO::getCandidateId)
+                .orderByDesc(HrmRecruitInterviewDO::getStageNumber)
+                .orderByDesc(HrmRecruitInterviewDO::getId));
+    }
+
+    default List<HrmRecruitInterviewDO> selectListByInterviewTimeBetween(
+            LocalDateTime[] interviewTimes) {
+        return selectList(new LambdaQueryWrapperX<HrmRecruitInterviewDO>()
+                .betweenIfPresent(HrmRecruitInterviewDO::getInterviewTime, interviewTimes)
+                .orderByAsc(HrmRecruitInterviewDO::getInterviewTime)
+                .orderByAsc(HrmRecruitInterviewDO::getId));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateRecruitInterviewArrangement(HrmRecruitInterviewDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmRecruitInterviewDO>()
+                .set(HrmRecruitInterviewDO::getEvaluate, null)
+                .set(HrmRecruitInterviewDO::getCancelReason, null)
+                .eq(HrmRecruitInterviewDO::getId, updateObj.getId()));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateRecruitInterviewResult(HrmRecruitInterviewDO updateObj) {
+        return update(new LambdaUpdateWrapper<HrmRecruitInterviewDO>()
+                .set(HrmRecruitInterviewDO::getResult, updateObj.getResult())
+                .set(HrmRecruitInterviewDO::getEvaluate, updateObj.getEvaluate())
+                .set(HrmRecruitInterviewDO::getCancelReason, updateObj.getCancelReason())
+                .eq(HrmRecruitInterviewDO::getId, updateObj.getId()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/config/HrmRecruitChannelMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/config/HrmRecruitChannelMapper.java
new file mode 100644
index 0000000..03d33de
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/config/HrmRecruitChannelMapper.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.recruit.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmRecruitChannelMapper extends BaseMapperX<HrmRecruitChannelDO> {
+
+    default PageResult<HrmRecruitChannelDO> selectPage(HrmRecruitChannelPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmRecruitChannelDO>()
+                .likeIfPresent(HrmRecruitChannelDO::getName, reqVO.getName())
+                .eqIfPresent(HrmRecruitChannelDO::getStatus, reqVO.getStatus())
+                .orderByAsc(HrmRecruitChannelDO::getSort)
+                .orderByDesc(HrmRecruitChannelDO::getId));
+    }
+
+    default List<HrmRecruitChannelDO> selectListByStatus(Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmRecruitChannelDO>()
+                .eq(HrmRecruitChannelDO::getStatus, status)
+                .orderByAsc(HrmRecruitChannelDO::getSort)
+                .orderByDesc(HrmRecruitChannelDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/post/HrmRecruitPostMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/post/HrmRecruitPostMapper.java
new file mode 100644
index 0000000..aa2f9e8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/post/HrmRecruitPostMapper.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.recruit.post;
+
+import cn.hutool.core.map.MapUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.QueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface HrmRecruitPostMapper extends BaseMapperX<HrmRecruitPostDO> {
+
+    default PageResult<HrmRecruitPostDO> selectPage(HrmRecruitPostPageReqVO reqVO) {
+        return selectPage(reqVO, buildQueryWrapper(reqVO)
+                .eqIfPresent("status", reqVO.getStatus())
+                .orderByDesc("id"));
+    }
+
+    default Map<Integer, Long> selectCountMapByStatus(HrmRecruitPostPageReqVO reqVO) {
+        QueryWrapperX<HrmRecruitPostDO> query = buildQueryWrapper(reqVO);
+        query.select("status", "COUNT(id) AS count").groupBy("status");
+        return CollectionUtils.convertMap(selectMaps(query),
+                record -> MapUtil.getInt(record, "status"),
+                record -> MapUtil.getLong(record, "count"));
+    }
+
+    default List<HrmRecruitPostDO> selectListByStatus(Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmRecruitPostDO>()
+                .eq(HrmRecruitPostDO::getStatus, status)
+                .orderByDesc(HrmRecruitPostDO::getId));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateForEdit(HrmRecruitPostDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmRecruitPostDO>()
+                .eq(HrmRecruitPostDO::getId, updateObj.getId())
+                .set(updateObj.getDeptId() == null, HrmRecruitPostDO::getDeptId, null)
+                .set(updateObj.getAreaId() == null, HrmRecruitPostDO::getAreaId, null)
+                .set(updateObj.getRecruitNum() == null, HrmRecruitPostDO::getRecruitNum, null)
+                .set(updateObj.getReason() == null, HrmRecruitPostDO::getReason, null)
+                .set(updateObj.getWorkTime() == null, HrmRecruitPostDO::getWorkTime, null)
+                .set(updateObj.getEducationRequire() == null, HrmRecruitPostDO::getEducationRequire, null)
+                .set(updateObj.getMinSalary() == null, HrmRecruitPostDO::getMinSalary, null)
+                .set(updateObj.getMaxSalary() == null, HrmRecruitPostDO::getMaxSalary, null)
+                .set(updateObj.getSalaryUnit() == null, HrmRecruitPostDO::getSalaryUnit, null)
+                .set(updateObj.getMinAge() == null, HrmRecruitPostDO::getMinAge, null)
+                .set(updateObj.getMaxAge() == null, HrmRecruitPostDO::getMaxAge, null)
+                .set(updateObj.getLatestEntryTime() == null, HrmRecruitPostDO::getLatestEntryTime, null)
+                .set(updateObj.getOwnerEmployeeId() == null, HrmRecruitPostDO::getOwnerEmployeeId, null)
+                .set(updateObj.getInterviewEmployeeIds() == null, HrmRecruitPostDO::getInterviewEmployeeIds, null)
+                .set(updateObj.getDescription() == null, HrmRecruitPostDO::getDescription, null)
+                .set(updateObj.getEmergencyLevel() == null, HrmRecruitPostDO::getEmergencyLevel, null)
+                .set(updateObj.getPostTypeId() == null, HrmRecruitPostDO::getPostTypeId, null));
+    }
+
+    private QueryWrapperX<HrmRecruitPostDO> buildQueryWrapper(HrmRecruitPostPageReqVO reqVO) {
+        return new QueryWrapperX<HrmRecruitPostDO>()
+                .likeIfPresent("post_name", reqVO.getPostName())
+                .eqIfPresent("job_nature", reqVO.getJobNature())
+                .eqIfPresent("area_id", reqVO.getAreaId())
+                .eqIfPresent("dept_id", reqVO.getDeptId())
+                .eqIfPresent("owner_employee_id", reqVO.getOwnerEmployeeId())
+                .eqIfPresent("post_type_id", reqVO.getPostTypeId())
+                .betweenIfPresent("create_time", reqVO.getCreateTime());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/post/HrmRecruitPostTypeMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/post/HrmRecruitPostTypeMapper.java
new file mode 100644
index 0000000..70d6d24
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/recruit/post/HrmRecruitPostTypeMapper.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.recruit.post;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostTypeDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmRecruitPostTypeMapper extends BaseMapperX<HrmRecruitPostTypeDO> {
+
+    default List<HrmRecruitPostTypeDO> selectListByStatus(Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmRecruitPostTypeDO>()
+                .eqIfPresent(HrmRecruitPostTypeDO::getStatus, status)
+                .orderByAsc(HrmRecruitPostTypeDO::getSort)
+                .orderByAsc(HrmRecruitPostTypeDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryChangeTemplateMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryChangeTemplateMapper.java
new file mode 100644
index 0000000..b118cfc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryChangeTemplateMapper.java
@@ -0,0 +1,22 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryChangeTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmSalaryChangeTemplateMapper extends BaseMapperX<HrmSalaryChangeTemplateDO> {
+
+    default List<HrmSalaryChangeTemplateDO> selectListByIdDesc() {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryChangeTemplateDO>()
+                .orderByDesc(HrmSalaryChangeTemplateDO::getId));
+    }
+
+    default List<HrmSalaryChangeTemplateDO> selectListByDefaultStatus(Boolean defaultStatus) {
+        return selectList(HrmSalaryChangeTemplateDO::getDefaultStatus, defaultStatus);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryConfigMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryConfigMapper.java
new file mode 100644
index 0000000..0114d52
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryConfigMapper.java
@@ -0,0 +1,17 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryConfigDO;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface HrmSalaryConfigMapper extends BaseMapperX<HrmSalaryConfigDO> {
+
+    default HrmSalaryConfigDO selectFirst() {
+        return selectOne(new LambdaQueryWrapperX<HrmSalaryConfigDO>()
+                .orderByAsc(HrmSalaryConfigDO::getId)
+                .last("LIMIT 1"));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryGroupMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryGroupMapper.java
new file mode 100644
index 0000000..b721028
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryGroupMapper.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.config;
+
+import cn.hutool.core.map.MapUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+@Mapper
+public interface HrmSalaryGroupMapper extends BaseMapperX<HrmSalaryGroupDO> {
+
+    default PageResult<HrmSalaryGroupDO> selectPage(HrmSalaryGroupPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmSalaryGroupDO>()
+                .likeIfPresent(HrmSalaryGroupDO::getName, reqVO.getName())
+                .eqIfPresent(HrmSalaryGroupDO::getTaxRuleId, reqVO.getTaxRuleId())
+                .orderByDesc(HrmSalaryGroupDO::getId));
+    }
+
+    default HrmSalaryGroupDO selectByName(String name) {
+        return selectFirstOne(HrmSalaryGroupDO::getName, name);
+    }
+
+    default List<HrmSalaryGroupDO> selectListByIdDesc() {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryGroupDO>()
+                .orderByDesc(HrmSalaryGroupDO::getId));
+    }
+
+    default Map<Long, Long> selectCountMapByTaxRuleIds(Collection<Long> taxRuleIds) {
+        List<Map<String, Object>> result = selectMaps(new MPJLambdaWrapperX<HrmSalaryGroupDO>()
+                .selectAs(HrmSalaryGroupDO::getTaxRuleId, "taxRuleId")
+                .selectCount(HrmSalaryGroupDO::getId, "count")
+                .in(HrmSalaryGroupDO::getTaxRuleId, taxRuleIds)
+                .groupBy(HrmSalaryGroupDO::getTaxRuleId));
+        return CollectionUtils.convertMap(result,
+                record -> MapUtil.getLong(record, "taxRuleId"),
+                record -> MapUtil.getLong(record, "count"));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryOptionMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryOptionMapper.java
new file mode 100644
index 0000000..f78149f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryOptionMapper.java
@@ -0,0 +1,41 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import org.apache.ibatis.annotations.Select;
+
+import java.util.List;
+
+@Mapper
+public interface HrmSalaryOptionMapper extends BaseMapperX<HrmSalaryOptionDO> {
+
+    default HrmSalaryOptionDO selectByCode(Integer code) {
+        return selectFirstOne(HrmSalaryOptionDO::getCode, code);
+    }
+
+    @Select("SELECT * FROM hrm_salary_option WHERE code = #{code} LIMIT 1")
+    HrmSalaryOptionDO selectByCodeIncludeDeleted(@Param("code") Integer code);
+
+    default HrmSalaryOptionDO selectByCodeForUpdate(Integer code) {
+        return selectFirstOneForUpdate(new LambdaQueryWrapper<HrmSalaryOptionDO>()
+                .eq(HrmSalaryOptionDO::getCode, code)
+                .orderByDesc(HrmSalaryOptionDO::getId));
+    }
+
+    default List<HrmSalaryOptionDO> selectListByEnabledAndVisible(Boolean enabled, Boolean visible) {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryOptionDO>()
+                .eqIfPresent(HrmSalaryOptionDO::getEnabled, enabled)
+                .eqIfPresent(HrmSalaryOptionDO::getVisible, visible)
+                .orderByAsc(HrmSalaryOptionDO::getCode));
+    }
+
+    @Select("SELECT MAX(code) FROM hrm_salary_option "
+            + "WHERE parent_code = #{parentCode} AND code >= #{minCode}")
+    Integer selectMaxCodeByParentCodeAndCodeGreaterThanOrEqual(
+            @Param("parentCode") Integer parentCode, @Param("minCode") Integer minCode);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryOptionTemplateMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryOptionTemplateMapper.java
new file mode 100644
index 0000000..64277d7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryOptionTemplateMapper.java
@@ -0,0 +1,18 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmSalaryOptionTemplateMapper extends BaseMapperX<HrmSalaryOptionTemplateDO> {
+
+    default List<HrmSalaryOptionTemplateDO> selectListOrderByCode() {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryOptionTemplateDO>()
+                .orderByAsc(HrmSalaryOptionTemplateDO::getCode));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryTaxRuleMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryTaxRuleMapper.java
new file mode 100644
index 0000000..c8b98b0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/config/HrmSalaryTaxRuleMapper.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.config;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmSalaryTaxRuleMapper extends BaseMapperX<HrmSalaryTaxRuleDO> {
+
+    default HrmSalaryTaxRuleDO selectByName(String name) {
+        return selectFirstOne(HrmSalaryTaxRuleDO::getName, name);
+    }
+
+    default List<HrmSalaryTaxRuleDO> selectList() {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryTaxRuleDO>().orderByAsc(HrmSalaryTaxRuleDO::getId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/employee/HrmSalaryChangeRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/employee/HrmSalaryChangeRecordMapper.java
new file mode 100644
index 0000000..78a908f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/employee/HrmSalaryChangeRecordMapper.java
@@ -0,0 +1,66 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.employee;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryChangeRecordDO;
+import org.apache.ibatis.annotations.Mapper;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+@Mapper
+public interface HrmSalaryChangeRecordMapper extends BaseMapperX<HrmSalaryChangeRecordDO> {
+
+    default List<HrmSalaryChangeRecordDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryChangeRecordDO>()
+                .eq(HrmSalaryChangeRecordDO::getEmployeeId, employeeId)
+                .orderByDesc(HrmSalaryChangeRecordDO::getEffectTime)
+                .orderByDesc(HrmSalaryChangeRecordDO::getId));
+    }
+
+    default HrmSalaryChangeRecordDO selectByEmployeeIdAndType(Long employeeId, Integer type) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmSalaryChangeRecordDO>()
+                .eq(HrmSalaryChangeRecordDO::getEmployeeId, employeeId)
+                .eq(HrmSalaryChangeRecordDO::getType, type)
+                .orderByAsc(HrmSalaryChangeRecordDO::getId));
+    }
+
+    default Long selectCountByEmployeeIdAndStatus(Long employeeId, Integer status, Long excludeId) {
+        return selectCount(new LambdaQueryWrapperX<HrmSalaryChangeRecordDO>()
+                .eq(HrmSalaryChangeRecordDO::getEmployeeId, employeeId)
+                .eq(HrmSalaryChangeRecordDO::getStatus, status)
+                .neIfPresent(HrmSalaryChangeRecordDO::getId, excludeId));
+    }
+
+    default Long selectCountByEmployeeIdAndTypeAndStatusNot(
+            Long employeeId, Integer type, Integer status) {
+        return selectCount(new LambdaQueryWrapperX<HrmSalaryChangeRecordDO>()
+                .eq(HrmSalaryChangeRecordDO::getEmployeeId, employeeId)
+                .eq(HrmSalaryChangeRecordDO::getType, type)
+                .ne(HrmSalaryChangeRecordDO::getStatus, status));
+    }
+
+    default List<HrmSalaryChangeRecordDO> selectListByStatusAndEffectTimeBeforeOrEqual(
+            Integer status, LocalDateTime endTime) {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryChangeRecordDO>()
+                .eq(HrmSalaryChangeRecordDO::getStatus, status)
+                .le(HrmSalaryChangeRecordDO::getEffectTime, endTime)
+                .orderByAsc(HrmSalaryChangeRecordDO::getEffectTime)
+                .orderByAsc(HrmSalaryChangeRecordDO::getId));
+    }
+
+    default Long selectCountByStatusAndEffectTimeBeforeOrEqual(Integer status, LocalDateTime endTime) {
+        return selectCount(new LambdaQueryWrapperX<HrmSalaryChangeRecordDO>()
+                .eq(HrmSalaryChangeRecordDO::getStatus, status)
+                .le(HrmSalaryChangeRecordDO::getEffectTime, endTime));
+    }
+
+    default int updateByIdAndStatus(HrmSalaryChangeRecordDO updateObj, Integer status) {
+        return update(updateObj,
+                new LambdaUpdateWrapper<HrmSalaryChangeRecordDO>()
+                        .eq(HrmSalaryChangeRecordDO::getId, updateObj.getId())
+                        .eq(HrmSalaryChangeRecordDO::getStatus, status));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/employee/HrmSalaryEmployeeInfoMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/employee/HrmSalaryEmployeeInfoMapper.java
new file mode 100644
index 0000000..f94d663
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/employee/HrmSalaryEmployeeInfoMapper.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryEmployeeInfoDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+@Mapper
+public interface HrmSalaryEmployeeInfoMapper extends BaseMapperX<HrmSalaryEmployeeInfoDO> {
+
+    default HrmSalaryEmployeeInfoDO selectByEmployeeId(Long employeeId) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmSalaryEmployeeInfoDO>()
+                .eq(HrmSalaryEmployeeInfoDO::getEmployeeId, employeeId)
+                .orderByAsc(HrmSalaryEmployeeInfoDO::getId));
+    }
+
+    default PageResult<HrmSalaryEmployeeInfoDO> selectPage(HrmSalaryEmployeeInfoPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmSalaryEmployeeInfoDO>()
+                .eqIfPresent(HrmSalaryEmployeeInfoDO::getEmployeeId, reqVO.getEmployeeId())
+                .inIfPresent(HrmSalaryEmployeeInfoDO::getEmployeeId, reqVO.getEmployeeIds())
+                .eqIfPresent(HrmSalaryEmployeeInfoDO::getChangeType, reqVO.getChangeType())
+                .orderByDesc(HrmSalaryEmployeeInfoDO::getId));
+    }
+
+    default List<HrmSalaryEmployeeInfoDO> selectListByEmployeeIds(List<Long> employeeIds) {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryEmployeeInfoDO>()
+                .in(HrmSalaryEmployeeInfoDO::getEmployeeId, employeeIds)
+                .orderByDesc(HrmSalaryEmployeeInfoDO::getId));
+    }
+
+    default List<Long> selectEmployeeIdListByChangeType(Integer changeType) {
+        LambdaQueryWrapperX<HrmSalaryEmployeeInfoDO> query = new LambdaQueryWrapperX<>();
+        query.select(HrmSalaryEmployeeInfoDO::getEmployeeId);
+        query.eqIfPresent(HrmSalaryEmployeeInfoDO::getChangeType, changeType);
+        return convertList(selectList(query),
+                HrmSalaryEmployeeInfoDO::getEmployeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/monthrecord/HrmSalaryMonthEmployeeRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/monthrecord/HrmSalaryMonthEmployeeRecordMapper.java
new file mode 100644
index 0000000..9b83c12
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/monthrecord/HrmSalaryMonthEmployeeRecordMapper.java
@@ -0,0 +1,99 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.monthrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.MPJLambdaWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryEmployeeMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.Collection;
+import java.util.List;
+
+@Mapper
+public interface HrmSalaryMonthEmployeeRecordMapper extends BaseMapperX<HrmSalaryMonthEmployeeRecordDO> {
+
+    default PageResult<HrmSalaryMonthEmployeeRecordDO> selectPage(HrmSalaryMonthEmployeeRecordPageReqVO reqVO) {
+        MPJLambdaWrapperX<HrmSalaryMonthEmployeeRecordDO> query =
+                new MPJLambdaWrapperX<HrmSalaryMonthEmployeeRecordDO>()
+                .selectAll(HrmSalaryMonthEmployeeRecordDO.class)
+                .eq(HrmSalaryMonthEmployeeRecordDO::getMonthRecordId, reqVO.getMonthRecordId())
+                .eqIfPresent(HrmSalaryMonthEmployeeRecordDO::getEmployeeId, reqVO.getEmployeeId())
+                .inIfPresent(HrmSalaryMonthEmployeeRecordDO::getEmployeeId, reqVO.getEmployeeIds());
+        query.orderByAsc(HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+        appendSalarySlipSentCondition(query, reqVO.getSalarySlipSent());
+        return selectJoinPage(reqVO, HrmSalaryMonthEmployeeRecordDO.class, query);
+    }
+
+    default PageResult<HrmSalaryMonthEmployeeRecordDO> selectPageByEmployeeId(
+            HrmSalaryEmployeeMonthRecordPageReqVO reqVO, Collection<Long> monthRecordIds) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmSalaryMonthEmployeeRecordDO>()
+                .eq(HrmSalaryMonthEmployeeRecordDO::getEmployeeId, reqVO.getEmployeeId())
+                .in(HrmSalaryMonthEmployeeRecordDO::getMonthRecordId, monthRecordIds)
+                .orderByDesc(HrmSalaryMonthEmployeeRecordDO::getYear)
+                .orderByDesc(HrmSalaryMonthEmployeeRecordDO::getMonth)
+                .orderByDesc(HrmSalaryMonthEmployeeRecordDO::getId));
+    }
+
+    default List<HrmSalaryMonthEmployeeRecordDO> selectListByMonthRecordId(Long monthRecordId) {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryMonthEmployeeRecordDO>()
+                .eq(HrmSalaryMonthEmployeeRecordDO::getMonthRecordId, monthRecordId)
+                .orderByAsc(HrmSalaryMonthEmployeeRecordDO::getId));
+    }
+
+    default List<HrmSalaryMonthEmployeeRecordDO> selectList(Long monthRecordId, Collection<Long> employeeIds) {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryMonthEmployeeRecordDO>()
+                .eq(HrmSalaryMonthEmployeeRecordDO::getMonthRecordId, monthRecordId)
+                .inIfPresent(HrmSalaryMonthEmployeeRecordDO::getEmployeeId, employeeIds)
+                .orderByAsc(HrmSalaryMonthEmployeeRecordDO::getEmployeeId));
+    }
+
+    default List<HrmSalaryMonthEmployeeRecordDO> selectList(HrmSalaryMonthEmployeeRecordListReqVO reqVO) {
+        MPJLambdaWrapperX<HrmSalaryMonthEmployeeRecordDO> query =
+                new MPJLambdaWrapperX<HrmSalaryMonthEmployeeRecordDO>()
+                .selectAll(HrmSalaryMonthEmployeeRecordDO.class)
+                .eq(HrmSalaryMonthEmployeeRecordDO::getMonthRecordId, reqVO.getMonthRecordId())
+                .eqIfPresent(HrmSalaryMonthEmployeeRecordDO::getEmployeeId, reqVO.getEmployeeId())
+                .inIfPresent(HrmSalaryMonthEmployeeRecordDO::getEmployeeId, reqVO.getEmployeeIds());
+        query.orderByAsc(HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+        appendSalarySlipSentCondition(query, reqVO.getSalarySlipSent());
+        return selectJoinList(HrmSalaryMonthEmployeeRecordDO.class, query);
+    }
+
+    default HrmSalaryMonthEmployeeRecordDO selectByEmployeeIdAndYearMonth(Long employeeId, Integer year, Integer month) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmSalaryMonthEmployeeRecordDO>()
+                .eq(HrmSalaryMonthEmployeeRecordDO::getEmployeeId, employeeId)
+                .eq(HrmSalaryMonthEmployeeRecordDO::getYear, year)
+                .eq(HrmSalaryMonthEmployeeRecordDO::getMonth, month)
+                .orderByAsc(HrmSalaryMonthEmployeeRecordDO::getId));
+    }
+
+    default void deleteByMonthRecordId(Long monthRecordId) {
+        delete(new LambdaQueryWrapperX<HrmSalaryMonthEmployeeRecordDO>()
+                .eq(HrmSalaryMonthEmployeeRecordDO::getMonthRecordId, monthRecordId));
+    }
+
+    /**
+     * 拼接工资条发送状态查询条件
+     *
+     * @param query 查询条件
+     * @param salarySlipSent 是否已发送工资条
+     */
+    private void appendSalarySlipSentCondition(
+            MPJLambdaWrapperX<HrmSalaryMonthEmployeeRecordDO> query, Boolean salarySlipSent) {
+        if (Boolean.TRUE.equals(salarySlipSent)) {
+            query.innerJoin(HrmSalarySlipDO.class, HrmSalarySlipDO::getMonthEmployeeRecordId,
+                            HrmSalaryMonthEmployeeRecordDO::getId)
+                    .distinct();
+        } else if (Boolean.FALSE.equals(salarySlipSent)) {
+            query.leftJoin(HrmSalarySlipDO.class, HrmSalarySlipDO::getMonthEmployeeRecordId,
+                            HrmSalaryMonthEmployeeRecordDO::getId)
+                    .isNull(HrmSalarySlipDO::getId);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/monthrecord/HrmSalaryMonthRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/monthrecord/HrmSalaryMonthRecordMapper.java
new file mode 100644
index 0000000..be17d8c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/monthrecord/HrmSalaryMonthRecordMapper.java
@@ -0,0 +1,49 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.monthrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmSalaryMonthRecordMapper extends BaseMapperX<HrmSalaryMonthRecordDO> {
+
+    default HrmSalaryMonthRecordDO selectByIdForUpdate(Long id) {
+        return selectOneForUpdate(HrmSalaryMonthRecordDO::getId, id);
+    }
+
+    default HrmSalaryMonthRecordDO selectByYearMonth(Integer year, Integer month) {
+        return selectLastOne(new LambdaQueryWrapperX<HrmSalaryMonthRecordDO>()
+                .eq(HrmSalaryMonthRecordDO::getYear, year)
+                .eq(HrmSalaryMonthRecordDO::getMonth, month)
+                .orderByAsc(HrmSalaryMonthRecordDO::getId));
+    }
+
+    default HrmSalaryMonthRecordDO selectLast() {
+        return selectOne(new LambdaQueryWrapperX<HrmSalaryMonthRecordDO>()
+                .orderByDesc(HrmSalaryMonthRecordDO::getYear)
+                .orderByDesc(HrmSalaryMonthRecordDO::getMonth)
+                .last("LIMIT 1"));
+    }
+
+    default PageResult<HrmSalaryMonthRecordDO> selectPage(HrmSalaryMonthRecordPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmSalaryMonthRecordDO>()
+                .eqIfPresent(HrmSalaryMonthRecordDO::getYear, reqVO.getYear())
+                .eqIfPresent(HrmSalaryMonthRecordDO::getMonth, reqVO.getMonth())
+                .eqIfPresent(HrmSalaryMonthRecordDO::getStatus, reqVO.getStatus())
+                .orderByDesc(HrmSalaryMonthRecordDO::getYear)
+                .orderByDesc(HrmSalaryMonthRecordDO::getMonth));
+    }
+
+    default List<HrmSalaryMonthRecordDO> selectListByStatus(Integer status) {
+        return selectList(new LambdaQueryWrapperX<HrmSalaryMonthRecordDO>()
+                .eqIfPresent(HrmSalaryMonthRecordDO::getStatus, status)
+                .orderByDesc(HrmSalaryMonthRecordDO::getYear)
+                .orderByDesc(HrmSalaryMonthRecordDO::getMonth));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipMapper.java
new file mode 100644
index 0000000..63c340d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipMapper.java
@@ -0,0 +1,93 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip;
+
+import cn.hutool.core.map.MapUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.QueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipDO;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.time.YearMonth;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+@Mapper
+public interface HrmSalarySlipMapper extends BaseMapperX<HrmSalarySlipDO> {
+
+    default PageResult<HrmSalarySlipDO> selectPage(HrmSalarySlipPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmSalarySlipDO>()
+                .eqIfPresent(HrmSalarySlipDO::getSendRecordId, reqVO.getSendRecordId())
+                .eqIfPresent(HrmSalarySlipDO::getEmployeeId, reqVO.getEmployeeId())
+                .inIfPresent(HrmSalarySlipDO::getEmployeeId, reqVO.getEmployeeIds())
+                .eqIfPresent(HrmSalarySlipDO::getReadStatus, reqVO.getReadStatus())
+                .likeIfPresent(HrmSalarySlipDO::getRemark, reqVO.getRemark())
+                .orderByDesc(HrmSalarySlipDO::getId));
+    }
+
+    default Map<Long, Long> selectCountMapBySendRecordIdsAndReadStatus(
+            Collection<Long> sendRecordIds, Integer readStatus) {
+        QueryWrapperX<HrmSalarySlipDO> query = new QueryWrapperX<>();
+        query.select("send_record_id AS sendRecordId", "COUNT(id) AS count")
+                .in("send_record_id", sendRecordIds)
+                .eq("read_status", readStatus)
+                .groupBy("send_record_id");
+        return CollectionUtils.convertMap(selectMaps(query),
+                record -> MapUtil.getLong(record, "sendRecordId"),
+                record -> MapUtil.getLong(record, "count"));
+    }
+
+    default List<HrmSalarySlipDO> selectListByEmployeeId(Long employeeId) {
+        return selectList(new LambdaQueryWrapperX<HrmSalarySlipDO>()
+                .eq(HrmSalarySlipDO::getEmployeeId, employeeId));
+    }
+
+    default List<HrmSalarySlipDO> selectListByEmployeeId(
+            Long employeeId, YearMonth startMonth, YearMonth endMonth,
+            Integer orderType, Integer order) {
+        QueryWrapperX<HrmSalarySlipDO> query = new QueryWrapperX<>();
+        query.eq("employee_id", employeeId)
+                .apply(startMonth != null, "(year * 100 + month) >= {0}",
+                        startMonth == null ? null : startMonth.getYear() * 100 + startMonth.getMonthValue())
+                .apply(endMonth != null, "(year * 100 + month) <= {0}",
+                        endMonth == null ? null : endMonth.getYear() * 100 + endMonth.getMonthValue());
+        boolean asc = Objects.equals(order, 2);
+        if (Objects.equals(orderType, 2)) {
+            query.orderBy(true, asc, "real_pay_salary", "id");
+        } else {
+            // 默认排序表达工资条发放时序；补发旧月份时仍按后发记录优先。
+            query.orderBy(true, asc, "id");
+        }
+        return selectList(query);
+    }
+
+    default List<HrmSalarySlipDO> selectListByMonthEmployeeRecordIds(Collection<Long> monthEmployeeRecordIds) {
+        return selectList(new LambdaQueryWrapperX<HrmSalarySlipDO>()
+                .in(HrmSalarySlipDO::getMonthEmployeeRecordId, monthEmployeeRecordIds));
+    }
+
+    default List<HrmSalarySlipDO> selectListByEmployeeIdsAndYearMonth(
+            Collection<Long> employeeIds, Integer year, Integer month) {
+        return selectList(new LambdaQueryWrapperX<HrmSalarySlipDO>()
+                .in(HrmSalarySlipDO::getEmployeeId, employeeIds)
+                .eq(HrmSalarySlipDO::getYear, year)
+                .eq(HrmSalarySlipDO::getMonth, month));
+    }
+
+    default void deleteBySendRecordId(Long sendRecordId) {
+        delete(new LambdaQueryWrapperX<HrmSalarySlipDO>()
+                .eq(HrmSalarySlipDO::getSendRecordId, sendRecordId));
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    default int updateByIds(Collection<Long> ids, HrmSalarySlipDO updateObj) {
+        return update(updateObj, new LambdaUpdateWrapper<HrmSalarySlipDO>()
+                .in(HrmSalarySlipDO::getId, ids));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipSendRecordMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipSendRecordMapper.java
new file mode 100644
index 0000000..0f447c6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipSendRecordMapper.java
@@ -0,0 +1,21 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipSendRecordDO;
+import org.apache.ibatis.annotations.Mapper;
+
+@Mapper
+public interface HrmSalarySlipSendRecordMapper extends BaseMapperX<HrmSalarySlipSendRecordDO> {
+
+    default PageResult<HrmSalarySlipSendRecordDO> selectPage(HrmSalarySlipSendRecordPageReqVO reqVO) {
+        return selectPage(reqVO, new LambdaQueryWrapperX<HrmSalarySlipSendRecordDO>()
+                .eqIfPresent(HrmSalarySlipSendRecordDO::getYear, reqVO.getYear())
+                .eqIfPresent(HrmSalarySlipSendRecordDO::getMonth, reqVO.getMonth())
+                .orderByDesc(HrmSalarySlipSendRecordDO::getYear)
+                .orderByDesc(HrmSalarySlipSendRecordDO::getMonth));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipTemplateMapper.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipTemplateMapper.java
new file mode 100644
index 0000000..5d2a698
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/mysql/salary/slip/HrmSalarySlipTemplateMapper.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip;
+
+import cn.iocoder.yudao.framework.mybatis.core.mapper.BaseMapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.LambdaQueryWrapperX;
+import cn.iocoder.yudao.framework.mybatis.core.query.QueryWrapperX;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import org.apache.ibatis.annotations.Mapper;
+
+import java.util.List;
+
+@Mapper
+public interface HrmSalarySlipTemplateMapper extends BaseMapperX<HrmSalarySlipTemplateDO> {
+
+    default List<HrmSalarySlipTemplateDO> selectListByDefaultStatusDesc() {
+        return selectList(new LambdaQueryWrapperX<HrmSalarySlipTemplateDO>()
+                .orderByDesc(HrmSalarySlipTemplateDO::getDefaultStatus)
+                .orderByDesc(HrmSalarySlipTemplateDO::getId));
+    }
+
+    /**
+     * 获得平台级默认工资条模板
+     *
+     * <p>默认模板以 tenant_id = 0 保存，由所有租户只读共享；租户自己的自定义模板仍由租户拦截器隔离。</p>
+     *
+     * @return 平台级默认工资条模板
+     */
+    default HrmSalarySlipTemplateDO selectGlobalDefaultTemplate() {
+        return selectOne(new QueryWrapperX<HrmSalarySlipTemplateDO>()
+                .eq("tenant_id", 0L)
+                .eq("default_status", true)
+                .orderByDesc("id")
+                .limitN(1));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/redis/RedisKeyConstants.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/redis/RedisKeyConstants.java
new file mode 100644
index 0000000..5f7d159
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/dal/redis/RedisKeyConstants.java
@@ -0,0 +1,26 @@
+package cn.iocoder.yudao.module.hrm.dal.redis;
+
+/**
+ * HRM Redis Key 常量
+ *
+ * @author 芋道源码
+ */
+public interface RedisKeyConstants {
+
+    /**
+     * 标准参保类型的缓存
+     *
+     * KEY 格式：hrm:insurance_standard_type:{areaId}
+     * VALUE 数据格式：标准参保类型列表
+     */
+    String INSURANCE_STANDARD_TYPE = "hrm:insurance_standard_type";
+
+    /**
+     * 标准参保项目的缓存
+     *
+     * KEY 格式：hrm:insurance_standard_project:{areaId}:{typeCode}
+     * VALUE 数据格式：标准参保项目列表
+     */
+    String INSURANCE_STANDARD_PROJECT = "hrm:insurance_standard_project";
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/DictTypeConstants.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/DictTypeConstants.java
new file mode 100644
index 0000000..03fefbf
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/DictTypeConstants.java
@@ -0,0 +1,49 @@
+package cn.iocoder.yudao.module.hrm.enums;
+
+/**
+ * HRM 字典类型的枚举类
+ */
+public interface DictTypeConstants {
+
+    String HRM_EMPLOYEE_ENTRY_STATUS = "hrm_employee_entry_status"; // 员工入职状态
+    String HRM_EMPLOYEE_STATUS = "hrm_employee_status"; // 员工状态
+    String HRM_EMPLOYEE_TYPE = "hrm_employee_type"; // 聘用形式
+    String HRM_EMPLOYEE_EDUCATION = "hrm_employee_education"; // 员工学历
+    String HRM_EMPLOYEE_ID_TYPE = "hrm_employee_id_type"; // 员工证件类型
+    String BOOLEAN_STRING = "infra_boolean_string"; // 复用平台 Boolean 是否类型
+    String HRM_RECRUIT_POST_STATUS = "hrm_recruit_post_status"; // 招聘职位状态
+    String HRM_RECRUIT_JOB_NATURE = "hrm_recruit_job_nature"; // 工作性质
+    String HRM_RECRUIT_WORK_TIME = "hrm_recruit_work_time"; // 工作经验
+    String HRM_RECRUIT_POST_EDUCATION = "hrm_recruit_post_education"; // 职位学历要求
+    String HRM_RECRUIT_SALARY_UNIT = "hrm_recruit_salary_unit"; // 薪资单位
+    String HRM_RECRUIT_EMERGENCY_LEVEL = "hrm_recruit_emergency_level"; // 紧急程度
+    String HRM_RECRUIT_CANDIDATE_STATUS = "hrm_recruit_candidate_status"; // 候选人状态
+    String HRM_RECRUIT_CANDIDATE_EDUCATION = "hrm_recruit_candidate_education"; // 候选人学历
+    String HRM_RECRUIT_INTERVIEW_TYPE = "hrm_recruit_interview_type"; // 面试方式
+    String HRM_RECRUIT_INTERVIEW_RESULT = "hrm_recruit_interview_result"; // 面试结果
+    String HRM_ATTENDANCE_CLOCK_TYPE = "hrm_attendance_clock_type"; // 打卡类型
+    String HRM_ATTENDANCE_CLOCK_SOURCE = "hrm_attendance_clock_source"; // 打卡来源
+    String HRM_ATTENDANCE_CLOCK_STATUS = "hrm_attendance_clock_status"; // 打卡状态
+    String HRM_ATTENDANCE_HOLIDAY_TYPE = "hrm_attendance_holiday_type"; // 考勤节假日类型
+    String HRM_ATTENDANCE_LEAVE_TYPE = "hrm_attendance_leave_type"; // 考勤请假类型
+    String HRM_ATTENDANCE_YES_NO = "hrm_attendance_yes_no"; // 考勤是否
+    String HRM_SALARY_CHANGE_REASON = "hrm_salary_change_reason"; // 调薪原因
+    String HRM_SALARY_CHANGE_TYPE = "hrm_salary_change_type"; // 薪资档案状态
+    String HRM_SALARY_CHANGE_RECORD_STATUS = "hrm_salary_change_record_status"; // 定薪调薪记录状态
+    String HRM_SALARY_MONTH_STATUS = "hrm_salary_month_status"; // 月度工资表状态
+    String HRM_SALARY_TAX_TYPE = "hrm_salary_tax_type"; // 计税类型
+    String HRM_SALARY_OPTION_TYPE = "hrm_salary_option_type"; // 薪资项类型
+    String HRM_SALARY_SLIP_READ_STATUS = "hrm_salary_slip_read_status"; // 工资条阅读状态
+    String HRM_SALARY_YES_NO = "hrm_salary_yes_no"; // 薪资是否
+    String HRM_INSURANCE_SCHEME_TYPE = "hrm_insurance_scheme_type"; // 社保方案类型
+    String HRM_INSURANCE_PROJECT_TYPE = "hrm_insurance_project_type"; // 社保项目类型
+    String HRM_INSURANCE_MONTH_STATUS = "hrm_insurance_month_status"; // 社保表状态
+    String HRM_INSURANCE_EMP_STATUS = "hrm_insurance_emp_status"; // 参保状态
+    String HRM_PERFORMANCE_PLAN_STATUS = "hrm_performance_plan_status"; // 绩效计划状态
+    String HRM_PERFORMANCE_STAGE_STATUS = "hrm_performance_stage_status"; // 绩效阶段状态
+    String HRM_PERFORMANCE_APPEAL_STATUS = "hrm_performance_appeal_status"; // 绩效申诉状态
+    String HRM_PERFORMANCE_SCORE_CALCULATION = "hrm_performance_score_calculation"; // 绩效计分方式
+    String HRM_PERFORMANCE_UPPER_LIMIT_TYPE = "hrm_performance_upper_limit_type"; // 绩效上限类型
+    String HRM_PERFORMANCE_YES_NO = "hrm_performance_yes_no"; // 绩效是否
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/ErrorCodeConstants.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/ErrorCodeConstants.java
new file mode 100644
index 0000000..6b0e0a6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/ErrorCodeConstants.java
@@ -0,0 +1,297 @@
+package cn.iocoder.yudao.module.hrm.enums;
+
+import cn.iocoder.yudao.framework.common.exception.ErrorCode;
+
+/**
+ * HRM 错误码枚举类
+ *
+ * HRM 系统，使用 1-050-000-000 段
+ */
+public interface ErrorCodeConstants {
+
+    // ========== 员工档案 1-050-100-000 ==========
+    ErrorCode EMPLOYEE_NOT_EXISTS = new ErrorCode(1_050_100_000, "员工档案不存在");
+    ErrorCode EMPLOYEE_JOB_NUMBER_DUPLICATE = new ErrorCode(1_050_100_001, "员工工号已存在");
+    ErrorCode EMPLOYEE_USER_DUPLICATE = new ErrorCode(1_050_100_002, "系统用户已绑定员工档案");
+    ErrorCode EMPLOYEE_MOBILE_DUPLICATE = new ErrorCode(1_050_100_003, "手机号已绑定员工档案");
+    ErrorCode EMPLOYEE_IMPORT_LIST_IS_EMPTY = new ErrorCode(1_050_100_006, "导入员工档案数据不能为空");
+    ErrorCode EMPLOYEE_IMPORT_DUPLICATE_STRATEGY_INVALID =
+            new ErrorCode(1_050_100_033, "员工导入重复数据处理策略不合法");
+    ErrorCode EMPLOYEE_LEADER_INVALID = new ErrorCode(1_050_100_014, "直属上级不能是员工本人或下属");
+    ErrorCode EMPLOYEE_ENTRY_STATUS_INVALID = new ErrorCode(1_050_100_037, "员工【{}】不是在职状态");
+    ErrorCode EMPLOYEE_IMPORT_REFERENCE_NOT_EXISTS =
+            new ErrorCode(1_050_100_038, "导入字段【{}】的值【{}】不存在");
+    // ========== 员工生命周期 1-050-100-004 ==========
+    ErrorCode EMPLOYEE_CANDIDATE_CONVERTED = new ErrorCode(1_050_100_005, "招聘候选人已转为员工档案");
+    ErrorCode EMPLOYEE_REHIRE_STATUS_INVALID = new ErrorCode(1_050_100_007, "只有已离职员工可以办理再入职");
+    ErrorCode EMPLOYEE_CONFIRM_ENTRY_STATUS_INVALID = new ErrorCode(1_050_100_009, "只有待入职员工可以确认入职");
+    ErrorCode EMPLOYEE_QUIT_STATUS_INVALID = new ErrorCode(1_050_100_010, "只有在职或待离职员工可以设置离职");
+    ErrorCode EMPLOYEE_QUIT_CANCEL_STATUS_INVALID = new ErrorCode(1_050_100_011, "只有待离职员工可以取消离职");
+    ErrorCode EMPLOYEE_CHANGE_STATUS_INVALID = new ErrorCode(1_050_100_025, "员工当前状态不允许办理【{}】");
+    ErrorCode EMPLOYEE_CHANGE_TYPE_INVALID = new ErrorCode(1_050_100_026, "员工异动类型【{}】不合法");
+    ErrorCode EMPLOYEE_QUIT_TIME_INVALID = new ErrorCode(1_050_100_028, "离职时间范围不合法");
+    ErrorCode EMPLOYEE_RESOURCE_BELONG_INVALID = new ErrorCode(1_050_100_029, "员工{}不属于指定员工");
+    ErrorCode EMPLOYEE_PERSONAL_NOTE_NOT_EXISTS = new ErrorCode(1_050_100_030, "员工个人备忘不存在");
+    ErrorCode EMPLOYEE_CREATE_USER_LIST_DUPLICATE =
+            new ErrorCode(1_050_100_031, "批量建档的后台用户不能重复");
+    ErrorCode EMPLOYEE_CREATE_USER_NOT_EXISTS = new ErrorCode(1_050_100_032, "批量建档的后台用户不存在");
+
+    // ========== 员工教育经历 1-050-100-016 ==========
+    ErrorCode EMPLOYEE_EDUCATION_EXPERIENCE_NOT_EXISTS =
+            new ErrorCode(1_050_100_016, "员工教育经历不存在");
+
+    // ========== 员工工作经历 1-050-100-017 ==========
+    ErrorCode EMPLOYEE_WORK_EXPERIENCE_NOT_EXISTS = new ErrorCode(1_050_100_017, "员工工作经历不存在");
+
+    // ========== 员工培训经历 1-050-100-018 ==========
+    ErrorCode EMPLOYEE_TRAINING_EXPERIENCE_NOT_EXISTS =
+            new ErrorCode(1_050_100_018, "员工培训经历不存在");
+
+    // ========== 员工证书 1-050-100-019 ==========
+    ErrorCode EMPLOYEE_CERTIFICATE_NOT_EXISTS = new ErrorCode(1_050_100_019, "员工证书不存在");
+
+    // ========== 员工联系人 1-050-100-020 ==========
+    ErrorCode EMPLOYEE_CONTACT_NOT_EXISTS = new ErrorCode(1_050_100_020, "员工联系人不存在");
+
+    // ========== 员工合同 1-050-100-021 ==========
+    ErrorCode EMPLOYEE_CONTRACT_NOT_EXISTS = new ErrorCode(1_050_100_021, "员工合同不存在");
+
+    // ========== 员工离职信息 1-050-100-023 ==========
+    ErrorCode EMPLOYEE_QUIT_INFO_NOT_EXISTS = new ErrorCode(1_050_100_023, "员工离职信息不存在");
+
+    // ========== 员工字段配置 1-050-100-024 ==========
+    ErrorCode EMPLOYEE_FIELD_CONFIG_INVALID = new ErrorCode(1_050_100_024, "员工字段配置【{}】不合法");
+    ErrorCode EMPLOYEE_FIELD_NOT_VISIBLE = new ErrorCode(1_050_100_034, "员工字段【{}】当前未显示，不能提交");
+    ErrorCode EMPLOYEE_PROFILE_FIELD_REQUIRED = new ErrorCode(1_050_100_035, "员工档案字段【{}】不能为空");
+
+    // ========== 招聘职位 1-050-200-000 ==========
+    ErrorCode RECRUIT_POST_NOT_EXISTS = new ErrorCode(1_050_200_000, "招聘职位不存在");
+
+    // ========== 招聘候选人 1-050-200-001 ==========
+    ErrorCode RECRUIT_CANDIDATE_NOT_EXISTS = new ErrorCode(1_050_200_001, "招聘候选人不存在");
+    ErrorCode RECRUIT_CANDIDATE_STATUS_TRANSITION_INVALID =
+            new ErrorCode(1_050_200_011, "候选人当前状态不允许流转到【{}】");
+    ErrorCode RECRUIT_CANDIDATE_HAS_EMPLOYEE =
+            new ErrorCode(1_050_200_012, "候选人已生成员工档案，不能删除");
+    ErrorCode RECRUIT_CANDIDATE_DELETE_STATUS_INVALID =
+            new ErrorCode(1_050_200_016, "候选人当前状态不允许删除");
+    ErrorCode RECRUIT_CANDIDATE_CONVERT_STATUS_INVALID =
+            new ErrorCode(1_050_200_017, "候选人当前状态不允许转为员工");
+    ErrorCode RECRUIT_CANDIDATE_ELIMINATE_STATUS_INVALID =
+            new ErrorCode(1_050_200_018, "候选人当前状态不允许淘汰");
+
+    // ========== 招聘面试 1-050-200-002 ==========
+    ErrorCode RECRUIT_INTERVIEW_NOT_EXISTS = new ErrorCode(1_050_200_002, "招聘面试不存在");
+    ErrorCode RECRUIT_INTERVIEW_FINISHED = new ErrorCode(1_050_200_009, "已完成的招聘面试不允许修改安排");
+    ErrorCode RECRUIT_INTERVIEW_CANCEL_REASON_REQUIRED =
+            new ErrorCode(1_050_200_010, "取消面试时必须填写取消原因");
+    ErrorCode RECRUIT_INTERVIEW_STATE_INVALID =
+            new ErrorCode(1_050_200_013, "候选人当前状态不允许安排或修改面试");
+    ErrorCode RECRUIT_INTERVIEW_NOT_CURRENT =
+            new ErrorCode(1_050_200_014, "只能操作候选人当前轮次的面试");
+    ErrorCode RECRUIT_INTERVIEW_RESULT_INVALID =
+            new ErrorCode(1_050_200_015, "当前面试状态或面试结果不允许提交");
+
+    // ========== 招聘渠道 1-050-200-003 ==========
+    ErrorCode RECRUIT_CHANNEL_NOT_EXISTS = new ErrorCode(1_050_200_003, "招聘渠道不存在");
+    ErrorCode RECRUIT_CHANNEL_SYSTEM_NAME_UPDATE_FORBIDDEN =
+            new ErrorCode(1_050_200_005, "系统内置招聘渠道不允许修改名称");
+    ErrorCode RECRUIT_CHANNEL_SYSTEM_DELETE_FORBIDDEN =
+            new ErrorCode(1_050_200_006, "系统内置招聘渠道不允许删除");
+    ErrorCode RECRUIT_CHANNEL_TRANSFER_SELF =
+            new ErrorCode(1_050_200_007, "承接招聘渠道不能是待删除渠道");
+    ErrorCode RECRUIT_CHANNEL_TRANSFER_DISABLED = new ErrorCode(1_050_200_008, "承接招聘渠道已停用");
+
+    // ========== 招聘职位类型 1-050-200-004 ==========
+    ErrorCode RECRUIT_POST_TYPE_NOT_EXISTS = new ErrorCode(1_050_200_004, "招聘职位类型不存在");
+
+    // ========== 考勤组 1-050-300-002 ==========
+    ErrorCode ATTENDANCE_GROUP_NOT_EXISTS = new ErrorCode(1_050_300_002, "考勤组不存在");
+    ErrorCode ATTENDANCE_NAME_DUPLICATE = new ErrorCode(1_050_300_007, "考勤名称已存在");
+    ErrorCode ATTENDANCE_DEFAULT_CANNOT_DELETE = new ErrorCode(1_050_300_008, "默认考勤配置不能删除");
+
+    // ========== 考勤打卡 1-050-300-003 ==========
+    ErrorCode ATTENDANCE_CLOCK_NOT_EXISTS = new ErrorCode(1_050_300_003, "打卡记录不存在");
+    ErrorCode ATTENDANCE_CLOCK_NON_MANUAL_MODIFY_FORBIDDEN = new ErrorCode(1_050_300_028,
+            "只有手工录入的打卡记录可以修改或删除");
+    ErrorCode ATTENDANCE_CLOCK_TIME_INVALID = new ErrorCode(1_050_300_033,
+            "应打卡时间或实际打卡时间不在员工班次窗口内");
+    ErrorCode ATTENDANCE_CLOCK_REST_DAY = new ErrorCode(1_050_300_034, "今日休息，无需打卡");
+    ErrorCode ATTENDANCE_CLOCK_NOT_ALLOWED = new ErrorCode(1_050_300_035, "当前不在可打卡时间");
+    ErrorCode ATTENDANCE_CLOCK_POINT_INVALID = new ErrorCode(1_050_300_036, "不在考勤打卡范围内");
+    ErrorCode ATTENDANCE_CLOCK_WIFI_INVALID = new ErrorCode(1_050_300_037, "未连接指定的考勤 WiFi");
+    ErrorCode ATTENDANCE_CLOCK_GROUP_NOT_EXISTS = new ErrorCode(1_050_300_038, "未匹配到考勤组，无法打卡");
+
+    // ========== 考勤节假日 1-050-300-006 ==========
+    ErrorCode ATTENDANCE_HOLIDAY_NOT_EXISTS = new ErrorCode(1_050_300_006, "考勤节假日不存在");
+    ErrorCode ATTENDANCE_HOLIDAY_DATE_DUPLICATE = new ErrorCode(1_050_300_029, "该日期已配置为考勤节假日");
+
+    // ========== 考勤请假 1-050-300-030 ==========
+    ErrorCode ATTENDANCE_LEAVE_NOT_EXISTS = new ErrorCode(1_050_300_030, "请假申请不存在");
+    ErrorCode ATTENDANCE_LEAVE_TIME_CONFLICT = new ErrorCode(1_050_300_031, "请假时间与已有申请重叠");
+    ErrorCode ATTENDANCE_LEAVE_STATUS_INVALID = new ErrorCode(1_050_300_032, "只有审批中的请假申请可以取消");
+
+    // ========== 薪资配置 1-050-400-000 ==========
+    ErrorCode SALARY_CONFIG_NOT_EXISTS = new ErrorCode(1_050_400_000, "薪资配置不存在");
+    ErrorCode SALARY_CONFIG_EXISTS = new ErrorCode(1_050_400_022, "薪资配置已存在");
+
+    // ========== 薪资组 1-050-400-001 ==========
+    ErrorCode SALARY_GROUP_NOT_EXISTS = new ErrorCode(1_050_400_001, "薪资组不存在");
+    ErrorCode SALARY_GROUP_NAME_DUPLICATE = new ErrorCode(1_050_400_002, "薪资组名称已存在");
+    ErrorCode SALARY_GROUP_EMPLOYEE_CONFLICT = new ErrorCode(1_050_400_020, "所选员工已属于其他薪资组");
+    ErrorCode SALARY_GROUP_DEPT_CONFLICT = new ErrorCode(1_050_400_021, "所选部门或其上下级部门已属于其他薪资组");
+
+    // ========== 薪资项 1-050-400-003 ==========
+    ErrorCode SALARY_OPTION_NOT_EXISTS = new ErrorCode(1_050_400_003, "薪资项不存在");
+    ErrorCode SALARY_OPTION_CATEGORY_INVALID = new ErrorCode(1_050_400_028, "薪资项分类不存在或不可用");
+    ErrorCode SALARY_OPTION_CODE_OCCUPIED = new ErrorCode(1_050_400_029,
+            "薪资项编码 {} 已被历史或自定义数据占用，请先完成数据迁移");
+    ErrorCode SALARY_OPTION_STANDARD_CANNOT_MODIFY =
+            new ErrorCode(1_050_400_029, "标准薪资项不允许修改或删除");
+
+    // ========== 薪资计税规则 1-050-400-005 ==========
+    ErrorCode SALARY_TAX_RULE_NOT_EXISTS = new ErrorCode(1_050_400_005, "计税规则不存在");
+    ErrorCode SALARY_TAX_RULE_NAME_DUPLICATE = new ErrorCode(1_050_400_023, "计税规则名称已存在");
+    ErrorCode SALARY_TAX_RULE_USED = new ErrorCode(1_050_400_027, "计税规则已被薪资组使用，不能删除");
+
+    // ========== 员工薪资信息 1-050-400-006 ==========
+    ErrorCode SALARY_EMPLOYEE_INFO_NOT_EXISTS = new ErrorCode(1_050_400_006, "员工薪资信息不存在");
+    ErrorCode SALARY_DATA_ILLEGAL = new ErrorCode(1_050_400_014, "薪资数据不合法");
+    ErrorCode SALARY_IMPORT_LIST_IS_EMPTY = new ErrorCode(1_050_400_015, "导入薪资档案数据不能为空");
+
+    // ========== 定薪调薪记录 1-050-400-007 ==========
+    ErrorCode SALARY_CHANGE_RECORD_NOT_EXISTS = new ErrorCode(1_050_400_007, "定薪调薪记录不存在");
+    ErrorCode SALARY_PENDING_CHANGE_RECORD_EXISTS = new ErrorCode(1_050_400_016, "员工存在待生效的定薪调薪记录");
+    ErrorCode SALARY_CHANGE_RECORD_STATUS_INVALID = new ErrorCode(1_050_400_017, "当前定薪调薪记录状态不允许执行该操作");
+    ErrorCode SALARY_CHANGE_EFFECT_DATE_INVALID =
+            new ErrorCode(1_050_400_030, "调薪生效日期不能为空，且不能早于最近工资月份");
+
+    // ========== 月度工资表 1-050-400-008 ==========
+    ErrorCode SALARY_MONTH_RECORD_NOT_EXISTS = new ErrorCode(1_050_400_008, "月度工资表不存在");
+    ErrorCode SALARY_MONTH_RECORD_EXISTS = new ErrorCode(1_050_400_009, "该月份工资表已存在");
+    ErrorCode SALARY_MONTH_EMP_RECORD_NOT_EXISTS = new ErrorCode(1_050_400_010, "员工月度工资记录不存在");
+    ErrorCode SALARY_MONTH_RECORD_STATUS_INVALID = new ErrorCode(1_050_400_018, "当前工资表状态不允许执行该操作");
+    ErrorCode SALARY_MONTH_RECORD_NOT_LATEST =
+            new ErrorCode(1_050_400_024, "只能删除最新的月度工资表");
+    ErrorCode SALARY_MONTH_RECORD_CANNOT_DELETE_ONLY =
+            new ErrorCode(1_050_400_025, "至少需要保留一张月度工资表");
+
+    // ========== 工资条 1-050-400-011 ==========
+    ErrorCode SALARY_SLIP_TEMPLATE_NOT_EXISTS = new ErrorCode(1_050_400_011, "工资条模板不存在");
+    ErrorCode SALARY_SLIP_RECORD_NOT_EXISTS = new ErrorCode(1_050_400_012, "工资条发放记录不存在");
+    ErrorCode SALARY_SLIP_NOT_EXISTS = new ErrorCode(1_050_400_013, "工资条不存在");
+    ErrorCode SALARY_SLIP_ALREADY_SENT = new ErrorCode(1_050_400_030, "员工工资条已经发放，请勿重复操作");
+    ErrorCode SALARY_SLIP_EMPLOYEE_ACCOUNT_NOT_EXISTS = new ErrorCode(1_050_400_031,
+            "所选员工未绑定后台账号，无法发放工资条");
+
+    // ========== 社保方案 1-050-500-000 ==========
+    ErrorCode INSURANCE_SCHEME_NOT_EXISTS = new ErrorCode(1_050_500_000, "社保方案不存在");
+    ErrorCode INSURANCE_SCHEME_NAME_DUPLICATE = new ErrorCode(1_050_500_001, "社保方案名称已存在");
+    ErrorCode INSURANCE_SCHEME_USED = new ErrorCode(1_050_500_002, "社保方案已被员工使用，不能删除");
+    ErrorCode INSURANCE_SCHEME_PROJECT_EMPTY = new ErrorCode(1_050_500_011, "社保方案至少需要一个社保项目");
+    ErrorCode INSURANCE_SCHEME_PROJECT_TYPE_DUPLICATE = new ErrorCode(1_050_500_012, "社保方案项目类型重复");
+    ErrorCode INSURANCE_SCHEME_AREA_INVALID = new ErrorCode(1_050_500_024, "参保地区必须选择城市或区县");
+
+    // ========== 员工社保信息 1-050-500-003 ==========
+    ErrorCode INSURANCE_EMPLOYEE_INFO_NOT_EXISTS = new ErrorCode(1_050_500_003, "员工参保信息不存在");
+    ErrorCode INSURANCE_EMPLOYEE_INFO_EMPLOYEE_MISMATCH = new ErrorCode(1_050_500_015,
+            "员工参保信息不能变更所属员工");
+    ErrorCode INSURANCE_EMP_STATUS_ILLEGAL = new ErrorCode(1_050_500_018, "员工参保状态不合法");
+    ErrorCode INSURANCE_EMPLOYEE_SCHEME_NOT_CONFIGURED = new ErrorCode(1_050_500_025,
+            "员工尚未配置有效的社保方案");
+
+    // ========== 月度社保表 1-050-500-004 ==========
+    ErrorCode INSURANCE_MONTH_RECORD_NOT_EXISTS = new ErrorCode(1_050_500_004, "月度社保表不存在");
+    ErrorCode INSURANCE_MONTH_RECORD_EXISTS = new ErrorCode(1_050_500_005, "该月份社保表已存在");
+    ErrorCode INSURANCE_MONTH_EMP_RECORD_NOT_EXISTS = new ErrorCode(1_050_500_006, "员工月度社保记录不存在");
+    ErrorCode INSURANCE_DATA_ILLEGAL = new ErrorCode(1_050_500_007, "社保数据不合法");
+    ErrorCode INSURANCE_MONTH_RECORD_ARCHIVED = new ErrorCode(1_050_500_009, "月度社保表已归档，不能修改");
+    ErrorCode INSURANCE_MONTH_YEAR_MONTH_ILLEGAL = new ErrorCode(1_050_500_017, "社保表年月不合法");
+    ErrorCode INSURANCE_MONTH_RECORD_NOT_LATEST = new ErrorCode(1_050_500_020, "只能删除最新的月度社保表");
+    ErrorCode INSURANCE_MONTH_RECORD_CANNOT_DELETE_ONLY = new ErrorCode(1_050_500_021,
+            "至少需要保留一张月度社保表");
+    ErrorCode INSURANCE_FIRST_MONTH_RECORD_EXISTS = new ErrorCode(1_050_500_023,
+            "已存在社保表，请新建次月社保表");
+    ErrorCode INSURANCE_MONTH_EMPLOYEE_NOT_ELIGIBLE = new ErrorCode(1_050_500_026,
+            "员工在所选月份不符合参保条件");
+
+    // ========== 员工工资卡 1-050-500-008 ==========
+    ErrorCode EMPLOYEE_SALARY_CARD_NOT_EXISTS = new ErrorCode(1_050_500_008, "员工工资卡不存在");
+    ErrorCode EMPLOYEE_SALARY_CARD_EMPLOYEE_MISMATCH = new ErrorCode(1_050_500_016,
+            "员工工资卡不能变更所属员工");
+
+    // ========== 绩效考核模板 1-050-600-000 ==========
+    ErrorCode PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS = new ErrorCode(1_050_600_000, "绩效考核模板不存在");
+    ErrorCode PERFORMANCE_ASSESSMENT_TEMPLATE_NAME_DUPLICATE =
+            new ErrorCode(1_050_600_001, "绩效考核模板名称已存在");
+
+    // ========== 绩效结果模板 1-050-600-002 ==========
+    ErrorCode PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS = new ErrorCode(1_050_600_002, "绩效结果模板不存在");
+    ErrorCode PERFORMANCE_RESULT_TEMPLATE_NAME_DUPLICATE =
+            new ErrorCode(1_050_600_003, "绩效结果模板名称已存在");
+
+    // ========== 绩效计划 1-050-600-004 ==========
+    ErrorCode PERFORMANCE_PLAN_NOT_EXISTS = new ErrorCode(1_050_600_004, "绩效计划不存在");
+    ErrorCode PERFORMANCE_PLAN_NAME_DUPLICATE = new ErrorCode(1_050_600_005, "绩效计划名称已存在");
+    ErrorCode PERFORMANCE_PLAN_STARTED_CANNOT_MODIFY =
+            new ErrorCode(1_050_600_014, "绩效计划启动后不能修改计划配置或参评员工");
+    ErrorCode PERFORMANCE_PLAN_STATUS_NOT_ALLOW_DELETE =
+            new ErrorCode(1_050_600_025, "当前状态的绩效计划不允许删除");
+
+    // ========== 员工绩效考核 1-050-600-006 ==========
+    ErrorCode PERFORMANCE_ASSESSMENT_NOT_EXISTS = new ErrorCode(1_050_600_006, "员工绩效考核不存在");
+    ErrorCode PERFORMANCE_DATA_ILLEGAL = new ErrorCode(1_050_600_007, "绩效数据不合法");
+    ErrorCode PERFORMANCE_RESULT_LEVEL_NOT_MATCH =
+            new ErrorCode(1_050_600_028, "绩效总分未匹配到结果等级，请检查绩效结果模板");
+
+    // ========== 绩效流程 1-050-600-008 ==========
+    ErrorCode PERFORMANCE_STAGE_ACTION_INVALID = new ErrorCode(1_050_600_008, "当前绩效阶段不允许执行该操作");
+    ErrorCode PERFORMANCE_PROCESS_RUNNING_CANNOT_MODIFY =
+            new ErrorCode(1_050_600_009, "绩效流程处理中，不能修改当前记录");
+    ErrorCode PERFORMANCE_PROCESS_CONFIG_INVALID =
+            new ErrorCode(1_050_600_024, "绩效流程配置不合法");
+    ErrorCode PERFORMANCE_STAGE_NO_PERMISSION =
+            new ErrorCode(1_050_600_027, "当前用户不是该绩效阶段的处理人");
+    ErrorCode PERFORMANCE_STAGE_HANDLER_USER_NOT_BOUND =
+            new ErrorCode(1_050_600_026, "绩效必办节点处理人【{}】未绑定后台账号");
+
+    // ========== 绩效评分阶段 1-050-600-011 ==========
+    ErrorCode PERFORMANCE_REVIEW_STAGE_CONFIG_INVALID = new ErrorCode(1_050_600_011, "绩效评分流程配置不合法");
+    ErrorCode PERFORMANCE_REVIEW_STAGE_NOT_EXISTS = new ErrorCode(1_050_600_012, "绩效评分任务不存在");
+    ErrorCode PERFORMANCE_REVIEW_STAGE_NO_PERMISSION =
+            new ErrorCode(1_050_600_013, "当前用户不是该绩效阶段的评分人");
+    ErrorCode PERFORMANCE_REVIEW_STAGE_REJECT_INVALID =
+            new ErrorCode(1_050_600_015, "当前绩效评分阶段不能驳回上一阶段");
+
+    // ========== 绩效阶段流转 1-050-600-016 ==========
+    ErrorCode PERFORMANCE_INTERVIEW_NOT_READY =
+            new ErrorCode(1_050_600_016, "绩效结果审核尚未全部完成，无法发起绩效面谈");
+    ErrorCode PERFORMANCE_ARCHIVE_NOT_READY =
+            new ErrorCode(1_050_600_017, "绩效面谈或申诉尚未全部结束，无法归档");
+    ErrorCode PERFORMANCE_SCORING_NOT_READY =
+            new ErrorCode(1_050_600_018, "指标制定或目标确认尚未全部完成，无法开启评分");
+
+    // ========== 绩效指标 1-050-600-019 ==========
+    ErrorCode PERFORMANCE_QUOTA_SETTING_INVALID =
+            new ErrorCode(1_050_600_019, "绩效指标制定数据不合法");
+
+    // ========== 绩效目标确认 1-050-600-020 ==========
+    ErrorCode PERFORMANCE_TARGET_CONFIRM_CONFIG_INVALID =
+            new ErrorCode(1_050_600_020, "绩效目标确认人配置不合法");
+    ErrorCode PERFORMANCE_TARGET_CONFIRM_NO_PERMISSION =
+            new ErrorCode(1_050_600_021, "当前用户不是该绩效目标的确认人");
+
+    // ========== HRM 配置 1-050-800-000 ==========
+    ErrorCode HRM_CONFIG_NOT_EXISTS = new ErrorCode(1_050_800_000, "HRM 配置不存在");
+
+    // ========== 调薪模板 1-050-800-002 ==========
+    ErrorCode SALARY_CHANGE_TEMPLATE_NOT_EXISTS = new ErrorCode(1_050_800_002, "调薪模板不存在");
+    ErrorCode SALARY_CHANGE_TEMPLATE_DEFAULT_CANNOT_DELETE =
+            new ErrorCode(1_050_800_003, "默认调薪模板不能删除");
+    ErrorCode SALARY_CHANGE_TEMPLATE_OPTION_INVALID =
+            new ErrorCode(1_050_800_004, "调薪模板包含无效或重复的薪资项");
+
+    // ========== HRM 首页 1-050-900-001 ==========
+    ErrorCode HOME_CALENDAR_DATE_RANGE_ILLEGAL = new ErrorCode(1_050_900_001, "HRM 首页日期范围不合法");
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/LogRecordConstants.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/LogRecordConstants.java
new file mode 100644
index 0000000..1fc6668
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/LogRecordConstants.java
@@ -0,0 +1,364 @@
+package cn.iocoder.yudao.module.hrm.enums;
+
+/**
+ * HRM 操作日志常量
+ *
+ * @author 芋道源码
+ */
+public interface LogRecordConstants {
+
+    // ======================= HRM_EMPLOYEE 员工档案 =======================
+
+    String HRM_EMPLOYEE_TYPE = "HRM 员工档案";
+    String HRM_EMPLOYEE_CREATE_SUB_TYPE = "创建员工档案";
+    String HRM_EMPLOYEE_CREATE_SUCCESS = "创建了员工档案【{{#employee.name}}】";
+    String HRM_EMPLOYEE_CREATE_FROM_USER_LIST_SUB_TYPE = "从后台用户创建员工档案";
+    String HRM_EMPLOYEE_ARCHIVE_FILL_MESSAGE_SUB_TYPE = "发送填写员工档案通知";
+    String HRM_EMPLOYEE_UPDATE_SUB_TYPE = "更新员工档案";
+    String HRM_EMPLOYEE_UPDATE_SUCCESS = "更新了员工档案【{{#updateReqVO.name}}】: {_DIFF{#updateReqVO}}";
+    String HRM_EMPLOYEE_PROFILE_UPDATE_SUB_TYPE = "员工更新个人档案";
+    String HRM_EMPLOYEE_PROFILE_UPDATE_SUCCESS =
+            "员工更新了个人档案【{{#updateReqVO.name}}】: {_DIFF{#updateReqVO}}";
+    String HRM_EMPLOYEE_DELETE_SUB_TYPE = "删除员工档案";
+    String HRM_EMPLOYEE_DELETE_SUCCESS = "删除了员工档案【{{#employee.name}}】";
+    String HRM_EMPLOYEE_FILE_UPDATE_SUB_TYPE = "更新员工材料附件";
+    String HRM_EMPLOYEE_FILE_UPDATE_SUCCESS = "更新了员工档案【{{#employee.name}}】的材料附件";
+    String HRM_EMPLOYEE_CONFIRM_ENTRY_SUB_TYPE = "确认员工入职";
+    String HRM_EMPLOYEE_CONFIRM_ENTRY_SUCCESS = "确认员工【{{#employee.name}}】入职";
+    String HRM_EMPLOYEE_REHIRE_SUB_TYPE = "办理员工再入职";
+    String HRM_EMPLOYEE_REHIRE_SUCCESS = "办理员工【{{#employee.name}}】再入职";
+    String HRM_EMPLOYEE_REGULAR_SUB_TYPE = "办理员工转正";
+    String HRM_EMPLOYEE_REGULAR_SUCCESS = "办理员工【{{#employee.name}}】转正，生效时间："
+            + "【{{#reqVO.effectTime}}】";
+    String HRM_EMPLOYEE_TRANSFER_SUB_TYPE = "办理员工调岗";
+    String HRM_EMPLOYEE_TRANSFER_SUCCESS = "办理员工【{{#employee.name}}】调岗，生效时间："
+            + "【{{#reqVO.effectTime}}】";
+    String HRM_EMPLOYEE_PROMOTE_SUB_TYPE = "办理员工晋升";
+    String HRM_EMPLOYEE_PROMOTE_SUCCESS = "办理员工【{{#employee.name}}】晋升，生效时间："
+            + "【{{#reqVO.effectTime}}】";
+    String HRM_EMPLOYEE_DEMOTE_SUB_TYPE = "办理员工降级";
+    String HRM_EMPLOYEE_DEMOTE_SUCCESS = "办理员工【{{#employee.name}}】降级，生效时间："
+            + "【{{#reqVO.effectTime}}】";
+    String HRM_EMPLOYEE_FULL_TIME_SUB_TYPE = "办理员工转为全职";
+    String HRM_EMPLOYEE_FULL_TIME_SUCCESS = "办理员工【{{#employee.name}}】转为全职，生效时间："
+            + "【{{#reqVO.effectTime}}】";
+    String HRM_EMPLOYEE_QUIT_SUB_TYPE = "设置员工离职";
+    String HRM_EMPLOYEE_QUIT_SUCCESS = "设置员工【{{#employee.name}}】离职，计划离职时间："
+            + "【{{#reqVO.planQuitTime}}】";
+    String HRM_EMPLOYEE_CANCEL_QUIT_SUB_TYPE = "取消员工离职";
+    String HRM_EMPLOYEE_CANCEL_QUIT_SUCCESS = "取消员工【{{#employee.name}}】的离职安排，原因："
+            + "【{{#reqVO.reason}}】";
+    String HRM_EMPLOYEE_SALARY_CARD_SAVE_SUB_TYPE = "保存员工工资卡";
+    String HRM_EMPLOYEE_SALARY_CARD_SAVE_SUCCESS =
+            "保存了员工【{{#employee.name}}】的工资卡: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_SALARY_CARD_DELETE_SUB_TYPE = "删除员工工资卡";
+    String HRM_EMPLOYEE_SALARY_CARD_DELETE_SUCCESS = "删除了员工【{{#employee.name}}】的工资卡";
+    String HRM_EMPLOYEE_EDUCATION_EXPERIENCE_CREATE_SUB_TYPE = "新增员工教育经历";
+    String HRM_EMPLOYEE_EDUCATION_EXPERIENCE_CREATE_SUCCESS =
+            "新增了员工教育经历【{{#educationExperience.id}}】";
+    String HRM_EMPLOYEE_EDUCATION_EXPERIENCE_UPDATE_SUB_TYPE = "更新员工教育经历";
+    String HRM_EMPLOYEE_EDUCATION_EXPERIENCE_UPDATE_SUCCESS =
+            "更新了员工教育经历【{{#reqVO.id}}】: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_EDUCATION_EXPERIENCE_DELETE_SUB_TYPE = "删除员工教育经历";
+    String HRM_EMPLOYEE_EDUCATION_EXPERIENCE_DELETE_SUCCESS =
+            "删除了员工教育经历【{{#educationExperience.id}}】";
+    String HRM_EMPLOYEE_WORK_EXPERIENCE_CREATE_SUB_TYPE = "新增员工工作经历";
+    String HRM_EMPLOYEE_WORK_EXPERIENCE_CREATE_SUCCESS =
+            "新增了员工工作经历【{{#workExperience.id}}】";
+    String HRM_EMPLOYEE_WORK_EXPERIENCE_UPDATE_SUB_TYPE = "更新员工工作经历";
+    String HRM_EMPLOYEE_WORK_EXPERIENCE_UPDATE_SUCCESS =
+            "更新了员工工作经历【{{#reqVO.id}}】: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_WORK_EXPERIENCE_DELETE_SUB_TYPE = "删除员工工作经历";
+    String HRM_EMPLOYEE_WORK_EXPERIENCE_DELETE_SUCCESS =
+            "删除了员工工作经历【{{#workExperience.id}}】";
+    String HRM_EMPLOYEE_TRAINING_EXPERIENCE_CREATE_SUB_TYPE = "新增员工培训经历";
+    String HRM_EMPLOYEE_TRAINING_EXPERIENCE_CREATE_SUCCESS =
+            "新增了员工培训经历【{{#trainingExperience.id}}】";
+    String HRM_EMPLOYEE_TRAINING_EXPERIENCE_UPDATE_SUB_TYPE = "更新员工培训经历";
+    String HRM_EMPLOYEE_TRAINING_EXPERIENCE_UPDATE_SUCCESS =
+            "更新了员工培训经历【{{#reqVO.id}}】: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_TRAINING_EXPERIENCE_DELETE_SUB_TYPE = "删除员工培训经历";
+    String HRM_EMPLOYEE_TRAINING_EXPERIENCE_DELETE_SUCCESS =
+            "删除了员工培训经历【{{#trainingExperience.id}}】";
+    String HRM_EMPLOYEE_CERTIFICATE_CREATE_SUB_TYPE = "新增员工证书";
+    String HRM_EMPLOYEE_CERTIFICATE_CREATE_SUCCESS = "新增了员工证书【{{#certificate.id}}】";
+    String HRM_EMPLOYEE_CERTIFICATE_UPDATE_SUB_TYPE = "更新员工证书";
+    String HRM_EMPLOYEE_CERTIFICATE_UPDATE_SUCCESS =
+            "更新了员工证书【{{#reqVO.id}}】: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_CERTIFICATE_DELETE_SUB_TYPE = "删除员工证书";
+    String HRM_EMPLOYEE_CERTIFICATE_DELETE_SUCCESS = "删除了员工证书【{{#certificate.id}}】";
+    String HRM_EMPLOYEE_CONTACT_CREATE_SUB_TYPE = "新增员工联系人";
+    String HRM_EMPLOYEE_CONTACT_CREATE_SUCCESS = "新增了员工联系人【{{#contact.id}}】";
+    String HRM_EMPLOYEE_CONTACT_UPDATE_SUB_TYPE = "更新员工联系人";
+    String HRM_EMPLOYEE_CONTACT_UPDATE_SUCCESS =
+            "更新了员工联系人【{{#reqVO.id}}】: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_CONTACT_DELETE_SUB_TYPE = "删除员工联系人";
+    String HRM_EMPLOYEE_CONTACT_DELETE_SUCCESS = "删除了员工联系人【{{#contact.id}}】";
+    String HRM_EMPLOYEE_CONTRACT_CREATE_SUB_TYPE = "新增员工合同";
+    String HRM_EMPLOYEE_CONTRACT_CREATE_SUCCESS = "新增了员工合同【{{#contract.id}}】";
+    String HRM_EMPLOYEE_CONTRACT_UPDATE_SUB_TYPE = "更新员工合同";
+    String HRM_EMPLOYEE_CONTRACT_UPDATE_SUCCESS =
+            "更新了员工合同【{{#reqVO.id}}】: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_CONTRACT_DELETE_SUB_TYPE = "删除员工合同";
+    String HRM_EMPLOYEE_CONTRACT_DELETE_SUCCESS = "删除了员工合同【{{#contract.id}}】";
+
+    // ======================= HRM_EMPLOYEE_CONFIG 员工字段配置 =======================
+
+    String HRM_EMPLOYEE_CONFIG_TYPE = "HRM 员工字段配置";
+    String HRM_EMPLOYEE_CREATE_FIELD_CONFIG_UPDATE_SUB_TYPE = "更新新建员工字段配置";
+    String HRM_EMPLOYEE_CREATE_FIELD_CONFIG_UPDATE_SUCCESS =
+            "更新了【{{#configGroupName}}】: {_DIFF{#reqVO}}";
+    String HRM_EMPLOYEE_ARCHIVE_FIELD_CONFIG_UPDATE_SUB_TYPE = "更新员工档案字段配置";
+    String HRM_EMPLOYEE_ARCHIVE_FIELD_CONFIG_UPDATE_SUCCESS =
+            "更新了员工档案字段配置: {_DIFF{#reqVO}}";
+    // ======================= HRM_INSURANCE_EMPLOYEE_INFO 员工参保信息 =======================
+
+    String HRM_INSURANCE_EMPLOYEE_INFO_TYPE = "HRM 员工参保信息";
+    String HRM_INSURANCE_EMPLOYEE_INFO_SAVE_SUB_TYPE = "保存员工参保信息";
+    String HRM_INSURANCE_EMPLOYEE_INFO_SAVE_SUCCESS =
+            "保存了员工【{{#employee.name}}】的参保信息: {_DIFF{#reqVO}}";
+    String HRM_INSURANCE_EMPLOYEE_INFO_UPDATE_SCHEME_SUB_TYPE = "设置员工参保方案";
+    String HRM_INSURANCE_EMPLOYEE_INFO_UPDATE_SCHEME_SUCCESS = "将员工【{{#employee.name}}】的参保方案从"
+            + "【{{#oldSchemeName}}】变更为【{{#newSchemeName}}】";
+
+    // ======================= HRM_INSURANCE_SCHEME 社保方案 =======================
+
+    String HRM_INSURANCE_SCHEME_TYPE = "HRM 社保方案";
+    String HRM_INSURANCE_SCHEME_CREATE_SUB_TYPE = "创建社保方案";
+    String HRM_INSURANCE_SCHEME_CREATE_SUCCESS = "创建了社保方案【{{#insuranceScheme.name}}】";
+    String HRM_INSURANCE_SCHEME_UPDATE_SUB_TYPE = "更新社保方案";
+    String HRM_INSURANCE_SCHEME_UPDATE_SUCCESS = "更新了社保方案【{{#insuranceScheme.name}}】";
+    String HRM_INSURANCE_SCHEME_DELETE_SUB_TYPE = "删除社保方案";
+    String HRM_INSURANCE_SCHEME_DELETE_SUCCESS = "删除了社保方案【{{#insuranceScheme.name}}】";
+
+    // ======================= HRM_INSURANCE_MONTH 月度社保表 =======================
+
+    String HRM_INSURANCE_MONTH_TYPE = "HRM 月度社保表";
+    String HRM_INSURANCE_MONTH_CREATE_SUB_TYPE = "创建月度社保表";
+    String HRM_INSURANCE_MONTH_CREATE_SUCCESS = "创建了月度社保表【{{#monthRecord.title}}】";
+    String HRM_INSURANCE_MONTH_DELETE_SUB_TYPE = "删除月度社保表";
+    String HRM_INSURANCE_MONTH_DELETE_SUCCESS = "删除了月度社保表【{{#monthRecord.title}}】";
+    String HRM_INSURANCE_MONTH_EMPLOYEE_CREATE_SUB_TYPE = "添加月度参保员工";
+    String HRM_INSURANCE_MONTH_EMPLOYEE_CREATE_SUCCESS = "向月度社保表【{{#monthRecord.title}}】添加了"
+            + "【{{#reqVO.employeeIds.size()}}】名员工";
+    String HRM_INSURANCE_MONTH_EMPLOYEE_UPDATE_SUB_TYPE = "调整员工月度参保方案";
+    String HRM_INSURANCE_MONTH_EMPLOYEE_UPDATE_SUCCESS = "将员工月度社保记录【{{#employeeRecord.id}}】调整为"
+            + "参保方案【{{#scheme.name}}】";
+    String HRM_INSURANCE_MONTH_EMPLOYEE_STOP_SUB_TYPE = "批量停止员工参保";
+    String HRM_INSURANCE_MONTH_EMPLOYEE_STOP_SUCCESS = "停止了月度社保表【{{#monthRecord.title}}】中的"
+            + "【{{#ids.size()}}】名员工参保";
+
+    // ======================= HRM_ATTENDANCE_GROUP 考勤组 =======================
+
+    String HRM_ATTENDANCE_GROUP_TYPE = "HRM 考勤组";
+    String HRM_ATTENDANCE_GROUP_CREATE_SUB_TYPE = "创建考勤组";
+    String HRM_ATTENDANCE_GROUP_CREATE_SUCCESS = "创建了考勤组【{{#attendanceGroup.name}}】";
+    String HRM_ATTENDANCE_GROUP_UPDATE_SUB_TYPE = "更新考勤组";
+    String HRM_ATTENDANCE_GROUP_UPDATE_SUCCESS =
+            "更新了考勤组【{{#updateReqVO.name}}】: {_DIFF{#updateReqVO}}";
+    String HRM_ATTENDANCE_GROUP_DELETE_SUB_TYPE = "删除考勤组";
+    String HRM_ATTENDANCE_GROUP_DELETE_SUCCESS = "删除了考勤组【{{#attendanceGroup.name}}】";
+
+    // ======================= HRM_RECRUIT_POST 招聘职位 =======================
+
+    String HRM_RECRUIT_POST_TYPE = "HRM 招聘职位";
+    String HRM_RECRUIT_POST_CREATE_SUB_TYPE = "创建招聘职位";
+    String HRM_RECRUIT_POST_CREATE_SUCCESS = "创建了招聘职位【{{#createReqVO.postName}}】";
+    String HRM_RECRUIT_POST_UPDATE_SUB_TYPE = "更新招聘职位";
+    String HRM_RECRUIT_POST_UPDATE_SUCCESS = "更新了招聘职位【{{#updateReqVO.postName}}】: {_DIFF{#updateReqVO}}";
+    String HRM_RECRUIT_POST_UPDATE_STATUS_SUB_TYPE = "更新招聘职位状态";
+    String HRM_RECRUIT_POST_UPDATE_STATUS_SUCCESS = "将招聘职位【{{#recruitPost.postName}}】的状态从"
+            + "【{getRecruitPostStatusName{#recruitPost.status}}】变更为了"
+            + "【{getRecruitPostStatusName{#reqVO.status}}】";
+
+    // ======================= HRM_RECRUIT_CHANNEL 招聘渠道 =======================
+
+    String HRM_RECRUIT_CHANNEL_TYPE = "HRM 招聘渠道";
+    String HRM_RECRUIT_CHANNEL_CREATE_SUB_TYPE = "创建招聘渠道";
+    String HRM_RECRUIT_CHANNEL_CREATE_SUCCESS = "创建了招聘渠道【{{#createReqVO.name}}】";
+    String HRM_RECRUIT_CHANNEL_UPDATE_SUB_TYPE = "更新招聘渠道";
+    String HRM_RECRUIT_CHANNEL_UPDATE_SUCCESS = "更新了招聘渠道【{{#updateReqVO.name}}】: {_DIFF{#updateReqVO}}";
+    String HRM_RECRUIT_CHANNEL_UPDATE_STATUS_SUB_TYPE = "更新招聘渠道状态";
+    String HRM_RECRUIT_CHANNEL_UPDATE_STATUS_SUCCESS = "将招聘渠道【{{#recruitChannel.name}}】的状态从"
+            + "【{getHrmCommonStatusName{#recruitChannel.status}}】变更为了"
+            + "【{getHrmCommonStatusName{#statusReqVO.status}}】";
+    String HRM_RECRUIT_CHANNEL_DELETE_SUB_TYPE = "删除招聘渠道";
+    String HRM_RECRUIT_CHANNEL_DELETE_SUCCESS = "删除了招聘渠道【{{#recruitChannel.name}}】，并将关联员工和候选人"
+            + "转移至【{{#transferRecruitChannel.name}}】";
+
+    // ======================= HRM_RECRUIT_CONFIG 招聘设置 =======================
+
+    String HRM_RECRUIT_CONFIG_TYPE = "HRM 招聘设置";
+    String HRM_RECRUIT_ELIMINATE_REASON_UPDATE_SUB_TYPE = "更新招聘淘汰原因";
+    String HRM_RECRUIT_ELIMINATE_REASON_UPDATE_SUCCESS =
+            "更新了招聘淘汰原因: {_DIFF{#saveReqVO}}";
+
+    // ======================= HRM_RECRUIT_CANDIDATE 招聘候选人 =======================
+
+    String HRM_RECRUIT_CANDIDATE_TYPE = "HRM 招聘候选人";
+    String HRM_RECRUIT_CANDIDATE_CREATE_SUB_TYPE = "创建招聘候选人";
+    String HRM_RECRUIT_CANDIDATE_CREATE_SUCCESS = "创建了招聘候选人【{{#createReqVO.name}}】";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_SUB_TYPE = "更新招聘候选人";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_SUCCESS = "更新了招聘候选人【{{#updateReqVO.name}}】: {_DIFF{#updateReqVO}}";
+    String HRM_RECRUIT_CANDIDATE_DELETE_SUB_TYPE = "删除招聘候选人";
+    String HRM_RECRUIT_CANDIDATE_DELETE_SUCCESS = "删除了招聘候选人【{{#recruitCandidate.name}}】";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_STATUS_SUB_TYPE = "更新招聘候选人状态";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_STATUS_SUCCESS = "将招聘候选人【{{#recruitCandidate.name}}】的状态从"
+            + "【{getRecruitCandidateStatusName{#recruitCandidate.status}}】变更为了"
+            + "【{getRecruitCandidateStatusName{#reqVO.status}}】";
+    String HRM_RECRUIT_CANDIDATE_ARRANGE_INTERVIEW_SUB_TYPE = "安排招聘面试";
+    String HRM_RECRUIT_CANDIDATE_ARRANGE_INTERVIEW_SUCCESS = "为招聘候选人【{{#recruitCandidate.name}}】安排了第"
+            + "【{{#recruitInterview.stageNumber}}】轮面试";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_INTERVIEW_SUB_TYPE = "更改招聘面试安排";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_INTERVIEW_SUCCESS = "更改了招聘候选人"
+            + "【{{#recruitCandidate.name}}】第【{{#recruitInterview.stageNumber}}】轮面试安排: {_DIFF{#updateReqVO}}";
+    String HRM_RECRUIT_CANDIDATE_INTERVIEW_RESULT_SUB_TYPE =
+            "{{#reqVO.result == 2 ? '面试通过' : (#reqVO.result == 3 ? '面试未通过' : "
+                    + "(#reqVO.result == 4 ? '取消面试' : '登记面试结果'))}}";
+    String HRM_RECRUIT_CANDIDATE_INTERVIEW_RESULT_SUCCESS = "将招聘候选人【{{#recruitCandidate.name}}】第"
+            + "【{{#recruitInterview.stageNumber}}】轮面试结果设置为"
+            + "【{getRecruitInterviewResultName{#reqVO.result}}】"
+            + "{{#reqVO.result == 4 ? '，取消原因：【' + #reqVO.cancelReason + '】' : "
+            + "(#reqVO.evaluate != null && !#reqVO.evaluate.isEmpty() ? '，面试评价：【' + #reqVO.evaluate + '】' : '')}}";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_POST_SUB_TYPE = "更新招聘候选人应聘职位";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_POST_SUCCESS = "将招聘候选人【{{#recruitCandidate.name}}】的应聘职位变更为"
+            + "【{{#recruitPost.postName}}】";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_CHANNEL_SUB_TYPE = "更新招聘候选人招聘渠道";
+    String HRM_RECRUIT_CANDIDATE_UPDATE_CHANNEL_SUCCESS = "将招聘候选人【{{#recruitCandidate.name}}】的招聘渠道变更为"
+            + "【{{#recruitChannel.name}}】";
+    String HRM_RECRUIT_CANDIDATE_ELIMINATE_SUB_TYPE = "淘汰招聘候选人";
+    String HRM_RECRUIT_CANDIDATE_ELIMINATE_SUCCESS = "淘汰了招聘候选人【{{#recruitCandidate.name}}】，原因："
+            + "【{{#reqVO.eliminate}}】";
+    String HRM_RECRUIT_CANDIDATE_CONVERT_EMPLOYEE_SUB_TYPE = "招聘候选人转员工";
+    String HRM_RECRUIT_CANDIDATE_CONVERT_EMPLOYEE_SUCCESS = "将招聘候选人【{{#recruitCandidate.name}}】转为员工，"
+            + "员工编号为【{{#employeeId}}】";
+
+    // ======================= HRM_SALARY_MONTH 月度工资表 =======================
+
+    String HRM_SALARY_MONTH_TYPE = "HRM 月度工资表";
+    String HRM_SALARY_MONTH_CREATE_SUB_TYPE = "创建月度工资表";
+    String HRM_SALARY_MONTH_CREATE_SUCCESS = "创建了月度工资表【{{#salaryMonthRecord.title}}】";
+    String HRM_SALARY_MONTH_COMPUTE_SUB_TYPE = "核算月度工资表";
+    String HRM_SALARY_MONTH_COMPUTE_SUCCESS = "核算了月度工资表【{{#salaryMonthRecord.title}}】";
+    String HRM_SALARY_MONTH_DELETE_SUB_TYPE = "删除月度工资表";
+    String HRM_SALARY_MONTH_DELETE_SUCCESS = "删除了月度工资表【{{#salaryMonthRecord.title}}】";
+    String HRM_SALARY_MONTH_EMPLOYEE_UPDATE_SUB_TYPE = "在线修改员工月度工资";
+    String HRM_SALARY_MONTH_EMPLOYEE_UPDATE_SUCCESS =
+            "在线修改了月度工资表【{{#salaryMonthRecord.title}}】，影响【{{#employeeCount}}】名员工，"
+                    + "员工编号【{{#employeeScope}}】，变更薪资项【{{#changedOptionSummary}}】";
+
+    // ======================= HRM_SALARY_CONFIG 计薪配置 =======================
+
+    String HRM_SALARY_CONFIG_TYPE = "HRM 计薪配置";
+    String HRM_SALARY_CONFIG_UPDATE_SUB_TYPE = "更新计薪配置";
+    String HRM_SALARY_CONFIG_UPDATE_SUCCESS = "更新了计薪配置: {_DIFF{#updateReqVO}}";
+
+    // ======================= HRM_SALARY_GROUP 薪资组 =======================
+
+    String HRM_SALARY_GROUP_TYPE = "HRM 薪资组";
+    String HRM_SALARY_GROUP_CREATE_SUB_TYPE = "创建薪资组";
+    String HRM_SALARY_GROUP_CREATE_SUCCESS = "创建了薪资组【{{#salaryGroup.name}}】";
+    String HRM_SALARY_GROUP_UPDATE_SUB_TYPE = "更新薪资组";
+    String HRM_SALARY_GROUP_UPDATE_SUCCESS = "更新了薪资组【{{#updateReqVO.name}}】: {_DIFF{#updateReqVO}}";
+    String HRM_SALARY_GROUP_DELETE_SUB_TYPE = "删除薪资组";
+    String HRM_SALARY_GROUP_DELETE_SUCCESS = "删除了薪资组【{{#salaryGroup.name}}】";
+
+    // ======================= HRM_SALARY_OPTION 薪资项 =======================
+
+    String HRM_SALARY_OPTION_TYPE = "HRM 薪资项";
+    String HRM_SALARY_OPTION_CREATE_SUB_TYPE = "创建薪资项";
+    String HRM_SALARY_OPTION_CREATE_SUCCESS = "创建了薪资项【{{#salaryOption.name}}】";
+    String HRM_SALARY_OPTION_UPDATE_ENABLED_SUB_TYPE = "更新薪资项启用状态";
+    String HRM_SALARY_OPTION_UPDATE_ENABLED_SUCCESS =
+            "将薪资项【{{#salaryOption.name}}】设置为【{{#enabled ? '启用' : '停用'}}】";
+    String HRM_SALARY_OPTION_UPDATE_VISIBLE_SUB_TYPE = "更新薪资项显示状态";
+    String HRM_SALARY_OPTION_UPDATE_VISIBLE_SUCCESS =
+            "将薪资项【{{#salaryOption.name}}】设置为【{{#visible ? '显示' : '隐藏'}}】";
+    String HRM_SALARY_OPTION_DELETE_SUB_TYPE = "删除薪资项";
+    String HRM_SALARY_OPTION_DELETE_SUCCESS = "删除了薪资项【{{#salaryOption.name}}】";
+
+    // ======================= HRM_SALARY_TAX_RULE 薪资计税规则 =======================
+
+    String HRM_SALARY_TAX_RULE_TYPE = "HRM 薪资计税规则";
+    String HRM_SALARY_TAX_RULE_CREATE_SUB_TYPE = "创建薪资计税规则";
+    String HRM_SALARY_TAX_RULE_CREATE_SUCCESS = "创建了薪资计税规则【{{#salaryTaxRule.name}}】";
+    String HRM_SALARY_TAX_RULE_UPDATE_SUB_TYPE = "更新薪资计税规则";
+    String HRM_SALARY_TAX_RULE_UPDATE_SUCCESS =
+            "更新了薪资计税规则【{{#salaryTaxRule.name}}】: {_DIFF{#updateReqVO}}";
+    String HRM_SALARY_TAX_RULE_DELETE_SUB_TYPE = "删除薪资计税规则";
+    String HRM_SALARY_TAX_RULE_DELETE_SUCCESS = "删除了薪资计税规则【{{#salaryTaxRule.name}}】";
+
+    // ======================= HRM_SALARY_EMPLOYEE 员工薪资 =======================
+
+    String HRM_SALARY_EMPLOYEE_TYPE = "HRM 员工薪资";
+    String HRM_SALARY_EMPLOYEE_SET_SUB_TYPE = "员工定薪调薪";
+    String HRM_SALARY_EMPLOYEE_SET_SUCCESS = "保存了员工【{{#employee.name}}】的定薪调薪记录";
+    String HRM_SALARY_EMPLOYEE_BATCH_SET_SUB_TYPE = "批量调薪";
+    String HRM_SALARY_EMPLOYEE_BATCH_SET_SUCCESS =
+            "批量调薪完成，成功【{{#batchResult.successEmployeeIds.size()}}】人，"
+                    + "失败【{{#batchResult.failureEmployeeReasons.size()}}】人";
+
+    // ======================= HRM_SALARY_SLIP 工资条 =======================
+
+    String HRM_SALARY_SLIP_TYPE = "HRM 工资条";
+    String HRM_SALARY_SLIP_SEND_SUB_TYPE = "发放工资条";
+    String HRM_SALARY_SLIP_SEND_SUCCESS = "发放了【{{#salarySlipSendRecord.year}}】年"
+            + "【{{#salarySlipSendRecord.month}}】月工资条，共【{{#salarySlipSendRecord.sendEmployeeCount}}】人";
+    String HRM_SALARY_SLIP_DELETE_SUB_TYPE = "删除工资条发放记录";
+    String HRM_SALARY_SLIP_DELETE_SUCCESS = "删除了【{{#salarySlipSendRecord.year}}】年"
+            + "【{{#salarySlipSendRecord.month}}】月工资条发放记录";
+
+    // ======================= HRM_PERFORMANCE_PLAN 绩效计划 =======================
+
+    String HRM_PERFORMANCE_PLAN_TYPE = "HRM 绩效计划";
+    String HRM_PERFORMANCE_PLAN_CREATE_SUB_TYPE = "创建绩效计划";
+    String HRM_PERFORMANCE_PLAN_CREATE_SUCCESS = "创建了绩效计划【{{#performancePlan.name}}】";
+    String HRM_PERFORMANCE_PLAN_UPDATE_SUB_TYPE = "更新绩效计划";
+    String HRM_PERFORMANCE_PLAN_UPDATE_SUCCESS = "更新了绩效计划【{{#performancePlan.name}}】";
+    String HRM_PERFORMANCE_PLAN_DELETE_SUB_TYPE = "删除绩效计划";
+    String HRM_PERFORMANCE_PLAN_DELETE_SUCCESS = "删除了绩效计划【{{#performancePlan.name}}】";
+    String HRM_PERFORMANCE_PLAN_START_SUB_TYPE = "启动绩效计划";
+    String HRM_PERFORMANCE_PLAN_START_SUCCESS = "启动了绩效计划【{{#performancePlan.name}}】";
+    String HRM_PERFORMANCE_PLAN_OPEN_SCORING_SUB_TYPE = "开启绩效评分";
+    String HRM_PERFORMANCE_PLAN_OPEN_SCORING_SUCCESS = "开启了绩效计划【{{#performancePlan.name}}】的评分";
+    String HRM_PERFORMANCE_PLAN_INTERVIEW_SUB_TYPE = "发起绩效面谈";
+    String HRM_PERFORMANCE_PLAN_INTERVIEW_SUCCESS = "发起了绩效计划【{{#performancePlan.name}}】的绩效面谈";
+    String HRM_PERFORMANCE_PLAN_ARCHIVE_SUB_TYPE = "归档绩效计划";
+    String HRM_PERFORMANCE_PLAN_ARCHIVE_SUCCESS = "归档了绩效计划【{{#performancePlan.name}}】";
+    String HRM_PERFORMANCE_PLAN_TERMINATE_SUB_TYPE = "终止绩效计划";
+    String HRM_PERFORMANCE_PLAN_TERMINATE_SUCCESS = "终止了绩效计划【{{#performancePlan.name}}】";
+
+    // ======================= HRM_PERFORMANCE 绩效考核 =======================
+
+    String HRM_PERFORMANCE_TYPE = "HRM 绩效考核";
+    String HRM_PERFORMANCE_FILL_QUOTA_SUB_TYPE = "提交绩效指标";
+    String HRM_PERFORMANCE_FILL_QUOTA_SUCCESS = "提交了绩效指标";
+    String HRM_PERFORMANCE_SCORE_SUB_TYPE = "提交绩效评分";
+    String HRM_PERFORMANCE_SCORE_SUCCESS = "提交了绩效评分";
+    String HRM_PERFORMANCE_REJECT_SCORE_SUB_TYPE = "驳回绩效评分";
+    String HRM_PERFORMANCE_REJECT_SCORE_SUCCESS = "驳回了上一绩效评分阶段，原因：【{{#reqVO.reason}}】";
+    String HRM_PERFORMANCE_CONFIRM_TARGET_SUB_TYPE =
+            "{{#reqVO.pass == 1 ? '确认绩效目标' : '驳回绩效目标'}}";
+    String HRM_PERFORMANCE_CONFIRM_TARGET_SUCCESS =
+            "{{#reqVO.pass == 1 ? '确认了绩效目标' : '驳回了绩效目标'}}"
+                    + "{{#reqVO.comment != null && !#reqVO.comment.isEmpty() ? '，意见：【' + #reqVO.comment + '】' : ''}}";
+    String HRM_PERFORMANCE_CONFIRM_RESULT_SUB_TYPE = "确认绩效结果";
+    String HRM_PERFORMANCE_CONFIRM_RESULT_SUCCESS = "确认了绩效结果";
+    String HRM_PERFORMANCE_APPEAL_SUB_TYPE = "提交绩效申诉";
+    String HRM_PERFORMANCE_APPEAL_SUCCESS = "提交了绩效申诉，原因：【{{#reqVO.appealReason}}】";
+    String HRM_PERFORMANCE_RESULT_AUDIT_SUB_TYPE =
+            "{{#reqVO.pass == 1 ? '通过绩效结果审核' : '驳回绩效结果审核'}}";
+    String HRM_PERFORMANCE_RESULT_AUDIT_SUCCESS =
+            "{{#reqVO.pass == 1 ? '通过了绩效结果审核' : '驳回了绩效结果审核'}}"
+                    + "{{#reqVO.comment != null && !#reqVO.comment.isEmpty() ? '，意见：【' + #reqVO.comment + '】' : ''}}";
+    String HRM_PERFORMANCE_APPEAL_HANDLE_SUB_TYPE =
+            "{{#reqVO.pass == 1 ? '通过绩效申诉' : '驳回绩效申诉'}}";
+    String HRM_PERFORMANCE_APPEAL_HANDLE_SUCCESS =
+            "{{#reqVO.pass == 1 ? '通过了绩效申诉' : '驳回了绩效申诉'}}"
+                    + "{{#reqVO.comment != null && !#reqVO.comment.isEmpty() ? '，意见：【' + #reqVO.comment + '】' : ''}}";
+    String HRM_PERFORMANCE_APPEAL_TIMEOUT_HANDLE_SUB_TYPE =
+            "{{#appealPass ? '自动通过绩效申诉' : '自动驳回绩效申诉'}}";
+    String HRM_PERFORMANCE_APPEAL_TIMEOUT_HANDLE_SUCCESS =
+            "{{#appealPass ? '申诉确认超期，系统自动通过了绩效申诉' : '申诉确认超期，系统自动驳回了绩效申诉'}}";
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/MessageTemplateConstants.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/MessageTemplateConstants.java
new file mode 100644
index 0000000..8653e12
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/MessageTemplateConstants.java
@@ -0,0 +1,20 @@
+package cn.iocoder.yudao.module.hrm.enums;
+
+/**
+ * HRM 消息模板常量
+ *
+ * @author 芋道源码
+ */
+public interface MessageTemplateConstants {
+
+    // ======================= 站内信模板 =======================
+
+    String RECRUIT_INTERVIEW_ARRANGED = "hrm_recruit_interview_arranged"; // 招聘面试安排通知
+    String EMPLOYEE_OPENED = "hrm_employee_opened"; // 员工端开通通知
+    String EMPLOYEE_ARCHIVE_FILL = "hrm_employee_archive_fill"; // 填写员工档案通知
+    String INSURANCE_MONTH_RECORD_CREATED = "hrm_insurance_month_record_created"; // 月度社保表生成通知
+    String PERFORMANCE_TASK_PENDING = "hrm_performance_task_pending"; // 绩效待办通知
+    String PERFORMANCE_PROCESS_RESULT = "hrm_performance_process_result"; // 绩效处理结果通知
+    String SALARY_SLIP_SENT = "hrm_salary_slip_sent"; // 工资条发放通知
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceAbsenteeismDeductMethodEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceAbsenteeismDeductMethodEnum.java
new file mode 100644
index 0000000..05031da
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceAbsenteeismDeductMethodEnum.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤旷工扣款方式
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceAbsenteeismDeductMethodEnum implements ArrayValuable<Integer> {
+
+    BY_DAY(1, "按旷工天数扣款");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceAbsenteeismDeductMethodEnum::getMethod).toArray(Integer[]::new);
+
+    private final Integer method;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceAbsenteeismDeductMethodEnum valueOf(Integer method) {
+        return ArrayUtil.firstMatch(item -> item.getMethod().equals(method), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceHolidayTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceHolidayTypeEnum.java
new file mode 100644
index 0000000..8f2a9c4
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceHolidayTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤节假日类型
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceHolidayTypeEnum implements ArrayValuable<Integer> {
+
+    WORK(1, "上班"),
+    REST(2, "休息");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceHolidayTypeEnum::getType).toArray(Integer[]::new);
+
+    private final Integer type;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceHolidayTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceLateEarlyDeductMethodEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceLateEarlyDeductMethodEnum.java
new file mode 100644
index 0000000..3501f8b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceLateEarlyDeductMethodEnum.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤迟到早退扣款方式
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceLateEarlyDeductMethodEnum implements ArrayValuable<Integer> {
+
+    FIXED_MONTH(1, "每月固定扣款"),
+    BY_MINUTE(2, "按分钟扣款"),
+    BY_COUNT(3, "按次数扣款");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceLateEarlyDeductMethodEnum::getMethod).toArray(Integer[]::new);
+
+    private final Integer method;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceLateEarlyDeductMethodEnum valueOf(Integer method) {
+        return ArrayUtil.firstMatch(item -> item.getMethod().equals(method), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceMisscardDeductMethodEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceMisscardDeductMethodEnum.java
new file mode 100644
index 0000000..7a5d733
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/config/HrmAttendanceMisscardDeductMethodEnum.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤缺卡扣款方式
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceMisscardDeductMethodEnum implements ArrayValuable<Integer> {
+
+    BY_COUNT(1, "按缺卡次数扣款");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceMisscardDeductMethodEnum::getMethod).toArray(Integer[]::new);
+
+    private final Integer method;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceMisscardDeductMethodEnum valueOf(Integer method) {
+        return ArrayUtil.firstMatch(item -> item.getMethod().equals(method), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockButtonStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockButtonStatusEnum.java
new file mode 100644
index 0000000..85b0229
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockButtonStatusEnum.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.record;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工端打卡按钮状态
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceClockButtonStatusEnum implements ArrayValuable<Integer> {
+
+    NOT_YET(0, "未到时间", false),
+    NORMAL(1, "正常打卡", true),
+    UPDATE(2, "更新打卡", true),
+    LATE(3, "迟到打卡", true),
+    EARLY(4, "早退打卡", true);
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceClockButtonStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名字
+     */
+    private final String name;
+    /**
+     * 是否可以打卡
+     */
+    private final boolean canClock;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceClockButtonStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockSourceEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockSourceEnum.java
new file mode 100644
index 0000000..1d126ac
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockSourceEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.record;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤打卡来源
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceClockSourceEnum implements ArrayValuable<Integer> {
+
+    MOBILE(1, "手机端"),
+    MANUAL(2, "手工录入");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceClockSourceEnum::getSource).toArray(Integer[]::new);
+
+    /**
+     * 来源
+     */
+    private final Integer source;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceClockSourceEnum valueOf(Integer source) {
+        return ArrayUtil.firstMatch(item -> item.getSource().equals(source), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockStageEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockStageEnum.java
new file mode 100644
index 0000000..c1d4975
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockStageEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.record;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤打卡阶段枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceClockStageEnum implements ArrayValuable<Integer> {
+
+    FIRST(1, "第一段");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceClockStageEnum::getStage).toArray(Integer[]::new);
+
+    /**
+     * 阶段
+     */
+    private final Integer stage;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceClockStageEnum valueOf(Integer stage) {
+        return ArrayUtil.firstMatch(item -> item.getStage().equals(stage), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockStatusEnum.java
new file mode 100644
index 0000000..a58eca9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockStatusEnum.java
@@ -0,0 +1,39 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.record;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤打卡状态
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceClockStatusEnum implements ArrayValuable<Integer> {
+
+    NORMAL(0, "正常"),
+    LATE(1, "迟到"),
+    EARLY(2, "早退"),
+    MISS_CARD(3, "缺卡");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceClockStatusEnum::getStatus).toArray(Integer[]::new);
+
+    private final Integer status;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceClockStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockTypeEnum.java
new file mode 100644
index 0000000..b943c5c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/record/HrmAttendanceClockTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.record;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 考勤打卡类型
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceClockTypeEnum implements ArrayValuable<Integer> {
+
+    ON_DUTY(1, "上班打卡"),
+    OFF_DUTY(2, "下班打卡");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmAttendanceClockTypeEnum::getType).toArray(Integer[]::new);
+
+    private final Integer type;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmAttendanceClockTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/statistics/HrmAttendanceResultEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/statistics/HrmAttendanceResultEnum.java
new file mode 100644
index 0000000..d93083a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/attendance/statistics/HrmAttendanceResultEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.hrm.enums.attendance.statistics;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * HRM 考勤结果枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmAttendanceResultEnum {
+
+    NOT_SCHEDULED("未排班"),
+    REST("休息"),
+    FUTURE("未到日期"),
+    LEAVE("请假"),
+    LEAVE_DAYS("请假 %s 天"),
+    ABSENTEEISM("旷工"),
+    ABSENTEEISM_DAYS("旷工 %s 天"),
+    MISS_CARD("缺卡 %s 次"),
+    LATE("迟到 %s 分钟"),
+    EARLY("早退 %s 分钟"),
+    PENDING_CLOCK("待打卡"),
+    NORMAL("正常");
+
+    /**
+     * 结果格式
+     */
+    private final String format;
+
+    public String format(Object... args) {
+        return String.format(format, args);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/common/HrmBizTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/common/HrmBizTypeEnum.java
new file mode 100644
index 0000000..a23e4c9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/common/HrmBizTypeEnum.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.hrm.enums.common;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.Getter;
+import lombok.RequiredArgsConstructor;
+
+import java.util.Arrays;
+
+/**
+ * HRM 业务类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@RequiredArgsConstructor
+public enum HrmBizTypeEnum implements ArrayValuable<Integer> {
+
+    RECRUIT_POST(1, "招聘职位"),
+    RECRUIT_CANDIDATE(2, "招聘候选人"),
+    EMPLOYEE(3, "员工档案"),
+    PERFORMANCE_ASSESSMENT(4, "绩效考核"),
+    PERFORMANCE_PLAN(5, "绩效计划");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmBizTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/config/HrmConfigTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/config/HrmConfigTypeEnum.java
new file mode 100644
index 0000000..ac60d15
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/config/HrmConfigTypeEnum.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.enums.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 业务配置类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmConfigTypeEnum implements ArrayValuable<Integer> {
+
+    RECRUIT_ELIMINATE(1, "招聘淘汰原因"),
+    EMPLOYEE_CREATE_ACTIVE_FIELD(2, "新建在职员工字段"),
+    EMPLOYEE_CREATE_PENDING_FIELD(3, "新建待入职员工字段"),
+    EMPLOYEE_ARCHIVE_FIELD(4, "员工档案字段");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmConfigTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmConfigTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/config/HrmEmployeeArchiveFieldEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/config/HrmEmployeeArchiveFieldEnum.java
new file mode 100644
index 0000000..719ead8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/config/HrmEmployeeArchiveFieldEnum.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * HRM 员工档案字段枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeArchiveFieldEnum {
+
+    NAME("name", "员工姓名", "基本信息", true, true, false),
+    COUNTRY("country", "国家或地区", "基本信息", true, true, false),
+    NATION("nation", "民族", "基本信息", true, true, false),
+    ID_TYPE("idType", "证件类型", "基本信息", true, true, false),
+    ID_NUMBER("idNumber", "证件号码", "基本信息", true, true, false),
+    SEX("sex", "性别", "基本信息", true, true, false),
+    NATIVE_PLACE("nativePlace", "籍贯", "基本信息", true, true, false),
+    BIRTHDAY("birthday", "出生日期", "基本信息", true, true, false),
+    AGE("age", "年龄", "基本信息", true, false, true),
+    HIGHEST_EDUCATION("highestEducation", "最高学历", "基本信息", true, true, false),
+
+    MOBILE("mobile", "手机号", "通讯信息", true, true, false),
+    EMAIL("email", "邮箱", "通讯信息", true, true, false),
+    ADDRESS("address", "户籍地址", "通讯信息", true, true, false);
+
+    /**
+     * 字段名称
+     */
+    private final String name;
+    /**
+     * 字段标题
+     */
+    private final String title;
+    /**
+     * 字段分组名称
+     */
+    private final String groupName;
+    /**
+     * 默认是否显示
+     */
+    private final Boolean defaultVisible;
+    /**
+     * 默认是否允许员工编辑
+     */
+    private final Boolean defaultEditable;
+    /**
+     * 是否锁定编辑
+     */
+    private final Boolean editableLocked;
+
+    public static HrmEmployeeArchiveFieldEnum valueOfName(String name) {
+        return ArrayUtil.firstMatch(item -> item.getName().equals(name), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/config/HrmEmployeeCreateFieldEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/config/HrmEmployeeCreateFieldEnum.java
new file mode 100644
index 0000000..64409fd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/config/HrmEmployeeCreateFieldEnum.java
@@ -0,0 +1,110 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.config;
+
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.hutool.core.util.ArrayUtil;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * HRM 新建员工字段枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeCreateFieldEnum {
+
+    NAME("name", "员工姓名", "个人信息", true, true, true, true),
+    USER_ID("userId", "绑定用户", "个人信息", true, false, true, false),
+    MOBILE("mobile", "手机号", "个人信息", true, true, true, true),
+    EMAIL("email", "邮箱", "个人信息", true, false, true, false),
+    COUNTRY("country", "国家或地区", "个人信息", false, false, false, false),
+    NATION("nation", "民族", "个人信息", false, false, false, false),
+    ID_TYPE("idType", "证件类型", "个人信息", true, false, true, false),
+    ID_NUMBER("idNumber", "证件号码", "个人信息", true, false, true, false),
+    SEX("sex", "性别", "个人信息", true, false, true, false),
+    NATIVE_PLACE("nativePlace", "籍贯", "个人信息", false, false, false, false),
+    BIRTHDAY("birthday", "出生日期", "个人信息", false, false, false, false),
+    AGE("age", "年龄", "个人信息", false, false, false, false),
+    HIGHEST_EDUCATION("highestEducation", "最高学历", "个人信息", false, false, false, false),
+    ADDRESS("address", "户籍地址", "个人信息", false, false, false, false),
+
+    JOB_NUMBER("jobNumber", "工号", "入职信息", true, true, false, false),
+    ENTRY_STATUS("entryStatus", "入职状态", "入职信息", true, true, true, true),
+    DEPT_ID("deptId", "部门", "入职信息", true, false, true, false),
+    POST_NAME("postName", "职位名称", "入职信息", true, false, true, false),
+    POST_LEVEL("postLevel", "岗位职级", "入职信息", false, false, false, false),
+    LEADER_EMPLOYEE_ID("leaderEmployeeId", "直属上级", "入职信息", true, false, true, false),
+    CHANNEL_ID("channelId", "招聘渠道", "入职信息", false, false, false, false),
+    TYPE("type", "聘用形式", "入职信息", true, true, true, true),
+    STATUS("status", "员工状态", "入职信息", true, true, true, true),
+    ENTRY_TIME("entryTime", "入职时间", "入职信息", true, true, true, true),
+    PROBATION("probation", "试用期（月）", "入职信息", true, true, true, true),
+    REGULAR_TIME("regularTime", "转正时间", "入职信息", false, false, false, false),
+    LEAVE_TIME("leaveTime", "离职时间", "入职信息", false, false, false, false),
+    COMPANY_AGE_START_TIME("companyAgeStartTime", "司龄起算时间", "入职信息",
+            false, false, false, false),
+    COMPANY_AGE("companyAge", "司龄（年）", "入职信息", false, false, false, false),
+    WORK_CITY("workCity", "工作城市", "入职信息", true, false, true, false),
+    WORK_ADDRESS("workAddress", "工作地点", "入职信息", false, false, false, false),
+    WORK_DETAIL_ADDRESS("workDetailAddress", "工作详细地址", "入职信息",
+            false, false, false, false),
+    CANDIDATE_ID("candidateId", "招聘候选人", "入职信息", false, false, false, false),
+    REMARK("remark", "备注", "入职信息", true, false, true, false);
+
+    /**
+     * 字段名称
+     */
+    private final String name;
+    /**
+     * 字段标题
+     */
+    private final String title;
+    /**
+     * 字段分组名称
+     */
+    private final String groupName;
+    /**
+     * 在职办理时默认是否显示
+     */
+    private final Boolean activeDefaultVisible;
+    /**
+     * 在职办理时是否锁定显示
+     */
+    private final Boolean activeVisibleLocked;
+    /**
+     * 待入职办理时默认是否显示
+     */
+    private final Boolean pendingEntryDefaultVisible;
+    /**
+     * 待入职办理时是否锁定显示
+     */
+    private final Boolean pendingEntryVisibleLocked;
+
+    public static HrmEmployeeCreateFieldEnum valueOfName(String name) {
+        return ArrayUtil.firstMatch(item -> item.getName().equals(name), values());
+    }
+
+    /**
+     * 获得指定入职状态的默认显隐值
+     *
+     * @param entryStatus 入职状态
+     * @return 默认是否显示
+     */
+    public Boolean getDefaultVisible(Integer entryStatus) {
+        return HrmEmployeeEntryStatusEnum.ACTIVE.getStatus().equals(entryStatus)
+                ? activeDefaultVisible : pendingEntryDefaultVisible;
+    }
+
+    /**
+     * 获得指定入职状态的锁定显示值
+     *
+     * @param entryStatus 入职状态
+     * @return 是否锁定显示
+     */
+    public Boolean getVisibleLocked(Integer entryStatus) {
+        return HrmEmployeeEntryStatusEnum.ACTIVE.getStatus().equals(entryStatus)
+                ? activeVisibleLocked : pendingEntryVisibleLocked;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeChangeReasonEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeChangeReasonEnum.java
new file mode 100644
index 0000000..ebbd10a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeChangeReasonEnum.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.employment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import cn.iocoder.yudao.framework.common.util.collection.SetUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+import java.util.Set;
+
+/**
+ * HRM 员工异动原因枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeChangeReasonEnum implements ArrayValuable<Integer> {
+
+    ORGANIZATION_ADJUSTMENT(1, "组织架构调整"),
+    PERSONAL_APPLICATION(2, "个人申请"),
+    WORK_ARRANGEMENT(3, "工作安排"),
+    VIOLATION(4, "违规违纪"),
+    UNDERPERFORMANCE(5, "绩效不达标"),
+    HEALTH_REASON(6, "个人身体原因"),
+    UNSUITABLE_POSITION(7, "不适应当前岗位");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeChangeReasonEnum::getReason).toArray(Integer[]::new);
+
+    /**
+     * 调岗、晋升原因
+     */
+    public static final Set<Integer> TRANSFER_AND_PROMOTION_REASONS = SetUtils.asSet(
+            ORGANIZATION_ADJUSTMENT.getReason(), PERSONAL_APPLICATION.getReason(), WORK_ARRANGEMENT.getReason());
+
+    /**
+     * 降级原因
+     */
+    public static final Set<Integer> DEMOTION_REASONS = SetUtils.asSet(
+            VIOLATION.getReason(), UNDERPERFORMANCE.getReason(), HEALTH_REASON.getReason(),
+            UNSUITABLE_POSITION.getReason());
+
+    /**
+     * 原因
+     */
+    private final Integer reason;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeChangeReasonEnum valueOf(Integer reason) {
+        return ArrayUtil.firstMatch(item -> item.getReason().equals(reason), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeChangeTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeChangeTypeEnum.java
new file mode 100644
index 0000000..8f2189c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeChangeTypeEnum.java
@@ -0,0 +1,55 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.employment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import cn.iocoder.yudao.framework.common.util.collection.SetUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+import java.util.Set;
+
+/**
+ * HRM 员工异动类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeChangeTypeEnum implements ArrayValuable<Integer> {
+
+    REGULAR(4, "转正"),
+    TRANSFER(5, "调岗"),
+    PROMOTION(6, "晋升"),
+    DEMOTION(7, "降级"),
+    FULL_TIME(8, "转为全职"),
+    REHIRE(9, "再入职");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeChangeTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 需要预约生效的异动类型集合
+     */
+    public static final Set<Integer> PENDING_EFFECT_TYPES = SetUtils.asSet(
+            REGULAR.getType(), TRANSFER.getType(), PROMOTION.getType(), DEMOTION.getType(), FULL_TIME.getType());
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeChangeTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeContractStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeContractStatusEnum.java
new file mode 100644
index 0000000..803ad76
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeContractStatusEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.employment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工合同状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeContractStatusEnum implements ArrayValuable<Integer> {
+
+    NOT_PERFORMED(0, "未执行"),
+    IN_PROGRESS(1, "执行中"),
+    EXPIRED(2, "已到期");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeContractStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeContractStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeContractTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeContractTypeEnum.java
new file mode 100644
index 0000000..c6cbd03
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeContractTypeEnum.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.employment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工合同类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeContractTypeEnum implements ArrayValuable<Integer> {
+
+    FIXED_TERM_LABOR_CONTRACT(1, "固定期限劳动合同"),
+    NON_FIXED_TERM_LABOR_CONTRACT(2, "无固定期限劳动合同"),
+    WORK_TASK_LABOR_CONTRACT(3, "以完成一定工作任务为期限的劳动合同"),
+    INTERNSHIP_AGREEMENT(4, "实习协议"),
+    LABOR_SERVICE_CONTRACT(5, "劳务合同"),
+    REEMPLOYMENT_AGREEMENT(6, "返聘协议"),
+    LABOR_DISPATCH_CONTRACT(7, "劳务派遣合同"),
+    SECONDMENT_CONTRACT(8, "借调合同"),
+    OTHER(9, "其他");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeContractTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeContractTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeQuitReasonEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeQuitReasonEnum.java
new file mode 100644
index 0000000..76698b6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeQuitReasonEnum.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.employment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工离职原因枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeQuitReasonEnum implements ArrayValuable<Integer> {
+
+    FAMILY(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 1, "家庭原因"),
+    HEALTH(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 2, "身体原因"),
+    SALARY(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 3, "薪资原因"),
+    INCONVENIENT_TRAFFIC(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 4, "交通不便"),
+    WORK_PRESSURE(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 5, "工作压力"),
+    MANAGEMENT_ISSUE(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 6, "管理问题"),
+    NO_PROMOTION_OPPORTUNITY(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 7, "无晋升机会"),
+    CAREER_PLANNING(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 8, "职业规划"),
+    GIVE_UP_RENEWAL(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 9, "合同到期放弃续签"),
+    OTHER_PERSONAL_REASON(HrmEmployeeQuitTypeEnum.VOLUNTARY.getType(), 10, "其他个人原因"),
+    TRIAL_PERIOD_DISMISSAL(HrmEmployeeQuitTypeEnum.INVOLUNTARY.getType(), 11, "试用期内辞退"),
+    VIOLATION(HrmEmployeeQuitTypeEnum.INVOLUNTARY.getType(), 12, "违反公司条例"),
+    LAYOFF(HrmEmployeeQuitTypeEnum.INVOLUNTARY.getType(), 13, "组织调整/裁员"),
+    UNDERPERFORMANCE(HrmEmployeeQuitTypeEnum.INVOLUNTARY.getType(), 14, "绩效不达标辞退"),
+    CONTRACT_NOT_RENEWED(HrmEmployeeQuitTypeEnum.INVOLUNTARY.getType(), 15, "合同到期不续签"),
+    OTHER_INVOLUNTARY_REASON(HrmEmployeeQuitTypeEnum.INVOLUNTARY.getType(), 16, "其他原因");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeQuitReasonEnum::getReason).toArray(Integer[]::new);
+
+    /**
+     * 离职类型
+     *
+     * 枚举 {@link HrmEmployeeQuitTypeEnum}
+     */
+    private final Integer quitType;
+    /**
+     * 原因
+     */
+    private final Integer reason;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeQuitReasonEnum valueOf(Integer reason) {
+        return ArrayUtil.firstMatch(item -> item.getReason().equals(reason), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeQuitTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeQuitTypeEnum.java
new file mode 100644
index 0000000..37cffcd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/employment/HrmEmployeeQuitTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.employment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工离职类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeQuitTypeEnum implements ArrayValuable<Integer> {
+
+    VOLUNTARY(1, "主动离职"),
+    INVOLUNTARY(2, "被动离职"),
+    RETIREMENT(3, "退休");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeQuitTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeQuitTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/experience/HrmEmployeeEducationEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/experience/HrmEmployeeEducationEnum.java
new file mode 100644
index 0000000..e80c148
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/experience/HrmEmployeeEducationEnum.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.experience;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工学历枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeEducationEnum implements ArrayValuable<Integer> {
+
+    PRIMARY_SCHOOL(1, "小学"),
+    JUNIOR_HIGH_SCHOOL(2, "初中"),
+    SECONDARY_TECHNICAL_SCHOOL(3, "中专"),
+    SECONDARY_VOCATIONAL_SCHOOL(4, "中职"),
+    TECHNICAL_SCHOOL(5, "技校"),
+    HIGH_SCHOOL(6, "高中"),
+    COLLEGE(7, "大专"),
+    BACHELOR(8, "本科"),
+    MASTER(9, "硕士"),
+    DOCTOR(10, "博士"),
+    POSTDOCTORAL(11, "博士后"),
+    OTHER(12, "其他");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeEducationEnum::getEducation).toArray(Integer[]::new);
+
+    /**
+     * 学历
+     */
+    private final Integer education;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeEducationEnum valueOf(Integer education) {
+        return ArrayUtil.firstMatch(item -> item.getEducation().equals(education), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/experience/HrmEmployeeTeachingMethodEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/experience/HrmEmployeeTeachingMethodEnum.java
new file mode 100644
index 0000000..7492b4d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/experience/HrmEmployeeTeachingMethodEnum.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.experience;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工教育经历教学方式枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeTeachingMethodEnum implements ArrayValuable<Integer> {
+
+    FULL_TIME(1, "全日制"),
+    ADULT_EDUCATION(2, "成人教育"),
+    DISTANCE_EDUCATION(3, "远程教育"),
+    SELF_STUDY_EXAMINATION(4, "自学考试"),
+    OTHER(5, "其他");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeTeachingMethodEnum::getMethod).toArray(Integer[]::new);
+
+    /**
+     * 教学方式
+     */
+    private final Integer method;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeTeachingMethodEnum valueOf(Integer method) {
+        return ArrayUtil.firstMatch(item -> item.getMethod().equals(method), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeEntryStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeEntryStatusEnum.java
new file mode 100644
index 0000000..78895cb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeEntryStatusEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import cn.iocoder.yudao.framework.common.util.collection.SetUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+import java.util.Set;
+
+/**
+ * HRM 员工入职状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeEntryStatusEnum implements ArrayValuable<Integer> {
+
+    ACTIVE(1, "在职"),
+    PENDING_ENTRY(2, "待入职"),
+    PENDING_LEAVE(3, "待离职"),
+    LEFT(4, "离职");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeEntryStatusEnum::getStatus).toArray(Integer[]::new);
+
+    public static final Set<Integer> ACTIVE_STATUSES = SetUtils.asSet(
+            ACTIVE.getStatus(), PENDING_LEAVE.getStatus());
+
+    private final Integer status;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeEntryStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeFileTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeFileTypeEnum.java
new file mode 100644
index 0000000..b92b133
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeFileTypeEnum.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工材料附件类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeFileTypeEnum implements ArrayValuable<Integer> {
+
+    ID_CARD_ORIGINAL(11, "身份证原件照片"),
+    EDUCATION_CERTIFICATE(12, "学历证明"),
+    PROFILE_PHOTO(13, "个人证件照"),
+    ID_CARD_COPY(14, "身份证复印件"),
+    SALARY_BANK_CARD(15, "工资银行卡"),
+    SOCIAL_SECURITY_CARD(16, "社保卡"),
+    HOUSING_FUND_CARD(17, "公积金卡"),
+    AWARD_CERTIFICATE(18, "获奖证书"),
+    BASIC_OTHER(19, "其他基本资料"),
+    LABOR_CONTRACT(21, "劳动合同"),
+    ENTRY_RESUME(22, "入职简历"),
+    ENTRY_REGISTRATION(23, "入职登记表"),
+    ENTRY_MEDICAL_REPORT(24, "入职体检单"),
+    PREVIOUS_LEAVE_CERTIFICATE(25, "上家公司离职证明"),
+    REGULAR_APPLICATION(26, "转正申请表"),
+    ARCHIVE_OTHER(27, "其他档案资料"),
+    LEAVE_APPROVAL(31, "离职审批"),
+    LEAVE_CERTIFICATE(32, "离职证明"),
+    LEAVE_OTHER(33, "其他离职资料");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeFileTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeFileTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeIdTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeIdTypeEnum.java
new file mode 100644
index 0000000..be23574
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeIdTypeEnum.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工证件类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeIdTypeEnum implements ArrayValuable<Integer> {
+
+    ID_CARD(1, "身份证"),
+    HONG_KONG_MACAO_PASS(2, "港澳通行证"),
+    TAIWAN_PASS(3, "台湾通行证"),
+    PASSPORT(4, "护照"),
+    OTHER(5, "其他");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeIdTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeIdTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeImportDuplicateStrategyEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeImportDuplicateStrategyEnum.java
new file mode 100644
index 0000000..f25989f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeImportDuplicateStrategyEnum.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工导入重复数据处理策略枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeImportDuplicateStrategyEnum implements ArrayValuable<Integer> {
+
+    SKIP(1, "跳过"),
+    UPDATE(2, "覆盖"),
+    FAIL(3, "判失败");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeImportDuplicateStrategyEnum::getStrategy).toArray(Integer[]::new);
+
+    private final Integer strategy;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeImportDuplicateStrategyEnum valueOf(Integer strategy) {
+        return ArrayUtil.firstMatch(item -> item.getStrategy().equals(strategy), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeStatusEnum.java
new file mode 100644
index 0000000..f2071fb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeStatusEnum.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import cn.iocoder.yudao.framework.common.util.collection.SetUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+import java.util.Set;
+
+/**
+ * HRM 员工状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeStatusEnum implements ArrayValuable<Integer> {
+
+    REGULAR(1, HrmEmployeeTypeEnum.FORMAL.getType(), "正式"),
+    PROBATION(2, HrmEmployeeTypeEnum.FORMAL.getType(), "试用"),
+    INTERN(3, HrmEmployeeTypeEnum.INFORMAL.getType(), "实习"),
+    PART_TIME(4, HrmEmployeeTypeEnum.INFORMAL.getType(), "兼职"),
+    LABOR(5, HrmEmployeeTypeEnum.INFORMAL.getType(), "劳务"),
+    CONSULTANT(6, HrmEmployeeTypeEnum.INFORMAL.getType(), "顾问"),
+    REHIRE(7, HrmEmployeeTypeEnum.INFORMAL.getType(), "返聘"),
+    OUTSOURCE(8, HrmEmployeeTypeEnum.INFORMAL.getType(), "外包");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 正式员工状态集合
+     */
+    public static final Set<Integer> FULL_TIME_STATUSES = SetUtils.asSet(
+            REGULAR.getStatus(), PROBATION.getStatus());
+
+    /**
+     * 非正式员工状态集合
+     */
+    public static final Set<Integer> INFORMAL_STATUSES = SetUtils.asSet(
+            INTERN.getStatus(), PART_TIME.getStatus(), LABOR.getStatus(),
+            CONSULTANT.getStatus(), REHIRE.getStatus(), OUTSOURCE.getStatus());
+
+    /**
+     * 可转为全职的员工状态集合
+     */
+    public static final Set<Integer> CONVERTIBLE_TO_FULL_TIME_STATUSES = SetUtils.asSet(
+            INTERN.getStatus(), PART_TIME.getStatus());
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 聘用形式
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeStatusTabEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeStatusTabEnum.java
new file mode 100644
index 0000000..bab513e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeStatusTabEnum.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工状态页签枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeStatusTabEnum implements ArrayValuable<Integer> {
+
+    REGULAR(HrmEmployeeStatusEnum.REGULAR.getStatus(), "正式"),
+    PROBATION(HrmEmployeeStatusEnum.PROBATION.getStatus(), "试用"),
+    INTERN(HrmEmployeeStatusEnum.INTERN.getStatus(), "实习"),
+    PART_TIME(HrmEmployeeStatusEnum.PART_TIME.getStatus(), "兼职"),
+    LABOR(HrmEmployeeStatusEnum.LABOR.getStatus(), "劳务"),
+    CONSULTANT(HrmEmployeeStatusEnum.CONSULTANT.getStatus(), "顾问"),
+    REHIRE(HrmEmployeeStatusEnum.REHIRE.getStatus(), "返聘"),
+    OUTSOURCE(HrmEmployeeStatusEnum.OUTSOURCE.getStatus(), "外包"),
+    ACTIVE(11, "在职"),
+    FULL_TIME(12, "全职"),
+    PENDING_ENTRY(13, "待入职"),
+    PENDING_LEAVE(14, "待离职"),
+    LEFT(15, "已离职");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeStatusTabEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态页签
+     */
+    private final Integer status;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeStatusTabEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeSurveyTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeSurveyTypeEnum.java
new file mode 100644
index 0000000..49a2c11
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeSurveyTypeEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 首页人事概况筛选类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeSurveyTypeEnum implements ArrayValuable<Integer> {
+
+    ENTRY(1, "入职"),
+    LEAVE(2, "离职"),
+    REGULAR(3, "转正"),
+    TRANSFER(4, "调岗"),
+    PENDING_ENTRY(5, "待入职"),
+    PENDING_LEAVE(6, "待离职");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeSurveyTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeTodoTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeTodoTypeEnum.java
new file mode 100644
index 0000000..ca00324
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeTodoTypeEnum.java
@@ -0,0 +1,37 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工待办筛选类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeTodoTypeEnum implements ArrayValuable<Integer> {
+
+    PENDING_LEAVE(2), // 待离职
+    CONTRACT_EXPIRE(3), // 合同到期
+    REGULAR(4), // 待转正
+    PENDING_ENTRY(5), // 待入职
+    BIRTHDAY(6); // 员工生日
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeTodoTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeTypeEnum.java
new file mode 100644
index 0000000..9ba2bc7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/employee/info/HrmEmployeeTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.employee.info;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmEmployeeTypeEnum implements ArrayValuable<Integer> {
+
+    FORMAL(1, "正式"),
+    INFORMAL(2, "非正式");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmEmployeeTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmEmployeeTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeAgeRangeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeAgeRangeEnum.java
new file mode 100644
index 0000000..fb02f75
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeAgeRangeEnum.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.enums.home;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 团队工作台年龄区间枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmHomeAgeRangeEnum implements ArrayValuable<Integer> {
+
+    UNDER_18(1, "17 以下", 17),
+    AGE_18_TO_25(2, "18 至 25", 25),
+    AGE_26_TO_35(3, "26 至 35", 35),
+    AGE_36_TO_45(4, "36 至 45", 45),
+    AGE_46_TO_55(5, "46 至 55", 55),
+    AGE_56_AND_ABOVE(6, "56 以上", Integer.MAX_VALUE);
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmHomeAgeRangeEnum::getType).toArray(Integer[]::new);
+
+    private final Integer type;
+    private final String name;
+    private final Integer maximumAge;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    /**
+     * 根据年龄获得区间类型
+     *
+     * @param age 年龄
+     * @return 区间类型；年龄未填写或非法时返回 {@code null}
+     */
+    public static Integer getType(Integer age) {
+        if (age == null || age < 0) {
+            return null;
+        }
+        return Arrays.stream(values()).filter(item -> age <= item.maximumAge)
+                .findFirst().map(HrmHomeAgeRangeEnum::getType).orElse(null);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeCalendarItemTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeCalendarItemTypeEnum.java
new file mode 100644
index 0000000..237b800
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeCalendarItemTypeEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.home;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 首页日历事项类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmHomeCalendarItemTypeEnum implements ArrayValuable<Integer> {
+
+    NOTE(1, "备忘"),
+    BIRTHDAY(2, "生日"),
+    ENTRY(3, "入职"),
+    REGULAR(4, "转正"),
+    LEAVE(5, "离职"),
+    RECRUIT(6, "招聘"),
+    ATTENDANCE(7, "考勤");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmHomeCalendarItemTypeEnum::getType).toArray(Integer[]::new);
+
+    private final Integer type;
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmHomeCalendarItemTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeCompanyAgeRangeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeCompanyAgeRangeEnum.java
new file mode 100644
index 0000000..83a63b9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/home/HrmHomeCompanyAgeRangeEnum.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.hrm.enums.home;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 团队工作台司龄区间枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmHomeCompanyAgeRangeEnum implements ArrayValuable<Integer> {
+
+    WITHIN_3_MONTHS(1, "3 个月内", 89L),
+    MONTHS_3_TO_6(2, "3 至 6 个月", 179L),
+    MONTHS_6_TO_1_YEAR(3, "6 个月至 1 年", 364L),
+    YEARS_1_TO_3(4, "1 至 3 年", 1094L),
+    YEARS_3_TO_5(5, "3 至 5 年", 1824L),
+    YEARS_5_TO_10(6, "5 至 10 年", 3649L),
+    YEARS_10_AND_ABOVE(7, "10 年以上", Long.MAX_VALUE);
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmHomeCompanyAgeRangeEnum::getType).toArray(Integer[]::new);
+
+    private final Integer type;
+    private final String name;
+    private final Long maximumDays;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    /**
+     * 根据司龄天数获得区间类型
+     *
+     * @param companyAgeDays 司龄天数
+     * @return 区间类型；司龄未填写或非法时返回 {@code null}
+     */
+    public static Integer getType(Long companyAgeDays) {
+        if (companyAgeDays == null || companyAgeDays < 0) {
+            return null;
+        }
+        return Arrays.stream(values()).filter(item -> companyAgeDays <= item.maximumDays)
+                .findFirst().map(HrmHomeCompanyAgeRangeEnum::getType).orElse(null);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/config/HrmInsuranceProjectTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/config/HrmInsuranceProjectTypeEnum.java
new file mode 100644
index 0000000..adff4bb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/config/HrmInsuranceProjectTypeEnum.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.enums.insurance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 社保项目类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmInsuranceProjectTypeEnum implements ArrayValuable<Integer> {
+
+    PENSION_INSURANCE(1, "养老保险"),
+    MEDICAL_INSURANCE(2, "医疗保险"),
+    UNEMPLOYMENT_INSURANCE(3, "失业保险"),
+    WORK_INJURY_INSURANCE(4, "工伤保险"),
+    MATERNITY_INSURANCE(5, "生育保险"),
+    SUPPLEMENTARY_MEDICAL_INSURANCE(6, "补充大病医疗"),
+    SUPPLEMENTARY_PENSION_INSURANCE(7, "补充养老"),
+    DISABILITY_INSURANCE(8, "残保金"),
+    SOCIAL_SECURITY_CUSTOM(9, "社保自定义"),
+    PROVIDENT_FUND(10, "公积金"),
+    PROVIDENT_FUND_CUSTOM(11, "公积金自定义");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmInsuranceProjectTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public boolean isSocialSecurity() {
+        return !isProvidentFund();
+    }
+
+    public boolean isProvidentFund() {
+        return this == PROVIDENT_FUND || this == PROVIDENT_FUND_CUSTOM;
+    }
+
+    public boolean isCustom() {
+        return this == SOCIAL_SECURITY_CUSTOM || this == PROVIDENT_FUND_CUSTOM;
+    }
+
+    public static HrmInsuranceProjectTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+    public static boolean isSocialSecurity(Integer type) {
+        HrmInsuranceProjectTypeEnum typeEnum = valueOf(type);
+        return typeEnum != null && typeEnum.isSocialSecurity();
+    }
+
+    public static boolean isProvidentFund(Integer type) {
+        HrmInsuranceProjectTypeEnum typeEnum = valueOf(type);
+        return typeEnum != null && typeEnum.isProvidentFund();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/config/HrmInsuranceSchemeTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/config/HrmInsuranceSchemeTypeEnum.java
new file mode 100644
index 0000000..7aeb61d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/config/HrmInsuranceSchemeTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.insurance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 社保方案类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmInsuranceSchemeTypeEnum implements ArrayValuable<Integer> {
+
+    PROPORTION(1, "比例"),
+    AMOUNT(2, "金额");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmInsuranceSchemeTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmInsuranceSchemeTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/employee/HrmInsuranceEmployeeStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/employee/HrmInsuranceEmployeeStatusEnum.java
new file mode 100644
index 0000000..e30e0ff
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/employee/HrmInsuranceEmployeeStatusEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.insurance.employee;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工参保状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmInsuranceEmployeeStatusEnum implements ArrayValuable<Integer> {
+
+    STOPPED(0, "停保"),
+    NORMAL(1, "正常");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmInsuranceEmployeeStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmInsuranceEmployeeStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/monthrecord/HrmInsuranceMonthStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/monthrecord/HrmInsuranceMonthStatusEnum.java
new file mode 100644
index 0000000..55e7601
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/insurance/monthrecord/HrmInsuranceMonthStatusEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.insurance.monthrecord;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 社保月度记录状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmInsuranceMonthStatusEnum implements ArrayValuable<Integer> {
+
+    UNARCHIVED(0, "未归档"),
+    ARCHIVED(1, "已归档");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmInsuranceMonthStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmInsuranceMonthStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealRecordStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealRecordStatusEnum.java
new file mode 100644
index 0000000..a84faf5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealRecordStatusEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效申诉记录处理状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceAppealRecordStatusEnum implements ArrayValuable<Integer> {
+
+    NOT_PROCESSED(0, "未处理"),
+    PROCESSED(1, "已处理");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceAppealRecordStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceAppealRecordStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealStatusEnum.java
new file mode 100644
index 0000000..e7aeb65
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealStatusEnum.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效申诉状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceAppealStatusEnum implements ArrayValuable<Integer> {
+
+    NONE(0, "无申诉"),
+    PENDING(1, "待处理"),
+    PASS(2, "已通过"),
+    REJECT(3, "已驳回"),
+    CANCEL(4, "已取消");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceAppealStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceAppealStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealTimeoutActionEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealTimeoutActionEnum.java
new file mode 100644
index 0000000..e9aacf3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAppealTimeoutActionEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效申诉超期处理动作枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceAppealTimeoutActionEnum implements ArrayValuable<Integer> {
+
+    REJECT(1, "自动拒绝"),
+    APPROVE(2, "自动通过");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceAppealTimeoutActionEnum::getAction).toArray(Integer[]::new);
+
+    /**
+     * 动作
+     */
+    private final Integer action;
+    /**
+     * 名称
+     */
+    private final String name;
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceAppealTimeoutActionEnum valueOf(Integer action) {
+        return ArrayUtil.firstMatch(item -> item.getAction().equals(action), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentActionTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentActionTypeEnum.java
new file mode 100644
index 0000000..772476b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentActionTypeEnum.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工绩效考核动作类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceAssessmentActionTypeEnum implements ArrayValuable<Integer> {
+
+    FILL_QUOTA(1, "提交绩效指标", "填写并提交了绩效指标"), // 填写考核指标
+    CONFIRM_TARGET(2, "确认绩效目标", "确认了绩效目标%s"), // 确认考核目标
+    REJECT_TARGET(3, "驳回绩效目标", "驳回了绩效目标%s"), // 驳回考核目标
+    SCORE(4, "提交绩效评分", "填写并提交了评分，阶段得分：%s%s"), // 绩效评分
+    REJECT_SCORE(5, "驳回绩效评分", "驳回到【%s】，原因：%s"), // 驳回绩效评分
+    CONFIRM_RESULT(6, "确认绩效结果", "确认了绩效结果%s"), // 确认绩效结果
+    SUBMIT_APPEAL(7, "提交绩效申诉", "提交了绩效申诉，原因：%s"), // 提交绩效申诉
+    PASS_RESULT_AUDIT(8, "通过绩效结果审核", "通过了绩效结果审核%s"), // 通过结果审核
+    REJECT_RESULT_AUDIT(9, "驳回绩效结果审核", "驳回了绩效结果审核%s"), // 驳回结果审核
+    PASS_APPEAL(10, "通过绩效申诉", "通过了绩效申诉%s"), // 通过绩效申诉
+    REJECT_APPEAL(11, "驳回绩效申诉", "驳回了绩效申诉%s"), // 驳回绩效申诉
+    APPEAL_TIMEOUT_PASS(12, "自动通过绩效申诉", "通过了绩效申诉%s"), // 超时自动通过申诉
+    APPEAL_TIMEOUT_REJECT(13, "自动驳回绩效申诉", "驳回了绩效申诉%s"), // 超时自动驳回申诉
+    TERMINATE(14, "终止绩效考核", "终止了绩效考核"); // 终止绩效考核
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceAssessmentActionTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 动作类型
+     */
+    private final Integer type;
+    /**
+     * 动作标题
+     */
+    private final String title;
+    /**
+     * 动作内容模板
+     */
+    private final String contentTemplate;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceAssessmentActionTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+    /**
+     * 格式化动作内容
+     *
+     * @param args 内容参数
+     * @return 动作内容
+     */
+    public String formatContent(Object... args) {
+        return String.format(contentTemplate, args);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentProcessStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentProcessStatusEnum.java
new file mode 100644
index 0000000..3b6b77d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentProcessStatusEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工绩效处理状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceAssessmentProcessStatusEnum implements ArrayValuable<Integer> {
+
+    PROCESSING(1, "进行中"),
+    FINISHED(2, "已完成");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceAssessmentProcessStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceAssessmentProcessStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentStageStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentStageStatusEnum.java
new file mode 100644
index 0000000..c93a7d2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceAssessmentStageStatusEnum.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工绩效考核阶段状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceAssessmentStageStatusEnum implements ArrayValuable<Integer> {
+
+    NOT_PROCESSED(0, "未处理"),
+    PROCESSED(1, "已处理"),
+    PENDING(2, "待处理"),
+    REJECTED(3, "已驳回"),
+    PROCESSING(4, "处理中"),
+    APPEALED(5, "已申诉");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceAssessmentStageStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceAssessmentStageStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceConfirmationResultEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceConfirmationResultEnum.java
new file mode 100644
index 0000000..0f82aba
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceConfirmationResultEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效确认结果枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceConfirmationResultEnum implements ArrayValuable<Integer> {
+
+    REJECT(0, "驳回"),
+    PASS(1, "通过");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceConfirmationResultEnum::getResult).toArray(Integer[]::new);
+
+    /**
+     * 结果
+     */
+    private final Integer result;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceConfirmationResultEnum valueOf(Integer result) {
+        return ArrayUtil.firstMatch(item -> item.getResult().equals(result), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceResultAuditStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceResultAuditStatusEnum.java
new file mode 100644
index 0000000..f9b2316
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/assessment/HrmPerformanceResultAuditStatusEnum.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.assessment;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效结果审核状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceResultAuditStatusEnum implements ArrayValuable<Integer> {
+
+    PENDING(1, "审核中"),
+    PASS(2, "已通过"),
+    REJECT(3, "已驳回"),
+    CANCEL(4, "已取消");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceResultAuditStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceResultAuditStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceQuotaTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceQuotaTypeEnum.java
new file mode 100644
index 0000000..78c14f1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceQuotaTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效指标类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceQuotaTypeEnum implements ArrayValuable<Integer> {
+
+    PERFORMANCE(1, "业绩指标"),
+    BEHAVIOR(2, "行为态度指标");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceQuotaTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceQuotaTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceScoreCalculationEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceScoreCalculationEnum.java
new file mode 100644
index 0000000..14585ee
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceScoreCalculationEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效计分方式枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceScoreCalculationEnum implements ArrayValuable<Integer> {
+
+    WEIGHTED(1, "加权计算");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceScoreCalculationEnum::getCalculation).toArray(Integer[]::new);
+
+    /**
+     * 计分方式
+     */
+    private final Integer calculation;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceScoreCalculationEnum valueOf(Integer calculation) {
+        return ArrayUtil.firstMatch(item -> item.getCalculation().equals(calculation), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceUpperLimitTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceUpperLimitTypeEnum.java
new file mode 100644
index 0000000..900d3c8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/config/HrmPerformanceUpperLimitTypeEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效评分上限类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceUpperLimitTypeEnum implements ArrayValuable<Integer> {
+
+    UNIFIED(1, "统一上限");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceUpperLimitTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceUpperLimitTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceCycleTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceCycleTypeEnum.java
new file mode 100644
index 0000000..f673cdf
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceCycleTypeEnum.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效考核周期类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceCycleTypeEnum implements ArrayValuable<Integer> {
+
+    MONTH(1, "月度"),
+    QUARTER(2, "季度"),
+    FIRST_HALF_YEAR(3, "上半年"),
+    SECOND_HALF_YEAR(4, "下半年"),
+    YEAR(5, "全年"),
+    OTHER(6, "其他");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceCycleTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceCycleTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanOperationTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanOperationTypeEnum.java
new file mode 100644
index 0000000..a188c8f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanOperationTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效计划操作类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformancePlanOperationTypeEnum implements ArrayValuable<Integer> {
+
+    START_SCORING(1, "开启评分"),
+    START_INTERVIEW(2, "发起绩效面谈"),
+    ARCHIVE(3, "归档");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformancePlanOperationTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformancePlanOperationTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanScopeTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanScopeTypeEnum.java
new file mode 100644
index 0000000..d964e02
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanScopeTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效计划考评范围类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformancePlanScopeTypeEnum implements ArrayValuable<Integer> {
+
+    EMPLOYEE_DEPT(1, "员工部门"),
+    EMPLOYMENT(2, "聘用形式"),
+    EXCLUDED_EMPLOYEE(3, "排除员工");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformancePlanScopeTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformancePlanScopeTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanStatusEnum.java
new file mode 100644
index 0000000..e8215b2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformancePlanStatusEnum.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效计划状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformancePlanStatusEnum implements ArrayValuable<Integer> {
+
+    DRAFT(1, "草稿"),
+    NOT_STARTED(2, "未开始"),
+    RUNNING(3, "进行中"),
+    ARCHIVED(4, "已归档"),
+    TERMINATED(5, "已终止");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformancePlanStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformancePlanStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuarterEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuarterEnum.java
new file mode 100644
index 0000000..6c251c4
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuarterEnum.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效考核季度枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceQuarterEnum implements ArrayValuable<Integer> {
+
+    FIRST_QUARTER(1, "第一季度"),
+    SECOND_QUARTER(2, "第二季度"),
+    THIRD_QUARTER(3, "第三季度"),
+    FOURTH_QUARTER(4, "第四季度");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceQuarterEnum::getQuarter).toArray(Integer[]::new);
+
+    /**
+     * 季度
+     */
+    private final Integer quarter;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceQuarterEnum valueOf(Integer quarter) {
+        return ArrayUtil.firstMatch(item -> item.getQuarter().equals(quarter), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuotaScoreTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuotaScoreTypeEnum.java
new file mode 100644
index 0000000..f020849
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuotaScoreTypeEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效指标评分类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceQuotaScoreTypeEnum implements ArrayValuable<Integer> {
+
+    DIRECT_INPUT(1, "直接输入");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceQuotaScoreTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceQuotaScoreTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuotaSettingTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuotaSettingTypeEnum.java
new file mode 100644
index 0000000..009d8c0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceQuotaSettingTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效指标设置类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceQuotaSettingTypeEnum implements ArrayValuable<Integer> {
+
+    SYSTEM(1, "系统制定"),
+    EMPLOYEE(2, "员工填写");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceQuotaSettingTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceQuotaSettingTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceRaterTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceRaterTypeEnum.java
new file mode 100644
index 0000000..a6a8652
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceRaterTypeEnum.java
@@ -0,0 +1,45 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效评分人类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceRaterTypeEnum implements ArrayValuable<Integer> {
+
+    SUPERIOR(1, "上级"),
+    DEPT_LEADER(2, "部门负责人"),
+    SPECIFIED(3, "指定评分人"),
+    SELF(4, "被考核人");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceRaterTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceRaterTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceReviewScoringTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceReviewScoringTypeEnum.java
new file mode 100644
index 0000000..2dfbd14
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceReviewScoringTypeEnum.java
@@ -0,0 +1,42 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效评分方式枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceReviewScoringTypeEnum implements ArrayValuable<Integer> {
+
+    QUOTA(1, "按指标评分");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceReviewScoringTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceReviewScoringTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceReviewVisibleContentEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceReviewVisibleContentEnum.java
new file mode 100644
index 0000000..0219e52
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceReviewVisibleContentEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 绩效评分可见内容枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceReviewVisibleContentEnum implements ArrayValuable<Integer> {
+
+    SELF(1, "仅自己的评分和评语"),
+    ALL(2, "所有人的评分和评语");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceReviewVisibleContentEnum::getContent).toArray(Integer[]::new);
+
+    /**
+     * 可见内容
+     */
+    private final Integer content;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceReviewVisibleContentEnum valueOf(Integer content) {
+        return ArrayUtil.firstMatch(item -> item.getContent().equals(content), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceStageTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceStageTypeEnum.java
new file mode 100644
index 0000000..a93c388
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/performance/plan/HrmPerformanceStageTypeEnum.java
@@ -0,0 +1,57 @@
+package cn.iocoder.yudao.module.hrm.enums.performance.plan;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * HRM 绩效阶段类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmPerformanceStageTypeEnum implements ArrayValuable<Integer> {
+
+    NOT_STARTED(0, "未开始"),
+    FILL_QUOTA(1, "员工填写"),
+    TARGET_CONFIRM(2, "目标确认"),
+    SELF_SCORE(3, "自评"),
+    OTHER_SCORE(4, "他人评分"),
+    RESULT_AUDIT(5, "结果审核"),
+    RESULT_CONFIRM(6, "结果确认"),
+    APPEAL_CONFIRM(7, "申诉确认"),
+    ARCHIVED(8, "归档"),
+    EXECUTING(9, "执行中"),
+    END(10, "结束");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmPerformanceStageTypeEnum::getType).toArray(Integer[]::new);
+
+    public static final List<Integer> REVIEW_TYPES = Collections.unmodifiableList(Arrays.asList(
+            SELF_SCORE.getType(), OTHER_SCORE.getType()));
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmPerformanceStageTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/candidate/HrmRecruitCandidateStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/candidate/HrmRecruitCandidateStatusEnum.java
new file mode 100644
index 0000000..19788b7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/candidate/HrmRecruitCandidateStatusEnum.java
@@ -0,0 +1,90 @@
+package cn.iocoder.yudao.module.hrm.enums.recruit.candidate;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import cn.iocoder.yudao.framework.common.util.collection.SetUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+import java.util.Set;
+
+/**
+ * HRM 招聘候选人状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmRecruitCandidateStatusEnum implements ArrayValuable<Integer> {
+
+    NEW(1, "新候选人"),
+    PRIMARY_PASS(2, "初选通过"),
+    INTERVIEW(3, "安排面试"),
+    INTERVIEW_PASS(4, "面试通过"),
+    OFFER_SENT(5, "已发 offer"),
+    PENDING_ENTRY(6, "待入职"),
+    ELIMINATED(7, "已淘汰"),
+    JOINED(8, "已入职");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmRecruitCandidateStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 候选人列表需要展示最近一次面试信息的状态集合
+     */
+    public static final Set<Integer> INTERVIEW_RELATED_STATUSES = SetUtils.asSet(
+            INTERVIEW.getStatus(), INTERVIEW_PASS.getStatus(), OFFER_SENT.getStatus(),
+            PENDING_ENTRY.getStatus(), ELIMINATED.getStatus(), JOINED.getStatus());
+
+    /**
+     * HRM 首页日历允许展示面试事项的候选人状态集合
+     */
+    public static final Set<Integer> CALENDAR_STATUSES = SetUtils.asSet(
+            NEW.getStatus(), PRIMARY_PASS.getStatus(), INTERVIEW.getStatus(), INTERVIEW_PASS.getStatus());
+
+    /**
+     * 招聘流程中的候选人状态集合
+     */
+    public static final Set<Integer> PROCESSING_STATUSES = SetUtils.asSet(
+            NEW.getStatus(), PRIMARY_PASS.getStatus(), INTERVIEW.getStatus(),
+            INTERVIEW_PASS.getStatus(), OFFER_SENT.getStatus());
+
+    /**
+     * 允许安排面试的候选人状态集合
+     */
+    public static final Set<Integer> INTERVIEW_ARRANGE_STATUSES = SetUtils.asSet(
+            NEW.getStatus(), PRIMARY_PASS.getStatus(), INTERVIEW.getStatus(), INTERVIEW_PASS.getStatus());
+
+    /**
+     * 允许淘汰的候选人状态集合
+     */
+    public static final Set<Integer> ELIMINATE_STATUSES = SetUtils.asSet(
+            NEW.getStatus(), PRIMARY_PASS.getStatus(), INTERVIEW.getStatus(), INTERVIEW_PASS.getStatus(),
+            OFFER_SENT.getStatus(), PENDING_ENTRY.getStatus());
+
+    /**
+     * 允许转为员工的候选人状态集合
+     */
+    public static final Set<Integer> CONVERT_EMPLOYEE_STATUSES = SetUtils.asSet(
+            INTERVIEW_PASS.getStatus(), OFFER_SENT.getStatus());
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmRecruitCandidateStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/candidate/HrmRecruitInterviewResultEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/candidate/HrmRecruitInterviewResultEnum.java
new file mode 100644
index 0000000..7f64ee0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/candidate/HrmRecruitInterviewResultEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.recruit.candidate;
+
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 招聘面试结果枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmRecruitInterviewResultEnum implements ArrayValuable<Integer> {
+
+    UNFINISHED(1, "面试未完成"),
+    PASS(2, "面试通过"),
+    NOT_PASS(3, "面试未通过"),
+    CANCEL(4, "面试取消");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmRecruitInterviewResultEnum::getResult).toArray(Integer[]::new);
+
+    /**
+     * 结果
+     */
+    private final Integer result;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmRecruitInterviewResultEnum valueOf(Integer result) {
+        return Arrays.stream(values()).filter(item -> item.getResult().equals(result)).findFirst().orElse(null);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/post/HrmRecruitPostStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/post/HrmRecruitPostStatusEnum.java
new file mode 100644
index 0000000..bbbec9f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/recruit/post/HrmRecruitPostStatusEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.recruit.post;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 招聘职位状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmRecruitPostStatusEnum implements ArrayValuable<Integer> {
+
+    RECRUITING(1, "招聘中"),
+    STOPPED(0, "停止招聘");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmRecruitPostStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名字
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmRecruitPostStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryOptionCodeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryOptionCodeEnum.java
new file mode 100644
index 0000000..190d2af
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryOptionCodeEnum.java
@@ -0,0 +1,120 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import cn.iocoder.yudao.framework.common.util.collection.SetUtils;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Set;
+
+/**
+ * HRM 预置薪资项目编码枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryOptionCodeEnum implements ArrayValuable<Integer> {
+
+    BASIC_SALARY(10101, "基本工资"),
+    POST_SALARY(10102, "岗位工资"),
+    MEAL_ALLOWANCE(20104, "餐补"),
+
+    OVERTIME_PAY(180101, "加班工资"),
+    LATE_DEDUCTION(190101, "迟到扣款"),
+    EARLY_DEDUCTION(190102, "早退扣款"),
+    ABSENTEEISM_DEDUCTION(190103, "旷工扣款"),
+    LEAVE_DEDUCTION(190104, "假期扣款"),
+    MISSING_CARD_DEDUCTION(190105, "缺卡扣款"),
+    COMPREHENSIVE_DEDUCTION(190106, "综合扣款"),
+    ATTENDANCE_DEDUCTION_TOTAL(200101, "考勤扣款合计"),
+
+    PERSONAL_INSURANCE(100101, "个人社保"),
+    PERSONAL_PROVIDENT_FUND(100102, "个人公积金"),
+    CORPORATE_INSURANCE(110101, "公司社保"),
+    CORPORATE_PROVIDENT_FUND(120101, "公司公积金"),
+
+    EXPECTED_PAY(210101, "应发工资"),
+    TAXABLE(220101, "应税工资"),
+    PERSONAL_TAX(230101, "个人所得税"),
+    REAL_PAY(240101, "实发工资"),
+
+    LAST_MONTH_CUMULATIVE_INCOME(250101, "累计收入额（截至上月）"),
+    LAST_MONTH_CUMULATIVE_DEDUCT_EXPENSE(250102, "累计减除费用（截至上月）"),
+    LAST_MONTH_CUMULATIVE_SPECIAL_DEDUCTION(250103, "累计专项扣除（截至上月）"),
+    LAST_MONTH_PREPAID_TAX(250105, "累计已预缴税额"),
+
+    CHILD_EDUCATION_DEDUCTION(260101, "累计子女教育"),
+    HOUSE_RENT_DEDUCTION(260102, "累计住房租金"),
+    HOUSE_LOAN_DEDUCTION(260103, "累计住房贷款利息"),
+    ELDERLY_SUPPORT_DEDUCTION(260104, "累计赡养老人"),
+    CONTINUING_EDUCATION_DEDUCTION(260105, "累计继续教育"),
+
+    CURRENT_CUMULATIVE_INCOME(270101, "累计收入额"),
+    CURRENT_CUMULATIVE_DEDUCT_EXPENSE(270102, "累计减除费用"),
+    CURRENT_CUMULATIVE_SPECIAL_DEDUCTION(270103, "累计专项扣除"),
+    CURRENT_CUMULATIVE_ADDITIONAL_DEDUCTION(270104, "累计专项附加扣除"),
+    CURRENT_CUMULATIVE_TAXABLE(270105, "累计应纳税所得额"),
+    CURRENT_CUMULATIVE_TAX(270106, "累计应纳税额");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryOptionCodeEnum::getCode).toArray(Integer[]::new);
+
+    /**
+     * 系统计算的薪资项编码集合
+     */
+    public static final Set<Integer> COMPUTED_CODES = Collections.unmodifiableSet(SetUtils.asSet(
+            EXPECTED_PAY.getCode(), TAXABLE.getCode(), PERSONAL_TAX.getCode(), REAL_PAY.getCode(),
+            CURRENT_CUMULATIVE_INCOME.getCode(), CURRENT_CUMULATIVE_DEDUCT_EXPENSE.getCode(),
+            CURRENT_CUMULATIVE_SPECIAL_DEDUCTION.getCode(), CURRENT_CUMULATIVE_ADDITIONAL_DEDUCTION.getCode(),
+            CURRENT_CUMULATIVE_TAXABLE.getCode(), CURRENT_CUMULATIVE_TAX.getCode()));
+
+    /**
+     * 默认工资条模板的薪资项编码
+     */
+    public static final List<Integer> SALARY_SLIP_DEFAULT_CODES = Collections.unmodifiableList(Arrays.asList(
+            BASIC_SALARY.getCode(), POST_SALARY.getCode(), EXPECTED_PAY.getCode(),
+            PERSONAL_TAX.getCode(), REAL_PAY.getCode()));
+
+    /**
+     * 默认工资条模板基本项编码
+     */
+    public static final Set<Integer> SALARY_SLIP_BASIC_CODES = Collections.unmodifiableSet(SetUtils.asSet(
+            EXPECTED_PAY.getCode(), PERSONAL_TAX.getCode(), REAL_PAY.getCode()));
+
+    /**
+     * 上月累计薪资项编码集合
+     */
+    public static final List<Integer> LAST_MONTH_CUMULATIVE_CODES = Collections.unmodifiableList(Arrays.asList(
+            LAST_MONTH_CUMULATIVE_INCOME.getCode(), LAST_MONTH_CUMULATIVE_DEDUCT_EXPENSE.getCode(),
+            LAST_MONTH_CUMULATIVE_SPECIAL_DEDUCTION.getCode(), LAST_MONTH_PREPAID_TAX.getCode()));
+
+    /**
+     * 员工薪资信息导入排除的父薪资项编码集合
+     */
+    public static final Set<Integer> EMPLOYEE_INFO_IMPORT_EXCLUDED_PARENT_CODES =
+            Collections.unmodifiableSet(SetUtils.asSet(180, 190, 200, 210, 220, 230, 240, 250, 260));
+
+    /**
+     * 编码
+     */
+    private final Integer code;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryOptionCodeEnum valueOf(Integer code) {
+        return ArrayUtil.firstMatch(item -> item.getCode().equals(code), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryOptionTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryOptionTypeEnum.java
new file mode 100644
index 0000000..ae209ce
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryOptionTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 薪资项类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryOptionTypeEnum implements ArrayValuable<Integer> {
+
+    MINUS(0, "减项"),
+    ADD(1, "加项"),
+    CALCULATED(2, "计算项");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryOptionTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryOptionTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalarySocialSecurityMonthTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalarySocialSecurityMonthTypeEnum.java
new file mode 100644
index 0000000..5a5e64f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalarySocialSecurityMonthTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 薪资对应社保月份类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalarySocialSecurityMonthTypeEnum implements ArrayValuable<Integer> {
+
+    PREVIOUS_MONTH(0, "上月"),
+    CURRENT_MONTH(1, "当月"),
+    NEXT_MONTH(2, "次月");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalarySocialSecurityMonthTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalarySocialSecurityMonthTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxCycleTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxCycleTypeEnum.java
new file mode 100644
index 0000000..8089dff
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxCycleTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 薪资计税周期类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryTaxCycleTypeEnum implements ArrayValuable<Integer> {
+
+    DECEMBER_TO_NOVEMBER(1, "上年 12 月至本年 11 月"),
+    JANUARY_TO_DECEMBER(2, "本年 1 月至 12 月");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryTaxCycleTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryTaxCycleTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxRateEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxRateEnum.java
new file mode 100644
index 0000000..3b994d0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxRateEnum.java
@@ -0,0 +1,71 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.config;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.math.BigDecimal;
+
+/**
+ * HRM 薪资个人所得税税率档位枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryTaxRateEnum {
+
+    // ==================== 工资薪金所得税 ====================
+
+    SALARY_LEVEL_1(HrmSalaryTaxTypeEnum.SALARY.getType(), new BigDecimal("36000"), 3, BigDecimal.ZERO),
+    SALARY_LEVEL_2(HrmSalaryTaxTypeEnum.SALARY.getType(), new BigDecimal("144000"), 10, new BigDecimal("2520")),
+    SALARY_LEVEL_3(HrmSalaryTaxTypeEnum.SALARY.getType(), new BigDecimal("300000"), 20, new BigDecimal("16920")),
+    SALARY_LEVEL_4(HrmSalaryTaxTypeEnum.SALARY.getType(), new BigDecimal("420000"), 25, new BigDecimal("31920")),
+    SALARY_LEVEL_5(HrmSalaryTaxTypeEnum.SALARY.getType(), new BigDecimal("660000"), 30, new BigDecimal("52920")),
+    SALARY_LEVEL_6(HrmSalaryTaxTypeEnum.SALARY.getType(), new BigDecimal("960000"), 35, new BigDecimal("85920")),
+    SALARY_LEVEL_7(HrmSalaryTaxTypeEnum.SALARY.getType(), null, 45, new BigDecimal("181920")),
+
+    // ==================== 劳务报酬所得税 ====================
+
+    REMUNERATION_LEVEL_1(HrmSalaryTaxTypeEnum.REMUNERATION.getType(), new BigDecimal("20000"), 20, BigDecimal.ZERO),
+    REMUNERATION_LEVEL_2(HrmSalaryTaxTypeEnum.REMUNERATION.getType(), new BigDecimal("50000"), 30,
+            new BigDecimal("2000")),
+    REMUNERATION_LEVEL_3(HrmSalaryTaxTypeEnum.REMUNERATION.getType(), null, 40, new BigDecimal("7000"));
+
+    /**
+     * 计税类型
+     */
+    private final Integer taxType;
+    /**
+     * 应纳税所得额上限；为空表示不设上限
+     */
+    private final BigDecimal taxableUpperLimit;
+    /**
+     * 税率，单位：百分比
+     */
+    private final Integer rate;
+    /**
+     * 速算扣除数
+     */
+    private final BigDecimal quickDeduction;
+
+    /**
+     * 获得应纳税所得额对应的税率档位
+     *
+     * @param taxType 计税类型
+     * @param taxable 应纳税所得额
+     * @return 税率档位
+     */
+    public static HrmSalaryTaxRateEnum valueOf(Integer taxType, BigDecimal taxable) {
+        for (HrmSalaryTaxRateEnum taxRate : values()) {
+            if (!taxRate.getTaxType().equals(taxType)) {
+                continue;
+            }
+            if (taxRate.getTaxableUpperLimit() == null
+                    || taxable.compareTo(taxRate.getTaxableUpperLimit()) <= 0) {
+                return taxRate;
+            }
+        }
+        throw new IllegalArgumentException("不存在匹配的薪资个人所得税税率档位");
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxTypeEnum.java
new file mode 100644
index 0000000..0ebe4bd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/config/HrmSalaryTaxTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.config;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 薪资计税类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryTaxTypeEnum implements ArrayValuable<Integer> {
+
+    SALARY(1, "工资薪金所得税"),
+    REMUNERATION(2, "劳务报酬所得税"),
+    NONE(3, "不计税");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryTaxTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryTaxTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryBatchAdjustTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryBatchAdjustTypeEnum.java
new file mode 100644
index 0000000..1f9511d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryBatchAdjustTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.employee;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 批量调薪方式枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryBatchAdjustTypeEnum implements ArrayValuable<Integer> {
+
+    PERCENT(1, "按比例"),
+    AMOUNT(2, "按金额");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryBatchAdjustTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryBatchAdjustTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeReasonEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeReasonEnum.java
new file mode 100644
index 0000000..d5592d1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeReasonEnum.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.employee;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 定薪调薪原因枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryChangeReasonEnum implements ArrayValuable<Integer> {
+
+    ENTRY_SALARY(0, "入职定薪"),
+    ENTRY_CONFIRM(1, "入职核定"),
+    REGULAR(2, "转正"),
+    PROMOTION(3, "晋升"),
+    TRANSFER(4, "调动"),
+    MID_YEAR_ADJUSTMENT(5, "年中调薪"),
+    ANNUAL_ADJUSTMENT(6, "年度调薪"),
+    SPECIAL_ADJUSTMENT(7, "特别调薪"),
+    OTHER(8, "其他");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryChangeReasonEnum::getReason).toArray(Integer[]::new);
+
+    /**
+     * 原因
+     */
+    private final Integer reason;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryChangeReasonEnum valueOf(Integer reason) {
+        return ArrayUtil.firstMatch(item -> item.getReason().equals(reason), values());
+    }
+
+    public static HrmSalaryChangeReasonEnum valueOfName(String name) {
+        return ArrayUtil.firstMatch(item -> item.getName().equals(name), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeRecordStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeRecordStatusEnum.java
new file mode 100644
index 0000000..28db779
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeRecordStatusEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.employee;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 定薪调薪记录状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryChangeRecordStatusEnum implements ArrayValuable<Integer> {
+
+    PENDING(0, "待生效"),
+    EFFECTIVE(1, "已生效"),
+    CANCELLED(2, "已取消");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryChangeRecordStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryChangeRecordStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeRecordTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeRecordTypeEnum.java
new file mode 100644
index 0000000..fe3f4c3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryChangeRecordTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.employee;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 定薪调薪记录类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryChangeRecordTypeEnum implements ArrayValuable<Integer> {
+
+    SALARY_SET(1, "定薪"),
+    SALARY_ADJUSTMENT(2, "调薪");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryChangeRecordTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryChangeRecordTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryEmployeeChangeTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryEmployeeChangeTypeEnum.java
new file mode 100644
index 0000000..8790df0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryEmployeeChangeTypeEnum.java
@@ -0,0 +1,46 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.employee;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 工资表员工异动分类枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryEmployeeChangeTypeEnum implements ArrayValuable<Integer> {
+
+    ALL(0, "计薪人数"),
+    ENTRY(1, "新入职"),
+    LEAVE(2, "离职"),
+    REGULAR(3, "转正"),
+    TRANSFER(4, "调岗");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryEmployeeChangeTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryEmployeeChangeTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryEmployeeInfoChangeTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryEmployeeInfoChangeTypeEnum.java
new file mode 100644
index 0000000..0238643
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/employee/HrmSalaryEmployeeInfoChangeTypeEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.employee;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 员工薪资信息变更类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryEmployeeInfoChangeTypeEnum implements ArrayValuable<Integer> {
+
+    UNSET(0, "未定薪"),
+    SET(1, "已定薪"),
+    ADJUSTED(2, "已调薪");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryEmployeeInfoChangeTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryEmployeeInfoChangeTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/monthrecord/HrmSalaryMonthRecordStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/monthrecord/HrmSalaryMonthRecordStatusEnum.java
new file mode 100644
index 0000000..67a1f7f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/monthrecord/HrmSalaryMonthRecordStatusEnum.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.monthrecord;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 月度工资表状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalaryMonthRecordStatusEnum implements ArrayValuable<Integer> {
+
+    UNCOMPUTED(5, "未核算"),
+    HISTORY(10, "已归档"),
+    COMPUTED(11, "已核算");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalaryMonthRecordStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalaryMonthRecordStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipReadStatusEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipReadStatusEnum.java
new file mode 100644
index 0000000..fadfdfc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipReadStatusEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.slip;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 工资条阅读状态枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalarySlipReadStatusEnum implements ArrayValuable<Integer> {
+
+    UNREAD(0, "未读"),
+    READ(1, "已读");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalarySlipReadStatusEnum::getStatus).toArray(Integer[]::new);
+
+    /**
+     * 状态
+     */
+    private final Integer status;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalarySlipReadStatusEnum valueOf(Integer status) {
+        return ArrayUtil.firstMatch(item -> item.getStatus().equals(status), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipTemplateCategoryEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipTemplateCategoryEnum.java
new file mode 100644
index 0000000..97aa83d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipTemplateCategoryEnum.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.slip;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 默认工资条模板分类枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalarySlipTemplateCategoryEnum implements ArrayValuable<Integer> {
+
+    BASIC(-1, "基本项", 1),
+    DETAIL(-2, "明细项", 2);
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalarySlipTemplateCategoryEnum::getCode).toArray(Integer[]::new);
+
+    /**
+     * 分类编码
+     */
+    private final Integer code;
+    /**
+     * 分类名称
+     */
+    private final String name;
+    /**
+     * 排序
+     */
+    private final Integer sort;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalarySlipTemplateCategoryEnum valueOf(Integer code) {
+        return ArrayUtil.firstMatch(item -> item.getCode().equals(code), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipTemplateOptionTypeEnum.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipTemplateOptionTypeEnum.java
new file mode 100644
index 0000000..10d430e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/enums/salary/slip/HrmSalarySlipTemplateOptionTypeEnum.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.enums.salary.slip;
+
+import cn.hutool.core.util.ArrayUtil;
+import cn.iocoder.yudao.framework.common.core.ArrayValuable;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.Arrays;
+
+/**
+ * HRM 工资条模板项类型枚举
+ *
+ * @author 芋道源码
+ */
+@Getter
+@AllArgsConstructor
+public enum HrmSalarySlipTemplateOptionTypeEnum implements ArrayValuable<Integer> {
+
+    CATEGORY(1, "分类"),
+    ITEM(2, "薪资项");
+
+    public static final Integer[] ARRAYS = Arrays.stream(values())
+            .map(HrmSalarySlipTemplateOptionTypeEnum::getType).toArray(Integer[]::new);
+
+    /**
+     * 类型
+     */
+    private final Integer type;
+    /**
+     * 名称
+     */
+    private final String name;
+
+    @Override
+    public Integer[] array() {
+        return ARRAYS;
+    }
+
+    public static HrmSalarySlipTemplateOptionTypeEnum valueOf(Integer type) {
+        return ArrayUtil.firstMatch(item -> item.getType().equals(type), values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/excel/core/HrmEmployeeProbationExcelColumnSelectFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/excel/core/HrmEmployeeProbationExcelColumnSelectFunction.java
new file mode 100644
index 0000000..d1f0a5f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/excel/core/HrmEmployeeProbationExcelColumnSelectFunction.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.hrm.framework.excel.core;
+
+import cn.iocoder.yudao.framework.excel.core.function.ExcelColumnSelectFunction;
+import org.springframework.stereotype.Service;
+
+import java.util.Arrays;
+import java.util.List;
+
+/**
+ * 员工试用期月份下拉框数据源的 {@link ExcelColumnSelectFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+public class HrmEmployeeProbationExcelColumnSelectFunction implements ExcelColumnSelectFunction {
+
+    public static final String NAME = "getHrmEmployeeProbationMonthList";
+
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    @Override
+    public List<String> getOptions() {
+        return Arrays.asList("0", "1", "2", "3", "4", "5", "6");
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/excel/core/HrmRecruitChannelExcelColumnSelectFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/excel/core/HrmRecruitChannelExcelColumnSelectFunction.java
new file mode 100644
index 0000000..f744245
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/excel/core/HrmRecruitChannelExcelColumnSelectFunction.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.framework.excel.core;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.excel.core.function.ExcelColumnSelectFunction;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+/**
+ * 招聘渠道下拉框数据源的 {@link ExcelColumnSelectFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+public class HrmRecruitChannelExcelColumnSelectFunction implements ExcelColumnSelectFunction {
+
+    public static final String NAME = "getHrmRecruitChannelNameList";
+
+    @Resource
+    private HrmRecruitChannelService recruitChannelService;
+
+    @Override
+    public String getName() {
+        return NAME;
+    }
+
+    @Override
+    public List<String> getOptions() {
+        return convertList(recruitChannelService.getRecruitChannelSimpleList(),
+                HrmRecruitChannelExcelColumnSelectFunction::formatOption);
+    }
+
+    /**
+     * 格式化招聘渠道 Excel 下拉选项
+     *
+     * @param channel 招聘渠道
+     * @return Excel 下拉选项
+     */
+    public static String formatOption(HrmRecruitChannelDO channel) {
+        return channel.getName() + "（" + channel.getId() + "）";
+    }
+
+    /**
+     * 解析招聘渠道 Excel 下拉选项
+     *
+     * @param channels 可选招聘渠道
+     * @param option Excel 选项
+     * @return 招聘渠道；选项不存在时返回 {@code null}
+     */
+    public static HrmRecruitChannelDO parseOption(List<HrmRecruitChannelDO> channels, String option) {
+        return CollUtil.findOne(channels, item -> formatOption(item).equals(option));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmBankCardNumberParseFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmBankCardNumberParseFunction.java
new file mode 100644
index 0000000..d872ed7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmBankCardNumberParseFunction.java
@@ -0,0 +1,31 @@
+package cn.iocoder.yudao.module.hrm.framework.operatelog.core;
+
+import cn.hutool.core.util.DesensitizedUtil;
+import cn.hutool.core.util.StrUtil;
+import com.mzt.logapi.service.IParseFunction;
+import org.springframework.stereotype.Component;
+
+/**
+ * HRM 银行卡号脱敏的 {@link IParseFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Component
+public class HrmBankCardNumberParseFunction implements IParseFunction {
+
+    public static final String NAME = "getHrmBankCardNumber";
+
+    @Override
+    public String functionName() {
+        return NAME;
+    }
+
+    @Override
+    public String apply(Object value) {
+        if (StrUtil.isEmptyIfStr(value)) {
+            return "";
+        }
+        return DesensitizedUtil.bankCard(value.toString());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmCommonStatusParseFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmCommonStatusParseFunction.java
new file mode 100644
index 0000000..899e2d5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmCommonStatusParseFunction.java
@@ -0,0 +1,40 @@
+package cn.iocoder.yudao.module.hrm.framework.operatelog.core;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import com.mzt.logapi.service.IParseFunction;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+/**
+ * HRM 通用状态的 {@link IParseFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Component
+@Slf4j
+public class HrmCommonStatusParseFunction implements IParseFunction {
+
+    public static final String NAME = "getHrmCommonStatusName";
+
+    @Override
+    public String functionName() {
+        return NAME;
+    }
+
+    @Override
+    public String apply(Object value) {
+        if (StrUtil.isEmptyIfStr(value)) {
+            return "";
+        }
+        Integer status = Integer.valueOf(value.toString());
+        if (CommonStatusEnum.isEnable(status)) {
+            return CommonStatusEnum.ENABLE.getName();
+        }
+        if (CommonStatusEnum.isDisable(status)) {
+            return CommonStatusEnum.DISABLE.getName();
+        }
+        return "";
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitCandidateStatusParseFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitCandidateStatusParseFunction.java
new file mode 100644
index 0000000..a1de377
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitCandidateStatusParseFunction.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.hrm.framework.operatelog.core;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import com.mzt.logapi.service.IParseFunction;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+/**
+ * HRM 招聘候选人状态的 {@link IParseFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Component
+@Slf4j
+public class HrmRecruitCandidateStatusParseFunction implements IParseFunction {
+
+    public static final String NAME = "getRecruitCandidateStatusName";
+
+    @Override
+    public String functionName() {
+        return NAME;
+    }
+
+    @Override
+    public String apply(Object value) {
+        if (StrUtil.isEmptyIfStr(value)) {
+            return "";
+        }
+        HrmRecruitCandidateStatusEnum status = HrmRecruitCandidateStatusEnum.valueOf(
+                Integer.valueOf(value.toString()));
+        return status == null ? "" : status.getName();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitInterviewResultParseFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitInterviewResultParseFunction.java
new file mode 100644
index 0000000..f18fb91
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitInterviewResultParseFunction.java
@@ -0,0 +1,35 @@
+package cn.iocoder.yudao.module.hrm.framework.operatelog.core;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import com.mzt.logapi.service.IParseFunction;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+/**
+ * HRM 招聘面试结果的 {@link IParseFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Component
+@Slf4j
+public class HrmRecruitInterviewResultParseFunction implements IParseFunction {
+
+    public static final String NAME = "getRecruitInterviewResultName";
+
+    @Override
+    public String functionName() {
+        return NAME;
+    }
+
+    @Override
+    public String apply(Object value) {
+        if (StrUtil.isEmptyIfStr(value)) {
+            return "";
+        }
+        HrmRecruitInterviewResultEnum result = HrmRecruitInterviewResultEnum.valueOf(
+                Integer.valueOf(value.toString()));
+        return result == null ? "" : result.getName();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitPostStatusParseFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitPostStatusParseFunction.java
new file mode 100644
index 0000000..7d8f87f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmRecruitPostStatusParseFunction.java
@@ -0,0 +1,34 @@
+package cn.iocoder.yudao.module.hrm.framework.operatelog.core;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import com.mzt.logapi.service.IParseFunction;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+/**
+ * HRM 招聘职位状态的 {@link IParseFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Component
+@Slf4j
+public class HrmRecruitPostStatusParseFunction implements IParseFunction {
+
+    public static final String NAME = "getRecruitPostStatusName";
+
+    @Override
+    public String functionName() {
+        return NAME;
+    }
+
+    @Override
+    public String apply(Object value) {
+        if (StrUtil.isEmptyIfStr(value)) {
+            return "";
+        }
+        HrmRecruitPostStatusEnum status = HrmRecruitPostStatusEnum.valueOf(Integer.valueOf(value.toString()));
+        return status == null ? "" : status.getName();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmSalarySocialSecurityMonthTypeParseFunction.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmSalarySocialSecurityMonthTypeParseFunction.java
new file mode 100644
index 0000000..f5d74e8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/core/HrmSalarySocialSecurityMonthTypeParseFunction.java
@@ -0,0 +1,33 @@
+package cn.iocoder.yudao.module.hrm.framework.operatelog.core;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalarySocialSecurityMonthTypeEnum;
+import com.mzt.logapi.service.IParseFunction;
+import org.springframework.stereotype.Component;
+
+/**
+ * HRM 薪资对应社保月份类型的 {@link IParseFunction} 实现类
+ *
+ * @author 芋道源码
+ */
+@Component
+public class HrmSalarySocialSecurityMonthTypeParseFunction implements IParseFunction {
+
+    public static final String NAME = "getSalarySocialSecurityMonthTypeName";
+
+    @Override
+    public String functionName() {
+        return NAME;
+    }
+
+    @Override
+    public String apply(Object value) {
+        if (StrUtil.isEmptyIfStr(value)) {
+            return "";
+        }
+        HrmSalarySocialSecurityMonthTypeEnum monthType =
+                HrmSalarySocialSecurityMonthTypeEnum.valueOf(Integer.valueOf(value.toString()));
+        return monthType == null ? "" : monthType.getName();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/package-info.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/package-info.java
new file mode 100644
index 0000000..4a33a3e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/operatelog/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * hrm 模块的 operatelog 拓展封装
+ */
+package cn.iocoder.yudao.module.hrm.framework.operatelog;
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/package-info.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/package-info.java
new file mode 100644
index 0000000..5b7d41b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/package-info.java
@@ -0,0 +1,6 @@
+/**
+ * 属于 hrm 模块的 framework 封装
+ *
+ * @author 芋道源码
+ */
+package cn.iocoder.yudao.module.hrm.framework;
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/web/config/HrmWebConfiguration.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/web/config/HrmWebConfiguration.java
new file mode 100644
index 0000000..79bf169
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/web/config/HrmWebConfiguration.java
@@ -0,0 +1,24 @@
+package cn.iocoder.yudao.module.hrm.framework.web.config;
+
+import cn.iocoder.yudao.framework.swagger.config.YudaoSwaggerAutoConfiguration;
+import org.springdoc.core.models.GroupedOpenApi;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * hrm 模块的 web 组件的 Configuration
+ *
+ * @author 芋道源码
+ */
+@Configuration(proxyBeanMethods = false)
+public class HrmWebConfiguration {
+
+    /**
+     * hrm 模块的 API 分组
+     */
+    @Bean
+    public GroupedOpenApi hrmGroupedOpenApi() {
+        return YudaoSwaggerAutoConfiguration.buildGroupedOpenApi("hrm");
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/web/package-info.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/web/package-info.java
new file mode 100644
index 0000000..54fb101
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/framework/web/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * hrm 模块的 web 拓展封装
+ */
+package cn.iocoder.yudao.module.hrm.framework.web;
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/employee/HrmEmployeeChangeJob.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/employee/HrmEmployeeChangeJob.java
new file mode 100644
index 0000000..8ba4624
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/employee/HrmEmployeeChangeJob.java
@@ -0,0 +1,102 @@
+package cn.iocoder.yudao.module.hrm.job.employee;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.quartz.core.handler.JobHandler;
+import cn.iocoder.yudao.framework.tenant.core.job.TenantJob;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeQuitInfoService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Set;
+
+/**
+ * HRM 员工异动生效 Job
+ *
+ * @author 芋道源码
+ */
+@Component
+@Slf4j
+public class HrmEmployeeChangeJob implements JobHandler {
+
+    @Resource
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmEmployeeQuitInfoService employeeQuitInfoService;
+
+    @Override
+    @TenantJob
+    public String execute(String param) {
+        LocalDateTime deadlineTime = StrUtil.isBlank(param) ? LocalDateTime.now()
+                : LocalDateTimeUtils.getDayEndTime(LocalDate.parse(param));
+        Set<Long> affectedEmployeeIds = new HashSet<>();
+
+        // 1. 逐条应用到期且尚未生效的员工异动记录
+        List<HrmEmployeeChangeRecordDO> changeRecords =
+                employeeChangeRecordService.getPendingEmployeeChangeRecordList(deadlineTime);
+        int changeSuccessCount = 0;
+        int failureCount = 0;
+        for (HrmEmployeeChangeRecordDO changeRecord : changeRecords) {
+            try {
+                if (employeeService.applyEmployeeChange(changeRecord)) {
+                    affectedEmployeeIds.add(changeRecord.getEmployeeId());
+                    changeSuccessCount++;
+                }
+            } catch (RuntimeException ex) {
+                failureCount++;
+                log.error("[execute][应用员工异动记录失败，changeRecordId=({})]", changeRecord.getId(), ex);
+            }
+        }
+
+        // 2. 逐个应用到期转正
+        List<HrmEmployeeDO> regularEmployees = employeeService.getDueRegularEmployeeList(deadlineTime);
+        int regularEmployeeCount = 0;
+        for (HrmEmployeeDO employee : regularEmployees) {
+            try {
+                if (employeeService.applyEmployeeRegular(employee.getId())) {
+                    affectedEmployeeIds.add(employee.getId());
+                    regularEmployeeCount++;
+                }
+            } catch (RuntimeException ex) {
+                failureCount++;
+                log.error("[execute][应用员工转正失败，employeeId=({})]", employee.getId(), ex);
+            }
+        }
+
+        // 3. 逐个应用到期离职
+        List<HrmEmployeeQuitInfoDO> quitInfos =
+                employeeQuitInfoService.getDueQuitInfoList(deadlineTime);
+        int quitEmployeeCount = 0;
+        for (HrmEmployeeQuitInfoDO quitInfo : quitInfos) {
+            try {
+                if (employeeService.applyEmployeeQuit(quitInfo)) {
+                    affectedEmployeeIds.add(quitInfo.getEmployeeId());
+                    quitEmployeeCount++;
+                }
+            } catch (RuntimeException ex) {
+                failureCount++;
+                log.error("[execute][应用员工离职失败，quitInfoId=({})]", quitInfo.getId(), ex);
+            }
+        }
+
+        // 4. 返回执行结果
+        return String.format("HRM 员工异动生效：截止 %s，异动 %s/%s 条，转正 %s/%s 人，离职 %s/%s 人，"
+                        + "失败 %s 条，影响员工 %s 人",
+                deadlineTime, changeSuccessCount, changeRecords.size(), regularEmployeeCount,
+                regularEmployees.size(), quitEmployeeCount, quitInfos.size(), failureCount,
+                affectedEmployeeIds.size());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/package-info.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/package-info.java
new file mode 100644
index 0000000..cf56c66
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/package-info.java
@@ -0,0 +1,4 @@
+/**
+ * HRM 模块的定时任务
+ */
+package cn.iocoder.yudao.module.hrm.job;
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/performance/HrmPerformanceAppealTimeoutJob.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/performance/HrmPerformanceAppealTimeoutJob.java
new file mode 100644
index 0000000..34d2bd5
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/performance/HrmPerformanceAppealTimeoutJob.java
@@ -0,0 +1,43 @@
+package cn.iocoder.yudao.module.hrm.job.performance;
+
+import cn.iocoder.yudao.framework.quartz.core.handler.JobHandler;
+import cn.iocoder.yudao.framework.tenant.core.job.TenantJob;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentProcessService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Component;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 绩效申诉超期处理 Job
+ *
+ * @author 芋道源码
+ */
+@Component
+public class HrmPerformanceAppealTimeoutJob implements JobHandler {
+
+    @Resource
+    private HrmPerformanceAssessmentProcessService performanceAssessmentProcessService;
+
+    @Override
+    @TenantJob
+    public String execute(String param) {
+        // 1. 查询超时的绩效申诉阶段
+        List<HrmPerformanceAssessmentStageDO> stages =
+                performanceAssessmentProcessService.getAppealTimeoutStageList(LocalDateTime.now());
+
+        // 2. 逐个处理，确保每个申诉使用独立事务
+        int successCount = 0;
+        for (HrmPerformanceAssessmentStageDO stage : stages) {
+            if (performanceAssessmentProcessService.processAppealTimeout(stage.getId())) {
+                successCount++;
+            }
+        }
+
+        // 3. 返回执行结果
+        return String.format("HRM 绩效申诉超期处理：待处理 %s 条，成功 %s 条", stages.size(), successCount);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/salary/HrmSalaryChangeJob.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/salary/HrmSalaryChangeJob.java
new file mode 100644
index 0000000..004e0ef
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/job/salary/HrmSalaryChangeJob.java
@@ -0,0 +1,38 @@
+package cn.iocoder.yudao.module.hrm.job.salary;
+
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.quartz.core.handler.JobHandler;
+import cn.iocoder.yudao.framework.tenant.core.job.TenantJob;
+import cn.iocoder.yudao.module.hrm.service.salary.employee.HrmSalaryEmployeeInfoService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Component;
+
+import java.time.LocalDate;
+import java.util.HashSet;
+import java.util.List;
+
+/**
+ * HRM 定薪调薪记录生效 Job
+ *
+ * @author 芋道源码
+ */
+@Component
+public class HrmSalaryChangeJob implements JobHandler {
+
+    @Resource
+    private HrmSalaryEmployeeInfoService salaryEmployeeInfoService;
+
+    @Override
+    @TenantJob
+    public String execute(String param) {
+        LocalDate targetDate = StrUtil.isBlank(param) ? LocalDate.now() : LocalDate.parse(param);
+
+        // 1. 应用到期的调薪记录
+        List<Long> employeeIds = salaryEmployeeInfoService.applyDueSalaryChanges(targetDate);
+
+        // 2. 返回执行结果
+        return String.format("HRM 薪资调整生效：日期 %s，生效 %s 条，影响员工 %s 人",
+                targetDate, employeeIds.size(), new HashSet<>(employeeIds).size());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/package-info.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/package-info.java
new file mode 100644
index 0000000..6a5671c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/package-info.java
@@ -0,0 +1,10 @@
+/**
+ * hrm 包下，人力资源管理（Human Resource Management）
+ * 例如说：员工、招聘、考勤、薪资、社保、绩效等等
+ *
+ * 1. Controller URL：以 /hrm/ 开头，避免和其它 Module 冲突
+ * 2. DataObject 表名：以 hrm_ 开头，方便在数据库中区分
+ *
+ * 注意，由于 Hrm 模块下容易和其它模块重名，所以类名都加 Hrm 前缀
+ */
+package cn.iocoder.yudao.module.hrm;
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupService.java
new file mode 100644
index 0000000..35c50d3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupService.java
@@ -0,0 +1,114 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * HRM 考勤组 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmAttendanceGroupService {
+
+    /**
+     * 创建考勤组
+     *
+     * @param createReqVO 考勤组信息
+     * @return 考勤组编号
+     */
+    Long createAttendanceGroup(@Valid HrmAttendanceGroupSaveReqVO createReqVO);
+
+    /**
+     * 更新考勤组
+     *
+     * @param updateReqVO 考勤组信息
+     */
+    void updateAttendanceGroup(@Valid HrmAttendanceGroupSaveReqVO updateReqVO);
+
+    /**
+     * 删除考勤组
+     *
+     * @param id 考勤组编号
+     */
+    void deleteAttendanceGroup(Long id);
+
+    /**
+     * 获得考勤组详情
+     *
+     * @param id 考勤组编号
+     * @return 考勤组详情
+     */
+    HrmAttendanceGroupDO getAttendanceGroup(Long id);
+
+    /**
+     * 获得员工所在考勤组详情
+     *
+     * @param employeeId 员工编号
+     * @return 考勤组详情
+     */
+    HrmAttendanceGroupDO getMyAttendanceGroup(Long employeeId);
+
+    /**
+     * 获得指定员工的考勤组 Map
+     *
+     * @param employeeIds 员工编号数组
+     * @return 考勤组 Map
+     */
+    Map<Long, HrmAttendanceGroupDO> getAttendanceGroupMap(Collection<Long> employeeIds);
+
+    /**
+     * 获得考勤组指定日期的有效班次 Map
+     *
+     * @param attendanceGroup 考勤组
+     * @param attendanceDates 考勤日期数组
+     * @param holidayMap 节假日 Map
+     * @return 有效班次 Map
+     */
+    Map<LocalDate, HrmAttendanceGroupDO.Shift> getAttendanceGroupShiftMap(
+            HrmAttendanceGroupDO attendanceGroup, Collection<LocalDate> attendanceDates,
+            Map<LocalDate, HrmAttendanceHolidayDO> holidayMap);
+
+    /**
+     * 获得员工指定考勤时间的实际班次
+     *
+     * @param employeeId 员工编号
+     * @param attendanceTime 考勤时间
+     * @return 实际班次；休息日返回 {@code null}
+     */
+    HrmAttendanceGroupDO.Shift getEmployeeAttendanceShift(
+            Long employeeId, LocalDateTime attendanceTime);
+
+    /**
+     * 获得考勤组分页
+     *
+     * @param pageReqVO 分页查询条件
+     * @return 考勤组分页
+     */
+    PageResult<HrmAttendanceGroupDO> getAttendanceGroupPage(HrmAttendanceGroupPageReqVO pageReqVO);
+
+    /**
+     * 获得考勤组列表
+     *
+     * @return 考勤组列表
+     */
+    List<HrmAttendanceGroupDO> getAttendanceGroupList();
+
+    /**
+     * 校验考勤组是否存在
+     *
+     * @param id 考勤组编号
+     * @return 考勤组
+     */
+    HrmAttendanceGroupDO validateAttendanceGroupExists(Long id);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupServiceImpl.java
new file mode 100644
index 0000000..55645a6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupServiceImpl.java
@@ -0,0 +1,421 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.config.HrmAttendanceGroupMapper;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceHolidayTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.function.Function;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_DEFAULT_CANNOT_DELETE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_GROUP_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_ATTENDANCE_GROUP_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_ATTENDANCE_GROUP_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_ATTENDANCE_GROUP_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_ATTENDANCE_GROUP_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_ATTENDANCE_GROUP_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_ATTENDANCE_GROUP_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_ATTENDANCE_GROUP_UPDATE_SUCCESS;
+
+/**
+ * HRM 考勤组 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmAttendanceGroupServiceImpl implements HrmAttendanceGroupService {
+
+    @Resource
+    private HrmAttendanceGroupMapper attendanceGroupMapper;
+
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+    @Resource
+    private HrmAttendanceHolidayService attendanceHolidayService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_ATTENDANCE_GROUP_TYPE, subType = HRM_ATTENDANCE_GROUP_CREATE_SUB_TYPE,
+            bizNo = "{{#attendanceGroup.id}}", success = HRM_ATTENDANCE_GROUP_CREATE_SUCCESS)
+    public Long createAttendanceGroup(HrmAttendanceGroupSaveReqVO createReqVO) {
+        // 1.1 校验考勤组名称唯一
+        validateAttendanceGroupNameUnique(null, createReqVO.getName());
+        // 1.2 校验班次、特殊日期和适用范围
+        validateAttendanceGroup(createReqVO);
+
+        // 2. 创建考勤组
+        HrmAttendanceGroupDO group = BeanUtils.toBean(createReqVO, HrmAttendanceGroupDO.class)
+                .setSpecialDates(BeanUtils.toBean(createReqVO.getSpecialDates(),
+                        HrmAttendanceGroupDO.SpecialDate.class, specialDate -> specialDate
+                                .setDate(LocalDateTimeUtils.getDayBeginTime(specialDate.getDate()))))
+                .setDefaultStatus(false);
+        attendanceGroupMapper.insert(group);
+
+        // 3. 接管考勤组适用范围
+        transferAttendanceGroupScope(group.getId(), createReqVO);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("attendanceGroup", group);
+        return group.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_ATTENDANCE_GROUP_TYPE, subType = HRM_ATTENDANCE_GROUP_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = HRM_ATTENDANCE_GROUP_UPDATE_SUCCESS)
+    public void updateAttendanceGroup(HrmAttendanceGroupSaveReqVO updateReqVO) {
+        // 1.1 校验考勤组是否存在
+        HrmAttendanceGroupDO oldGroup = validateAttendanceGroupExists(updateReqVO.getId());
+        // 1.2 校验考勤组名称唯一
+        validateAttendanceGroupNameUnique(updateReqVO.getId(), updateReqVO.getName());
+        // 1.3 校验班次、特殊日期和适用范围
+        validateAttendanceGroup(updateReqVO);
+
+        // 2. 更新考勤组
+        HrmAttendanceGroupDO group = BeanUtils.toBean(updateReqVO, HrmAttendanceGroupDO.class)
+                .setSpecialDates(BeanUtils.toBean(updateReqVO.getSpecialDates(),
+                        HrmAttendanceGroupDO.SpecialDate.class, specialDate -> specialDate
+                                .setDate(LocalDateTimeUtils.getDayBeginTime(specialDate.getDate()))));
+        attendanceGroupMapper.updateById(group);
+
+        // 3. 接管考勤组适用范围
+        transferAttendanceGroupScope(group.getId(), updateReqVO);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(oldGroup, HrmAttendanceGroupSaveReqVO.class));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_ATTENDANCE_GROUP_TYPE, subType = HRM_ATTENDANCE_GROUP_DELETE_SUB_TYPE,
+            bizNo = "{{#attendanceGroup.id}}", success = HRM_ATTENDANCE_GROUP_DELETE_SUCCESS)
+    public void deleteAttendanceGroup(Long id) {
+        // 1. 校验考勤组是否存在且不是默认考勤组
+        HrmAttendanceGroupDO group = validateAttendanceGroupExists(id);
+        if (Boolean.TRUE.equals(group.getDefaultStatus())) {
+            throw exception(ATTENDANCE_DEFAULT_CANNOT_DELETE);
+        }
+
+        // 2. 删除考勤组
+        attendanceGroupMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("attendanceGroup", group);
+    }
+
+    @Override
+    public HrmAttendanceGroupDO getAttendanceGroup(Long id) {
+        return attendanceGroupMapper.selectById(id);
+    }
+
+    @Override
+    public HrmAttendanceGroupDO getMyAttendanceGroup(Long employeeId) {
+        // 1. 校验员工是否存在
+        HrmEmployeeDO employee = employeeService.getEmployee(employeeId);
+        if (employee == null) {
+            return null;
+        }
+
+        // 2. 匹配员工考勤组
+        Map<Long, List<Long>> deptHierarchyMap = buildDeptHierarchyMap(
+                Collections.singleton(employee.getDeptId()));
+        return matchAttendanceGroup(employee,
+                attendanceGroupMapper.selectListOrderByDefaultStatusAndId(), deptHierarchyMap);
+    }
+
+    @Override
+    public Map<Long, HrmAttendanceGroupDO> getAttendanceGroupMap(Collection<Long> employeeIds) {
+        // 1. 获得员工 Map
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyMap();
+        }
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        if (CollUtil.isEmpty(employeeMap)) {
+            return Collections.emptyMap();
+        }
+        // 2. 匹配员工考勤组
+        Map<Long, List<Long>> deptHierarchyMap = buildDeptHierarchyMap(
+                convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId));
+        return matchAttendanceGroupMap(employeeMap,
+                attendanceGroupMapper.selectListOrderByDefaultStatusAndId(), deptHierarchyMap);
+    }
+
+    @Override
+    public Map<LocalDate, HrmAttendanceGroupDO.Shift> getAttendanceGroupShiftMap(
+            HrmAttendanceGroupDO attendanceGroup, Collection<LocalDate> attendanceDates,
+            Map<LocalDate, HrmAttendanceHolidayDO> holidayMap) {
+        if (attendanceGroup == null || CollUtil.isEmpty(attendanceDates)) {
+            return Collections.emptyMap();
+        }
+
+        // 1. 将考勤组特殊日期按自然日归集，便于优先匹配
+        Map<LocalDate, HrmAttendanceGroupDO.SpecialDate> specialDateMap = convertMap(
+                CollUtil.emptyIfNull(attendanceGroup.getSpecialDates()),
+                specialDate -> specialDate.getDate().toLocalDate(), Function.identity(),
+                (first, second) -> second);
+
+        // 2. 逐日结合特殊日期、法定节假日和每周班次解析实际班次
+        Map<LocalDate, HrmAttendanceGroupDO.Shift> result = new LinkedHashMap<>();
+        for (LocalDate attendanceDate : attendanceDates) {
+            if (attendanceDate == null) {
+                continue;
+            }
+            HrmAttendanceHolidayDO holiday = holidayMap == null ? null : holidayMap.get(attendanceDate);
+            HrmAttendanceGroupDO.Shift shift = resolveAttendanceGroupShift(
+                    attendanceGroup, attendanceDate, holiday, specialDateMap.get(attendanceDate));
+            result.put(attendanceDate, shift);
+        }
+        return result;
+    }
+
+    @Override
+    public HrmAttendanceGroupDO.Shift getEmployeeAttendanceShift(
+            Long employeeId, LocalDateTime attendanceTime) {
+        LocalDate attendanceDate = attendanceTime.toLocalDate();
+        HrmAttendanceGroupDO attendanceGroup = getMyAttendanceGroup(employeeId);
+        Map<LocalDate, HrmAttendanceHolidayDO> holidayMap =
+                attendanceHolidayService.getAttendanceHolidayMap(
+                        LocalDateTimeUtils.getDateTimeRange(
+                                attendanceDate, attendanceDate));
+        return getAttendanceGroupShiftMap(attendanceGroup,
+                Collections.singletonList(attendanceDate), holidayMap).get(attendanceDate);
+    }
+
+    @Override
+    public PageResult<HrmAttendanceGroupDO> getAttendanceGroupPage(HrmAttendanceGroupPageReqVO pageReqVO) {
+        return attendanceGroupMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmAttendanceGroupDO> getAttendanceGroupList() {
+        return attendanceGroupMapper.selectListOrderByDefaultStatusAndId();
+    }
+
+    @Override
+    public HrmAttendanceGroupDO validateAttendanceGroupExists(Long id) {
+        HrmAttendanceGroupDO group = attendanceGroupMapper.selectById(id);
+        if (group == null) {
+            throw exception(ATTENDANCE_GROUP_NOT_EXISTS);
+        }
+        return group;
+    }
+
+    /**
+     * 解析指定日期实际执行的考勤班次：特殊日期优先于法定节假日，法定节假日优先于每周班次
+     *
+     * @param group 考勤组
+     * @param attendanceDate 考勤日期
+     * @param holiday 法定节假日
+     * @param specialDate 考勤组特殊日期
+     * @return 实际班次；休息日返回 {@code null}
+     */
+    private HrmAttendanceGroupDO.Shift resolveAttendanceGroupShift(
+            HrmAttendanceGroupDO group, LocalDate attendanceDate,
+            HrmAttendanceHolidayDO holiday, HrmAttendanceGroupDO.SpecialDate specialDate) {
+        // 命中特殊日期时，以考勤组的工作日或休息日配置为准
+        if (specialDate != null) {
+            return Objects.equals(specialDate.getType(), HrmAttendanceHolidayTypeEnum.WORK.getType())
+                    ? getWorkShift(group, attendanceDate) : null;
+        }
+        // 未配置特殊日期时，再按法定节假日决定休息或补班
+        if (holiday != null) {
+            if (Objects.equals(holiday.getType(), HrmAttendanceHolidayTypeEnum.REST.getType())
+                    && Boolean.TRUE.equals(group.getRest())) {
+                return null;
+            }
+            if (Objects.equals(holiday.getType(), HrmAttendanceHolidayTypeEnum.WORK.getType())) {
+                return getWorkShift(group, attendanceDate);
+            }
+        }
+        return getWeeklyShift(group, attendanceDate);
+    }
+
+    /**
+     * 获得指定工作日的班次：优先使用当天配置的每周班次；补班日期未命中时，回退到考勤组第一个班次
+     *
+     * @param group 考勤组
+     * @param attendanceDate 考勤日期
+     * @return 工作日班次
+     */
+    private HrmAttendanceGroupDO.Shift getWorkShift(
+            HrmAttendanceGroupDO group, LocalDate attendanceDate) {
+        HrmAttendanceGroupDO.Shift shift = getWeeklyShift(group, attendanceDate);
+        if (shift != null || CollUtil.isEmpty(group.getShifts())) {
+            return shift;
+        }
+        return CollUtil.getFirst(group.getShifts());
+    }
+
+    /**
+     * 获得指定日期配置的每周班次
+     *
+     * @param group 考勤组
+     * @param attendanceDate 考勤日期
+     * @return 每周班次；未配置时返回 {@code null}
+     */
+    private HrmAttendanceGroupDO.Shift getWeeklyShift(
+            HrmAttendanceGroupDO group, LocalDate attendanceDate) {
+        if (CollUtil.isEmpty(group.getShifts())) {
+            return null;
+        }
+        int week = attendanceDate.getDayOfWeek().getValue();
+        return CollUtil.findOne(group.getShifts(),
+                shift -> shift != null && CollUtil.contains(shift.getWeeks(), week));
+    }
+
+    private void validateAttendanceGroupNameUnique(Long id, String name) {
+        HrmAttendanceGroupDO group = attendanceGroupMapper.selectByName(name);
+        if (group != null && ObjUtil.notEqual(group.getId(), id)) {
+            throw exception(ATTENDANCE_NAME_DUPLICATE);
+        }
+    }
+
+    private void validateAttendanceGroup(HrmAttendanceGroupSaveReqVO reqVO) {
+        // 1. 校验适用部门存在
+        deptApi.validateDeptList(reqVO.getDeptIds());
+        // 2. 校验适用员工存在
+        employeeService.validateEmployeeListExists(reqVO.getEmployeeIds());
+    }
+
+    /**
+     * 接管考勤组适用范围：同一部门或员工只能归属一个考勤组
+     *
+     * @param attendanceGroupId 当前考勤组编号
+     * @param reqVO 考勤组保存信息
+     */
+    private void transferAttendanceGroupScope(
+            Long attendanceGroupId, HrmAttendanceGroupSaveReqVO reqVO) {
+        // 1. 计算当前组接管的部门及员工范围
+        Set<Long> deptIds = new HashSet<>(reqVO.getDeptIds());
+        Set<Long> deptScope = new HashSet<>(deptIds);
+        deptScope.addAll(convertSet(deptApi.getChildDeptList(deptIds), DeptRespDTO::getId));
+        Set<Long> employeeIds = new HashSet<>(reqVO.getEmployeeIds());
+        if (CollUtil.isNotEmpty(deptScope)) {
+            employeeIds.addAll(convertSet(
+                    employeeService.getEmployeeListByDeptIds(deptScope), HrmEmployeeDO::getId));
+        }
+
+        // 2. 从其它考勤组移除冲突范围
+        for (HrmAttendanceGroupDO group : attendanceGroupMapper.selectListOrderByDefaultStatusAndId()) {
+            if (Objects.equals(group.getId(), attendanceGroupId)) {
+                continue;
+            }
+            List<Long> remainDeptIds = CollUtil.subtractToList(
+                    CollUtil.emptyIfNull(group.getDeptIds()), deptScope);
+            List<Long> remainEmployeeIds = CollUtil.subtractToList(
+                    CollUtil.emptyIfNull(group.getEmployeeIds()), employeeIds);
+            if (Objects.equals(remainDeptIds, group.getDeptIds())
+                    && Objects.equals(remainEmployeeIds, group.getEmployeeIds())) {
+                continue;
+            }
+            attendanceGroupMapper.updateById(new HrmAttendanceGroupDO().setId(group.getId())
+                    .setDeptIds(remainDeptIds).setEmployeeIds(remainEmployeeIds));
+        }
+    }
+
+    private Map<Long, HrmAttendanceGroupDO> matchAttendanceGroupMap(
+            Map<Long, HrmEmployeeDO> employeeMap, List<HrmAttendanceGroupDO> groupList,
+            Map<Long, List<Long>> deptHierarchyMap) {
+        Map<Long, HrmAttendanceGroupDO> result = new HashMap<>();
+        for (HrmEmployeeDO employee : employeeMap.values()) {
+            HrmAttendanceGroupDO group = matchAttendanceGroup(employee, groupList, deptHierarchyMap);
+            if (group != null) {
+                result.put(employee.getId(), group);
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 按显式员工、最近上级部门、默认考勤组的顺序匹配员工考勤组
+     */
+    private HrmAttendanceGroupDO matchAttendanceGroup(
+            HrmEmployeeDO employee, List<HrmAttendanceGroupDO> groups,
+            Map<Long, List<Long>> deptHierarchyMap) {
+        // 1. 优先匹配显式员工
+        for (HrmAttendanceGroupDO group : groups) {
+            if (CollUtil.contains(group.getEmployeeIds(), employee.getId())) {
+                return group;
+            }
+        }
+
+        // 2. 其次按当前部门到父部门的顺序匹配
+        if (employee.getDeptId() != null) {
+            List<Long> deptHierarchy = deptHierarchyMap.getOrDefault(
+                    employee.getDeptId(), Collections.singletonList(employee.getDeptId()));
+            for (Long deptId : deptHierarchy) {
+                for (HrmAttendanceGroupDO group : groups) {
+                    if (CollUtil.contains(group.getDeptIds(), deptId)) {
+                        return group;
+                    }
+                }
+            }
+        }
+
+        // 3. 最后使用默认考勤组
+        return CollUtil.findOne(groups, group -> Boolean.TRUE.equals(group.getDefaultStatus()));
+    }
+
+    /**
+     * 批量构造部门自身到根部门的层级编号
+     *
+     * @param deptIds 部门编号集合
+     * @return 部门层级 Map
+     */
+    private Map<Long, List<Long>> buildDeptHierarchyMap(Collection<Long> deptIds) {
+        Set<Long> validDeptIds = convertSet(deptIds);
+        validDeptIds.removeIf(deptId -> deptId <= 0);
+        if (CollUtil.isEmpty(validDeptIds)) {
+            return Collections.emptyMap();
+        }
+
+        Map<Long, List<Long>> result = new HashMap<>();
+        for (Long deptId : validDeptIds) {
+            List<Long> hierarchy = new ArrayList<>(Collections.singletonList(deptId));
+            hierarchy.addAll(convertList(deptApi.getParentDeptList(deptId), DeptRespDTO::getId));
+            result.put(deptId, hierarchy);
+        }
+        return result;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayService.java
new file mode 100644
index 0000000..ec98840
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayService.java
@@ -0,0 +1,83 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidayPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidaySaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * HRM 考勤节假日 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmAttendanceHolidayService {
+
+    /**
+     * 创建考勤节假日
+     *
+     * @param createReqVO 节假日信息
+     * @return 节假日编号
+     */
+    Long createAttendanceHoliday(HrmAttendanceHolidaySaveReqVO createReqVO);
+
+    /**
+     * 更新考勤节假日
+     *
+     * @param updateReqVO 节假日信息
+     */
+    void updateAttendanceHoliday(HrmAttendanceHolidaySaveReqVO updateReqVO);
+
+    /**
+     * 删除考勤节假日
+     *
+     * @param id 节假日编号
+     */
+    void deleteAttendanceHoliday(Long id);
+
+    /**
+     * 获得考勤节假日
+     *
+     * @param id 节假日编号
+     * @return 节假日
+     */
+    HrmAttendanceHolidayDO getAttendanceHoliday(Long id);
+
+    /**
+     * 检查指定日期的考勤节假日
+     *
+     * @param date 日期
+     * @return 节假日
+     */
+    HrmAttendanceHolidayDO checkAttendanceHoliday(LocalDateTime date);
+
+    /**
+     * 获得日期范围内的考勤节假日列表
+     *
+     * @param dateTimes 日期时间闭区间
+     * @return 节假日列表
+     */
+    List<HrmAttendanceHolidayDO> getAttendanceHolidayListByDateRange(
+            LocalDateTime[] dateTimes);
+
+    /**
+     * 获得日期范围内的考勤节假日 Map
+     *
+     * @param dateTimes 日期时间闭区间
+     * @return 节假日 Map
+     */
+    Map<LocalDate, HrmAttendanceHolidayDO> getAttendanceHolidayMap(LocalDateTime[] dateTimes);
+
+    /**
+     * 获得考勤节假日分页
+     *
+     * @param pageReqVO 分页查询条件
+     * @return 节假日分页
+     */
+    PageResult<HrmAttendanceHolidayDO> getAttendanceHolidayPage(HrmAttendanceHolidayPageReqVO pageReqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayServiceImpl.java
new file mode 100644
index 0000000..43c2476
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayServiceImpl.java
@@ -0,0 +1,112 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.config;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidayPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidaySaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.config.HrmAttendanceHolidayMapper;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_HOLIDAY_DATE_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_HOLIDAY_NOT_EXISTS;
+
+/**
+ * HRM 考勤节假日 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmAttendanceHolidayServiceImpl implements HrmAttendanceHolidayService {
+
+    @Resource
+    private HrmAttendanceHolidayMapper attendanceHolidayMapper;
+
+    @Override
+    public Long createAttendanceHoliday(HrmAttendanceHolidaySaveReqVO createReqVO) {
+        // 1. 校验日期未配置
+        LocalDateTime date = getDayBeginTime(createReqVO.getDate());
+        validateAttendanceHolidayDateUnique(null, date);
+
+        // 2. 新增节假日配置
+        HrmAttendanceHolidayDO holiday = BeanUtils.toBean(createReqVO, HrmAttendanceHolidayDO.class)
+                .setDate(date);
+        attendanceHolidayMapper.insert(holiday);
+        return holiday.getId();
+    }
+
+    @Override
+    public void updateAttendanceHoliday(HrmAttendanceHolidaySaveReqVO updateReqVO) {
+        // 1. 校验节假日配置存在
+        validateAttendanceHolidayExists(updateReqVO.getId());
+        LocalDateTime date = getDayBeginTime(updateReqVO.getDate());
+        validateAttendanceHolidayDateUnique(updateReqVO.getId(), date);
+
+        // 2. 更新节假日配置
+        attendanceHolidayMapper.updateById(BeanUtils.toBean(updateReqVO, HrmAttendanceHolidayDO.class)
+                .setDate(date));
+    }
+
+    @Override
+    public void deleteAttendanceHoliday(Long id) {
+        // 1. 校验节假日配置存在
+        validateAttendanceHolidayExists(id);
+
+        // 2. 删除节假日配置
+        attendanceHolidayMapper.deleteById(id);
+    }
+
+    @Override
+    public HrmAttendanceHolidayDO getAttendanceHoliday(Long id) {
+        return attendanceHolidayMapper.selectById(id);
+    }
+
+    @Override
+    public HrmAttendanceHolidayDO checkAttendanceHoliday(LocalDateTime date) {
+        return attendanceHolidayMapper.selectByDate(getDayBeginTime(date));
+    }
+
+    @Override
+    public List<HrmAttendanceHolidayDO> getAttendanceHolidayListByDateRange(
+            LocalDateTime[] dateTimes) {
+        return attendanceHolidayMapper.selectListByDateRange(dateTimes);
+    }
+
+    @Override
+    public Map<LocalDate, HrmAttendanceHolidayDO> getAttendanceHolidayMap(LocalDateTime[] dateTimes) {
+        List<HrmAttendanceHolidayDO> list = getAttendanceHolidayListByDateRange(dateTimes);
+        return convertMap(list, holiday -> holiday.getDate().toLocalDate());
+    }
+
+    @Override
+    public PageResult<HrmAttendanceHolidayDO> getAttendanceHolidayPage(HrmAttendanceHolidayPageReqVO pageReqVO) {
+        return attendanceHolidayMapper.selectPage(pageReqVO);
+    }
+
+    private void validateAttendanceHolidayExists(Long id) {
+        if (attendanceHolidayMapper.selectById(id) == null) {
+            throw exception(ATTENDANCE_HOLIDAY_NOT_EXISTS);
+        }
+    }
+
+    private void validateAttendanceHolidayDateUnique(Long id, LocalDateTime date) {
+        HrmAttendanceHolidayDO holiday = attendanceHolidayMapper.selectByDate(date);
+        if (holiday != null && ObjUtil.notEqual(holiday.getId(), id)) {
+            throw exception(ATTENDANCE_HOLIDAY_DATE_DUPLICATE);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockService.java
new file mode 100644
index 0000000..8916eb9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockService.java
@@ -0,0 +1,111 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.record;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockDetailRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * HRM 考勤打卡 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmAttendanceClockService {
+
+    /**
+     * 创建手工打卡记录
+     *
+     * @param createReqVO 打卡记录信息
+     * @return 打卡记录编号
+     */
+    Long createAttendanceClock(HrmAttendanceClockSaveReqVO createReqVO);
+
+    /**
+     * 获得员工端当前打卡详情
+     *
+     * @param userId 登录用户编号
+     * @return 打卡详情
+     */
+    HrmPortalAttendanceClockDetailRespVO getMyAttendanceClockDetail(Long userId);
+
+    /**
+     * 员工端手机打卡
+     *
+     * @param userId 登录用户编号
+     * @param createReqVO 打卡请求
+     * @return 打卡记录编号
+     */
+    Long createMyAttendanceClock(Long userId, HrmPortalAttendanceClockCreateReqVO createReqVO);
+
+    /**
+     * 更新手工打卡记录
+     *
+     * @param updateReqVO 打卡记录信息
+     */
+    void updateAttendanceClock(HrmAttendanceClockSaveReqVO updateReqVO);
+
+    /**
+     * 删除手工打卡记录
+     *
+     * @param id 打卡记录编号
+     */
+    void deleteAttendanceClock(Long id);
+
+    /**
+     * 批量删除手工打卡记录
+     *
+     * @param ids 打卡记录编号数组
+     */
+    void deleteAttendanceClockList(List<Long> ids);
+
+    /**
+     * 获得打卡记录
+     *
+     * @param id 打卡记录编号
+     * @return 打卡记录
+     */
+    HrmAttendanceClockDO getAttendanceClock(Long id);
+
+    /**
+     * 获得指定员工在打卡时间范围内的打卡记录
+     *
+     * @param employeeId 员工编号
+     * @param clockTimes 打卡时间闭区间
+     * @return 打卡记录列表
+     */
+    List<HrmAttendanceClockDO> getAttendanceClockListByEmployeeIdAndClockTime(
+            Long employeeId, LocalDateTime[] clockTimes);
+
+    /**
+     * 获得指定员工在打卡时间范围内的打卡记录
+     *
+     * @param employeeIds 员工编号集合
+     * @param clockTimes 打卡时间闭区间
+     * @return 打卡记录列表
+     */
+    List<HrmAttendanceClockDO> getAttendanceClockListByEmployeeIdsAndClockTime(
+            Collection<Long> employeeIds, LocalDateTime[] clockTimes);
+
+    /**
+     * 获得打卡记录分页
+     *
+     * @param pageReqVO 分页查询条件
+     * @return 打卡记录分页
+     */
+    PageResult<HrmAttendanceClockDO> getAttendanceClockPage(HrmAttendanceClockPageReqVO pageReqVO);
+
+    /**
+     * 获得打卡记录列表
+     *
+     * @param reqVO 查询条件
+     * @return 打卡记录列表
+     */
+    List<HrmAttendanceClockDO> getAttendanceClockList(HrmAttendanceClockPageReqVO reqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockServiceImpl.java
new file mode 100644
index 0000000..31519ea
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockServiceImpl.java
@@ -0,0 +1,538 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.record;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.TimeRange;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockDetailRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.record.HrmAttendanceClockMapper;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockButtonStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockSourceEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStageEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceGroupService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_GROUP_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_NON_MANUAL_MODIFY_FORBIDDEN;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_NOT_ALLOWED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_POINT_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_REST_DAY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_TIME_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_WIFI_INVALID;
+
+/**
+ * HRM 考勤打卡 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmAttendanceClockServiceImpl implements HrmAttendanceClockService {
+
+    @Resource
+    private HrmAttendanceClockMapper attendanceClockMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmAttendanceGroupService attendanceGroupService;
+
+    @Override
+    public Long createAttendanceClock(HrmAttendanceClockSaveReqVO createReqVO) {
+        // 1.1 校验员工存在
+        employeeService.validateEmployeeExists(createReqVO.getEmployeeId());
+        // 1.2 校验应打卡时间和实际打卡时间位于员工班次窗口内
+        validateAttendanceClockTime(createReqVO);
+
+        // 2. 创建手工打卡记录，来源和状态均由后端确定
+        HrmAttendanceClockDO clock = BeanUtils.toBean(createReqVO, HrmAttendanceClockDO.class);
+        fillAttendanceClockDefaultValue(clock, HrmAttendanceClockSourceEnum.MANUAL);
+        attendanceClockMapper.insert(clock);
+        return clock.getId();
+    }
+
+    @Override
+    public HrmPortalAttendanceClockDetailRespVO getMyAttendanceClockDetail(Long userId) {
+        // 1. 解析本人与考勤组
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(userId);
+        HrmAttendanceGroupDO group = attendanceGroupService.getMyAttendanceGroup(employee.getId());
+        if (group == null) {
+            throw exception(ATTENDANCE_CLOCK_GROUP_NOT_EXISTS);
+        }
+
+        // 2. 解析当前班次日与班次窗口
+        LocalDateTime now = LocalDateTime.now().withSecond(0).withNano(0);
+        HrmPortalAttendanceClockDetailRespVO detail = resolveAttendanceClockDetail(employee.getId(), now)
+                .setGroup(group);
+
+        // 3. 计算下一步动作和当日时间线
+        List<HrmAttendanceClockDO> dayClocks = getAttendanceClockListByAttendanceTime(
+                employee.getId(), detail.getOnDutyAttendanceTime(), detail.getOffDutyAttendanceTime());
+        return detail.setNextClock(buildNextClock(detail, dayClocks, now))
+                .setTimeline(buildTimeline(detail, dayClocks, now));
+    }
+
+    @Override
+    public Long createMyAttendanceClock(Long userId, HrmPortalAttendanceClockCreateReqVO createReqVO) {
+        // 1.1 解析本人、考勤组和下一步打卡动作
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(userId);
+        HrmAttendanceGroupDO group = attendanceGroupService.getMyAttendanceGroup(employee.getId());
+        if (group == null) {
+            throw exception(ATTENDANCE_CLOCK_GROUP_NOT_EXISTS);
+        }
+        LocalDateTime now = LocalDateTime.now().withSecond(0).withNano(0);
+        HrmPortalAttendanceClockDetailRespVO detail = resolveAttendanceClockDetail(employee.getId(), now);
+        if (detail.getShift() == null) {
+            throw exception(ATTENDANCE_CLOCK_REST_DAY);
+        }
+        List<HrmAttendanceClockDO> dayClocks = getAttendanceClockListByAttendanceTime(
+                employee.getId(), detail.getOnDutyAttendanceTime(), detail.getOffDutyAttendanceTime());
+        HrmPortalAttendanceClockDetailRespVO.NextClock nextClock = buildNextClock(detail, dayClocks, now);
+        HrmAttendanceClockButtonStatusEnum buttonStatus =
+                HrmAttendanceClockButtonStatusEnum.valueOf(nextClock.getButtonStatus());
+        if (buttonStatus == null || !buttonStatus.isCanClock()) {
+            throw exception(ATTENDANCE_CLOCK_NOT_ALLOWED);
+        }
+        // 1.2 按考勤组开关校验定位 / WiFi
+        validateMobileClockLocationAndWifi(group, createReqVO);
+
+        // 2. 写入手机端打卡
+        HrmAttendanceClockDO clock = new HrmAttendanceClockDO()
+                .setEmployeeId(employee.getId()).setType(nextClock.getType())
+                .setAttendanceTime(nextClock.getAttendanceTime()).setClockTime(now)
+                .setAddress(createReqVO.getAddress()).setLongitude(createReqVO.getLongitude())
+                .setLatitude(createReqVO.getLatitude())
+                .setSsid(createReqVO.getSsid()).setMac(createReqVO.getMac());
+        fillAttendanceClockDefaultValue(clock, HrmAttendanceClockSourceEnum.MOBILE);
+        attendanceClockMapper.insert(clock);
+        return clock.getId();
+    }
+
+    @Override
+    public void updateAttendanceClock(HrmAttendanceClockSaveReqVO updateReqVO) {
+        // 1.1 校验记录存在且为手工录入
+        HrmAttendanceClockDO oldClock = validateAttendanceClockExists(updateReqVO.getId());
+        validateAttendanceClockManual(oldClock);
+        // 1.2 校验员工存在
+        employeeService.validateEmployeeExists(updateReqVO.getEmployeeId());
+        // 1.3 校验应打卡时间和实际打卡时间位于员工班次窗口内
+        validateAttendanceClockTime(updateReqVO);
+
+        // 2. 更新手工打卡记录，重新计算状态
+        HrmAttendanceClockDO clock = BeanUtils.toBean(updateReqVO, HrmAttendanceClockDO.class);
+        fillAttendanceClockDefaultValue(clock, HrmAttendanceClockSourceEnum.MANUAL);
+        attendanceClockMapper.updateById(clock);
+    }
+
+    @Override
+    public void deleteAttendanceClock(Long id) {
+        // 1. 校验记录存在且为手工录入
+        HrmAttendanceClockDO clock = validateAttendanceClockExists(id);
+        validateAttendanceClockManual(clock);
+
+        // 2. 删除手工打卡记录
+        attendanceClockMapper.deleteById(id);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deleteAttendanceClockList(List<Long> ids) {
+        // 1. 校验记录全部存在且均为手工录入，避免批量删除部分成功
+        Set<Long> distinctIds = convertSet(ids);
+        if (CollUtil.isEmpty(distinctIds)) {
+            throw exception(ATTENDANCE_CLOCK_NOT_EXISTS);
+        }
+        List<HrmAttendanceClockDO> clocks = attendanceClockMapper.selectByIds(distinctIds);
+        if (clocks.size() != distinctIds.size()) {
+            throw exception(ATTENDANCE_CLOCK_NOT_EXISTS);
+        }
+        clocks.forEach(this::validateAttendanceClockManual);
+
+        // 2. 删除手工打卡记录
+        attendanceClockMapper.deleteByIds(distinctIds);
+    }
+
+    @Override
+    public HrmAttendanceClockDO getAttendanceClock(Long id) {
+        return attendanceClockMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmAttendanceClockDO> getAttendanceClockListByEmployeeIdAndClockTime(
+            Long employeeId, LocalDateTime[] clockTimes) {
+        return attendanceClockMapper.selectListByEmployeeIdAndClockTime(employeeId, clockTimes);
+    }
+
+    @Override
+    public List<HrmAttendanceClockDO> getAttendanceClockListByEmployeeIdsAndClockTime(
+            Collection<Long> employeeIds, LocalDateTime[] clockTimes) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        return attendanceClockMapper.selectListByEmployeeIdsAndClockTime(employeeIds, clockTimes);
+    }
+
+    @Override
+    public PageResult<HrmAttendanceClockDO> getAttendanceClockPage(HrmAttendanceClockPageReqVO pageReqVO) {
+        Collection<Long> employeeIds = getClockEmployeeIds(pageReqVO);
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return PageResult.empty();
+        }
+        pageReqVO.setEmployeeIds(employeeIds);
+        return attendanceClockMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmAttendanceClockDO> getAttendanceClockList(HrmAttendanceClockPageReqVO reqVO) {
+        Collection<Long> employeeIds = getClockEmployeeIds(reqVO);
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        reqVO.setEmployeeIds(employeeIds);
+        return attendanceClockMapper.selectList(reqVO);
+    }
+
+    private HrmAttendanceClockDO validateAttendanceClockExists(Long id) {
+        HrmAttendanceClockDO clock = id == null ? null : attendanceClockMapper.selectById(id);
+        if (clock == null) {
+            throw exception(ATTENDANCE_CLOCK_NOT_EXISTS);
+        }
+        return clock;
+    }
+
+    private void validateAttendanceClockManual(HrmAttendanceClockDO clock) {
+        if (ObjUtil.notEqual(clock.getSourceType(), HrmAttendanceClockSourceEnum.MANUAL.getSource())) {
+            throw exception(ATTENDANCE_CLOCK_NON_MANUAL_MODIFY_FORBIDDEN);
+        }
+    }
+
+    private void fillAttendanceClockDefaultValue(HrmAttendanceClockDO clock,
+                                                 HrmAttendanceClockSourceEnum sourceType) {
+        clock.setSourceType(sourceType.getSource())
+                .setStage(HrmAttendanceClockStageEnum.FIRST.getStage())
+                .setStatus(calculateClockStatus(clock));
+    }
+
+    /**
+     * 校验管理员补录的打卡时间
+     *
+     * @param reqVO 打卡信息
+     */
+    private void validateAttendanceClockTime(HrmAttendanceClockSaveReqVO reqVO) {
+        LocalDate attendanceDate = reqVO.getAttendanceTime().toLocalDate();
+        List<LocalDate> candidateDates = Arrays.asList(attendanceDate, attendanceDate.minusDays(1));
+        if (candidateDates.stream().noneMatch(candidateDate ->
+                isAttendanceClockTimeValid(reqVO, candidateDate))) {
+            throw exception(ATTENDANCE_CLOCK_TIME_INVALID);
+        }
+    }
+
+    /**
+     * 校验打卡时间是否匹配员工当日班次及打卡时间段
+     *
+     * @param reqVO 打卡保存参数
+     * @param attendanceDate 考勤日期
+     * @return 是否有效
+     */
+    private boolean isAttendanceClockTimeValid(
+            HrmAttendanceClockSaveReqVO reqVO, LocalDate attendanceDate) {
+        // 1. 解析员工当天班次，休息日或班次时间不完整时不允许补录
+        HrmAttendanceGroupDO.Shift shift = attendanceGroupService.getEmployeeAttendanceShift(
+                reqVO.getEmployeeId(), attendanceDate.atStartOfDay());
+        if (shift == null || shift.getStartTime() == null || shift.getEndTime() == null) {
+            return false;
+        }
+
+        // 2. 校验应打卡时间与班次的上班或下班时间一致
+        TimeRange shiftTimeRange = CollUtil.getFirst(LocalDateTimeUtils.buildDailyTimeRanges(
+                attendanceDate, attendanceDate, shift.getStartTime(), shift.getEndTime()));
+        boolean onDuty = ObjUtil.equals(reqVO.getType(), HrmAttendanceClockTypeEnum.ON_DUTY.getType());
+        LocalDateTime scheduledTime = onDuty ? shiftTimeRange.getStartTime() : shiftTimeRange.getEndTime();
+        if (ObjUtil.notEqual(reqVO.getAttendanceTime(), scheduledTime)) {
+            return false;
+        }
+
+        // 3. 校验实际打卡时间位于对应的上班或下班打卡闭区间内
+        LocalTime clockBeginTime = onDuty ? shift.getClockInStartTime() : shift.getClockOutStartTime();
+        LocalTime clockEndTime = onDuty ? shift.getClockInEndTime() : shift.getClockOutEndTime();
+        TimeRange clockTimeRange = LocalDateTimeUtils.findDailyTimeRange(
+                attendanceDate, clockBeginTime, clockEndTime, scheduledTime);
+        return clockTimeRange != null && LocalDateTimeUtils.isBetween(
+                clockTimeRange.getStartTime(), clockTimeRange.getEndTime(), reqVO.getClockTime());
+    }
+
+    /**
+     * 计算打卡状态
+     *
+     * @param clock 打卡记录
+     * @return 打卡状态
+     */
+    private Integer calculateClockStatus(HrmAttendanceClockDO clock) {
+        // 上班打卡晚于应打卡时间时，状态为迟到
+        if (ObjUtil.equals(clock.getType(), HrmAttendanceClockTypeEnum.ON_DUTY.getType())
+                && clock.getClockTime().isAfter(clock.getAttendanceTime())) {
+            return HrmAttendanceClockStatusEnum.LATE.getStatus();
+        }
+        // 下班打卡早于应打卡时间时，状态为早退
+        if (ObjUtil.equals(clock.getType(), HrmAttendanceClockTypeEnum.OFF_DUTY.getType())
+                && clock.getClockTime().isBefore(clock.getAttendanceTime())) {
+            return HrmAttendanceClockStatusEnum.EARLY.getStatus();
+        }
+        return HrmAttendanceClockStatusEnum.NORMAL.getStatus();
+    }
+
+    private Collection<Long> getClockEmployeeIds(HrmAttendanceClockPageReqVO reqVO) {
+        if (StrUtil.isBlank(reqVO.getSearch()) && CollUtil.isEmpty(reqVO.getDeptIds())) {
+            return null;
+        }
+        HrmEmployeeListReqVO listReqVO = new HrmEmployeeListReqVO()
+                .setIds(reqVO.getEmployeeId() == null ? null : Collections.singletonList(reqVO.getEmployeeId()))
+                .setSearch(reqVO.getSearch()).setDeptIds(reqVO.getDeptIds());
+        List<HrmEmployeeDO> list = employeeService.getEmployeeList(listReqVO);
+        return convertList(list, HrmEmployeeDO::getId);
+    }
+
+    /**
+     * 解析员工当前应归属的考勤日与班次窗口
+     *
+     * 优先取今日班次；若当前仍落在昨日下班打卡窗口内，则继续归属昨日班次。
+     */
+    private HrmPortalAttendanceClockDetailRespVO resolveAttendanceClockDetail(
+            Long employeeId, LocalDateTime now) {
+        LocalDate today = now.toLocalDate();
+        LocalDate yesterday = today.minusDays(1);
+        HrmPortalAttendanceClockDetailRespVO yesterdayDetail = buildAttendanceClockDetail(employeeId, yesterday);
+        TimeRange yesterdayClockOutRange = yesterdayDetail.getClockOutRange();
+        if (yesterdayDetail.getShift() != null && yesterdayClockOutRange != null
+                && LocalDateTimeUtils.isBetween(yesterdayClockOutRange.getStartTime(), yesterdayClockOutRange.getEndTime(), now)
+                && (yesterdayDetail.getClockInRange() == null || now.isAfter(yesterdayDetail.getClockInRange().getEndTime()))) {
+            return yesterdayDetail;
+        }
+        return buildAttendanceClockDetail(employeeId, today);
+    }
+
+    /**
+     * 构建员工指定考勤日的班次详情
+     *
+     * @param employeeId 员工编号
+     * @param attendanceDate 考勤日期
+     * @return 班次详情
+     */
+    private HrmPortalAttendanceClockDetailRespVO buildAttendanceClockDetail(
+            Long employeeId, LocalDate attendanceDate) {
+        // 实际班次由考勤组、特殊日期和节假日共同确定
+        HrmAttendanceGroupDO.Shift shift = attendanceGroupService.getEmployeeAttendanceShift(
+                employeeId, attendanceDate.atStartOfDay());
+        HrmPortalAttendanceClockDetailRespVO detail = new HrmPortalAttendanceClockDetailRespVO()
+                .setAttendanceDate(attendanceDate).setShift(shift).setRestDay(shift == null);
+        if (shift == null || ObjUtil.hasEmpty(shift.getStartTime(), shift.getEndTime(),
+                shift.getClockInStartTime(), shift.getClockInEndTime(),
+                shift.getClockOutStartTime(), shift.getClockOutEndTime())) {
+            return detail;
+        }
+        // 将班次时分转换为当前考勤日对应的实际日期时间范围
+        TimeRange shiftRange = CollUtil.getFirst(LocalDateTimeUtils.buildDailyTimeRanges(
+                attendanceDate, attendanceDate, shift.getStartTime(), shift.getEndTime()));
+        // 以上下班应打卡时间为锚点，分别解析可能跨日的打卡窗口
+        return detail.setOnDutyAttendanceTime(shiftRange.getStartTime()).setOffDutyAttendanceTime(shiftRange.getEndTime())
+                .setClockInRange(LocalDateTimeUtils.findDailyTimeRange(attendanceDate,
+                        shift.getClockInStartTime(), shift.getClockInEndTime(), shiftRange.getStartTime()))
+                .setClockOutRange(LocalDateTimeUtils.findDailyTimeRange(attendanceDate,
+                        shift.getClockOutStartTime(), shift.getClockOutEndTime(), shiftRange.getEndTime()));
+    }
+
+    private List<HrmAttendanceClockDO> getAttendanceClockListByAttendanceTime(
+            Long employeeId, LocalDateTime beginTime, LocalDateTime endTime) {
+        if (ObjUtil.hasEmpty(beginTime, endTime)) {
+            return Collections.emptyList();
+        }
+        return attendanceClockMapper.selectList(new HrmAttendanceClockPageReqVO().setEmployeeId(employeeId)
+                .setAttendanceTime(new LocalDateTime[]{beginTime, endTime}));
+    }
+
+    /**
+     * 构建下一次打卡动作
+     *
+     * @param detail 打卡详情
+     * @param dayClocks 当日打卡记录
+     * @param now 当前时间
+     * @return 下一次打卡动作
+     */
+    private HrmPortalAttendanceClockDetailRespVO.NextClock buildNextClock(
+            HrmPortalAttendanceClockDetailRespVO detail,
+            List<HrmAttendanceClockDO> dayClocks, LocalDateTime now) {
+        // 员工端当前只使用第一打卡阶段；无有效班次时不可打卡
+        HrmPortalAttendanceClockDetailRespVO.NextClock nextClock =
+                new HrmPortalAttendanceClockDetailRespVO.NextClock();
+        nextClock.setStage(HrmAttendanceClockStageEnum.FIRST.getStage());
+        if (ObjUtil.hasEmpty(detail.getShift(), detail.getOnDutyAttendanceTime(), detail.getOffDutyAttendanceTime())) {
+            return nextClock.setType(HrmAttendanceClockTypeEnum.ON_DUTY.getType())
+                    .setButtonStatus(HrmAttendanceClockButtonStatusEnum.NOT_YET.getStatus());
+        }
+
+        // 根据已存在的上下班卡，判断下一步应上班、下班还是更新打卡
+        HrmAttendanceClockDO onDutyClock = CollUtil.findOne(dayClocks,
+                clock -> ObjUtil.equals(clock.getType(), HrmAttendanceClockTypeEnum.ON_DUTY.getType()));
+        HrmAttendanceClockDO offDutyClock = CollUtil.findOne(dayClocks,
+                clock -> ObjUtil.equals(clock.getType(), HrmAttendanceClockTypeEnum.OFF_DUTY.getType()));
+        TimeRange clockInRange = detail.getClockInRange();
+        TimeRange clockOutRange = detail.getClockOutRange();
+        LocalDateTime onDutyTime = detail.getOnDutyAttendanceTime();
+        LocalDateTime offDutyTime = detail.getOffDutyAttendanceTime();
+
+        // 尚未上班打卡：优先引导上班；已过上班窗口则引导下班
+        if (onDutyClock == null) {
+            nextClock.setType(HrmAttendanceClockTypeEnum.ON_DUTY.getType());
+            nextClock.setAttendanceTime(onDutyTime);
+            if (clockInRange != null && LocalDateTimeUtils.isBetween(
+                    clockInRange.getStartTime(), clockInRange.getEndTime(), now)) {
+                if (LocalDateTimeUtils.isBeforeOrEqual(now, onDutyTime)) {
+                    return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.NORMAL.getStatus());
+                }
+                return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.LATE.getStatus());
+            }
+            if (clockOutRange != null
+                    && LocalDateTimeUtils.isBetween(clockOutRange.getStartTime(), clockOutRange.getEndTime(), now)) {
+                nextClock.setType(HrmAttendanceClockTypeEnum.OFF_DUTY.getType()).setAttendanceTime(offDutyTime);
+                if (now.isBefore(offDutyTime)) {
+                    return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.EARLY.getStatus());
+                }
+                return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.NORMAL.getStatus());
+            }
+            return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.NOT_YET.getStatus());
+        }
+
+        // 已打上班卡：引导下班；已打过下班卡时允许更新
+        nextClock.setType(HrmAttendanceClockTypeEnum.OFF_DUTY.getType());
+        nextClock.setAttendanceTime(offDutyTime);
+        if (clockOutRange == null || LocalDateTimeUtils.isNotBetween(
+                clockOutRange.getStartTime(), clockOutRange.getEndTime(), now)) {
+            return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.NOT_YET.getStatus());
+        }
+        if (offDutyClock != null) {
+            return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.UPDATE.getStatus());
+        }
+        if (now.isBefore(offDutyTime)) {
+            return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.EARLY.getStatus());
+        }
+        return nextClock.setButtonStatus(HrmAttendanceClockButtonStatusEnum.NORMAL.getStatus());
+    }
+
+    private List<HrmPortalAttendanceClockDetailRespVO.TimelineItem> buildTimeline(
+            HrmPortalAttendanceClockDetailRespVO detail,
+            List<HrmAttendanceClockDO> dayClocks, LocalDateTime now) {
+        if (ObjUtil.hasEmpty(detail.getShift(), detail.getOnDutyAttendanceTime(), detail.getOffDutyAttendanceTime())) {
+            return Collections.emptyList();
+        }
+        HrmPortalAttendanceClockDetailRespVO.TimelineItem onDutyItem = buildTimelineItem(
+                HrmAttendanceClockTypeEnum.ON_DUTY.getType(), detail.getOnDutyAttendanceTime(),
+                CollUtil.findOne(dayClocks, clock -> ObjUtil.equals(
+                        clock.getType(), HrmAttendanceClockTypeEnum.ON_DUTY.getType())), now);
+        HrmPortalAttendanceClockDetailRespVO.TimelineItem offDutyItem = buildTimelineItem(
+                HrmAttendanceClockTypeEnum.OFF_DUTY.getType(), detail.getOffDutyAttendanceTime(),
+                CollUtil.findOne(dayClocks, clock -> ObjUtil.equals(
+                        clock.getType(), HrmAttendanceClockTypeEnum.OFF_DUTY.getType())), now);
+        return Arrays.asList(onDutyItem, offDutyItem);
+    }
+
+    /**
+     * 构建打卡时间线条目
+     *
+     * @param type 打卡类型
+     * @param attendanceTime 应打卡时间
+     * @param clock 实际打卡记录
+     * @param now 当前时间
+     * @return 打卡时间线条目
+     */
+    private HrmPortalAttendanceClockDetailRespVO.TimelineItem buildTimelineItem(
+            Integer type, LocalDateTime attendanceTime, HrmAttendanceClockDO clock, LocalDateTime now) {
+        HrmPortalAttendanceClockDetailRespVO.TimelineItem item = new HrmPortalAttendanceClockDetailRespVO.TimelineItem()
+                .setType(type).setAttendanceTime(attendanceTime);
+        if (clock != null) {
+            return item.setClockTime(clock.getClockTime()).setStatus(clock.getStatus())
+                    .setMissCard(false).setAddress(clock.getAddress());
+        }
+        // 应打卡时间已过后仍无记录，展示缺卡
+        boolean missCard = LocalDateTimeUtils.isAfterOrEqual(now, attendanceTime);
+        return item.setMissCard(missCard)
+                .setStatus(missCard ? HrmAttendanceClockStatusEnum.MISS_CARD.getStatus() : null);
+    }
+
+    /**
+     * 校验手机打卡地点 / WiFi
+     *
+     * 仅开启定位时必须命中地点；仅开启 WiFi 时必须命中 WiFi；两者都开时满足其一即可。
+     */
+    private void validateMobileClockLocationAndWifi(
+            HrmAttendanceGroupDO group, HrmPortalAttendanceClockCreateReqVO createReqVO) {
+        boolean openPoint = Boolean.TRUE.equals(group.getOpenPointCard());
+        boolean openWifi = Boolean.TRUE.equals(group.getOpenWifiCard());
+        if (!openPoint && !openWifi) {
+            return;
+        }
+        if ((openPoint && isPointMatched(group.getPoints(), createReqVO))
+                || (openWifi && isWifiMatched(group.getWifis(), createReqVO))) {
+            return;
+        }
+        if (openPoint) {
+            throw exception(ATTENDANCE_CLOCK_POINT_INVALID);
+        }
+        throw exception(ATTENDANCE_CLOCK_WIFI_INVALID);
+    }
+
+    private boolean isPointMatched(List<HrmAttendanceGroupDO.Point> points,
+                                   HrmPortalAttendanceClockCreateReqVO createReqVO) {
+        if (ObjUtil.hasEmpty(points, createReqVO.getLatitude(), createReqVO.getLongitude())) {
+            return false;
+        }
+        double latitude = createReqVO.getLatitude().doubleValue();
+        double longitude = createReqVO.getLongitude().doubleValue();
+        return CollUtil.anyMatch(points, point -> {
+            // NumberUtils.getDistance 返回千米，考勤半径配置为米
+            double distanceMeter = NumberUtils.getDistance(latitude, longitude,
+                    point.getLatitude().doubleValue(), point.getLongitude().doubleValue()) * 1000;
+            return distanceMeter <= point.getRadius();
+        });
+    }
+
+    private boolean isWifiMatched(List<HrmAttendanceGroupDO.Wifi> wifis,
+                                  HrmPortalAttendanceClockCreateReqVO createReqVO) {
+        String requestMac = createReqVO.getMac();
+        String requestSsid = createReqVO.getSsid();
+        if (CollUtil.isEmpty(wifis) || ObjUtil.isAllEmpty(requestMac, requestSsid)) {
+            return false;
+        }
+        return CollUtil.anyMatch(wifis, wifi -> ObjUtil.equals(requestMac, wifi.getMac())
+                || ObjUtil.equals(requestSsid, wifi.getSsid()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveService.java
new file mode 100644
index 0000000..95f6b66
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveService.java
@@ -0,0 +1,106 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.record;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCancelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeavePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * HRM 考勤请假 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmAttendanceLeaveService {
+
+    /**
+     * 发起员工请假申请
+     *
+     * @param userId 用户编号
+     * @param reqVO 请假申请信息
+     * @return 请假记录编号
+     */
+    Long createLeave(Long userId, HrmAttendanceLeaveCreateReqVO reqVO);
+
+    /**
+     * 取消员工请假申请
+     *
+     * @param userId 用户编号
+     * @param reqVO 取消申请信息
+     */
+    void cancelLeave(Long userId, HrmAttendanceLeaveCancelReqVO reqVO);
+
+    /**
+     * 获得当前员工的请假列表
+     *
+     * @param userId 用户编号
+     * @return 请假列表
+     */
+    List<HrmAttendanceLeaveDO> getMyAttendanceLeaveList(Long userId);
+
+    /**
+     * 获得请假
+     *
+     * @param id 请假编号
+     * @return 请假
+     */
+    HrmAttendanceLeaveDO getAttendanceLeave(Long id);
+
+    /**
+     * 获得请假分页
+     *
+     * @param reqVO 分页查询条件
+     * @return 请假分页
+     */
+    PageResult<HrmAttendanceLeaveDO> getAttendanceLeavePage(HrmAttendanceLeavePageReqVO reqVO);
+
+    /**
+     * 获得请假列表
+     *
+     * @param reqVO 查询条件
+     * @return 请假列表
+     */
+    List<HrmAttendanceLeaveDO> getAttendanceLeaveList(HrmAttendanceLeavePageReqVO reqVO);
+
+    /**
+     * 获得指定员工的请假列表
+     *
+     * @param employeeId 员工编号
+     * @return 请假列表
+     */
+    List<HrmAttendanceLeaveDO> getAttendanceLeaveListByEmployeeId(Long employeeId);
+
+    /**
+     * 获得指定员工已生效的请假列表
+     *
+     * @param employeeId 员工编号
+     * @return 请假列表
+     */
+    List<HrmAttendanceLeaveDO> getEffectiveAttendanceLeaveListByEmployeeId(Long employeeId);
+
+    /**
+     * 获得指定员工在时间范围内已生效的请假列表
+     *
+     * @param employeeIds 员工编号数组
+     * @param leaveTimes 时间闭区间
+     * @return 请假列表
+     */
+    List<HrmAttendanceLeaveDO> getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(
+            Collection<Long> employeeIds, LocalDateTime[] leaveTimes);
+
+    /**
+     * 更新请假审批状态
+     *
+     * @param id 请假记录编号
+     * @param processInstanceId 流程实例编号
+     * @param status 审批状态
+     * @param reason 审批原因
+     */
+    void updateLeaveApprovalStatus(
+            Long id, String processInstanceId, Integer status, String reason);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveServiceImpl.java
new file mode 100644
index 0000000..e483343
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveServiceImpl.java
@@ -0,0 +1,216 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.record;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi;
+import cn.iocoder.yudao.module.bpm.api.task.dto.BpmProcessInstanceCreateReqDTO;
+import cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCancelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeavePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.record.HrmAttendanceLeaveMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_LEAVE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_LEAVE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_LEAVE_TIME_CONFLICT;
+
+/**
+ * HRM 考勤请假 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmAttendanceLeaveServiceImpl implements HrmAttendanceLeaveService {
+
+    public static final String LEAVE_PROCESS_KEY = "hrm_attendance_leave";
+
+    @Resource
+    private HrmAttendanceLeaveMapper attendanceLeaveMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private BpmProcessInstanceApi processInstanceApi;
+
+    @Override
+    @SuppressWarnings("ExtractMethodRecommender")
+    @Transactional(rollbackFor = Exception.class)
+    public Long createLeave(Long userId, HrmAttendanceLeaveCreateReqVO reqVO) {
+        // 1.1 校验当前用户已关联员工
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(userId);
+        // 1.2 锁定员工，避免同一员工并发创建重叠请假
+        employeeService.validateEmployeeExistsForUpdate(employee.getId());
+        // 1.3 校验请假时间未与审批中、已通过的申请重叠
+        Long conflictCount = attendanceLeaveMapper.selectCountByEmployeeIdAndTimeRangeAndApprovalStatusIn(
+                employee.getId(), new LocalDateTime[]{reqVO.getStartTime(), reqVO.getEndTime()},
+                Arrays.asList(BpmProcessInstanceStatusEnum.RUNNING.getStatus(), BpmProcessInstanceStatusEnum.APPROVE.getStatus()));
+        if (conflictCount > 0) {
+            throw exception(ATTENDANCE_LEAVE_TIME_CONFLICT);
+        }
+
+        // 2. 创建请假记录
+        HrmAttendanceLeaveDO attendanceLeave = BeanUtils.toBean(reqVO, HrmAttendanceLeaveDO.class)
+                .setEmployeeId(employee.getId()).setApprovalStatus(BpmProcessInstanceStatusEnum.RUNNING.getStatus());
+        attendanceLeaveMapper.insert(attendanceLeave);
+
+        // 3. 构建流程变量并发起审批流程
+        Map<String, Object> variables = new HashMap<>();
+        variables.put("employeeDeptId", employee.getDeptId());
+        variables.put("employeeId", employee.getId());
+        variables.put("employeeName", employee.getName());
+        variables.put("leaveType", reqVO.getType());
+        variables.put("startTime", reqVO.getStartTime().toString());
+        variables.put("endTime", reqVO.getEndTime().toString());
+        variables.put("day", reqVO.getDay());
+        variables.put("reason", reqVO.getReason());
+        BpmProcessInstanceCreateReqDTO processInstanceCreateReqDTO = new BpmProcessInstanceCreateReqDTO();
+        processInstanceCreateReqDTO.setProcessDefinitionKey(LEAVE_PROCESS_KEY);
+        processInstanceCreateReqDTO.setBusinessKey(String.valueOf(attendanceLeave.getId()));
+        processInstanceCreateReqDTO.setVariables(variables);
+        String processInstanceId = processInstanceApi.createProcessInstance(userId, processInstanceCreateReqDTO);
+        attendanceLeaveMapper.updateById(new HrmAttendanceLeaveDO().setId(attendanceLeave.getId())
+                .setProcessInstanceId(processInstanceId));
+        return attendanceLeave.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void cancelLeave(Long userId, HrmAttendanceLeaveCancelReqVO reqVO) {
+        // 1. 校验请假申请属于当前员工，且处于审批中
+        HrmEmployeeDO employee = employeeService.validateEmployeeBySelf(userId);
+        HrmAttendanceLeaveDO attendanceLeave = validateAttendanceLeaveExists(reqVO.getId());
+        if (ObjUtil.notEqual(attendanceLeave.getEmployeeId(), employee.getId())) {
+            throw exception(ATTENDANCE_LEAVE_NOT_EXISTS);
+        }
+        if (ObjUtil.notEqual(attendanceLeave.getApprovalStatus(), BpmProcessInstanceStatusEnum.RUNNING.getStatus())
+                || StrUtil.isBlank(attendanceLeave.getProcessInstanceId())) {
+            throw exception(ATTENDANCE_LEAVE_STATUS_INVALID);
+        }
+
+        // 2. 取消审批流程并更新请假审批状态
+        processInstanceApi.cancelProcessInstanceByStartUser(
+                userId, attendanceLeave.getProcessInstanceId(), reqVO.getReason());
+        updateLeaveApprovalStatus(attendanceLeave.getId(), attendanceLeave.getProcessInstanceId(),
+                BpmProcessInstanceStatusEnum.CANCEL.getStatus(), reqVO.getReason());
+    }
+
+    @Override
+    public List<HrmAttendanceLeaveDO> getMyAttendanceLeaveList(Long userId) {
+        return attendanceLeaveMapper.selectListByEmployeeId(employeeService.validateEmployeeBySelf(userId).getId());
+    }
+
+    @Override
+    public HrmAttendanceLeaveDO getAttendanceLeave(Long id) {
+        return attendanceLeaveMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<HrmAttendanceLeaveDO> getAttendanceLeavePage(HrmAttendanceLeavePageReqVO reqVO) {
+        // 1. 解析员工筛选条件
+        Collection<Long> employeeIds = resolveEmployeeIds(reqVO.getEmployeeId(), reqVO.getDeptIds(),
+                reqVO.getEmployeeKeyword());
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return PageResult.empty();
+        }
+        reqVO.setEmployeeIds(employeeIds);
+
+        // 2. 查询请假分页
+        return attendanceLeaveMapper.selectPage(reqVO);
+    }
+
+    @Override
+    public List<HrmAttendanceLeaveDO> getAttendanceLeaveList(HrmAttendanceLeavePageReqVO reqVO) {
+        // 1. 解析员工筛选条件
+        Collection<Long> employeeIds = resolveEmployeeIds(reqVO.getEmployeeId(), reqVO.getDeptIds(),
+                reqVO.getEmployeeKeyword());
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        reqVO.setEmployeeIds(employeeIds);
+
+        // 2. 查询请假列表
+        return attendanceLeaveMapper.selectList(reqVO);
+    }
+
+    @Override
+    public List<HrmAttendanceLeaveDO> getAttendanceLeaveListByEmployeeId(Long employeeId) {
+        return attendanceLeaveMapper.selectListByEmployeeId(employeeId);
+    }
+
+    @Override
+    public List<HrmAttendanceLeaveDO> getEffectiveAttendanceLeaveListByEmployeeId(Long employeeId) {
+        return attendanceLeaveMapper.selectListByEmployeeIdAndApprovalStatus(employeeId, BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+    }
+
+    @Override
+    public List<HrmAttendanceLeaveDO> getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(
+            Collection<Long> employeeIds, LocalDateTime[] leaveTimes) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        return attendanceLeaveMapper.selectListByEmployeeIdsAndTimeRangeAndApprovalStatus(
+                employeeIds, leaveTimes, BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+    }
+
+    @Override
+    public void updateLeaveApprovalStatus(
+            Long id, String processInstanceId, Integer status, String reason) {
+        // 1. 仅处理当前审批流程的结束状态
+        if (!BpmProcessInstanceStatusEnum.isProcessEndStatus(status)) {
+            return;
+        }
+        HrmAttendanceLeaveDO attendanceLeave = validateAttendanceLeaveExists(id);
+        if ((attendanceLeave.getProcessInstanceId() != null
+                && ObjUtil.notEqual(attendanceLeave.getProcessInstanceId(), processInstanceId))
+                || ObjUtil.notEqual(attendanceLeave.getApprovalStatus(), BpmProcessInstanceStatusEnum.RUNNING.getStatus())) {
+            return;
+        }
+
+        // 2. 仅允许当前审批中的流程写入一次终态
+        attendanceLeaveMapper.updateApprovalResultByIdAndProcessInstanceIdAndApprovalStatus(
+                id, processInstanceId, BpmProcessInstanceStatusEnum.RUNNING.getStatus(),
+                new HrmAttendanceLeaveDO().setProcessInstanceId(processInstanceId)
+                        .setApprovalStatus(status).setApprovalTime(LocalDateTime.now()).setApprovalReason(reason));
+    }
+
+    private HrmAttendanceLeaveDO validateAttendanceLeaveExists(Long id) {
+        HrmAttendanceLeaveDO attendanceLeave = attendanceLeaveMapper.selectById(id);
+        if (attendanceLeave == null) {
+            throw exception(ATTENDANCE_LEAVE_NOT_EXISTS);
+        }
+        return attendanceLeave;
+    }
+
+    private Collection<Long> resolveEmployeeIds(
+            Long employeeId, List<Long> deptIds, String employeeKeyword) {
+        if (employeeId == null && CollUtil.isEmpty(deptIds) && StrUtil.isBlank(employeeKeyword)) {
+            return null;
+        }
+        HrmEmployeeListReqVO employeeReqVO = new HrmEmployeeListReqVO()
+                .setIds(employeeId == null ? null : Collections.singletonList(employeeId))
+                .setSearch(employeeKeyword).setDeptIds(deptIds);
+        return convertList(employeeService.getEmployeeList(employeeReqVO), HrmEmployeeDO::getId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/listener/HrmAttendanceLeaveStatusListener.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/listener/HrmAttendanceLeaveStatusListener.java
new file mode 100644
index 0000000..a8166e3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/record/listener/HrmAttendanceLeaveStatusListener.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.record.listener;
+
+import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEvent;
+import cn.iocoder.yudao.module.bpm.api.event.BpmProcessInstanceStatusEventListener;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceLeaveService;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceLeaveServiceImpl;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Component;
+
+/**
+ * HRM 请假审批状态监听器
+ *
+ * @author 芋道源码
+ */
+@Component
+public class HrmAttendanceLeaveStatusListener extends BpmProcessInstanceStatusEventListener {
+
+    @Resource
+    private HrmAttendanceLeaveService attendanceLeaveService;
+
+    @Override
+    protected String getProcessDefinitionKey() {
+        return HrmAttendanceLeaveServiceImpl.LEAVE_PROCESS_KEY;
+    }
+
+    @Override
+    protected void onEvent(BpmProcessInstanceStatusEvent event) {
+        attendanceLeaveService.updateLeaveApprovalStatus(
+                Long.parseLong(event.getBusinessKey()), event.getId(), event.getStatus(), event.getReason());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsService.java
new file mode 100644
index 0000000..f827f03
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsService.java
@@ -0,0 +1,100 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.statistics;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthDailyOverviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordRespVO;
+
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 考勤统计 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmAttendanceStatisticsService {
+
+    /**
+     * 获得员工考勤日详情
+     *
+     * @param reqVO 查询条件
+     * @return 考勤日详情
+     */
+    HrmAttendanceDailyDetailRespVO getAttendanceDailyDetail(HrmAttendanceDailyDetailReqVO reqVO);
+
+    /**
+     * 获得员工月度考勤汇总分页
+     *
+     * @param reqVO 分页查询条件
+     * @return 月度考勤汇总分页
+     */
+    PageResult<HrmAttendanceMonthRecordRespVO> getAttendanceMonthRecordPage(HrmAttendanceMonthRecordPageReqVO reqVO);
+
+    /**
+     * 获得员工月度考勤汇总列表
+     *
+     * @param reqVO 查询条件
+     * @return 月度考勤汇总列表
+     */
+    List<HrmAttendanceMonthRecordRespVO> getAttendanceMonthRecordList(HrmAttendanceMonthRecordPageReqVO reqVO);
+
+    /**
+     * 获得指定员工的月度考勤汇总列表
+     *
+     * @param year 年份
+     * @param month 月份
+     * @param employeeIds 员工编号数组
+     * @return 月度考勤汇总列表
+     */
+    List<HrmAttendanceMonthRecordRespVO> getAttendanceMonthRecordList(
+            Integer year, Integer month, List<Long> employeeIds);
+
+    /**
+     * 获得指定员工的月度考勤汇总 Map
+     *
+     * @param year 年份
+     * @param month 月份
+     * @param employeeIds 员工编号数组
+     * @return 员工编号与月度考勤汇总的映射
+     */
+    default Map<Long, HrmAttendanceMonthRecordRespVO> getAttendanceMonthRecordMap(
+            Integer year, Integer month, List<Long> employeeIds) {
+        return convertMap(getAttendanceMonthRecordList(year, month, employeeIds),
+                HrmAttendanceMonthRecordRespVO::getEmployeeId);
+    }
+
+    /**
+     * 获得员工月度打卡概况分页
+     *
+     * @param reqVO 分页查询条件
+     * @return 月度打卡概况分页
+     */
+    PageResult<HrmAttendanceMonthDailyOverviewRespVO> getAttendanceMonthDailyOverviewPage(
+            HrmAttendanceMonthRecordPageReqVO reqVO);
+
+    /**
+     * 获得员工月度打卡概况列表
+     *
+     * @param reqVO 查询条件
+     * @return 月度打卡概况列表
+     */
+    List<HrmAttendanceMonthDailyOverviewRespVO> getAttendanceMonthDailyOverviewList(
+            HrmAttendanceMonthRecordPageReqVO reqVO);
+
+    /**
+     * 获得员工考勤月详情
+     *
+     * @param employeeId 员工编号
+     * @param year 年份
+     * @param month 月份
+     * @return 考勤月详情
+     */
+    HrmAttendanceMonthDetailRespVO getAttendanceMonthDetail(Long employeeId, Integer year, Integer month);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsServiceImpl.java
new file mode 100644
index 0000000..d585b7c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsServiceImpl.java
@@ -0,0 +1,1112 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.statistics;
+
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceGroupService;
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceHolidayService;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceClockService;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceLeaveService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.hutool.core.util.NumberUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.TimeRange;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.PageUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyOverviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthDailyOverviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStageEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceLateEarlyDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.statistics.HrmAttendanceResultEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import com.google.common.annotations.VisibleForTesting;
+import jakarta.annotation.Resource;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.Duration;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.temporal.ChronoUnit;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.function.Function;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getSumValue;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceAdd;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceMultiply;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceScale;
+
+/**
+ * HRM 考勤统计 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmAttendanceStatisticsServiceImpl implements HrmAttendanceStatisticsService {
+
+    @Resource
+    private HrmAttendanceClockService attendanceClockService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmAttendanceLeaveService attendanceLeaveService;
+    @Resource
+    private HrmAttendanceGroupService attendanceGroupService;
+    @Resource
+    private HrmAttendanceHolidayService attendanceHolidayService;
+
+    @Override
+    public HrmAttendanceDailyDetailRespVO getAttendanceDailyDetail(HrmAttendanceDailyDetailReqVO reqVO) {
+        // 1.1 查询员工
+        HrmEmployeeDO employee = employeeService.getEmployee(reqVO.getEmployeeId());
+        if (employee == null) {
+            return null;
+        }
+        LocalDate attendanceDate = reqVO.getAttendanceTime().toLocalDate();
+        // 1.2 查询员工考勤组和相邻两日班次，用于识别跨日班次的业务日期
+        HrmAttendanceGroupDO attendanceGroup = attendanceGroupService.getMyAttendanceGroup(employee.getId());
+        Map<LocalDate, HrmAttendanceGroupDO.Shift> shiftMap = getEmployeeShiftMap(
+                attendanceGroup, attendanceDate.minusDays(1), attendanceDate);
+        HrmAttendanceGroupDO.Shift shift = shiftMap.get(attendanceDate);
+        // 1.3 查询并归集当前业务日的打卡记录
+        List<HrmAttendanceClockDO> clockList = getDateClockListMap(
+                getEmployeeClockListForAttendanceTimes(employee.getId(),
+                        LocalDateTimeUtils.getDateTimeRange(attendanceDate, attendanceDate)), shiftMap)
+                .getOrDefault(attendanceDate, Collections.emptyList());
+        // 1.4 查询覆盖当前班次的有效请假记录
+        TimeRange shiftTimeRange = buildShiftTimeRange(attendanceDate, shift);
+        LocalDateTime[] leaveTimes = shiftTimeRange == null
+                ? LocalDateTimeUtils.getDateTimeRange(attendanceDate, attendanceDate)
+                : new LocalDateTime[]{shiftTimeRange.getStartTime(), shiftTimeRange.getEndTime()};
+        List<HrmAttendanceLeaveDO> leaveList = attendanceLeaveService
+                .getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(
+                        Collections.singleton(employee.getId()), leaveTimes);
+
+        // 2. 计算单日考勤明细
+        return buildDailyDetail(employee, attendanceDate, clockList,
+                attendanceGroup != null, shift, leaveList, LocalDateTime.now());
+    }
+
+    @Override
+    public PageResult<HrmAttendanceMonthRecordRespVO> getAttendanceMonthRecordPage(
+            HrmAttendanceMonthRecordPageReqVO reqVO) {
+        // 1. 未筛选全勤时，分页查询员工并计算月度汇总
+        if (reqVO.getFullAttendance() == null) {
+            PageResult<HrmEmployeeDO> employeePage = employeeService.getEmployeePage(buildEmployeePageReqVO(reqVO));
+            List<HrmAttendanceMonthRecordRespVO> monthSummaryList = buildMonthSummaryList(
+                    reqVO.getYear(), reqVO.getMonth(), employeePage.getList());
+            return new PageResult<>(monthSummaryList, employeePage.getTotal());
+        }
+
+        // 2. 筛选全勤时，计算全部员工的月度汇总并进行内存分页
+        List<HrmEmployeeDO> employeeList = getAttendanceEmployeeList(reqVO);
+        List<HrmAttendanceMonthRecordRespVO> monthSummaryList =
+                buildMonthSummaryList(reqVO.getYear(), reqVO.getMonth(), employeeList);
+        List<HrmAttendanceMonthRecordRespVO> filteredMonthSummaryList = filterList(monthSummaryList,
+                record -> Objects.equals(record.getFullAttendance(), reqVO.getFullAttendance()));
+        return PageUtils.buildPageResult(filteredMonthSummaryList, reqVO);
+    }
+
+    @Override
+    public List<HrmAttendanceMonthRecordRespVO> getAttendanceMonthRecordList(HrmAttendanceMonthRecordPageReqVO reqVO) {
+        // 1. 计算员工月度考勤汇总
+        List<HrmEmployeeDO> employeeList = getAttendanceEmployeeList(reqVO);
+        List<HrmAttendanceMonthRecordRespVO> monthSummaryList =
+                buildMonthSummaryList(reqVO.getYear(), reqVO.getMonth(), employeeList);
+
+        // 2. 按需过滤全勤条件
+        if (reqVO.getFullAttendance() == null) {
+            return monthSummaryList;
+        }
+        return filterList(monthSummaryList,
+                record -> Objects.equals(record.getFullAttendance(), reqVO.getFullAttendance()));
+    }
+
+    @Override
+    public List<HrmAttendanceMonthRecordRespVO> getAttendanceMonthRecordList(
+            Integer year, Integer month, List<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        // 1. 查询员工列表
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        List<HrmEmployeeDO> employeeList = filterAttendanceEmployeeList(
+                year, month, convertList(employeeIds, employeeMap::get));
+
+        // 2. 计算员工月度考勤汇总
+        return buildMonthSummaryList(year, month, employeeList);
+    }
+
+    @Override
+    public PageResult<HrmAttendanceMonthDailyOverviewRespVO> getAttendanceMonthDailyOverviewPage(
+            HrmAttendanceMonthRecordPageReqVO reqVO) {
+        // 1. 分页查询员工
+        PageResult<HrmEmployeeDO> employeePage = employeeService.getEmployeePage(buildEmployeePageReqVO(reqVO));
+
+        // 2. 计算员工月度打卡概况
+        List<HrmAttendanceMonthDailyOverviewRespVO> monthDailyOverviewList = buildMonthDailyOverviewList(
+                reqVO.getYear(), reqVO.getMonth(), employeePage.getList());
+        return new PageResult<>(monthDailyOverviewList, employeePage.getTotal());
+    }
+
+    @Override
+    public List<HrmAttendanceMonthDailyOverviewRespVO> getAttendanceMonthDailyOverviewList(
+            HrmAttendanceMonthRecordPageReqVO reqVO) {
+        // 1. 查询员工列表
+        List<HrmEmployeeDO> employeeList = getAttendanceEmployeeList(reqVO);
+
+        // 2. 计算员工月度打卡概况
+        return buildMonthDailyOverviewList(reqVO.getYear(), reqVO.getMonth(), employeeList);
+    }
+
+    @Override
+    public HrmAttendanceMonthDetailRespVO getAttendanceMonthDetail(
+            Long employeeId, Integer year, Integer month) {
+        // 1.1 查询员工
+        HrmEmployeeDO employee = employeeService.getEmployee(employeeId);
+        if (employee == null) {
+            return null;
+        }
+        // 1.2 查询员工当月的考勤关联数据
+        AttendanceMonthData monthData =
+                getAttendanceMonthData(year, month, Collections.singletonList(employee));
+
+        // 2. 拼接月度考勤详情
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(year, month);
+        List<HrmAttendanceLeaveDO> monthLeaveList = filterList(
+                monthData.getEmployeeLeaveList(employee.getId()),
+                leave -> LocalDateTimeUtils.isClosedRangeOverlap(
+                        leave.getStartTime(), leave.getEndTime(),
+                        monthTimes[0], monthTimes[1]));
+        List<HrmAttendanceLeaveRespVO> leaveList = convertList(monthLeaveList, leave ->
+                BeanUtils.toBean(leave, HrmAttendanceLeaveRespVO.class)
+                        .setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                        .setDeptId(employee.getDeptId()).setPostName(employee.getPostName()));
+        return new HrmAttendanceMonthDetailRespVO()
+                .setSummary(buildMonthSummary(employee, monthData))
+                .setDailyDetails(buildMonthDailyDetails(employee, monthData))
+                .setLeaves(leaveList);
+    }
+
+    // ==================== 排班解析 ====================
+
+    /**
+     * 获得员工指定日期范围的有效班次
+     *
+     * @param attendanceGroup 考勤组
+     * @param beginDate 开始日期
+     * @param endDate 结束日期
+     * @return 日期对应班次 Map
+     */
+    private Map<LocalDate, HrmAttendanceGroupDO.Shift> getEmployeeShiftMap(
+            HrmAttendanceGroupDO attendanceGroup, LocalDate beginDate, LocalDate endDate) {
+        if (attendanceGroup == null) {
+            return Collections.emptyMap();
+        }
+        Map<LocalDate, HrmAttendanceHolidayDO> holidayMap = attendanceHolidayService
+                .getAttendanceHolidayMap(LocalDateTimeUtils.getDateTimeRange(
+                        beginDate, endDate));
+        return attendanceGroupService.getAttendanceGroupShiftMap(attendanceGroup,
+                LocalDateTimeUtils.getDateList(beginDate,
+                        Math.toIntExact(ChronoUnit.DAYS.between(beginDate, endDate)) + 1),
+                holidayMap);
+    }
+
+    private List<HrmAttendanceDailyDetailRespVO> buildMonthDailyDetails(
+            HrmEmployeeDO employee, AttendanceMonthData monthData) {
+        Map<LocalDate, List<HrmAttendanceClockDO>> dateClockListMap =
+                getDateClockListMap(monthData.getEmployeeClockList(employee.getId()),
+                        monthData.getEmployeeShiftMap(employee.getId()));
+        Map<LocalDate, HrmAttendanceGroupDO.Shift> shiftMap =
+                monthData.getEmployeeShiftMap(employee.getId());
+        List<HrmAttendanceLeaveDO> leaveList = monthData.getEmployeeLeaveList(employee.getId());
+        return convertList(monthData.getAttendanceDateList(),
+                attendanceDate -> buildDailyDetail(employee, attendanceDate,
+                        dateClockListMap.getOrDefault(attendanceDate, Collections.emptyList()),
+                        monthData.getEmployeeAttendanceGroup(employee.getId()) != null,
+                        shiftMap.get(attendanceDate), leaveList, monthData.getCalculationTime()));
+    }
+
+    /**
+     * 构建员工单日考勤明细
+     *
+     * @param employee 员工
+     * @param attendanceDate 考勤日期
+     * @param clockList 打卡记录
+     * @param attendanceGroupConfigured 是否已配置考勤组
+     * @param shift 班次
+     * @param leaveList 请假记录
+     * @param calculationTime 统一计算时间
+     * @return 单日考勤明细
+     */
+    private HrmAttendanceDailyDetailRespVO buildDailyDetail(HrmEmployeeDO employee, LocalDate attendanceDate,
+                                                            List<HrmAttendanceClockDO> clockList,
+                                                            boolean attendanceGroupConfigured,
+                                                            HrmAttendanceGroupDO.Shift shift,
+                                                            List<HrmAttendanceLeaveDO> leaveList,
+                                                            LocalDateTime calculationTime) {
+        // 1. 设置员工和排班基础信息
+        HrmAttendanceDailyDetailRespVO respVO = new HrmAttendanceDailyDetailRespVO();
+        respVO.setEmployeeId(employee.getId()).setEmployeeName(employee.getName())
+                .setJobNumber(employee.getJobNumber()).setDeptId(employee.getDeptId())
+                .setPostName(employee.getPostName()).setAttendanceTime(attendanceDate.atStartOfDay());
+        if (shift != null) {
+            respVO.setShiftName(String.format("%s-%s", shift.getStartTime(), shift.getEndTime()));
+        }
+
+        // 2. 计算并设置单日考勤结果
+        boolean scheduledWorkday = isScheduledWorkday(employee, attendanceDate, shift);
+        AttendanceDayCalculation calculation = scheduledWorkday
+                ? calculateAttendanceDay(attendanceDate, shift, clockList, leaveList, calculationTime)
+                : AttendanceDayCalculation.rest(getActualClockCount(clockList));
+        respVO.setScheduled(scheduledWorkday)
+                .setRequiredClockCount(scheduledWorkday ? 2 : 0)
+                .setScheduledMinutes(calculation.getScheduledMinutes())
+                .setMisscardCount(calculation.getMisscardCount());
+        respVO.setAbsenteeism(calculation.getAbsenteeismMinutes() > 0)
+                .setAbsenteeismMinutes(calculation.getAbsenteeismMinutes())
+                .setAbsenteeismDays(calculation.getAbsenteeismDays());
+        respVO.setLeaveStatus(calculation.getLeaveMinutes() > 0)
+                .setLeaveMinutes(calculation.getLeaveMinutes())
+                .setLeaveDays(calculation.getLeaveDays());
+        respVO.setAttendanceResult(calculation.getAttendanceResult())
+                .setClockCount(calculation.getActualClockCount());
+        if (shift == null && !attendanceGroupConfigured) {
+            respVO.setAttendanceResult(HrmAttendanceResultEnum.NOT_SCHEDULED.getFormat());
+        }
+
+        // 3. 设置迟到和早退统计
+        if (scheduledWorkday) {
+            respVO.setLateCount(calculation.getLateCount()).setLateMinutes(calculation.getLateMinutes())
+                    .setEarlyCount(calculation.getEarlyCount()).setEarlyMinutes(calculation.getEarlyMinutes());
+        } else {
+            respVO.setLateCount(countClockByStatus(clockList, HrmAttendanceClockStatusEnum.LATE.getStatus()))
+                    .setLateMinutes(sumClockExceptionMinutesByStatus(
+                            clockList, HrmAttendanceClockStatusEnum.LATE.getStatus()))
+                    .setEarlyCount(countClockByStatus(clockList, HrmAttendanceClockStatusEnum.EARLY.getStatus()))
+                    .setEarlyMinutes(sumClockExceptionMinutesByStatus(
+                            clockList, HrmAttendanceClockStatusEnum.EARLY.getStatus()));
+        }
+
+        // 4. 排序并设置打卡记录
+        List<HrmAttendanceClockDO> sortedClockList = new ArrayList<>(clockList);
+        sortedClockList.sort(Comparator.comparing(HrmAttendanceClockDO::getClockTime));
+        respVO.setClockList(convertList(sortedClockList, clock -> {
+            HrmAttendanceClockRespVO clockRespVO = BeanUtils.toBean(clock, HrmAttendanceClockRespVO.class);
+            clockRespVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                    .setDeptId(employee.getDeptId()).setPostName(employee.getPostName());
+            return clockRespVO;
+        }));
+        return respVO;
+    }
+
+    // ==================== 单日考勤计算 ====================
+
+    /**
+     * 计算员工单日考勤结果
+     *
+     * @param attendanceDate 考勤日期
+     * @param shift 班次
+     * @param clockList 打卡记录
+     * @param leaveList 请假记录
+     * @param calculationTime 计算时间
+     * @return 单日考勤结果
+     */
+    @VisibleForTesting
+    AttendanceDayCalculation calculateAttendanceDay(LocalDate attendanceDate,
+                                                     HrmAttendanceGroupDO.Shift shift,
+                                                     List<HrmAttendanceClockDO> clockList,
+                                                     List<HrmAttendanceLeaveDO> leaveList,
+                                                     LocalDateTime calculationTime) {
+        calculationTime = calculationTime == null ? LocalDateTime.now() : calculationTime;
+        if (shift == null) {
+            return AttendanceDayCalculation.rest(getActualClockCount(clockList));
+        }
+        TimeRange shiftTimeRange = buildShiftTimeRange(attendanceDate, shift);
+        if (shiftTimeRange == null) {
+            return AttendanceDayCalculation.rest(getActualClockCount(clockList));
+        }
+
+        // 1.1 扣除班次休息时间，得到实际应工作范围
+        List<TimeRange> workRanges = buildWorkTimeRanges(shiftTimeRange, shift);
+        int scheduledMinutes = LocalDateTimeUtils.calculateDurationMinutes(workRanges);
+        // 1.2 过滤无效请假记录，并计算请假覆盖的工作范围
+        List<HrmAttendanceLeaveDO> validLeaveList = filterList(leaveList,
+                leave -> LocalDateTimeUtils.isTimeRangeValid(leave.getStartTime(), leave.getEndTime()));
+        List<TimeRange> leaveWorkRanges = buildLeaveWorkRanges(validLeaveList, workRanges);
+        int leaveMinutes = LocalDateTimeUtils.calculateDurationMinutes(leaveWorkRanges);
+        BigDecimal leaveDays = calculateDayRatio(leaveMinutes, scheduledMinutes);
+
+        // 2.1 匹配上、下班有效打卡记录
+        int lateCount = 0;
+        int lateMinutes = 0;
+        int earlyCount = 0;
+        int earlyMinutes = 0;
+        int misscardCount = 0;
+        int absenteeismMinutes = 0;
+        HrmAttendanceClockDO onDutyClock = findClockByType(
+                clockList, HrmAttendanceClockTypeEnum.ON_DUTY.getType());
+        HrmAttendanceClockDO offDutyClock = findClockByType(
+                clockList, HrmAttendanceClockTypeEnum.OFF_DUTY.getType());
+        int uncoveredMinutes = Math.max(scheduledMinutes - leaveMinutes, 0);
+        LocalDateTime clockInDeadline = getClockDeadline(attendanceDate,
+                shift.getClockInStartTime(), shift.getClockInEndTime(), shiftTimeRange.getStartTime());
+        LocalDateTime clockOutDeadline = getClockDeadline(attendanceDate,
+                shift.getClockOutStartTime(), shift.getClockOutEndTime(), shiftTimeRange.getEndTime());
+        // 2.2 下班打卡窗口结束且全天无打卡时，未请假时长计为旷工
+        if (onDutyClock == null && offDutyClock == null
+                && calculationTime.isAfter(clockOutDeadline)
+                && uncoveredMinutes > 0) {
+            absenteeismMinutes = uncoveredMinutes;
+        } else {
+            // 2.3 对应打卡窗口结束、没有打卡且未请假时，计为缺卡
+            if (onDutyClock == null
+                    && calculationTime.isAfter(clockInDeadline)
+                    && isAttendanceRequiredAt(validLeaveList, shiftTimeRange.getStartTime())) {
+                misscardCount++;
+            }
+            if (offDutyClock == null
+                    && calculationTime.isAfter(clockOutDeadline)
+                    && isAttendanceRequiredAt(validLeaveList, shiftTimeRange.getEndTime())) {
+                misscardCount++;
+            }
+            // 2.4 打卡晚于上班时间时，扣除休息及请假范围后计为迟到
+            if (onDutyClock != null && onDutyClock.getClockTime() != null
+                    && onDutyClock.getClockTime().isAfter(shiftTimeRange.getStartTime())) {
+                int minutes = calculateEffectiveExceptionMinutes(
+                        shiftTimeRange.getStartTime(), onDutyClock.getClockTime(), workRanges, leaveWorkRanges);
+                if (minutes > 0) {
+                    lateCount++;
+                    lateMinutes += minutes;
+                }
+            }
+            // 2.5 打卡早于下班时间时，扣除休息及请假范围后计为早退
+            if (offDutyClock != null && offDutyClock.getClockTime() != null
+                    && offDutyClock.getClockTime().isBefore(shiftTimeRange.getEndTime())) {
+                int minutes = calculateEffectiveExceptionMinutes(
+                        offDutyClock.getClockTime(), shiftTimeRange.getEndTime(), workRanges, leaveWorkRanges);
+                if (minutes > 0) {
+                    earlyCount++;
+                    earlyMinutes += minutes;
+                }
+            }
+        }
+
+        // 3. 汇总单日考勤结果
+        BigDecimal absenteeismDays = calculateDayRatio(absenteeismMinutes, scheduledMinutes);
+        int actualClockCount = getActualClockCount(clockList);
+        String attendanceResult = buildAttendanceResult(attendanceDate, calculationTime, scheduledMinutes,
+                leaveMinutes, leaveDays, absenteeismMinutes, absenteeismDays, misscardCount,
+                lateMinutes, earlyMinutes, actualClockCount, calculationTime.isAfter(clockOutDeadline));
+        return new AttendanceDayCalculation(scheduledMinutes, leaveMinutes, leaveDays,
+                lateCount, lateMinutes, earlyCount, earlyMinutes, misscardCount,
+                absenteeismMinutes, absenteeismDays, actualClockCount, attendanceResult);
+    }
+
+    private TimeRange buildShiftTimeRange(LocalDate attendanceDate, HrmAttendanceGroupDO.Shift shift) {
+        if (shift == null || shift.getStartTime() == null || shift.getEndTime() == null) {
+            return null;
+        }
+        LocalDateTime startTime = attendanceDate.atTime(shift.getStartTime());
+        LocalDateTime endTime = attendanceDate.atTime(shift.getEndTime());
+        if (LocalDateTimeUtils.isBeforeOrEqual(endTime, startTime)) {
+            endTime = endTime.plusDays(1);
+        }
+        return new TimeRange(startTime, endTime);
+    }
+
+    /**
+     * 获得指定应打卡时间所属打卡时间段的截止时间
+     *
+     * @param attendanceDate 考勤日期
+     * @param beginTime 打卡开始时间
+     * @param endTime 打卡结束时间
+     * @param attendanceTime 应打卡时间
+     * @return 打卡截止时间
+     */
+    private LocalDateTime getClockDeadline(LocalDate attendanceDate, LocalTime beginTime,
+                                           LocalTime endTime, LocalDateTime attendanceTime) {
+        TimeRange clockTimeRange = LocalDateTimeUtils.findDailyTimeRange(
+                attendanceDate, beginTime, endTime, attendanceTime);
+        return clockTimeRange == null ? attendanceTime : clockTimeRange.getEndTime();
+    }
+
+    /**
+     * 判断考勤日是否已经超过下班打卡截止时间
+     *
+     * @param attendanceDate 考勤日期
+     * @param shift 班次
+     * @param calculationTime 计算时间
+     * @return 是否已经结算
+     */
+    private boolean isAttendanceDaySettled(LocalDate attendanceDate, HrmAttendanceGroupDO.Shift shift,
+                                           LocalDateTime calculationTime) {
+        TimeRange shiftTimeRange = buildShiftTimeRange(attendanceDate, shift);
+        return shiftTimeRange != null && calculationTime.isAfter(getClockDeadline(
+                attendanceDate, shift.getClockOutStartTime(), shift.getClockOutEndTime(),
+                shiftTimeRange.getEndTime()));
+    }
+
+    /**
+     * 构建班次的有效工作时间范围，并按配置扣除休息时间
+     *
+     * @param shiftTimeRange 班次时间范围
+     * @param shift 班次配置
+     * @return 有效工作时间范围
+     */
+    private List<TimeRange> buildWorkTimeRanges(TimeRange shiftTimeRange, HrmAttendanceGroupDO.Shift shift) {
+        if (Boolean.FALSE.equals(shift.getExcludeRestTime())
+                || shift.getRestStartTime() == null || shift.getRestEndTime() == null) {
+            return Collections.singletonList(shiftTimeRange);
+        }
+        LocalDate firstDate = shiftTimeRange.getStartTime().toLocalDate().minusDays(1);
+        LocalDate lastDate = shiftTimeRange.getEndTime().toLocalDate();
+        List<TimeRange> restRanges = LocalDateTimeUtils.buildDailyTimeRanges(
+                firstDate, lastDate, shift.getRestStartTime(), shift.getRestEndTime());
+        List<TimeRange> workTimeRanges = new ArrayList<>(Collections.singletonList(shiftTimeRange));
+        for (TimeRange restRange : restRanges) {
+            workTimeRanges = LocalDateTimeUtils.subtractTimeRanges(workTimeRanges, restRange);
+        }
+        return LocalDateTimeUtils.mergeTimeRanges(workTimeRanges);
+    }
+
+    private List<TimeRange> buildLeaveWorkRanges(List<HrmAttendanceLeaveDO> leaveList,
+                                                  List<TimeRange> workRanges) {
+        List<TimeRange> ranges = new ArrayList<>();
+        for (HrmAttendanceLeaveDO leave : leaveList) {
+            TimeRange leaveRange = new TimeRange(leave.getStartTime(), leave.getEndTime());
+            for (TimeRange workRange : workRanges) {
+                TimeRange overlap = LocalDateTimeUtils.intersectTimeRange(leaveRange, workRange);
+                if (overlap != null) {
+                    ranges.add(overlap);
+                }
+            }
+        }
+        return LocalDateTimeUtils.mergeTimeRanges(ranges);
+    }
+
+    /**
+     * 计算异常时段中实际属于工作且未被请假覆盖的分钟数
+     *
+     * @param startTime 异常开始时间
+     * @param endTime 异常结束时间
+     * @param workRanges 工作时间范围
+     * @param leaveRanges 请假时间范围
+     * @return 有效异常分钟数
+     */
+    private int calculateEffectiveExceptionMinutes(LocalDateTime startTime, LocalDateTime endTime,
+                                                   List<TimeRange> workRanges, List<TimeRange> leaveRanges) {
+        if (LocalDateTimeUtils.isBeforeOrEqual(endTime, startTime)) {
+            return 0;
+        }
+        TimeRange exceptionRange = new TimeRange(startTime, endTime);
+        int workMinutes = LocalDateTimeUtils.calculateDurationMinutes(LocalDateTimeUtils.intersectTimeRanges(
+                workRanges, Collections.singletonList(exceptionRange)));
+        int leaveMinutes = LocalDateTimeUtils.calculateDurationMinutes(LocalDateTimeUtils.intersectTimeRanges(
+                leaveRanges, Collections.singletonList(exceptionRange)));
+        return Math.max(workMinutes - leaveMinutes, 0);
+    }
+
+    private boolean isAttendanceRequiredAt(List<HrmAttendanceLeaveDO> leaveList, LocalDateTime attendanceTime) {
+        return leaveList.stream().noneMatch(leave -> LocalDateTimeUtils.isBetween(
+                leave.getStartTime(), leave.getEndTime(), attendanceTime));
+    }
+
+    private HrmAttendanceClockDO findClockByType(List<HrmAttendanceClockDO> clockList, Integer type) {
+        Comparator<HrmAttendanceClockDO> comparator = Comparator.comparing(HrmAttendanceClockDO::getClockTime);
+        return clockList.stream()
+                .filter(clock -> clock.getClockTime() != null)
+                .filter(clock -> Objects.equals(clock.getStage() == null ? 1 : clock.getStage(), 1))
+                .filter(clock -> Objects.equals(clock.getType(), type))
+                .min(Objects.equals(type, HrmAttendanceClockTypeEnum.ON_DUTY.getType())
+                        ? comparator : comparator.reversed())
+                .orElse(null);
+    }
+
+    private BigDecimal calculateDayRatio(int minutes, int scheduledMinutes) {
+        if (minutes <= 0 || scheduledMinutes <= 0) {
+            return BigDecimal.ZERO.setScale(2, RoundingMode.HALF_UP);
+        }
+        return BigDecimal.valueOf(minutes)
+                .divide(BigDecimal.valueOf(scheduledMinutes), 2, RoundingMode.HALF_UP);
+    }
+
+    private String buildAttendanceResult(LocalDate attendanceDate, LocalDateTime currentTime, int scheduledMinutes,
+                                         int leaveMinutes, BigDecimal leaveDays, int absenteeismMinutes,
+                                         BigDecimal absenteeismDays, int misscardCount, int lateMinutes,
+                                         int earlyMinutes, int actualClockCount, boolean settled) {
+        if (attendanceDate.isAfter(currentTime.toLocalDate())) {
+            return HrmAttendanceResultEnum.FUTURE.getFormat();
+        }
+        boolean fullLeave = scheduledMinutes > 0 && leaveMinutes >= scheduledMinutes;
+        if (fullLeave && absenteeismMinutes == 0 && misscardCount == 0
+                && lateMinutes == 0 && earlyMinutes == 0) {
+            return HrmAttendanceResultEnum.LEAVE.getFormat();
+        }
+        List<String> results = new ArrayList<>();
+        if (leaveMinutes > 0) {
+            results.add(HrmAttendanceResultEnum.LEAVE_DAYS.format(NumberUtil.toStr(leaveDays)));
+        }
+        if (absenteeismMinutes > 0) {
+            if (leaveMinutes == 0 && absenteeismDays.compareTo(BigDecimal.ONE) == 0) {
+                results.add(HrmAttendanceResultEnum.ABSENTEEISM.getFormat());
+            } else {
+                results.add(HrmAttendanceResultEnum.ABSENTEEISM_DAYS.format(
+                        NumberUtil.toStr(absenteeismDays)));
+            }
+        }
+        if (misscardCount > 0) {
+            results.add(HrmAttendanceResultEnum.MISS_CARD.format(misscardCount));
+        }
+        if (lateMinutes > 0) {
+            results.add(HrmAttendanceResultEnum.LATE.format(lateMinutes));
+        }
+        if (earlyMinutes > 0) {
+            results.add(HrmAttendanceResultEnum.EARLY.format(earlyMinutes));
+        }
+        if (CollUtil.isNotEmpty(results)) {
+            return String.join(" / ", results);
+        }
+        return !settled || actualClockCount == 0
+                ? HrmAttendanceResultEnum.PENDING_CLOCK.getFormat()
+                : HrmAttendanceResultEnum.NORMAL.getFormat();
+    }
+
+    private List<HrmAttendanceMonthRecordRespVO> buildMonthSummaryList(
+            Integer year, Integer month, List<HrmEmployeeDO> employeeList) {
+        if (CollUtil.isEmpty(employeeList)) {
+            return Collections.emptyList();
+        }
+        AttendanceMonthData monthData = getAttendanceMonthData(year, month, employeeList);
+        return convertList(employeeList, employee -> buildMonthSummary(employee, monthData));
+    }
+
+    private List<HrmAttendanceMonthDailyOverviewRespVO> buildMonthDailyOverviewList(
+            Integer year, Integer month, List<HrmEmployeeDO> employeeList) {
+        if (CollUtil.isEmpty(employeeList)) {
+            return Collections.emptyList();
+        }
+        AttendanceMonthData monthData = getAttendanceMonthData(year, month, employeeList);
+        return convertList(employeeList, employee -> buildMonthDailyOverview(employee, monthData));
+    }
+
+    private HrmAttendanceMonthDailyOverviewRespVO buildMonthDailyOverview(
+            HrmEmployeeDO employee, AttendanceMonthData monthData) {
+        List<HrmAttendanceDailyDetailRespVO> dailyDetailList = buildMonthDailyDetails(employee, monthData);
+        Map<LocalDate, HrmAttendanceDailyOverviewRespVO> dailyClockMap = new LinkedHashMap<>();
+        for (HrmAttendanceDailyDetailRespVO dailyDetail : dailyDetailList) {
+            dailyClockMap.put(dailyDetail.getAttendanceTime().toLocalDate(), new HrmAttendanceDailyOverviewRespVO()
+                    .setClocks(dailyDetail.getClockList())
+                    .setAttendanceResult(dailyDetail.getAttendanceResult()));
+        }
+        HrmAttendanceMonthDailyOverviewRespVO respVO = new HrmAttendanceMonthDailyOverviewRespVO();
+        respVO.setEmployeeId(employee.getId()).setEmployeeName(employee.getName())
+                .setJobNumber(employee.getJobNumber()).setDeptId(employee.getDeptId())
+                .setPostName(employee.getPostName())
+                .setYear(monthData.getYear()).setMonth(monthData.getMonth()).setDailyClockMap(dailyClockMap);
+        return respVO;
+    }
+
+    private HrmAttendanceMonthRecordRespVO buildMonthSummary(
+            HrmEmployeeDO employee, AttendanceMonthData monthData) {
+        // 1. 归集员工当月打卡、班次和请假数据，逐日计算应出勤日结果
+        List<HrmAttendanceClockDO> clockList = monthData.getEmployeeClockList(employee.getId());
+        Map<LocalDate, HrmAttendanceGroupDO.Shift> shiftMap = monthData.getEmployeeShiftMap(employee.getId());
+        Map<LocalDate, List<HrmAttendanceClockDO>> dateClockListMap =
+                getDateClockListMap(clockList, shiftMap);
+        List<HrmAttendanceLeaveDO> leaveList = monthData.getEmployeeLeaveList(employee.getId());
+        List<LocalDate> scheduledDateList = filterList(monthData.getAttendanceDateList(),
+                attendanceDate -> isScheduledWorkday(employee, attendanceDate, shiftMap.get(attendanceDate))
+                        && isAttendanceDaySettled(attendanceDate, shiftMap.get(attendanceDate),
+                        monthData.getCalculationTime()));
+        List<AttendanceDayCalculation> dayCalculationList = convertList(scheduledDateList,
+                attendanceDate -> calculateAttendanceDay(attendanceDate, shiftMap.get(attendanceDate),
+                        dateClockListMap.getOrDefault(attendanceDate, Collections.emptyList()), leaveList,
+                        monthData.getCalculationTime()));
+
+        // 2. 拼接员工信息和基础出勤天数
+        HrmAttendanceMonthRecordRespVO respVO = new HrmAttendanceMonthRecordRespVO();
+        respVO.setEmployeeId(employee.getId()).setEmployeeName(employee.getName())
+                .setJobNumber(employee.getJobNumber()).setDeptId(employee.getDeptId())
+                .setPostName(employee.getPostName()).setEntryTime(employee.getEntryTime())
+                .setEmployeeStatus(employee.getStatus()).setWorkCity(employee.getWorkCity());
+        HrmAttendanceGroupDO attendanceGroup =
+                monthData.getEmployeeAttendanceGroup(employee.getId());
+        respVO.setAttendanceGroupName(attendanceGroup == null ? null : attendanceGroup.getName());
+        respVO.setYear(monthData.getYear()).setMonth(monthData.getMonth());
+        respVO.setAttendDays(scheduledDateList.size());
+        // 3. 汇总迟到、早退、缺卡、旷工和请假结果
+        if (CollUtil.isEmpty(dayCalculationList)) {
+            respVO.setLateCount(countClockByStatus(clockList, HrmAttendanceClockStatusEnum.LATE.getStatus()));
+            respVO.setEarlyCount(countClockByStatus(clockList, HrmAttendanceClockStatusEnum.EARLY.getStatus()));
+            respVO.setLateMinute(sumClockExceptionMinutesByStatus(
+                    clockList, HrmAttendanceClockStatusEnum.LATE.getStatus()));
+            respVO.setEarlyMinute(sumClockExceptionMinutesByStatus(
+                    clockList, HrmAttendanceClockStatusEnum.EARLY.getStatus()));
+        } else {
+            respVO.setLateCount(getSumValue(
+                    dayCalculationList, AttendanceDayCalculation::getLateCount, Integer::sum, 0));
+            respVO.setEarlyCount(getSumValue(
+                    dayCalculationList, AttendanceDayCalculation::getEarlyCount, Integer::sum, 0));
+            respVO.setLateMinute(getSumValue(
+                    dayCalculationList, AttendanceDayCalculation::getLateMinutes, Integer::sum, 0));
+            respVO.setEarlyMinute(getSumValue(
+                    dayCalculationList, AttendanceDayCalculation::getEarlyMinutes, Integer::sum, 0));
+        }
+        respVO.setMisscardCount(getSumValue(
+                dayCalculationList, AttendanceDayCalculation::getMisscardCount, Integer::sum, 0));
+        respVO.setAbsenteeismMinutes(getSumValue(
+                dayCalculationList, AttendanceDayCalculation::getAbsenteeismMinutes, Integer::sum, 0));
+        respVO.setAbsenteeismDays(sumDays(dayCalculationList, AttendanceDayCalculation::getAbsenteeismDays));
+        respVO.setLeaveMinutes(getSumValue(
+                dayCalculationList, AttendanceDayCalculation::getLeaveMinutes, Integer::sum, 0));
+        respVO.setLeaveDays(sumDays(dayCalculationList, AttendanceDayCalculation::getLeaveDays));
+
+        // 4. 计算实际出勤、考勤扣款和全勤结果
+        respVO.setActualDays(BigDecimal.valueOf(respVO.getAttendDays())
+                .subtract(respVO.getLeaveDays())
+                .subtract(respVO.getAbsenteeismDays())
+                .max(BigDecimal.ZERO)
+                .setScale(2, RoundingMode.HALF_UP));
+        setAttendanceDeductAmounts(respVO, monthData.getEmployeeDeductRule(employee.getId()));
+        respVO.setFullAttendance(respVO.getAttendDays() > 0
+                && respVO.getActualDays().compareTo(BigDecimal.valueOf(respVO.getAttendDays())) >= 0
+                && respVO.getLateCount() == 0 && respVO.getEarlyCount() == 0
+                && respVO.getMisscardCount() == 0
+                && respVO.getLeaveDays().compareTo(BigDecimal.ZERO) == 0
+                && respVO.getAbsenteeismDays().compareTo(BigDecimal.ZERO) == 0);
+        return respVO;
+    }
+
+    /**
+     * 根据员工所属考勤组的扣款规则，计算月度迟到、早退、旷工和缺卡扣款
+     *
+     * @param respVO 月度考勤汇总
+     * @param deductRule 扣款规则
+     */
+    @VisibleForTesting
+    void setAttendanceDeductAmounts(
+            HrmAttendanceMonthRecordRespVO respVO, HrmAttendanceGroupDO.DeductRule deductRule) {
+        if (deductRule == null) {
+            respVO.setLateDeductAmount(BigDecimal.ZERO).setEarlyDeductAmount(BigDecimal.ZERO)
+                    .setAbsenteeismDeductAmount(BigDecimal.ZERO).setMisscardDeductAmount(BigDecimal.ZERO)
+                    .setAttendanceDeductAmount(BigDecimal.ZERO);
+            return;
+        }
+        BigDecimal lateDeductAmount = calculateLateEarlyDeductAmount(
+                deductRule.getLateMethod(), deductRule.getLateDeductMoney(),
+                respVO.getLateCount(), respVO.getLateMinute());
+        BigDecimal earlyDeductAmount = calculateLateEarlyDeductAmount(
+                deductRule.getEarlyMethod(), deductRule.getEarlyDeductMoney(),
+                respVO.getEarlyCount(), respVO.getEarlyMinute());
+        BigDecimal absenteeismDeductAmount = multiplyDeductMoney(
+                deductRule.getAbsenteeismDeductMoney(), respVO.getAbsenteeismDays());
+        BigDecimal misscardDeductAmount = multiplyDeductMoney(
+                deductRule.getMisscardDeductMoney(), BigDecimal.valueOf(respVO.getMisscardCount()));
+        respVO.setLateDeductAmount(lateDeductAmount).setEarlyDeductAmount(earlyDeductAmount)
+                .setAbsenteeismDeductAmount(absenteeismDeductAmount)
+                .setMisscardDeductAmount(misscardDeductAmount)
+                .setAttendanceDeductAmount(priceAdd(lateDeductAmount, earlyDeductAmount,
+                        absenteeismDeductAmount, misscardDeductAmount));
+    }
+
+    @SuppressWarnings("EnhancedSwitchMigration")
+    private BigDecimal calculateLateEarlyDeductAmount(
+            Integer method, BigDecimal deductMoney, int count, int minutes) {
+        HrmAttendanceLateEarlyDeductMethodEnum methodEnum =
+                HrmAttendanceLateEarlyDeductMethodEnum.valueOf(method);
+        if (methodEnum == null || deductMoney == null) {
+            return BigDecimal.ZERO;
+        }
+        switch (methodEnum) {
+            case FIXED_MONTH:
+                return priceScale(deductMoney);
+            case BY_MINUTE:
+                return multiplyDeductMoney(deductMoney, BigDecimal.valueOf(minutes));
+            case BY_COUNT:
+                return multiplyDeductMoney(deductMoney, BigDecimal.valueOf(count));
+            default:
+                return BigDecimal.ZERO;
+        }
+    }
+
+    private BigDecimal multiplyDeductMoney(BigDecimal deductMoney, BigDecimal quantity) {
+        return ObjectUtil.defaultIfNull(priceMultiply(deductMoney, quantity), BigDecimal.ZERO);
+    }
+
+    private AttendanceMonthData getAttendanceMonthData(
+            Integer year, Integer month, List<HrmEmployeeDO> employeeList) {
+        LocalDateTime calculationTime = LocalDateTime.now();
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(year, month);
+        LocalDate monthBeginDate = monthTimes[0].toLocalDate();
+        LocalDate monthEndDate = monthTimes[1].toLocalDate();
+        List<LocalDate> attendanceDateList = LocalDateTimeUtils.getDateList(
+                monthBeginDate, monthBeginDate.lengthOfMonth());
+        List<LocalDate> shiftAttendanceDateList = LocalDateTimeUtils.getDateList(
+                monthBeginDate.minusDays(1), monthBeginDate.lengthOfMonth() + 1);
+        List<Long> employeeIds = convertList(employeeList, HrmEmployeeDO::getId);
+
+        // 1. 批量查询月度考勤关联数据
+        List<HrmAttendanceClockDO> clockList =
+                getEmployeeClockListForAttendanceTimes(employeeIds, monthTimes);
+        Map<Long, HrmAttendanceGroupDO> employeeAttendanceGroupMap =
+                attendanceGroupService.getAttendanceGroupMap(employeeIds);
+        Map<LocalDate, HrmAttendanceHolidayDO> holidayMap =
+                attendanceHolidayService.getAttendanceHolidayMap(
+                        LocalDateTimeUtils.getDateTimeRange(
+                                monthBeginDate.minusDays(1), monthEndDate));
+        List<HrmAttendanceLeaveDO> leaveList = attendanceLeaveService
+                .getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(
+                        employeeIds, LocalDateTimeUtils.getDateTimeRange(
+                                monthBeginDate, monthEndDate.plusDays(1)));
+
+        // 2.1 按考勤组解析班次，同一考勤组只计算一次
+        Map<Long, HrmAttendanceGroupDO> attendanceGroupMap = convertMap(
+                employeeAttendanceGroupMap.values(), HrmAttendanceGroupDO::getId);
+        Map<Long, Map<LocalDate, HrmAttendanceGroupDO.Shift>> attendanceGroupShiftMap = convertMap(
+                attendanceGroupMap.values(), HrmAttendanceGroupDO::getId,
+                attendanceGroup -> attendanceGroupService.getAttendanceGroupShiftMap(
+                        attendanceGroup, shiftAttendanceDateList, holidayMap));
+        // 2.2 按员工归集打卡、班次和请假数据
+        Map<Long, Map<LocalDate, HrmAttendanceGroupDO.Shift>> employeeShiftMap = convertMap(
+                employeeList, HrmEmployeeDO::getId, employee -> {
+                    HrmAttendanceGroupDO attendanceGroup = employeeAttendanceGroupMap.get(employee.getId());
+                    return attendanceGroup == null ? Collections.emptyMap()
+                            : attendanceGroupShiftMap.get(attendanceGroup.getId());
+                });
+        Map<Long, List<HrmAttendanceClockDO>> rawEmployeeClockListMap =
+                convertMultiMap(clockList, HrmAttendanceClockDO::getEmployeeId);
+        Map<Long, List<HrmAttendanceClockDO>> employeeClockListMap = convertMap(
+                employeeList, HrmEmployeeDO::getId, employee -> filterList(
+                        rawEmployeeClockListMap.getOrDefault(employee.getId(), Collections.emptyList()),
+                        clock -> isAttendanceDateInRange(clock, employeeShiftMap.get(employee.getId()),
+                                monthBeginDate, monthEndDate)));
+        Map<Long, List<HrmAttendanceLeaveDO>> employeeLeaveListMap =
+                convertMultiMap(leaveList, HrmAttendanceLeaveDO::getEmployeeId);
+        return new AttendanceMonthData(year, month, calculationTime,
+                attendanceDateList, employeeClockListMap, employeeAttendanceGroupMap,
+                employeeShiftMap, employeeLeaveListMap);
+    }
+
+    private List<HrmEmployeeDO> getAttendanceEmployeeList(HrmAttendanceMonthRecordPageReqVO reqVO) {
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(
+                reqVO.getYear(), reqVO.getMonth());
+        HrmEmployeeListReqVO employeeReqVO = new HrmEmployeeListReqVO();
+        employeeReqVO.setIds(reqVO.getEmployeeId() == null
+                ? null : Collections.singletonList(reqVO.getEmployeeId()));
+        employeeReqVO.setSearch(reqVO.getSearch()).setDeptIds(reqVO.getDeptIds())
+                .setActiveTime(monthTimes);
+        List<HrmEmployeeDO> employeeList = employeeService.getEmployeeList(employeeReqVO);
+        return employeeList;
+    }
+
+    private HrmEmployeePageReqVO buildEmployeePageReqVO(HrmAttendanceMonthRecordPageReqVO reqVO) {
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(
+                reqVO.getYear(), reqVO.getMonth());
+        HrmEmployeePageReqVO employeeReqVO = new HrmEmployeePageReqVO();
+        employeeReqVO.setIds(reqVO.getEmployeeId() == null
+                ? null : Collections.singletonList(reqVO.getEmployeeId()));
+        employeeReqVO.setSearch(reqVO.getSearch()).setDeptIds(reqVO.getDeptIds())
+                .setActiveTime(monthTimes);
+        employeeReqVO.setPageNo(reqVO.getPageNo()).setPageSize(reqVO.getPageSize());
+        return employeeReqVO;
+    }
+
+    private List<HrmEmployeeDO> filterAttendanceEmployeeList(
+            Integer year, Integer month, List<HrmEmployeeDO> employeeList) {
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(year, month);
+        return filterList(employeeList, employee -> employee != null
+                && employee.getEntryTime() != null
+                && LocalDateTimeUtils.isBeforeOrEqual(employee.getEntryTime(), monthTimes[1])
+                && (employee.getLeaveTime() == null
+                || LocalDateTimeUtils.isAfterOrEqual(employee.getLeaveTime(), monthTimes[0])));
+    }
+
+    private BigDecimal sumDays(List<AttendanceDayCalculation> dayCalculationList,
+                               Function<AttendanceDayCalculation, BigDecimal> valueFunction) {
+        return dayCalculationList.stream()
+                .map(valueFunction)
+                .reduce(BigDecimal.ZERO, BigDecimal::add)
+                .setScale(2, RoundingMode.HALF_UP);
+    }
+
+    private List<HrmAttendanceClockDO> getEmployeeClockListForAttendanceTimes(
+            Long employeeId, LocalDateTime[] attendanceTimes) {
+        LocalDate beginDate = attendanceTimes[0].toLocalDate();
+        LocalDate endDate = attendanceTimes[1].toLocalDate();
+        return attendanceClockService.getAttendanceClockListByEmployeeIdAndClockTime(employeeId,
+                LocalDateTimeUtils.getDateTimeRange(
+                        beginDate.minusDays(1), endDate.plusDays(1)));
+    }
+
+    private List<HrmAttendanceClockDO> getEmployeeClockListForAttendanceTimes(
+            List<Long> employeeIds, LocalDateTime[] attendanceTimes) {
+        LocalDate beginDate = attendanceTimes[0].toLocalDate();
+        LocalDate endDate = attendanceTimes[1].toLocalDate();
+        return attendanceClockService.getAttendanceClockListByEmployeeIdsAndClockTime(employeeIds,
+                LocalDateTimeUtils.getDateTimeRange(
+                        beginDate.minusDays(1), endDate.plusDays(1)));
+    }
+
+    private Map<LocalDate, List<HrmAttendanceClockDO>> getDateClockListMap(
+            List<HrmAttendanceClockDO> clockList,
+            Map<LocalDate, HrmAttendanceGroupDO.Shift> shiftMap) {
+        Map<LocalDate, List<HrmAttendanceClockDO>> result = new LinkedHashMap<>();
+        for (HrmAttendanceClockDO clock : clockList) {
+            LocalDate attendanceDate = getAttendanceDate(clock, shiftMap);
+            if (attendanceDate != null) {
+                result.computeIfAbsent(attendanceDate, key -> new ArrayList<>()).add(clock);
+            }
+        }
+        return result;
+    }
+
+    private boolean isAttendanceDateInRange(
+            HrmAttendanceClockDO clock, Map<LocalDate, HrmAttendanceGroupDO.Shift> shiftMap,
+            LocalDate beginDate, LocalDate endDate) {
+        LocalDate attendanceDate = getAttendanceDate(clock, shiftMap);
+        return attendanceDate != null && LocalDateTimeUtils.isBetween(beginDate, endDate, attendanceDate);
+    }
+
+    /**
+     * 根据应打卡时间和班次计算打卡所属业务日期
+     *
+     * @param clock 打卡记录
+     * @param shiftMap 日期对应班次 Map
+     * @return 打卡所属业务日期
+     */
+    @VisibleForTesting
+    LocalDate getAttendanceDate(HrmAttendanceClockDO clock,
+                                Map<LocalDate, HrmAttendanceGroupDO.Shift> shiftMap) {
+        if (clock.getAttendanceTime() == null) {
+            return clock.getClockTime() == null ? null : clock.getClockTime().toLocalDate();
+        }
+        LocalDate attendanceDate = clock.getAttendanceTime().toLocalDate();
+        if (isScheduledClockTime(clock, attendanceDate, shiftMap.get(attendanceDate))) {
+            return attendanceDate;
+        }
+        LocalDate previousAttendanceDate = attendanceDate.minusDays(1);
+        if (isScheduledClockTime(clock, previousAttendanceDate, shiftMap.get(previousAttendanceDate))) {
+            return previousAttendanceDate;
+        }
+        return attendanceDate;
+    }
+
+    /**
+     * 判断打卡记录的应打卡时间是否属于指定业务日期的班次
+     *
+     * @param clock 打卡记录
+     * @param attendanceDate 考勤业务日期
+     * @param shift 班次
+     * @return 是否属于指定业务日期的班次
+     */
+    private boolean isScheduledClockTime(
+            HrmAttendanceClockDO clock, LocalDate attendanceDate,
+            HrmAttendanceGroupDO.Shift shift) {
+        TimeRange shiftTimeRange = buildShiftTimeRange(attendanceDate, shift);
+        if (shiftTimeRange == null) {
+            return false;
+        }
+        LocalDateTime scheduledTime;
+        if (Objects.equals(clock.getType(), HrmAttendanceClockTypeEnum.ON_DUTY.getType())) {
+            scheduledTime = shiftTimeRange.getStartTime();
+        } else if (Objects.equals(clock.getType(), HrmAttendanceClockTypeEnum.OFF_DUTY.getType())) {
+            scheduledTime = shiftTimeRange.getEndTime();
+        } else {
+            return false;
+        }
+        return Objects.equals(clock.getAttendanceTime(), scheduledTime);
+    }
+
+    private boolean isScheduledWorkday(HrmEmployeeDO employee, LocalDate attendanceDate,
+                                       HrmAttendanceGroupDO.Shift shift) {
+        return shift != null
+                && (employee.getEntryTime() == null || LocalDateTimeUtils.isBeforeOrEqual(
+                        employee.getEntryTime().toLocalDate(), attendanceDate))
+                && (employee.getLeaveTime() == null || LocalDateTimeUtils.isAfterOrEqual(employee.getLeaveTime().toLocalDate(), attendanceDate));
+    }
+
+    private int getActualClockCount(List<HrmAttendanceClockDO> clockList) {
+        return (int) clockList.stream()
+                .filter(clock -> clock.getType() != null)
+                .filter(clock -> clock.getStage() == null
+                        || Objects.equals(clock.getStage(), HrmAttendanceClockStageEnum.FIRST.getStage()))
+                .map(HrmAttendanceClockDO::getType)
+                .distinct()
+                .count();
+    }
+
+    private int countClockByStatus(List<HrmAttendanceClockDO> clockList, Integer status) {
+        return (int) clockList.stream().filter(clock -> Objects.equals(clock.getStatus(), status)).count();
+    }
+
+    private int sumClockExceptionMinutesByStatus(List<HrmAttendanceClockDO> clockList, Integer status) {
+        return clockList.stream()
+                .filter(clock -> Objects.equals(clock.getStatus(), status))
+                .filter(clock -> clock.getAttendanceTime() != null && clock.getClockTime() != null)
+                .mapToInt(clock -> Math.toIntExact(Math.abs(Duration.between(
+                        clock.getAttendanceTime(), clock.getClockTime()).toMinutes())))
+                .sum();
+    }
+
+    /**
+     * 月度考勤计算所需的批量数据
+     */
+    @Getter
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class AttendanceMonthData {
+
+        /**
+         * 年份
+         */
+        private final Integer year;
+        /**
+         * 月份
+         */
+        private final Integer month;
+        /**
+         * 统一计算时间
+         */
+        private final LocalDateTime calculationTime;
+        /**
+         * 考勤日期列表
+         */
+        private final List<LocalDate> attendanceDateList;
+        /**
+         * 员工打卡记录 Map
+         */
+        private final Map<Long, List<HrmAttendanceClockDO>> employeeClockListMap;
+        /**
+         * 员工考勤组 Map
+         */
+        private final Map<Long, HrmAttendanceGroupDO> employeeAttendanceGroupMap;
+        /**
+         * 员工班次 Map
+         */
+        private final Map<Long, Map<LocalDate, HrmAttendanceGroupDO.Shift>> employeeShiftMap;
+        /**
+         * 员工有效请假记录 Map
+         */
+        private final Map<Long, List<HrmAttendanceLeaveDO>> employeeLeaveListMap;
+
+        private List<HrmAttendanceClockDO> getEmployeeClockList(Long employeeId) {
+            return employeeClockListMap.getOrDefault(employeeId, Collections.emptyList());
+        }
+
+        private HrmAttendanceGroupDO.DeductRule getEmployeeDeductRule(Long employeeId) {
+            HrmAttendanceGroupDO attendanceGroup = employeeAttendanceGroupMap.get(employeeId);
+            return attendanceGroup == null ? null : attendanceGroup.getDeductRule();
+        }
+
+        private HrmAttendanceGroupDO getEmployeeAttendanceGroup(Long employeeId) {
+            return employeeAttendanceGroupMap.get(employeeId);
+        }
+
+        private Map<LocalDate, HrmAttendanceGroupDO.Shift> getEmployeeShiftMap(Long employeeId) {
+            return employeeShiftMap.getOrDefault(employeeId, Collections.emptyMap());
+        }
+
+        private List<HrmAttendanceLeaveDO> getEmployeeLeaveList(Long employeeId) {
+            return employeeLeaveListMap.getOrDefault(employeeId, Collections.emptyList());
+        }
+
+    }
+
+    /**
+     * 员工单日考勤计算结果
+     */
+    @Getter
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    static class AttendanceDayCalculation {
+
+        /**
+         * 应出勤分钟数
+         */
+        private final int scheduledMinutes;
+        /**
+         * 请假分钟数
+         */
+        private final int leaveMinutes;
+        /**
+         * 请假天数
+         */
+        private final BigDecimal leaveDays;
+        /**
+         * 迟到次数
+         */
+        private final int lateCount;
+        /**
+         * 迟到分钟数
+         */
+        private final int lateMinutes;
+        /**
+         * 早退次数
+         */
+        private final int earlyCount;
+        /**
+         * 早退分钟数
+         */
+        private final int earlyMinutes;
+        /**
+         * 缺卡次数
+         */
+        private final int misscardCount;
+        /**
+         * 旷工分钟数
+         */
+        private final int absenteeismMinutes;
+        /**
+         * 旷工天数
+         */
+        private final BigDecimal absenteeismDays;
+        /**
+         * 实际打卡次数
+         */
+        private final int actualClockCount;
+        /**
+         * 考勤结果
+         */
+        private final String attendanceResult;
+
+        private static AttendanceDayCalculation rest(int actualClockCount) {
+            return new AttendanceDayCalculation(0, 0, BigDecimal.ZERO, 0, 0,
+                    0, 0, 0, 0, BigDecimal.ZERO, actualClockCount,
+                    HrmAttendanceResultEnum.REST.getFormat());
+        }
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigService.java
new file mode 100644
index 0000000..c3af1ff
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigService.java
@@ -0,0 +1,28 @@
+package cn.iocoder.yudao.module.hrm.service.config;
+
+import java.util.List;
+
+/**
+ * HRM 配置 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmConfigService {
+
+    /**
+     * 获得指定类型的配置值列表
+     *
+     * @param type 配置类型
+     * @return 配置值列表
+     */
+    List<String> getConfigValueList(Integer type);
+
+    /**
+     * 替换指定类型的配置值列表
+     *
+     * @param type 配置类型
+     * @param values 配置值列表
+     */
+    void replaceConfigValueList(Integer type, List<String> values);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigServiceImpl.java
new file mode 100644
index 0000000..476deae
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigServiceImpl.java
@@ -0,0 +1,50 @@
+package cn.iocoder.yudao.module.hrm.service.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.config.HrmConfigDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.config.HrmConfigMapper;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+
+/**
+ * HRM 配置 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmConfigServiceImpl implements HrmConfigService {
+
+    @Resource
+    private HrmConfigMapper hrmConfigMapper;
+
+    @Override
+    public List<String> getConfigValueList(Integer type) {
+        return convertList(hrmConfigMapper.selectListByType(type), HrmConfigDO::getValue);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void replaceConfigValueList(Integer type, List<String> values) {
+        // 1. 删除原配置
+        hrmConfigMapper.deleteByType(type);
+        if (CollUtil.isEmpty(values)) {
+            return;
+        }
+
+        // 2. 保存新配置
+        List<HrmConfigDO> configs = new ArrayList<>(values.size());
+        for (int i = 0; i < values.size(); i++) {
+            configs.add(HrmConfigDO.builder().type(type).value(values.get(i)).sort(i + 1).build());
+        }
+        hrmConfigMapper.insertBatch(configs);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigService.java
new file mode 100644
index 0000000..ac9d381
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigService.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.service.employee.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeArchiveFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeCreateFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+
+import java.util.List;
+import java.util.Set;
+
+/**
+ * HRM 员工字段配置 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeFieldConfigService {
+
+    /**
+     * 获得新建员工字段配置
+     *
+     * @param entryStatus 入职状态
+     * @return 字段配置列表
+     */
+    List<HrmEmployeeFieldConfigRespVO> getEmployeeCreateFieldConfigList(Integer entryStatus);
+
+    /**
+     * 保存新建员工字段配置
+     *
+     * @param reqVO 字段配置
+     */
+    void saveEmployeeCreateFieldConfig(HrmEmployeeCreateFieldConfigSaveReqVO reqVO);
+
+    /**
+     * 校验新建员工请求只包含当前配置可见的字段
+     *
+     * @param reqVO 员工保存请求
+     * @param entryStatus 目标入职状态
+     */
+    void validateEmployeeCreateFields(HrmEmployeeSaveReqVO reqVO, Integer entryStatus);
+
+    /**
+     * 获得员工档案字段配置
+     *
+     * @return 字段配置列表
+     */
+    List<HrmEmployeeFieldConfigRespVO> getEmployeeArchiveFieldConfigList();
+
+    /**
+     * 保存员工档案字段配置
+     *
+     * @param reqVO 字段配置
+     */
+    void saveEmployeeArchiveFieldConfig(HrmEmployeeArchiveFieldConfigSaveReqVO reqVO);
+
+    /**
+     * 获得员工端可见的档案字段名
+     *
+     * @return 字段名集合
+     */
+    Set<String> getVisibleArchiveFieldNames();
+
+    /**
+     * 获得允许员工编辑的档案字段名
+     *
+     * @return 字段名集合
+     */
+    Set<String> getEditableArchiveFieldNames();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigServiceImpl.java
new file mode 100644
index 0000000..e394ebf
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigServiceImpl.java
@@ -0,0 +1,223 @@
+package cn.iocoder.yudao.module.hrm.service.employee.config;
+
+import cn.hutool.core.bean.BeanUtil;
+import cn.hutool.core.util.BooleanUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.util.json.JsonUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeArchiveFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeCreateFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigValueVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeArchiveFieldEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeCreateFieldEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.config.HrmConfigService;
+import cn.iocoder.yudao.module.hrm.enums.config.HrmConfigTypeEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_FIELD_CONFIG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_FIELD_NOT_VISIBLE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_ARCHIVE_FIELD_CONFIG_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_ARCHIVE_FIELD_CONFIG_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CONFIG_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CREATE_FIELD_CONFIG_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CREATE_FIELD_CONFIG_UPDATE_SUCCESS;
+
+/**
+ * HRM 员工字段配置 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeFieldConfigServiceImpl implements HrmEmployeeFieldConfigService {
+
+    @Resource
+    private HrmConfigService configService;
+
+    @Override
+    public List<HrmEmployeeFieldConfigRespVO> getEmployeeCreateFieldConfigList(Integer entryStatus) {
+        Integer configType = getCreateFieldConfigType(entryStatus);
+        Map<String, HrmEmployeeFieldConfigValueVO> configMap = getFieldConfigMap(configType);
+        return convertList(HrmEmployeeCreateFieldEnum.values(), field -> {
+            HrmEmployeeFieldConfigValueVO config = configMap.get(field.getName());
+            boolean visibleLocked = Boolean.TRUE.equals(field.getVisibleLocked(entryStatus));
+            boolean visible = (visibleLocked || config == null)
+                    ? field.getDefaultVisible(entryStatus) : Boolean.TRUE.equals(config.getVisible());
+            return buildFieldConfigRespVO(field.getName(), field.getTitle(), field.getGroupName(), visible)
+                    .setVisibleLocked(visibleLocked);
+        });
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_CONFIG_TYPE, subType = HRM_EMPLOYEE_CREATE_FIELD_CONFIG_UPDATE_SUB_TYPE,
+            bizNo = "{{#configType}}", success = HRM_EMPLOYEE_CREATE_FIELD_CONFIG_UPDATE_SUCCESS)
+    public void saveEmployeeCreateFieldConfig(HrmEmployeeCreateFieldConfigSaveReqVO reqVO) {
+        // 1. 校验字段配置
+        Integer configType = getCreateFieldConfigType(reqVO.getEntryStatus());
+        Map<String, HrmEmployeeFieldConfigSaveReqVO> fieldConfigMap = validateFieldConfigList(reqVO.getFields());
+        for (String name : fieldConfigMap.keySet()) {
+            if (HrmEmployeeCreateFieldEnum.valueOfName(name) == null) {
+                throw exception(EMPLOYEE_FIELD_CONFIG_INVALID, name);
+            }
+        }
+        HrmEmployeeCreateFieldConfigSaveReqVO oldConfig = new HrmEmployeeCreateFieldConfigSaveReqVO()
+                .setEntryStatus(reqVO.getEntryStatus())
+                .setFields(BeanUtils.toBean(getEmployeeCreateFieldConfigList(reqVO.getEntryStatus()),
+                        HrmEmployeeFieldConfigSaveReqVO.class));
+
+        // 2. 保存字段配置
+        List<String> configValues = convertList(HrmEmployeeCreateFieldEnum.values(), field -> {
+            HrmEmployeeFieldConfigSaveReqVO fieldConfig = fieldConfigMap.get(field.getName());
+            boolean visible = (Boolean.TRUE.equals(field.getVisibleLocked(reqVO.getEntryStatus()))
+                    || fieldConfig == null) ? field.getDefaultVisible(reqVO.getEntryStatus())
+                    : Boolean.TRUE.equals(fieldConfig.getVisible());
+            return JsonUtils.toJsonString(new HrmEmployeeFieldConfigValueVO(field.getName(), visible, null));
+        });
+        configService.replaceConfigValueList(configType, configValues);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("configType", configType);
+        LogRecordContext.putVariable("configGroupName",
+                HrmEmployeeEntryStatusEnum.valueOf(reqVO.getEntryStatus()).getName() + "员工新建字段配置");
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, oldConfig);
+    }
+
+    @Override
+    public void validateEmployeeCreateFields(HrmEmployeeSaveReqVO reqVO, Integer entryStatus) {
+        for (HrmEmployeeFieldConfigRespVO field : getEmployeeCreateFieldConfigList(entryStatus)) {
+            if (Boolean.TRUE.equals(field.getVisible())
+                    || HrmEmployeeCreateFieldEnum.CANDIDATE_ID.getName().equals(field.getName())) {
+                continue;
+            }
+            if (ObjectUtil.isNotEmpty(BeanUtil.getFieldValue(reqVO, field.getName()))) {
+                throw exception(EMPLOYEE_FIELD_NOT_VISIBLE, field.getTitle());
+            }
+        }
+    }
+
+    @Override
+    @SuppressWarnings("DuplicatedCode")
+    public List<HrmEmployeeFieldConfigRespVO> getEmployeeArchiveFieldConfigList() {
+        Map<String, HrmEmployeeFieldConfigValueVO> configMap = getFieldConfigMap(
+                HrmConfigTypeEnum.EMPLOYEE_ARCHIVE_FIELD.getType());
+        return convertList(HrmEmployeeArchiveFieldEnum.values(), field -> {
+            HrmEmployeeFieldConfigValueVO config = configMap.get(field.getName());
+            boolean visible = config == null ? field.getDefaultVisible() : Boolean.TRUE.equals(config.getVisible());
+            boolean editable = config == null ? field.getDefaultEditable() : Boolean.TRUE.equals(config.getEditable());
+            if (BooleanUtil.isFalse(visible) || Boolean.TRUE.equals(field.getEditableLocked())) {
+                editable = false;
+            }
+            return buildFieldConfigRespVO(field.getName(), field.getTitle(), field.getGroupName(), visible)
+                    .setEditable(editable).setEditableLocked(field.getEditableLocked());
+        });
+    }
+
+    @Override
+    @SuppressWarnings("DuplicatedCode")
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_CONFIG_TYPE, subType = HRM_EMPLOYEE_ARCHIVE_FIELD_CONFIG_UPDATE_SUB_TYPE,
+            bizNo = "{{#configType}}", success = HRM_EMPLOYEE_ARCHIVE_FIELD_CONFIG_UPDATE_SUCCESS)
+    public void saveEmployeeArchiveFieldConfig(HrmEmployeeArchiveFieldConfigSaveReqVO reqVO) {
+        // 1. 校验字段配置
+        Map<String, HrmEmployeeFieldConfigSaveReqVO> fieldConfigMap = validateFieldConfigList(reqVO.getFields());
+        for (String name : fieldConfigMap.keySet()) {
+            if (HrmEmployeeArchiveFieldEnum.valueOfName(name) == null) {
+                throw exception(EMPLOYEE_FIELD_CONFIG_INVALID, name);
+            }
+        }
+        HrmEmployeeArchiveFieldConfigSaveReqVO oldConfig = new HrmEmployeeArchiveFieldConfigSaveReqVO()
+                .setFields(BeanUtils.toBean(getEmployeeArchiveFieldConfigList(),
+                        HrmEmployeeFieldConfigSaveReqVO.class));
+
+        // 2. 保存字段配置
+        List<String> configValues = convertList(HrmEmployeeArchiveFieldEnum.values(), field -> {
+            HrmEmployeeFieldConfigSaveReqVO fieldConfig = fieldConfigMap.get(field.getName());
+            boolean visible = fieldConfig == null ? field.getDefaultVisible()
+                    : Boolean.TRUE.equals(fieldConfig.getVisible());
+            boolean editable = fieldConfig == null ? field.getDefaultEditable()
+                    : Boolean.TRUE.equals(fieldConfig.getEditable());
+            if (BooleanUtil.isFalse(visible) || Boolean.TRUE.equals(field.getEditableLocked())) {
+                editable = false;
+            }
+            return JsonUtils.toJsonString(
+                    new HrmEmployeeFieldConfigValueVO(field.getName(), visible, editable));
+        });
+        configService.replaceConfigValueList(HrmConfigTypeEnum.EMPLOYEE_ARCHIVE_FIELD.getType(), configValues);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("configType", HrmConfigTypeEnum.EMPLOYEE_ARCHIVE_FIELD.getType());
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, oldConfig);
+    }
+
+    @Override
+    public Set<String> getVisibleArchiveFieldNames() {
+        return convertSet(getEmployeeArchiveFieldConfigList(), HrmEmployeeFieldConfigRespVO::getName,
+                field -> Boolean.TRUE.equals(field.getVisible()));
+    }
+
+    @Override
+    public Set<String> getEditableArchiveFieldNames() {
+        return convertSet(getEmployeeArchiveFieldConfigList(), HrmEmployeeFieldConfigRespVO::getName,
+                field -> Boolean.TRUE.equals(field.getEditable()));
+    }
+
+    private Integer getCreateFieldConfigType(Integer entryStatus) {
+        if (HrmEmployeeEntryStatusEnum.ACTIVE.getStatus().equals(entryStatus)) {
+            return HrmConfigTypeEnum.EMPLOYEE_CREATE_ACTIVE_FIELD.getType();
+        }
+        if (HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus().equals(entryStatus)) {
+            return HrmConfigTypeEnum.EMPLOYEE_CREATE_PENDING_FIELD.getType();
+        }
+        throw exception(EMPLOYEE_FIELD_CONFIG_INVALID, "entryStatus");
+    }
+
+    private Map<String, HrmEmployeeFieldConfigSaveReqVO> validateFieldConfigList(
+            List<HrmEmployeeFieldConfigSaveReqVO> fieldConfigs) {
+        Map<String, HrmEmployeeFieldConfigSaveReqVO> fieldConfigMap = new LinkedHashMap<>();
+        for (HrmEmployeeFieldConfigSaveReqVO fieldConfig : fieldConfigs) {
+            if (fieldConfigMap.put(fieldConfig.getName(), fieldConfig) != null) {
+                throw exception(EMPLOYEE_FIELD_CONFIG_INVALID, fieldConfig.getName());
+            }
+        }
+        return fieldConfigMap;
+    }
+
+    private Map<String, HrmEmployeeFieldConfigValueVO> getFieldConfigMap(Integer configType) {
+        Map<String, HrmEmployeeFieldConfigValueVO> configMap = new HashMap<>();
+        for (String configValue : configService.getConfigValueList(configType)) {
+            HrmEmployeeFieldConfigValueVO value = JsonUtils.parseObject(configValue,
+                    HrmEmployeeFieldConfigValueVO.class);
+            if (value != null && value.getName() != null) {
+                configMap.put(value.getName(), value);
+            }
+        }
+        return configMap;
+    }
+
+    private HrmEmployeeFieldConfigRespVO buildFieldConfigRespVO(String name, String title, String groupName,
+                                                                 Boolean visible) {
+        return new HrmEmployeeFieldConfigRespVO().setName(name).setTitle(title).setGroupName(groupName)
+                .setVisible(visible).setVisibleLocked(false).setEditableLocked(false);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordService.java
new file mode 100644
index 0000000..5d3708e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordService.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeChangeRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * HRM 员工异动记录 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeChangeRecordService {
+
+    /**
+     * 创建员工异动记录
+     *
+     * @param createReqVO 异动记录
+     */
+    HrmEmployeeChangeRecordDO createEmployeeChangeRecord(@Valid HrmEmployeeChangeRecordCreateReqVO createReqVO);
+
+    /**
+     * 获得员工的异动记录列表
+     *
+     * @param employeeId 员工编号
+     * @return 异动记录列表
+     */
+    List<HrmEmployeeChangeRecordDO> getEmployeeChangeRecordListByEmployeeId(Long employeeId);
+
+    /**
+     * 获得到期且尚未生效的异动记录列表
+     *
+     * @param deadlineTime 截止时间
+     * @return 异动记录列表
+     */
+    List<HrmEmployeeChangeRecordDO> getPendingEmployeeChangeRecordList(LocalDateTime deadlineTime);
+
+    /**
+     * 更新员工异动记录的实际生效时间
+     *
+     * @param id 异动记录编号
+     * @param appliedTime 实际生效时间
+     */
+    void updateEmployeeChangeRecordAppliedTime(Long id, LocalDateTime appliedTime);
+
+    /**
+     * 获得指定员工和生效日期范围的异动记录列表
+     *
+     * @param employeeIds 员工编号集合
+     * @param effectTimes 生效时间双闭区间
+     * @return 异动记录列表
+     */
+    List<HrmEmployeeChangeRecordDO> getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+            Collection<Long> employeeIds, LocalDateTime[] effectTimes);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordServiceImpl.java
new file mode 100644
index 0000000..d0e7434
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordServiceImpl.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeChangeRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeChangeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+
+/**
+ * HRM 员工异动记录 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeChangeRecordServiceImpl implements HrmEmployeeChangeRecordService {
+
+    @Resource
+    private HrmEmployeeChangeRecordMapper changeRecordMapper;
+
+    @Override
+    public HrmEmployeeChangeRecordDO createEmployeeChangeRecord(HrmEmployeeChangeRecordCreateReqVO createReqVO) {
+        boolean pendingEffect = HrmEmployeeChangeTypeEnum.PENDING_EFFECT_TYPES.contains(createReqVO.getType());
+        // 转正、调岗、晋升、降级和转全职按自然日生效；再入职保留实际入职时间
+        if (pendingEffect) {
+            createReqVO.setEffectTime(getDayBeginTime(createReqVO.getEffectTime()));
+        }
+        HrmEmployeeChangeRecordDO changeRecord = BeanUtils.toBean(createReqVO, HrmEmployeeChangeRecordDO.class);
+        // 非预约生效的再入职记录创建时即视为已生效
+        if (!pendingEffect) {
+            changeRecord.setAppliedTime(LocalDateTime.now());
+        }
+        changeRecordMapper.insert(changeRecord);
+        return changeRecord;
+    }
+
+    @Override
+    public List<HrmEmployeeChangeRecordDO> getEmployeeChangeRecordListByEmployeeId(Long employeeId) {
+        return changeRecordMapper.selectListByEmployeeId(employeeId);
+    }
+
+    @Override
+    public List<HrmEmployeeChangeRecordDO> getPendingEmployeeChangeRecordList(LocalDateTime deadlineTime) {
+        return changeRecordMapper.selectListByAppliedTimeNullAndEffectTimeBeforeOrEqual(
+                deadlineTime, HrmEmployeeChangeTypeEnum.PENDING_EFFECT_TYPES);
+    }
+
+    @Override
+    public void updateEmployeeChangeRecordAppliedTime(Long id, LocalDateTime appliedTime) {
+        changeRecordMapper.updateById(new HrmEmployeeChangeRecordDO().setId(id).setAppliedTime(appliedTime));
+    }
+
+    @Override
+    public List<HrmEmployeeChangeRecordDO> getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+            Collection<Long> employeeIds, LocalDateTime[] effectTimes) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        return changeRecordMapper.selectListByEmployeeIdsAndEffectTimeBetween(
+                employeeIds, effectTimes);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractService.java
new file mode 100644
index 0000000..633726b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractService.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contract.HrmEmployeeContractSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeContractDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 员工合同 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeContractService {
+
+    /**
+     * 创建员工合同
+     *
+     * @param reqVO 合同信息
+     * @return 合同编号
+     */
+    Long createContract(@Valid HrmEmployeeContractSaveReqVO reqVO);
+
+    /**
+     * 更新员工合同
+     *
+     * @param reqVO 合同信息
+     */
+    void updateContract(@Valid HrmEmployeeContractSaveReqVO reqVO);
+
+    /**
+     * 删除员工合同
+     *
+     * @param id 合同编号
+     */
+    void deleteContract(Long id);
+
+    /**
+     * 校验员工合同是否存在
+     *
+     * @param id 合同编号
+     * @return 员工合同
+     */
+    HrmEmployeeContractDO validateContractExists(Long id);
+
+    /**
+     * 获得员工合同列表
+     *
+     * @param employeeId 员工编号
+     * @return 合同列表
+     */
+    List<HrmEmployeeContractDO> getContractListByEmployeeId(Long employeeId);
+
+    /**
+     * 获得指定月份到期合同的员工数量
+     *
+     * @param endTimes 合同结束时间范围
+     * @return 员工数量
+     */
+    Long getExpireEmployeeCountInMonth(LocalDateTime[] endTimes);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractServiceImpl.java
new file mode 100644
index 0000000..d80fcc1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractServiceImpl.java
@@ -0,0 +1,121 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contract.HrmEmployeeContractSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeContractDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeContractMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeContractTypeEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CONTRACT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 员工合同 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeContractServiceImpl implements HrmEmployeeContractService {
+
+    @Resource
+    private HrmEmployeeContractMapper contractMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CONTRACT_CREATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_CONTRACT_CREATE_SUCCESS)
+    public Long createContract(HrmEmployeeContractSaveReqVO reqVO) {
+        // 1. 校验员工
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+
+        // 2. 创建合同
+        HrmEmployeeContractDO contract = BeanUtils.toBean(reqVO, HrmEmployeeContractDO.class)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime()))
+                .setSignTime(getDayBeginTime(reqVO.getSignTime()));
+        if (HrmEmployeeContractTypeEnum.NON_FIXED_TERM_LABOR_CONTRACT.getType().equals(contract.getType())) {
+            contract.setTerm(null);
+        }
+        contractMapper.insert(contract);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("contract", contract);
+        return contract.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CONTRACT_UPDATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_CONTRACT_UPDATE_SUCCESS)
+    public void updateContract(HrmEmployeeContractSaveReqVO reqVO) {
+        // 1. 校验员工和合同
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmEmployeeContractDO contract = validateContractExists(reqVO.getId());
+        if (notEqual(contract.getEmployeeId(), reqVO.getEmployeeId())) {
+            throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "合同");
+        }
+
+        // 2. 更新合同
+        contractMapper.updateById(BeanUtils.toBean(reqVO, HrmEmployeeContractDO.class)
+                .setEmployeeId(null)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime()))
+                .setSignTime(getDayBeginTime(reqVO.getSignTime())));
+        if (HrmEmployeeContractTypeEnum.NON_FIXED_TERM_LABOR_CONTRACT.getType().equals(reqVO.getType())) {
+            contractMapper.updateTermById(reqVO.getId(), null);
+        }
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(contract, HrmEmployeeContractSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CONTRACT_DELETE_SUB_TYPE,
+            bizNo = "{{#contract.employeeId}}", success = HRM_EMPLOYEE_CONTRACT_DELETE_SUCCESS)
+    public void deleteContract(Long id) {
+        // 1. 校验员工合同存在
+        HrmEmployeeContractDO contract = validateContractExists(id);
+
+        // 2. 删除员工合同
+        contractMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("contract", contract);
+    }
+
+    @Override
+    public HrmEmployeeContractDO validateContractExists(Long id) {
+        HrmEmployeeContractDO contract = contractMapper.selectById(id);
+        if (contract == null) {
+            throw exception(EMPLOYEE_CONTRACT_NOT_EXISTS);
+        }
+        return contract;
+    }
+
+    @Override
+    public List<HrmEmployeeContractDO> getContractListByEmployeeId(Long employeeId) {
+        return contractMapper.selectListByEmployeeId(employeeId);
+    }
+
+    @Override
+    public Long getExpireEmployeeCountInMonth(LocalDateTime[] endTimes) {
+        return contractMapper.selectCountByEndTimeBetween(endTimes);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoService.java
new file mode 100644
index 0000000..7b46ec3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoService.java
@@ -0,0 +1,66 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo.HrmEmployeeQuitInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * HRM 员工离职信息 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeQuitInfoService {
+
+    /**
+     * 保存员工离职信息
+     *
+     * @param saveReqVO 离职信息
+     * @return 离职信息编号
+     */
+    Long saveEmployeeQuitInfo(@Valid HrmEmployeeQuitInfoSaveReqVO saveReqVO);
+
+    /**
+     * 删除员工离职信息
+     *
+     * @param employeeId 员工编号
+     */
+    void deleteEmployeeQuitInfo(Long employeeId);
+
+    /**
+     * 获得员工离职信息
+     *
+     * @param employeeId 员工编号
+     * @return 离职信息
+     */
+    HrmEmployeeQuitInfoDO getQuitInfoByEmployeeId(Long employeeId);
+
+    /**
+     * 获得员工离职信息列表
+     *
+     * @param employeeIds 员工编号集合
+     * @return 员工离职信息列表
+     */
+    List<HrmEmployeeQuitInfoDO> getQuitInfoListByEmployeeIds(Collection<Long> employeeIds);
+
+    /**
+     * 校验员工离职信息是否存在
+     *
+     * @param employeeId 员工编号
+     * @return 离职信息
+     */
+    @SuppressWarnings("UnusedReturnValue")
+    HrmEmployeeQuitInfoDO validateQuitInfoByEmployeeId(Long employeeId);
+
+    /**
+     * 获得到期的离职信息列表
+     *
+     * @param deadlineTime 截止时间
+     * @return 离职信息列表
+     */
+    List<HrmEmployeeQuitInfoDO> getDueQuitInfoList(LocalDateTime deadlineTime);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoServiceImpl.java
new file mode 100644
index 0000000..20a262c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoServiceImpl.java
@@ -0,0 +1,75 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo.HrmEmployeeQuitInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeQuitInfoMapper;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_QUIT_INFO_NOT_EXISTS;
+
+/**
+ * HRM 员工离职信息 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeQuitInfoServiceImpl implements HrmEmployeeQuitInfoService {
+
+    @Resource
+    private HrmEmployeeQuitInfoMapper quitInfoMapper;
+
+    @Override
+    public Long saveEmployeeQuitInfo(HrmEmployeeQuitInfoSaveReqVO saveReqVO) {
+        // 1. 校验员工离职信息是否存在
+        HrmEmployeeQuitInfoDO quitInfo = BeanUtils.toBean(saveReqVO, HrmEmployeeQuitInfoDO.class);
+        HrmEmployeeQuitInfoDO dbQuitInfo = quitInfoMapper.selectByEmployeeId(saveReqVO.getEmployeeId());
+        // 2. 保存员工离职信息
+        quitInfo.setId(dbQuitInfo == null ? null : dbQuitInfo.getId());
+        quitInfoMapper.insertOrUpdate(quitInfo);
+        return quitInfo.getId();
+    }
+
+    @Override
+    public void deleteEmployeeQuitInfo(Long employeeId) {
+        quitInfoMapper.deleteByEmployeeId(employeeId);
+    }
+
+    @Override
+    public HrmEmployeeQuitInfoDO getQuitInfoByEmployeeId(Long employeeId) {
+        return quitInfoMapper.selectByEmployeeId(employeeId);
+    }
+
+    @Override
+    public List<HrmEmployeeQuitInfoDO> getQuitInfoListByEmployeeIds(Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        return quitInfoMapper.selectListByEmployeeIds(employeeIds);
+    }
+
+    @Override
+    public HrmEmployeeQuitInfoDO validateQuitInfoByEmployeeId(Long employeeId) {
+        HrmEmployeeQuitInfoDO quitInfo = getQuitInfoByEmployeeId(employeeId);
+        if (quitInfo == null) {
+            throw exception(EMPLOYEE_QUIT_INFO_NOT_EXISTS);
+        }
+        return quitInfo;
+    }
+
+    @Override
+    public List<HrmEmployeeQuitInfoDO> getDueQuitInfoList(LocalDateTime deadlineTime) {
+        return quitInfoMapper.selectListByPlanQuitTimeBeforeOrEqual(deadlineTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardService.java
new file mode 100644
index 0000000..7063c74
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardService.java
@@ -0,0 +1,69 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard.HrmEmployeeSalaryCardSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeSalaryCardDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 员工工资卡 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeSalaryCardService {
+
+    /**
+     * 保存员工工资卡
+     *
+     * @param reqVO 工资卡信息
+     * @return 工资卡编号
+     */
+    Long saveSalaryCard(@Valid HrmEmployeeSalaryCardSaveReqVO reqVO);
+
+    /**
+     * 删除员工工资卡
+     *
+     * @param employeeId 员工编号
+     */
+    void deleteSalaryCardByEmployeeId(Long employeeId);
+
+    /**
+     * 校验员工工资卡是否存在
+     *
+     * @param id 工资卡编号
+     * @return 工资卡
+     */
+    HrmEmployeeSalaryCardDO validateSalaryCardExists(Long id);
+
+    /**
+     * 获得员工工资卡
+     *
+     * @param employeeId 员工编号
+     * @return 工资卡
+     */
+    HrmEmployeeSalaryCardDO getSalaryCardByEmployeeId(Long employeeId);
+
+    /**
+     * 获得员工工资卡列表
+     *
+     * @param employeeIds 员工编号集合
+     * @return 员工工资卡列表
+     */
+    List<HrmEmployeeSalaryCardDO> getSalaryCardList(Collection<Long> employeeIds);
+
+    /**
+     * 获得员工工资卡 Map
+     *
+     * @param employeeIds 员工编号集合
+     * @return 员工编号与工资卡的映射
+     */
+    default Map<Long, HrmEmployeeSalaryCardDO> getSalaryCardMap(Collection<Long> employeeIds) {
+        return convertMap(getSalaryCardList(employeeIds), HrmEmployeeSalaryCardDO::getEmployeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardServiceImpl.java
new file mode 100644
index 0000000..ae5ac17
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardServiceImpl.java
@@ -0,0 +1,120 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard.HrmEmployeeSalaryCardSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeSalaryCardDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeSalaryCardMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_SALARY_CARD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_SALARY_CARD_SAVE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_SALARY_CARD_SAVE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_SALARY_CARD_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_SALARY_CARD_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_TYPE;
+
+/**
+ * HRM 员工工资卡 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeSalaryCardServiceImpl implements HrmEmployeeSalaryCardService {
+
+    @Resource
+    private HrmEmployeeSalaryCardMapper salaryCardMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_SALARY_CARD_SAVE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_SALARY_CARD_SAVE_SUCCESS)
+    public Long saveSalaryCard(HrmEmployeeSalaryCardSaveReqVO reqVO) {
+        // 1. 校验员工和工资卡
+        HrmEmployeeDO employee = employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmEmployeeSalaryCardDO oldSalaryCard = reqVO.getId() == null
+                ? salaryCardMapper.selectByEmployeeId(reqVO.getEmployeeId())
+                : validateSalaryCardExists(reqVO.getId());
+        if (oldSalaryCard != null && notEqual(oldSalaryCard.getEmployeeId(), reqVO.getEmployeeId())) {
+            throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "工资卡");
+        }
+
+        // 2. 保存员工工资卡
+        HrmEmployeeSalaryCardDO salaryCard = BeanUtils.toBean(reqVO, HrmEmployeeSalaryCardDO.class);
+        if (salaryCard.getId() == null && oldSalaryCard != null) {
+            salaryCard.setId(oldSalaryCard.getId());
+        }
+        salaryCardMapper.insertOrUpdate(salaryCard);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, oldSalaryCard == null
+                ? new HrmEmployeeSalaryCardSaveReqVO()
+                : BeanUtils.toBean(oldSalaryCard, HrmEmployeeSalaryCardSaveReqVO.class));
+        return salaryCard.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_SALARY_CARD_DELETE_SUB_TYPE,
+            bizNo = "{{#employee.id}}", success = HRM_EMPLOYEE_SALARY_CARD_DELETE_SUCCESS)
+    public void deleteSalaryCardByEmployeeId(Long employeeId) {
+        // 1. 校验员工和工资卡存在
+        HrmEmployeeDO employee = employeeService.validateEmployeeExists(employeeId);
+        HrmEmployeeSalaryCardDO salaryCard = salaryCardMapper.selectByEmployeeId(employeeId);
+        if (salaryCard == null) {
+            throw exception(EMPLOYEE_SALARY_CARD_NOT_EXISTS);
+        }
+
+        // 2. 删除工资卡
+        salaryCardMapper.deleteById(salaryCard.getId());
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    public HrmEmployeeSalaryCardDO validateSalaryCardExists(Long id) {
+        HrmEmployeeSalaryCardDO salaryCard = salaryCardMapper.selectById(id);
+        if (salaryCard == null) {
+            throw exception(EMPLOYEE_SALARY_CARD_NOT_EXISTS);
+        }
+        return salaryCard;
+    }
+
+    @Override
+    public HrmEmployeeSalaryCardDO getSalaryCardByEmployeeId(Long employeeId) {
+        return salaryCardMapper.selectByEmployeeId(employeeId);
+    }
+
+    @Override
+    public List<HrmEmployeeSalaryCardDO> getSalaryCardList(Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        // 历史重复数据按工资卡编号倒序只保留最新一张，维持员工单卡查询契约
+        Map<Long, HrmEmployeeSalaryCardDO> salaryCardMap = new LinkedHashMap<>();
+        for (HrmEmployeeSalaryCardDO salaryCard : salaryCardMapper.selectListByEmployeeIds(employeeIds)) {
+            salaryCardMap.putIfAbsent(salaryCard.getEmployeeId(), salaryCard);
+        }
+        return CollUtil.newArrayList(salaryCardMap.values());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateService.java
new file mode 100644
index 0000000..f8a7ff1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateService.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate.HrmEmployeeCertificateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeCertificateDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 员工证书 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeCertificateService {
+
+    /**
+     * 创建员工证书
+     *
+     * @param reqVO 证书信息
+     * @return 证书编号
+     */
+    Long createCertificate(@Valid HrmEmployeeCertificateSaveReqVO reqVO);
+
+    /**
+     * 更新员工证书
+     *
+     * @param reqVO 证书信息
+     */
+    void updateCertificate(@Valid HrmEmployeeCertificateSaveReqVO reqVO);
+
+    /**
+     * 删除员工证书
+     *
+     * @param id 证书编号
+     */
+    void deleteCertificate(Long id);
+
+    /**
+     * 校验员工证书是否存在
+     *
+     * @param id 证书编号
+     * @return 员工证书
+     */
+    HrmEmployeeCertificateDO validateCertificateExists(Long id);
+
+    /**
+     * 获得员工证书列表
+     *
+     * @param employeeId 员工编号
+     * @return 证书列表
+     */
+    List<HrmEmployeeCertificateDO> getCertificateListByEmployeeId(Long employeeId);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateServiceImpl.java
new file mode 100644
index 0000000..38249c3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateServiceImpl.java
@@ -0,0 +1,107 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate.HrmEmployeeCertificateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeCertificateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeCertificateMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CERTIFICATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 员工证书 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeCertificateServiceImpl implements HrmEmployeeCertificateService {
+
+    @Resource
+    private HrmEmployeeCertificateMapper certificateMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CERTIFICATE_CREATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_CERTIFICATE_CREATE_SUCCESS)
+    public Long createCertificate(HrmEmployeeCertificateSaveReqVO reqVO) {
+        // 1. 校验员工
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        // 2. 创建证书
+        HrmEmployeeCertificateDO certificate = BeanUtils.toBean(reqVO, HrmEmployeeCertificateDO.class)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime()))
+                .setIssuingTime(getDayBeginTime(reqVO.getIssuingTime()));
+        certificateMapper.insert(certificate);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("certificate", certificate);
+        return certificate.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CERTIFICATE_UPDATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_CERTIFICATE_UPDATE_SUCCESS)
+    public void updateCertificate(HrmEmployeeCertificateSaveReqVO reqVO) {
+        // 1. 校验员工和证书
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmEmployeeCertificateDO certificate = validateCertificateExists(reqVO.getId());
+        if (notEqual(certificate.getEmployeeId(), reqVO.getEmployeeId())) {
+            throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "证书");
+        }
+
+        // 2. 更新证书
+        certificateMapper.updateById(BeanUtils.toBean(reqVO, HrmEmployeeCertificateDO.class)
+                .setEmployeeId(null)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime()))
+                .setIssuingTime(getDayBeginTime(reqVO.getIssuingTime())));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(certificate, HrmEmployeeCertificateSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CERTIFICATE_DELETE_SUB_TYPE,
+            bizNo = "{{#certificate.employeeId}}", success = HRM_EMPLOYEE_CERTIFICATE_DELETE_SUCCESS)
+    public void deleteCertificate(Long id) {
+        // 1. 校验员工证书存在
+        HrmEmployeeCertificateDO certificate = validateCertificateExists(id);
+
+        // 2. 删除员工证书
+        certificateMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("certificate", certificate);
+    }
+
+    @Override
+    public HrmEmployeeCertificateDO validateCertificateExists(Long id) {
+        HrmEmployeeCertificateDO certificate = certificateMapper.selectById(id);
+        if (certificate == null) {
+            throw exception(EMPLOYEE_CERTIFICATE_NOT_EXISTS);
+        }
+        return certificate;
+    }
+
+    @Override
+    public List<HrmEmployeeCertificateDO> getCertificateListByEmployeeId(Long employeeId) {
+        return certificateMapper.selectListByEmployeeId(employeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceService.java
new file mode 100644
index 0000000..01d9a2a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceService.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience.HrmEmployeeEducationExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeEducationExperienceDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 员工教育经历 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeEducationExperienceService {
+
+    /**
+     * 创建员工教育经历
+     *
+     * @param reqVO 教育经历信息
+     * @return 教育经历编号
+     */
+    Long createEducationExperience(@Valid HrmEmployeeEducationExperienceSaveReqVO reqVO);
+
+    /**
+     * 更新员工教育经历
+     *
+     * @param reqVO 教育经历信息
+     */
+    void updateEducationExperience(@Valid HrmEmployeeEducationExperienceSaveReqVO reqVO);
+
+    /**
+     * 删除员工教育经历
+     *
+     * @param id 教育经历编号
+     */
+    void deleteEducationExperience(Long id);
+
+    /**
+     * 校验员工教育经历是否存在
+     *
+     * @param id 教育经历编号
+     * @return 教育经历
+     */
+    HrmEmployeeEducationExperienceDO validateEducationExperienceExists(Long id);
+
+    /**
+     * 获得员工教育经历列表
+     *
+     * @param employeeId 员工编号
+     * @return 教育经历列表
+     */
+    List<HrmEmployeeEducationExperienceDO> getEducationExperienceListByEmployeeId(Long employeeId);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceServiceImpl.java
new file mode 100644
index 0000000..95308ca
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceServiceImpl.java
@@ -0,0 +1,107 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience.HrmEmployeeEducationExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeEducationExperienceDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeEducationExperienceMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_EDUCATION_EXPERIENCE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 员工教育经历 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeEducationExperienceServiceImpl implements HrmEmployeeEducationExperienceService {
+
+    @Resource
+    private HrmEmployeeEducationExperienceMapper educationExperienceMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_EDUCATION_EXPERIENCE_CREATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_EDUCATION_EXPERIENCE_CREATE_SUCCESS)
+    public Long createEducationExperience(HrmEmployeeEducationExperienceSaveReqVO reqVO) {
+        // 1. 校验员工
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+
+        // 2. 创建教育经历
+        HrmEmployeeEducationExperienceDO educationExperience = BeanUtils.toBean(
+                        reqVO, HrmEmployeeEducationExperienceDO.class)
+                .setAdmissionTime(getDayBeginTime(reqVO.getAdmissionTime()))
+                .setGraduationTime(getDayBeginTime(reqVO.getGraduationTime()));
+        educationExperienceMapper.insert(educationExperience);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("educationExperience", educationExperience);
+        return educationExperience.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_EDUCATION_EXPERIENCE_UPDATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_EDUCATION_EXPERIENCE_UPDATE_SUCCESS)
+    public void updateEducationExperience(HrmEmployeeEducationExperienceSaveReqVO reqVO) {
+        // 1. 校验员工和教育经历
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmEmployeeEducationExperienceDO educationExperience = validateEducationExperienceExists(reqVO.getId());
+        if (notEqual(educationExperience.getEmployeeId(), reqVO.getEmployeeId())) {
+            throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "教育经历");
+        }
+
+        // 2. 更新教育经历
+        educationExperienceMapper.updateById(BeanUtils.toBean(reqVO, HrmEmployeeEducationExperienceDO.class)
+                .setEmployeeId(null)
+                .setAdmissionTime(getDayBeginTime(reqVO.getAdmissionTime()))
+                .setGraduationTime(getDayBeginTime(reqVO.getGraduationTime())));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(educationExperience, HrmEmployeeEducationExperienceSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_EDUCATION_EXPERIENCE_DELETE_SUB_TYPE,
+            bizNo = "{{#educationExperience.employeeId}}", success = HRM_EMPLOYEE_EDUCATION_EXPERIENCE_DELETE_SUCCESS)
+    public void deleteEducationExperience(Long id) {
+        // 1. 校验员工教育经历存在
+        HrmEmployeeEducationExperienceDO educationExperience = validateEducationExperienceExists(id);
+
+        // 2. 删除员工教育经历
+        educationExperienceMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("educationExperience", educationExperience);
+    }
+
+    @Override
+    public HrmEmployeeEducationExperienceDO validateEducationExperienceExists(Long id) {
+        HrmEmployeeEducationExperienceDO educationExperience = educationExperienceMapper.selectById(id);
+        if (educationExperience == null) {
+            throw exception(EMPLOYEE_EDUCATION_EXPERIENCE_NOT_EXISTS);
+        }
+        return educationExperience;
+    }
+
+    @Override
+    public List<HrmEmployeeEducationExperienceDO> getEducationExperienceListByEmployeeId(Long employeeId) {
+        return educationExperienceMapper.selectListByEmployeeId(employeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceService.java
new file mode 100644
index 0000000..8e05505
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceService.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience.HrmEmployeeTrainingExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeTrainingExperienceDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 员工培训经历 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeTrainingExperienceService {
+
+    /**
+     * 创建员工培训经历
+     *
+     * @param reqVO 培训经历信息
+     * @return 培训经历编号
+     */
+    Long createTrainingExperience(@Valid HrmEmployeeTrainingExperienceSaveReqVO reqVO);
+
+    /**
+     * 更新员工培训经历
+     *
+     * @param reqVO 培训经历信息
+     */
+    void updateTrainingExperience(@Valid HrmEmployeeTrainingExperienceSaveReqVO reqVO);
+
+    /**
+     * 删除员工培训经历
+     *
+     * @param id 培训经历编号
+     */
+    void deleteTrainingExperience(Long id);
+
+    /**
+     * 校验员工培训经历是否存在
+     *
+     * @param id 培训经历编号
+     * @return 培训经历
+     */
+    HrmEmployeeTrainingExperienceDO validateTrainingExperienceExists(Long id);
+
+    /**
+     * 获得员工培训经历列表
+     *
+     * @param employeeId 员工编号
+     * @return 培训经历列表
+     */
+    List<HrmEmployeeTrainingExperienceDO> getTrainingExperienceListByEmployeeId(Long employeeId);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceServiceImpl.java
new file mode 100644
index 0000000..d6d8de6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceServiceImpl.java
@@ -0,0 +1,108 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience.HrmEmployeeTrainingExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeTrainingExperienceDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeTrainingExperienceMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_TRAINING_EXPERIENCE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 员工培训经历 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeTrainingExperienceServiceImpl implements HrmEmployeeTrainingExperienceService {
+
+    @Resource
+    private HrmEmployeeTrainingExperienceMapper trainingExperienceMapper;
+
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_TRAINING_EXPERIENCE_CREATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_TRAINING_EXPERIENCE_CREATE_SUCCESS)
+    public Long createTrainingExperience(HrmEmployeeTrainingExperienceSaveReqVO reqVO) {
+        // 1. 校验员工
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+
+        // 2. 创建培训经历
+        HrmEmployeeTrainingExperienceDO trainingExperience = BeanUtils.toBean(
+                        reqVO, HrmEmployeeTrainingExperienceDO.class)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime()));
+        trainingExperienceMapper.insert(trainingExperience);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("trainingExperience", trainingExperience);
+        return trainingExperience.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_TRAINING_EXPERIENCE_UPDATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_TRAINING_EXPERIENCE_UPDATE_SUCCESS)
+    public void updateTrainingExperience(HrmEmployeeTrainingExperienceSaveReqVO reqVO) {
+        // 1. 校验员工和培训经历
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmEmployeeTrainingExperienceDO trainingExperience = validateTrainingExperienceExists(reqVO.getId());
+        if (notEqual(trainingExperience.getEmployeeId(), reqVO.getEmployeeId())) {
+            throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "培训经历");
+        }
+
+        // 2. 更新培训经历
+        trainingExperienceMapper.updateById(BeanUtils.toBean(reqVO, HrmEmployeeTrainingExperienceDO.class)
+                .setEmployeeId(null)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime())));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(trainingExperience, HrmEmployeeTrainingExperienceSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_TRAINING_EXPERIENCE_DELETE_SUB_TYPE,
+            bizNo = "{{#trainingExperience.employeeId}}", success = HRM_EMPLOYEE_TRAINING_EXPERIENCE_DELETE_SUCCESS)
+    public void deleteTrainingExperience(Long id) {
+        // 1. 校验员工培训经历存在
+        HrmEmployeeTrainingExperienceDO trainingExperience = validateTrainingExperienceExists(id);
+
+        // 2. 删除员工培训经历
+        trainingExperienceMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("trainingExperience", trainingExperience);
+    }
+
+    @Override
+    public HrmEmployeeTrainingExperienceDO validateTrainingExperienceExists(Long id) {
+        HrmEmployeeTrainingExperienceDO trainingExperience = trainingExperienceMapper.selectById(id);
+        if (trainingExperience == null) {
+            throw exception(EMPLOYEE_TRAINING_EXPERIENCE_NOT_EXISTS);
+        }
+        return trainingExperience;
+    }
+
+    @Override
+    public List<HrmEmployeeTrainingExperienceDO> getTrainingExperienceListByEmployeeId(Long employeeId) {
+        return trainingExperienceMapper.selectListByEmployeeId(employeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceService.java
new file mode 100644
index 0000000..09d954d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceService.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience.HrmEmployeeWorkExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeWorkExperienceDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 员工工作经历 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeWorkExperienceService {
+
+    /**
+     * 创建员工工作经历
+     *
+     * @param reqVO 工作经历信息
+     * @return 工作经历编号
+     */
+    Long createWorkExperience(@Valid HrmEmployeeWorkExperienceSaveReqVO reqVO);
+
+    /**
+     * 更新员工工作经历
+     *
+     * @param reqVO 工作经历信息
+     */
+    void updateWorkExperience(@Valid HrmEmployeeWorkExperienceSaveReqVO reqVO);
+
+    /**
+     * 删除员工工作经历
+     *
+     * @param id 工作经历编号
+     */
+    void deleteWorkExperience(Long id);
+
+    /**
+     * 校验员工工作经历是否存在
+     *
+     * @param id 工作经历编号
+     * @return 工作经历
+     */
+    HrmEmployeeWorkExperienceDO validateWorkExperienceExists(Long id);
+
+    /**
+     * 获得员工工作经历列表
+     *
+     * @param employeeId 员工编号
+     * @return 工作经历列表
+     */
+    List<HrmEmployeeWorkExperienceDO> getWorkExperienceListByEmployeeId(Long employeeId);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceServiceImpl.java
new file mode 100644
index 0000000..876ec3b
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceServiceImpl.java
@@ -0,0 +1,107 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience.HrmEmployeeWorkExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeWorkExperienceDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeWorkExperienceMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_WORK_EXPERIENCE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 员工工作经历 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeWorkExperienceServiceImpl implements HrmEmployeeWorkExperienceService {
+
+    @Resource
+    private HrmEmployeeWorkExperienceMapper workExperienceMapper;
+
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_WORK_EXPERIENCE_CREATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_WORK_EXPERIENCE_CREATE_SUCCESS)
+    public Long createWorkExperience(HrmEmployeeWorkExperienceSaveReqVO reqVO) {
+        // 1. 校验员工
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+
+        // 2. 创建工作经历
+        HrmEmployeeWorkExperienceDO workExperience = BeanUtils.toBean(reqVO, HrmEmployeeWorkExperienceDO.class)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime()));
+        workExperienceMapper.insert(workExperience);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("workExperience", workExperience);
+        return workExperience.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_WORK_EXPERIENCE_UPDATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_WORK_EXPERIENCE_UPDATE_SUCCESS)
+    public void updateWorkExperience(HrmEmployeeWorkExperienceSaveReqVO reqVO) {
+        // 1. 校验员工和工作经历
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmEmployeeWorkExperienceDO workExperience = validateWorkExperienceExists(reqVO.getId());
+        if (notEqual(workExperience.getEmployeeId(), reqVO.getEmployeeId())) {
+            throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "工作经历");
+        }
+
+        // 2. 更新工作经历
+        workExperienceMapper.updateById(BeanUtils.toBean(reqVO, HrmEmployeeWorkExperienceDO.class)
+                .setEmployeeId(null)
+                .setStartTime(getDayBeginTime(reqVO.getStartTime()))
+                .setEndTime(getDayBeginTime(reqVO.getEndTime())));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(workExperience, HrmEmployeeWorkExperienceSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_WORK_EXPERIENCE_DELETE_SUB_TYPE,
+            bizNo = "{{#workExperience.employeeId}}", success = HRM_EMPLOYEE_WORK_EXPERIENCE_DELETE_SUCCESS)
+    public void deleteWorkExperience(Long id) {
+        // 1. 校验员工工作经历存在
+        HrmEmployeeWorkExperienceDO workExperience = validateWorkExperienceExists(id);
+
+        // 2. 删除员工工作经历
+        workExperienceMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("workExperience", workExperience);
+    }
+
+    @Override
+    public HrmEmployeeWorkExperienceDO validateWorkExperienceExists(Long id) {
+        HrmEmployeeWorkExperienceDO workExperience = workExperienceMapper.selectById(id);
+        if (workExperience == null) {
+            throw exception(EMPLOYEE_WORK_EXPERIENCE_NOT_EXISTS);
+        }
+        return workExperience;
+    }
+
+    @Override
+    public List<HrmEmployeeWorkExperienceDO> getWorkExperienceListByEmployeeId(Long employeeId) {
+        return workExperienceMapper.selectListByEmployeeId(employeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactService.java
new file mode 100644
index 0000000..28ff052
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactService.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact.HrmEmployeeContactSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeContactDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 员工联系人 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeContactService {
+
+    /**
+     * 创建员工联系人
+     *
+     * @param reqVO 联系人信息
+     * @return 联系人编号
+     */
+    Long createContact(@Valid HrmEmployeeContactSaveReqVO reqVO);
+
+    /**
+     * 更新员工联系人
+     *
+     * @param reqVO 联系人信息
+     */
+    void updateContact(@Valid HrmEmployeeContactSaveReqVO reqVO);
+
+    /**
+     * 删除员工联系人
+     *
+     * @param id 联系人编号
+     */
+    void deleteContact(Long id);
+
+    /**
+     * 校验员工联系人是否存在
+     *
+     * @param id 联系人编号
+     * @return 联系人
+     */
+    HrmEmployeeContactDO validateContactExists(Long id);
+
+    /**
+     * 获得员工联系人列表
+     *
+     * @param employeeId 员工编号
+     * @return 联系人列表
+     */
+    List<HrmEmployeeContactDO> getContactListByEmployeeId(Long employeeId);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactServiceImpl.java
new file mode 100644
index 0000000..ea65ad4
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactServiceImpl.java
@@ -0,0 +1,100 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact.HrmEmployeeContactSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeContactDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeContactMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.List;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CONTACT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 员工联系人 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeContactServiceImpl implements HrmEmployeeContactService {
+
+    @Resource
+    private HrmEmployeeContactMapper contactMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CONTACT_CREATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_CONTACT_CREATE_SUCCESS)
+    public Long createContact(HrmEmployeeContactSaveReqVO reqVO) {
+        // 1. 校验员工
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+
+        // 2. 创建联系人
+        HrmEmployeeContactDO contact = BeanUtils.toBean(reqVO, HrmEmployeeContactDO.class);
+        contactMapper.insert(contact);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("contact", contact);
+        return contact.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CONTACT_UPDATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_CONTACT_UPDATE_SUCCESS)
+    public void updateContact(HrmEmployeeContactSaveReqVO reqVO) {
+        // 1. 校验员工和联系人
+        employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmEmployeeContactDO contact = validateContactExists(reqVO.getId());
+        if (notEqual(contact.getEmployeeId(), reqVO.getEmployeeId())) {
+            throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "联系人");
+        }
+
+        // 2. 更新联系人
+        contactMapper.updateById(BeanUtils.toBean(reqVO, HrmEmployeeContactDO.class)
+                .setEmployeeId(null));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(contact, HrmEmployeeContactSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CONTACT_DELETE_SUB_TYPE,
+            bizNo = "{{#contact.employeeId}}", success = HRM_EMPLOYEE_CONTACT_DELETE_SUCCESS)
+    public void deleteContact(Long id) {
+        // 1. 校验员工联系人存在
+        HrmEmployeeContactDO contact = validateContactExists(id);
+
+        // 2. 删除员工联系人
+        contactMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("contact", contact);
+    }
+
+    @Override
+    public HrmEmployeeContactDO validateContactExists(Long id) {
+        HrmEmployeeContactDO contact = contactMapper.selectById(id);
+        if (contact == null) {
+            throw exception(EMPLOYEE_CONTACT_NOT_EXISTS);
+        }
+        return contact;
+    }
+
+    @Override
+    public List<HrmEmployeeContactDO> getContactListByEmployeeId(Long employeeId) {
+        return contactMapper.selectListByEmployeeId(employeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileService.java
new file mode 100644
index 0000000..4017528
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileService.java
@@ -0,0 +1,30 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.file.HrmEmployeeFileSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeFileDO;
+
+import java.util.List;
+
+/**
+ * HRM 员工材料附件 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeFileService {
+
+    /**
+     * 保存员工指定类型的材料附件
+     *
+     * @param reqVO 附件信息
+     */
+    void saveEmployeeFiles(HrmEmployeeFileSaveReqVO reqVO);
+
+    /**
+     * 获得员工材料附件列表
+     *
+     * @param employeeId 员工编号
+     * @return 材料附件列表
+     */
+    List<HrmEmployeeFileDO> getEmployeeFileList(Long employeeId);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileServiceImpl.java
new file mode 100644
index 0000000..5c4d87d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileServiceImpl.java
@@ -0,0 +1,74 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.file.HrmEmployeeFileSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeFileDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeFileMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.diffList;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_FILE_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_FILE_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_TYPE;
+
+/**
+ * HRM 员工材料附件 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeeFileServiceImpl implements HrmEmployeeFileService {
+
+    @Resource
+    private HrmEmployeeFileMapper employeeFileMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_FILE_UPDATE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_FILE_UPDATE_SUCCESS)
+    public void saveEmployeeFiles(HrmEmployeeFileSaveReqVO reqVO) {
+        // 1. 校验员工
+        HrmEmployeeDO employee = employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+
+        // 2.1 按 URL 计算材料附件差异
+        List<HrmEmployeeFileDO> dbFiles = employeeFileMapper.selectListByEmployeeIdAndType(
+                reqVO.getEmployeeId(), reqVO.getType());
+        Set<String> fileUrls = new LinkedHashSet<>(reqVO.getFileUrls());
+        List<HrmEmployeeFileDO> newFiles = convertList(fileUrls, fileUrl -> new HrmEmployeeFileDO()
+                .setEmployeeId(reqVO.getEmployeeId()).setType(reqVO.getType()).setUrl(fileUrl));
+        List<List<HrmEmployeeFileDO>> diffFiles = diffList(dbFiles, newFiles,
+                (oldFile, newFile) -> oldFile.getUrl().equals(newFile.getUrl()));
+        // 2.2 新增请求中增加的附件
+        if (CollUtil.isNotEmpty(diffFiles.get(0))) {
+            employeeFileMapper.insertBatch(diffFiles.get(0));
+        }
+        // 2.3 删除请求中移除的附件及历史重复附件
+        if (CollUtil.isNotEmpty(diffFiles.get(2))) {
+            employeeFileMapper.deleteByIds(convertList(diffFiles.get(2), HrmEmployeeFileDO::getId));
+        }
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    public List<HrmEmployeeFileDO> getEmployeeFileList(Long employeeId) {
+        return employeeFileMapper.selectListByEmployeeId(employeeId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteService.java
new file mode 100644
index 0000000..e0b049d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteService.java
@@ -0,0 +1,44 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.personalnote.HrmEmployeePersonalNoteCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeePersonalNoteDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * HRM 员工个人备忘 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeePersonalNoteService {
+
+    /**
+     * 创建员工个人备忘
+     *
+     * @param employeeId 员工编号
+     * @param reqVO 个人备忘信息
+     * @return 个人备忘编号
+     */
+    Long createPersonalNote(Long employeeId, @Valid HrmEmployeePersonalNoteCreateReqVO reqVO);
+
+    /**
+     * 删除员工个人备忘
+     *
+     * @param employeeId 员工编号
+     * @param id 个人备忘编号
+     */
+    void deletePersonalNote(Long employeeId, Long id);
+
+    /**
+     * 获得员工指定提醒时间范围内的个人备忘
+     *
+     * @param employeeId 员工编号
+     * @param reminderTimes 提醒时间双闭区间
+     * @return 个人备忘列表
+     */
+    List<HrmEmployeePersonalNoteDO> getPersonalNoteList(
+            Long employeeId, LocalDateTime[] reminderTimes);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteServiceImpl.java
new file mode 100644
index 0000000..1ac9d6f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteServiceImpl.java
@@ -0,0 +1,62 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.personalnote.HrmEmployeePersonalNoteCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeePersonalNoteDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeePersonalNoteMapper;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_PERSONAL_NOTE_NOT_EXISTS;
+
+/**
+ * HRM 员工个人备忘 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmEmployeePersonalNoteServiceImpl implements HrmEmployeePersonalNoteService {
+
+    @Resource
+    private HrmEmployeePersonalNoteMapper personalNoteMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    public Long createPersonalNote(Long employeeId, HrmEmployeePersonalNoteCreateReqVO reqVO) {
+        // 1. 校验员工
+        employeeService.validateEmployeeExists(employeeId);
+
+        // 2. 创建个人备忘
+        HrmEmployeePersonalNoteDO personalNote = BeanUtils.toBean(reqVO, HrmEmployeePersonalNoteDO.class)
+                .setEmployeeId(employeeId);
+        personalNoteMapper.insert(personalNote);
+        return personalNote.getId();
+    }
+
+    @Override
+    public void deletePersonalNote(Long employeeId, Long id) {
+        // 1. 校验个人备忘属于当前员工
+        HrmEmployeePersonalNoteDO personalNote = personalNoteMapper.selectById(id);
+        if (personalNote == null || ObjUtil.notEqual(personalNote.getEmployeeId(), employeeId)) {
+            throw exception(EMPLOYEE_PERSONAL_NOTE_NOT_EXISTS);
+        }
+
+        // 2. 删除个人备忘
+        personalNoteMapper.deleteById(id);
+    }
+
+    @Override
+    public List<HrmEmployeePersonalNoteDO> getPersonalNoteList(
+            Long employeeId, LocalDateTime[] reminderTimes) {
+        return personalNoteMapper.selectListByEmployeeIdAndReminderTimeBetween(employeeId, reminderTimes);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeService.java
new file mode 100644
index 0000000..edfa516
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeService.java
@@ -0,0 +1,382 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeConvertToFullTimeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeDemoteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeePromoteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeRegularReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeTransferReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportExcelVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCreateFromUserReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCancelQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeConfirmEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeRehireReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeNotifyRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.employee.vo.employee.HrmPortalEmployeeUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 员工档案 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmEmployeeService {
+
+    /**
+     * 确认员工入职
+     *
+     * @param reqVO 员工固定字段
+     */
+    void confirmEmployeeEntry(@Valid HrmEmployeeConfirmEntryReqVO reqVO);
+
+    /**
+     * 办理离职员工再入职
+     *
+     * @param reqVO 再入职信息
+     */
+    void rehireEmployee(@Valid HrmEmployeeRehireReqVO reqVO);
+
+    /**
+     * 办理员工转正
+     *
+     * @param reqVO 异动信息
+     */
+    void regularEmployee(@Valid HrmEmployeeRegularReqVO reqVO);
+
+    /**
+     * 办理员工调岗
+     *
+     * @param reqVO 异动信息
+     */
+    void transferEmployee(@Valid HrmEmployeeTransferReqVO reqVO);
+
+    /**
+     * 办理员工晋升
+     *
+     * @param reqVO 异动信息
+     */
+    void promoteEmployee(@Valid HrmEmployeePromoteReqVO reqVO);
+
+    /**
+     * 办理员工降级
+     *
+     * @param reqVO 异动信息
+     */
+    void demoteEmployee(@Valid HrmEmployeeDemoteReqVO reqVO);
+
+    /**
+     * 办理员工转为全职
+     *
+     * @param reqVO 异动信息
+     */
+    void convertEmployeeToFullTime(@Valid HrmEmployeeConvertToFullTimeReqVO reqVO);
+
+    /**
+     * 应用一条员工异动记录
+     *
+     * @param changeRecord 异动记录
+     */
+    boolean applyEmployeeChange(HrmEmployeeChangeRecordDO changeRecord);
+
+    /**
+     * 获得到期且仍处于试用期的员工列表
+     *
+     * @param deadlineTime 截止时间
+     * @return 员工列表
+     */
+    List<HrmEmployeeDO> getDueRegularEmployeeList(LocalDateTime deadlineTime);
+
+    /**
+     * 应用一名员工的到期转正
+     *
+     * @param employeeId 员工编号
+     */
+    boolean applyEmployeeRegular(Long employeeId);
+
+    /**
+     * 应用一名员工的到期离职
+     *
+     * @param quitInfo 离职信息
+     * @return 是否应用成功
+     */
+    boolean applyEmployeeQuit(HrmEmployeeQuitInfoDO quitInfo);
+
+    /**
+     * 办理员工离职
+     *
+     * @param reqVO 离职信息
+     */
+    void quitEmployee(@Valid HrmEmployeeQuitReqVO reqVO);
+
+    /**
+     * 取消员工离职
+     *
+     * @param reqVO 取消离职信息
+     */
+    void cancelEmployeeQuit(@Valid HrmEmployeeCancelQuitReqVO reqVO);
+
+    /**
+     * 创建员工档案
+     *
+     * @param createReqVO 员工档案信息
+     * @return 员工档案编号
+     */
+    Long createEmployee(@Valid HrmEmployeeSaveReqVO createReqVO);
+
+    /**
+     * 从未建档的后台用户批量创建员工档案
+     *
+     * @param createReqVOList 批量创建信息
+     * @return 员工档案编号列表
+     */
+    List<Long> createEmployeeList(@Valid List<HrmEmployeeCreateFromUserReqVO> createReqVOList);
+
+    /**
+     * 获得已经建立员工档案的后台用户编号列表
+     *
+     * @return 后台用户编号列表
+     */
+    List<Long> getBoundUserIdList();
+
+    /**
+     * 发送填写员工档案通知
+     *
+     * @param employeeIds 员工编号列表
+     * @return 发送结果
+     */
+    HrmEmployeeNotifyRespVO sendEmployeeProfileFillMessage(List<Long> employeeIds);
+
+    /**
+     * 更新员工档案
+     *
+     * @param updateReqVO 员工档案信息
+     */
+    void updateEmployee(@Valid HrmEmployeeSaveReqVO updateReqVO);
+
+    /**
+     * 删除员工档案
+     *
+     * @param id 员工档案编号
+     */
+    void deleteEmployee(Long id);
+
+    /**
+     * 批量删除员工档案
+     *
+     * @param ids 员工档案编号集合
+     */
+    void deleteEmployeeList(List<Long> ids);
+
+    /**
+     * 将指定招聘渠道的员工迁移到新渠道
+     *
+     * @param channelId 原招聘渠道编号
+     * @param newChannelId 新招聘渠道编号
+     */
+    void updateEmployeeChannelByChannelId(Long channelId, Long newChannelId);
+
+    /**
+     * 获得员工档案
+     *
+     * @param id 员工档案编号
+     * @return 员工档案
+     */
+    HrmEmployeeDO getEmployee(Long id);
+
+    /**
+     * 获得后台用户对应的员工档案
+     *
+     * @param userId 后台用户编号
+     * @return 员工档案
+     */
+    HrmEmployeeDO getEmployeeByUserId(Long userId);
+
+    /**
+     * 获得指定工号的员工档案
+     *
+     * @param jobNumber 工号
+     * @return 员工档案
+     */
+    HrmEmployeeDO getEmployeeByJobNumber(String jobNumber);
+
+    /**
+     * 校验员工档案是否存在
+     *
+     * @param id 员工档案编号
+     * @return 员工档案
+     */
+    HrmEmployeeDO validateEmployeeExists(Long id);
+
+    /**
+     * 校验员工档案是否存在，并锁定员工记录
+     *
+     * @param id 员工档案编号
+     * @return 员工档案
+     */
+    HrmEmployeeDO validateEmployeeExistsForUpdate(Long id);
+
+    /**
+     * 校验员工档案是否都存在
+     *
+     * @param ids 员工档案编号集合
+     */
+    void validateEmployeeListExists(Collection<Long> ids);
+
+    /**
+     * 校验员工档案是否都处于指定入职状态
+     *
+     * @param ids 员工档案编号集合
+     * @param entryStatus 入职状态
+     */
+    void validateEmployeeListByEntryStatus(Collection<Long> ids, Integer entryStatus);
+
+    /**
+     * 获得招聘候选人对应的员工
+     *
+     * @param candidateId 招聘候选人编号
+     * @return 员工
+     */
+    HrmEmployeeDO getEmployeeByCandidateId(Long candidateId);
+
+    /**
+     * 获得招聘候选人对应的员工列表
+     *
+     * @param candidateIds 招聘候选人编号集合
+     * @return 员工列表
+     */
+    List<HrmEmployeeDO> getEmployeeListByCandidateIds(Collection<Long> candidateIds);
+
+    /**
+     * 获得招聘候选人对应的员工 Map
+     *
+     * @param candidateIds 招聘候选人编号集合
+     * @return 招聘候选人编号与员工的映射
+     */
+    default Map<Long, HrmEmployeeDO> getEmployeeMapByCandidateIds(Collection<Long> candidateIds) {
+        return convertMap(getEmployeeListByCandidateIds(candidateIds), HrmEmployeeDO::getCandidateId);
+    }
+
+    /**
+     * 获得员工档案列表
+     *
+     * @param ids 员工档案编号集合
+     * @return 员工档案列表
+     */
+    List<HrmEmployeeDO> getEmployeeListByIds(Collection<Long> ids);
+
+    /**
+     * 获得指定入职状态的员工列表
+     *
+     * @param entryStatuses 入职状态集合
+     * @return 员工列表
+     */
+    List<HrmEmployeeDO> getEmployeeListByEntryStatus(Collection<Integer> entryStatuses);
+
+    /**
+     * 获得指定部门的员工列表
+     *
+     * @param deptIds 部门编号集合
+     * @return 员工列表
+     */
+    List<HrmEmployeeDO> getEmployeeListByDeptIds(Collection<Long> deptIds);
+
+    /**
+     * 获得指定直属上级的员工列表
+     *
+     * @param leaderEmployeeId 直属上级员工编号
+     * @return 员工列表
+     */
+    List<HrmEmployeeDO> getEmployeeListByLeaderEmployeeId(Long leaderEmployeeId);
+
+    /**
+     * 获得员工档案 Map
+     *
+     * @param ids 员工档案编号集合
+     * @return 员工档案 Map
+     */
+    default Map<Long, HrmEmployeeDO> getEmployeeMap(Collection<Long> ids) {
+        return convertMap(getEmployeeListByIds(ids), HrmEmployeeDO::getId);
+    }
+
+    /**
+     * 获得员工档案分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 员工档案分页
+     */
+    PageResult<HrmEmployeeDO> getEmployeePage(HrmEmployeePageReqVO pageReqVO);
+
+    /**
+     * 获得员工档案列表
+     *
+     * @param listReqVO 列表查询
+     * @return 员工档案列表
+     */
+    List<HrmEmployeeDO> getEmployeeList(HrmEmployeeListReqVO listReqVO);
+
+    /**
+     * 导入员工档案
+     *
+     * @param importEmployees 导入员工列表
+     * @param duplicateStrategy 重复员工处理策略
+     * @return 导入结果
+     */
+    HrmEmployeeImportRespVO importEmployeeList(List<HrmEmployeeImportExcelVO> importEmployees,
+                                               Integer duplicateStrategy);
+
+    /**
+     * 获得员工状态数量
+     *
+     * @param pageReqVO 分页查询
+     * @return 状态页签与数量的映射
+     */
+    Map<Integer, Long> getEmployeeStatusCount(HrmEmployeePageReqVO pageReqVO);
+
+    /**
+     * 获得各部门在职员工的聘用形式数量
+     *
+     * @return 部门编号、聘用形式与数量的映射
+     */
+    Map<Long, Map<Integer, Long>> getEmployeeCountMapByDeptAndType();
+
+    /**
+     * 获得首页员工概况数量
+     *
+     * @return 首页概况类型与员工数量的映射
+     */
+    Map<Integer, Long> getEmployeeSurveyCountMap();
+
+    // ==================== 员工个人操作 ====================
+
+    /**
+     * 校验当前用户对应的员工档案是否存在
+     *
+     * @param userId 系统用户编号
+     * @return 员工档案
+     */
+    HrmEmployeeDO validateEmployeeBySelf(Long userId);
+
+    /**
+     * 更新当前用户自己的员工档案：仅更新员工档案设置允许员工本人维护的字段
+     *
+     * @param userId 系统用户编号
+     * @param updateReqVO 员工档案信息
+     */
+    void updateEmployeeBySelf(Long userId, @Valid HrmPortalEmployeeUpdateReqVO updateReqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeServiceImpl.java
new file mode 100644
index 0000000..6f63008
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeServiceImpl.java
@@ -0,0 +1,1606 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.module.hrm.service.employee.config.HrmEmployeeFieldConfigService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeQuitInfoService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeSalaryCardService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.map.MapUtil;
+import cn.hutool.core.util.IdcardUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.hutool.extra.spring.SpringUtil;
+import cn.iocoder.yudao.framework.common.exception.ServiceException;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.framework.common.util.validation.ValidationUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeChangeRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeConvertToFullTimeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeDemoteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeePromoteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeRegularReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeTransferReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportExcelVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCreateFromUserReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCancelQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeConfirmEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeNotifyRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeRehireReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.employee.vo.employee.HrmPortalEmployeeUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo.HrmEmployeeQuitInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard.HrmEmployeeSalaryCardSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo.HrmInsuranceEmployeeInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeMapper;
+import cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeArchiveFieldEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeIdTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeImportDuplicateStrategyEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeQuitTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeSurveyTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.ILogRecordService;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import jakarta.validation.ConstraintViolationException;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.transaction.support.TransactionSynchronization;
+import org.springframework.transaction.support.TransactionSynchronizationManager;
+import org.springframework.transaction.support.TransactionTemplate;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+import java.util.concurrent.atomic.AtomicInteger;
+
+import static cn.hutool.core.util.ObjectUtil.defaultIfNull;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.afterNow;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.beforeOrEqualNow;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getYearsBetween;
+import static cn.iocoder.yudao.module.hrm.framework.excel.core.HrmRecruitChannelExcelColumnSelectFunction.parseOption;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CONFIRM_ENTRY_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CREATE_USER_LIST_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CREATE_USER_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CHANGE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CHANGE_TYPE_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_ENTRY_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_IMPORT_LIST_IS_EMPTY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_IMPORT_DUPLICATE_STRATEGY_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_IMPORT_REFERENCE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_JOB_NUMBER_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_LEADER_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_MOBILE_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_PROFILE_FIELD_REQUIRED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_QUIT_CANCEL_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_QUIT_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_QUIT_TIME_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_REHIRE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_USER_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CHANNEL_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CREATE_FROM_USER_LIST_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CANCEL_QUIT_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CANCEL_QUIT_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CONFIRM_ENTRY_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_CONFIRM_ENTRY_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_DEMOTE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_DEMOTE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_FULL_TIME_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_FULL_TIME_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_PROFILE_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_PROFILE_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_PROMOTE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_PROMOTE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_QUIT_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_QUIT_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_REGULAR_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_REGULAR_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_REHIRE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_REHIRE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_TRANSFER_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_TRANSFER_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_ARCHIVE_FILL_MESSAGE_SUB_TYPE;
+
+/**
+ * HRM 员工档案 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+@Slf4j
+public class HrmEmployeeServiceImpl implements HrmEmployeeService {
+
+    @Resource
+    private HrmEmployeeMapper employeeMapper;
+
+    @Resource
+    private AdminUserApi adminUserApi;
+    @Resource
+    private DeptApi deptApi;
+    @Resource
+    private NotifyMessageSendApi notifyMessageSendApi;
+    @Resource
+    private ILogRecordService logRecordService;
+
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmRecruitChannelService recruitChannelService;
+    @Resource
+    private HrmEmployeeFieldConfigService employeeFieldConfigService;
+    @Resource
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @Resource
+    private HrmEmployeeQuitInfoService employeeQuitInfoService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmEmployeeSalaryCardService employeeSalaryCardService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmInsuranceSchemeService insuranceSchemeService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmRecruitCandidateService recruitCandidateService;
+    @Resource
+    private TransactionTemplate transactionTemplate;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CONFIRM_ENTRY_SUB_TYPE,
+            bizNo = "{{#reqVO.id}}", success = HRM_EMPLOYEE_CONFIRM_ENTRY_SUCCESS)
+    public void confirmEmployeeEntry(HrmEmployeeConfirmEntryReqVO reqVO) {
+        // 1. 校验员工状态和完整固定字段
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getId());
+        if (ObjUtil.notEqual(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus(), employee.getEntryStatus())) {
+            throw exception(EMPLOYEE_CONFIRM_ENTRY_STATUS_INVALID);
+        }
+        reqVO.setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        ValidationUtils.validate(reqVO);
+        employeeFieldConfigService.validateEmployeeCreateFields(
+                reqVO, HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        validateEmployeeForCreateOrUpdate(employee.getId(), reqVO);
+
+        // 2. 保存完整员工固定字段并确认入职
+        HrmEmployeeDO updateObj = buildEmployee(reqVO).setId(employee.getId())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()).setLeaveTime(null);
+        employeeMapper.updateForEntryById(updateObj);
+
+        // 3. 同步招聘候选人状态
+        if (employee.getCandidateId() != null) {
+            recruitCandidateService.confirmRecruitCandidateEntry(
+                    employee.getCandidateId(), updateObj.getEntryTime());
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_REHIRE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_REHIRE_SUCCESS)
+    public void rehireEmployee(HrmEmployeeRehireReqVO reqVO) {
+        // 1. 校验员工和再入职信息
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        if (ObjUtil.notEqual(HrmEmployeeEntryStatusEnum.LEFT.getStatus(), employee.getEntryStatus())) {
+            throw exception(EMPLOYEE_REHIRE_STATUS_INVALID);
+        }
+        reqVO.setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        ValidationUtils.validate(reqVO);
+        employeeFieldConfigService.validateEmployeeCreateFields(
+                reqVO, HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        validateEmployeeForCreateOrUpdate(employee.getId(), reqVO);
+
+        // 2.1 计算试用期和转正日期
+        int probation = defaultIfNull(reqVO.getProbation(), 0);
+        Integer status = reqVO.getStatus();
+        LocalDateTime regularTime = null;
+        if (HrmEmployeeTypeEnum.FORMAL.getType().equals(reqVO.getType())) {
+            regularTime = reqVO.getEntryTime().plusMonths(probation);
+            status = probation > 0 && regularTime.isAfter(LocalDateTime.now())
+                    ? HrmEmployeeStatusEnum.PROBATION.getStatus() : HrmEmployeeStatusEnum.REGULAR.getStatus();
+        } else {
+            probation = 0;
+        }
+        LocalDateTime companyAgeStartTime = defaultIfNull(
+                reqVO.getCompanyAgeStartTime(), reqVO.getEntryTime());
+        // 2.2 保存再入职异动记录
+        createEmployeeChangeRecord(BeanUtils.toBean(
+                reqVO, HrmEmployeeChangeRecordCreateReqVO.class)
+                .setNewDeptId(reqVO.getDeptId()).setNewPostName(reqVO.getPostName())
+                .setNewPostLevel(reqVO.getPostLevel()).setNewWorkAddress(reqVO.getWorkAddress())
+                .setNewLeaderEmployeeId(reqVO.getLeaderEmployeeId())
+                .setProbation(probation).setEffectTime(reqVO.getEntryTime()),
+                employee, HrmEmployeeChangeTypeEnum.REHIRE.getType());
+        // 2.3 清理原离职信息
+        employeeQuitInfoService.deleteEmployeeQuitInfo(employee.getId());
+
+        // 3. 更新员工档案
+        HrmEmployeeDO updateObj = BeanUtils.toBean(reqVO, HrmEmployeeDO.class);
+        normalizeEmployeePersonalInfo(updateObj);
+        updateObj.setId(employee.getId())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()).setEntryTime(reqVO.getEntryTime())
+                .setCompanyAgeStartTime(companyAgeStartTime)
+                .setCompanyAge(getYearsBetween(companyAgeStartTime.toLocalDate(), LocalDate.now()))
+                .setType(reqVO.getType()).setStatus(status).setProbation(probation).setRegularTime(regularTime)
+                .setDeptId(reqVO.getDeptId()).setLeaderEmployeeId(reqVO.getLeaderEmployeeId())
+                .setPostName(reqVO.getPostName()).setPostLevel(reqVO.getPostLevel())
+                .setWorkCity(reqVO.getWorkCity()).setWorkAddress(reqVO.getWorkAddress())
+                .setWorkDetailAddress(reqVO.getWorkDetailAddress()).setLeaveTime(null);
+        employeeMapper.updateForEntryById(updateObj);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_REGULAR_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_REGULAR_SUCCESS)
+    public void regularEmployee(HrmEmployeeRegularReqVO reqVO) {
+        // 1. 校验员工
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        validateEmployeeInService(employee, HrmEmployeeChangeTypeEnum.REGULAR);
+        if (ObjUtil.notEqual(HrmEmployeeStatusEnum.PROBATION.getStatus(), employee.getStatus())) {
+            throw exception(EMPLOYEE_CHANGE_STATUS_INVALID, HrmEmployeeChangeTypeEnum.REGULAR.getName());
+        }
+        HrmEmployeeChangeRecordCreateReqVO changeRecord = fillUnchangedPositionFields(
+                BeanUtils.toBean(reqVO, HrmEmployeeChangeRecordCreateReqVO.class), employee);
+        validatePositionChange(employee, HrmEmployeeChangeTypeEnum.REGULAR,
+                changeRecord.getNewDeptId(), changeRecord.getNewLeaderEmployeeId());
+
+        // 2. 创建转正记录
+        HrmEmployeeChangeRecordDO savedChangeRecord = createEmployeeChangeRecord(
+                changeRecord, employee, HrmEmployeeChangeTypeEnum.REGULAR.getType());
+
+        // 3. 同步预约转正时间，并立即应用已到期的转正
+        employeeMapper.updateById(new HrmEmployeeDO().setId(employee.getId())
+                .setRegularTime(savedChangeRecord.getEffectTime()));
+        if (beforeOrEqualNow(savedChangeRecord.getEffectTime())) {
+            applyEmployeeChange(savedChangeRecord);
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_TRANSFER_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_TRANSFER_SUCCESS)
+    public void transferEmployee(HrmEmployeeTransferReqVO reqVO) {
+        // 1. 校验员工
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        validatePositionChange(employee, HrmEmployeeChangeTypeEnum.TRANSFER,
+                reqVO.getNewDeptId(), reqVO.getNewLeaderEmployeeId());
+
+        // 2. 创建调岗记录
+        HrmEmployeeChangeRecordDO changeRecord = createEmployeeChangeRecord(
+                BeanUtils.toBean(reqVO, HrmEmployeeChangeRecordCreateReqVO.class),
+                employee, HrmEmployeeChangeTypeEnum.TRANSFER.getType());
+
+        // 3. 立即应用已生效的调岗
+        if (beforeOrEqualNow(changeRecord.getEffectTime())) {
+            employeeMapper.updatePositionById(changeRecord.getEmployeeId(), changeRecord.getNewDeptId(),
+                    changeRecord.getNewPostName(), changeRecord.getNewPostLevel(),
+                    changeRecord.getNewWorkAddress(), changeRecord.getNewLeaderEmployeeId());
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_PROMOTE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_PROMOTE_SUCCESS)
+    public void promoteEmployee(HrmEmployeePromoteReqVO reqVO) {
+        // 1. 校验员工
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        validatePositionChange(employee, HrmEmployeeChangeTypeEnum.PROMOTION,
+                reqVO.getNewDeptId(), reqVO.getNewLeaderEmployeeId());
+
+        // 2. 创建晋升记录
+        HrmEmployeeChangeRecordDO changeRecord = createEmployeeChangeRecord(
+                BeanUtils.toBean(reqVO, HrmEmployeeChangeRecordCreateReqVO.class),
+                employee, HrmEmployeeChangeTypeEnum.PROMOTION.getType());
+
+        // 3. 立即应用已生效的晋升
+        if (beforeOrEqualNow(changeRecord.getEffectTime())) {
+            employeeMapper.updatePositionById(changeRecord.getEmployeeId(), changeRecord.getNewDeptId(),
+                    changeRecord.getNewPostName(), changeRecord.getNewPostLevel(),
+                    changeRecord.getNewWorkAddress(), changeRecord.getNewLeaderEmployeeId());
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_DEMOTE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_DEMOTE_SUCCESS)
+    public void demoteEmployee(HrmEmployeeDemoteReqVO reqVO) {
+        // 1. 校验员工
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        validatePositionChange(employee, HrmEmployeeChangeTypeEnum.DEMOTION,
+                reqVO.getNewDeptId(), reqVO.getNewLeaderEmployeeId());
+
+        // 2. 创建降级记录
+        HrmEmployeeChangeRecordDO changeRecord = createEmployeeChangeRecord(
+                BeanUtils.toBean(reqVO, HrmEmployeeChangeRecordCreateReqVO.class),
+                employee, HrmEmployeeChangeTypeEnum.DEMOTION.getType());
+
+        // 3. 立即应用已生效的降级
+        if (beforeOrEqualNow(changeRecord.getEffectTime())) {
+            employeeMapper.updatePositionById(changeRecord.getEmployeeId(), changeRecord.getNewDeptId(),
+                    changeRecord.getNewPostName(), changeRecord.getNewPostLevel(),
+                    changeRecord.getNewWorkAddress(), changeRecord.getNewLeaderEmployeeId());
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_FULL_TIME_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_FULL_TIME_SUCCESS)
+    public void convertEmployeeToFullTime(HrmEmployeeConvertToFullTimeReqVO reqVO) {
+        // 1. 校验员工
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        validateEmployeeInService(employee, HrmEmployeeChangeTypeEnum.FULL_TIME);
+        if (!HrmEmployeeStatusEnum.CONVERTIBLE_TO_FULL_TIME_STATUSES.contains(employee.getStatus())) {
+            throw exception(EMPLOYEE_CHANGE_STATUS_INVALID, HrmEmployeeChangeTypeEnum.FULL_TIME.getName());
+        }
+        HrmEmployeeChangeRecordCreateReqVO changeRecord = fillUnchangedPositionFields(
+                BeanUtils.toBean(reqVO, HrmEmployeeChangeRecordCreateReqVO.class), employee);
+        validatePositionChange(employee, HrmEmployeeChangeTypeEnum.FULL_TIME,
+                changeRecord.getNewDeptId(), changeRecord.getNewLeaderEmployeeId());
+
+        // 2. 创建转为全职记录
+        HrmEmployeeChangeRecordDO savedChangeRecord = createEmployeeChangeRecord(
+                changeRecord, employee, HrmEmployeeChangeTypeEnum.FULL_TIME.getType());
+
+        // 3. 立即应用已生效的转为全职
+        if (beforeOrEqualNow(savedChangeRecord.getEffectTime())) {
+            applyEmployeeChange(savedChangeRecord);
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public boolean applyEmployeeChange(HrmEmployeeChangeRecordDO changeRecord) {
+        // 1. 校验异动类型
+        if (ObjectUtils.notEqualsAny(changeRecord.getType(), HrmEmployeeChangeTypeEnum.REGULAR.getType(),
+                HrmEmployeeChangeTypeEnum.TRANSFER.getType(), HrmEmployeeChangeTypeEnum.PROMOTION.getType(),
+                HrmEmployeeChangeTypeEnum.DEMOTION.getType(), HrmEmployeeChangeTypeEnum.FULL_TIME.getType())) {
+            throw exception(EMPLOYEE_CHANGE_TYPE_INVALID, changeRecord.getType());
+        }
+
+        // 2. 已生效记录、未到期记录和非在职员工不再重复处理
+        if (changeRecord.getAppliedTime() != null || afterNow(changeRecord.getEffectTime())) {
+            return false;
+        }
+        HrmEmployeeDO employee = employeeMapper.selectById(changeRecord.getEmployeeId());
+        if (employee == null || !HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(employee.getEntryStatus())) {
+            employeeChangeRecordService.updateEmployeeChangeRecordAppliedTime(changeRecord.getId(), LocalDateTime.now());
+            return false;
+        }
+
+        // 3. 按异动类型更新员工主档
+        if (HrmEmployeeChangeTypeEnum.REGULAR.getType().equals(changeRecord.getType())) {
+            if (ObjUtil.notEqual(employee.getStatus(), HrmEmployeeStatusEnum.PROBATION.getStatus())) {
+                employeeChangeRecordService.updateEmployeeChangeRecordAppliedTime(
+                        changeRecord.getId(), LocalDateTime.now());
+                return false;
+            }
+            fillUnchangedPositionFields(changeRecord, employee);
+            employeeMapper.updateById(new HrmEmployeeDO().setId(changeRecord.getEmployeeId())
+                    .setRegularTime(changeRecord.getEffectTime())
+                    .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus()));
+            employeeMapper.updatePositionById(changeRecord.getEmployeeId(), changeRecord.getNewDeptId(),
+                    changeRecord.getNewPostName(), changeRecord.getNewPostLevel(),
+                    changeRecord.getNewWorkAddress(), changeRecord.getNewLeaderEmployeeId());
+        } else if (ObjectUtils.equalsAny(changeRecord.getType(), HrmEmployeeChangeTypeEnum.TRANSFER.getType(),
+                HrmEmployeeChangeTypeEnum.PROMOTION.getType(), HrmEmployeeChangeTypeEnum.DEMOTION.getType())) {
+            employeeMapper.updatePositionById(changeRecord.getEmployeeId(), changeRecord.getNewDeptId(),
+                    changeRecord.getNewPostName(), changeRecord.getNewPostLevel(),
+                    changeRecord.getNewWorkAddress(), changeRecord.getNewLeaderEmployeeId());
+        } else if (HrmEmployeeChangeTypeEnum.FULL_TIME.getType().equals(changeRecord.getType())) {
+            if (!HrmEmployeeStatusEnum.CONVERTIBLE_TO_FULL_TIME_STATUSES.contains(employee.getStatus())) {
+                employeeChangeRecordService.updateEmployeeChangeRecordAppliedTime(
+                        changeRecord.getId(), LocalDateTime.now());
+                return false;
+            }
+            fillUnchangedPositionFields(changeRecord, employee);
+            int probation = defaultIfNull(changeRecord.getProbation(), 0);
+            LocalDateTime regularTime = changeRecord.getEffectTime().plusMonths(probation);
+            employeeMapper.updateById(new HrmEmployeeDO().setId(changeRecord.getEmployeeId())
+                    .setType(HrmEmployeeTypeEnum.FORMAL.getType())
+                    .setStatus(probation == 0 ? HrmEmployeeStatusEnum.REGULAR.getStatus()
+                            : HrmEmployeeStatusEnum.PROBATION.getStatus())
+                    .setProbation(probation).setRegularTime(regularTime));
+            employeeMapper.updatePositionById(changeRecord.getEmployeeId(), changeRecord.getNewDeptId(),
+                    changeRecord.getNewPostName(), changeRecord.getNewPostLevel(),
+                    changeRecord.getNewWorkAddress(), changeRecord.getNewLeaderEmployeeId());
+        }
+
+        // 4. 标记异动记录已实际生效
+        employeeChangeRecordService.updateEmployeeChangeRecordAppliedTime(changeRecord.getId(), LocalDateTime.now());
+        return true;
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getDueRegularEmployeeList(LocalDateTime deadlineTime) {
+        return employeeMapper.selectListByRegularTimeBeforeOrEqual(deadlineTime);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public boolean applyEmployeeRegular(Long employeeId) {
+        // 1. 只处理仍在职、处于试用期且转正时间已到的员工
+        HrmEmployeeDO employee = employeeMapper.selectById(employeeId);
+        if (employee == null || !HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(employee.getEntryStatus())
+                || ObjUtil.notEqual(employee.getStatus(), HrmEmployeeStatusEnum.PROBATION.getStatus())
+                || employee.getRegularTime() == null || afterNow(employee.getRegularTime())) {
+            return false;
+        }
+        // 2. 将员工状态更新为正式
+        employeeMapper.updateById(new HrmEmployeeDO().setId(employeeId)
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus()));
+        return true;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public boolean applyEmployeeQuit(HrmEmployeeQuitInfoDO quitInfo) {
+        // 1. 校验员工
+        HrmEmployeeDO employee = employeeMapper.selectById(quitInfo.getEmployeeId());
+        if (employee == null
+                || ObjUtil.notEqual(employee.getEntryStatus(), HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                || quitInfo.getPlanQuitTime() == null || afterNow(quitInfo.getPlanQuitTime())) {
+            return false;
+        }
+
+        // 2. 更新员工离职状态
+        LocalDate companyAgeStartDate = employee.getCompanyAgeStartTime() == null
+                ? null : employee.getCompanyAgeStartTime().toLocalDate();
+        employeeMapper.updateById(new HrmEmployeeDO().setId(employee.getId())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setLeaveTime(quitInfo.getPlanQuitTime())
+                .setCompanyAge(getYearsBetween(companyAgeStartDate, quitInfo.getPlanQuitTime().toLocalDate())));
+        return true;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_QUIT_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_QUIT_SUCCESS)
+    public void quitEmployee(HrmEmployeeQuitReqVO reqVO) {
+        // 1. 校验员工状态和离职信息
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        if (ObjectUtils.notEqualsAny(employee.getEntryStatus(), HrmEmployeeEntryStatusEnum.ACTIVE.getStatus(),
+                HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus(),
+                HrmEmployeeEntryStatusEnum.LEFT.getStatus())) {
+            throw exception(EMPLOYEE_QUIT_STATUS_INVALID);
+        }
+        boolean alreadyLeft = HrmEmployeeEntryStatusEnum.LEFT.getStatus().equals(employee.getEntryStatus());
+        if (alreadyLeft && afterNow(reqVO.getPlanQuitTime())) {
+            throw exception(EMPLOYEE_QUIT_TIME_INVALID);
+        }
+
+        // 2. 保存离职信息
+        if (HrmEmployeeQuitTypeEnum.RETIREMENT.getType().equals(reqVO.getType())) {
+            reqVO.setReason(null);
+        }
+        HrmEmployeeQuitInfoSaveReqVO quitInfo = BeanUtils.toBean(reqVO, HrmEmployeeQuitInfoSaveReqVO.class)
+                .setApplyQuitTime(getDayBeginTime(reqVO.getApplyQuitTime()))
+                .setSalarySettlementTime(getDayBeginTime(reqVO.getSalarySettlementTime()))
+                .setOldEmployeeStatus(employee.getStatus());
+        employeeQuitInfoService.saveEmployeeQuitInfo(quitInfo);
+
+        // 3. 更新员工离职状态
+        boolean effectiveImmediately = beforeOrEqualNow(reqVO.getPlanQuitTime());
+        Integer entryStatus = alreadyLeft ? HrmEmployeeEntryStatusEnum.LEFT.getStatus()
+                : HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus();
+        Integer companyAge = null;
+        if (alreadyLeft || effectiveImmediately) {
+            entryStatus = HrmEmployeeEntryStatusEnum.LEFT.getStatus();
+            companyAge = getYearsBetween(employee.getCompanyAgeStartTime() != null
+                    ? employee.getCompanyAgeStartTime().toLocalDate() : null, reqVO.getPlanQuitTime().toLocalDate());
+        }
+        employeeMapper.updateById(new HrmEmployeeDO().setId(reqVO.getEmployeeId())
+                .setEntryStatus(entryStatus).setLeaveTime(reqVO.getPlanQuitTime()).setCompanyAge(companyAge));
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CANCEL_QUIT_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_EMPLOYEE_CANCEL_QUIT_SUCCESS)
+    public void cancelEmployeeQuit(HrmEmployeeCancelQuitReqVO reqVO) {
+        // 1. 校验员工和离职信息
+        HrmEmployeeDO employee = validateEmployeeExists(reqVO.getEmployeeId());
+        if (ObjUtil.notEqual(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus(), employee.getEntryStatus())) {
+            throw exception(EMPLOYEE_QUIT_CANCEL_STATUS_INVALID);
+        }
+        employeeQuitInfoService.validateQuitInfoByEmployeeId(reqVO.getEmployeeId());
+
+        // 2. 删除离职信息
+        employeeQuitInfoService.deleteEmployeeQuitInfo(reqVO.getEmployeeId());
+
+        // 3. 恢复员工在职状态
+        employeeMapper.updateById(new HrmEmployeeDO().setId(reqVO.getEmployeeId())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+        employeeMapper.updateLeaveTimeById(reqVO.getEmployeeId(), null);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_CREATE_SUB_TYPE,
+            bizNo = "{{#employee.id}}", success = HRM_EMPLOYEE_CREATE_SUCCESS)
+    public Long createEmployee(HrmEmployeeSaveReqVO createReqVO) {
+        // 1. 校验员工档案及其关联数据
+        employeeFieldConfigService.validateEmployeeCreateFields(createReqVO, createReqVO.getEntryStatus());
+        validateEmployeeForCreateOrUpdate(null, createReqVO);
+
+        // 2. 插入员工档案
+        HrmEmployeeDO employee = buildEmployee(createReqVO);
+        employeeMapper.insert(employee);
+
+        // 3. 事务提交后发送员工端开通通知
+        sendEmployeeOpenedMessage(Collections.singletonList(employee));
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+        return employee.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<Long> createEmployeeList(List<HrmEmployeeCreateFromUserReqVO> createReqVOList) {
+        // 1.1 校验后台用户，并一次性加载用户资料
+        Set<Long> userIds = new HashSet<>();
+        for (HrmEmployeeCreateFromUserReqVO employeeReqVO : createReqVOList) {
+            if (!userIds.add(employeeReqVO.getUserId())) {
+                throw exception(EMPLOYEE_CREATE_USER_LIST_DUPLICATE);
+            }
+        }
+        adminUserApi.validateUserList(userIds);
+        Map<Long, AdminUserRespDTO> userMap = convertMap(
+                adminUserApi.getUserList(userIds), AdminUserRespDTO::getId);
+        // 1.2 构建并校验全部员工档案，避免部分数据校验失败时已经执行写库
+        Set<String> jobNumbers = new HashSet<>();
+        Set<String> mobiles = new HashSet<>();
+        List<HrmEmployeeSaveReqVO> saveReqVOList = new ArrayList<>();
+        for (HrmEmployeeCreateFromUserReqVO employeeReqVO : createReqVOList) {
+            AdminUserRespDTO user = userMap.get(employeeReqVO.getUserId());
+            if (user == null) {
+                throw exception(EMPLOYEE_CREATE_USER_NOT_EXISTS);
+            }
+            HrmEmployeeSaveReqVO saveReqVO = BeanUtils.toBean(employeeReqVO, HrmEmployeeSaveReqVO.class);
+            employeeFieldConfigService.validateEmployeeCreateFields(
+                    saveReqVO, HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+            saveReqVO.setName(user.getNickname()).setEmail(user.getEmail()).setSex(user.getSex())
+                    .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                    .setCompanyAgeStartTime(employeeReqVO.getEntryTime());
+            if (!jobNumbers.add(saveReqVO.getJobNumber())) {
+                throw exception(EMPLOYEE_JOB_NUMBER_DUPLICATE);
+            }
+            if (!mobiles.add(saveReqVO.getMobile())) {
+                throw exception(EMPLOYEE_MOBILE_DUPLICATE);
+            }
+            ValidationUtils.validate(saveReqVO);
+            validateEmployeeForCreateOrUpdate(null, saveReqVO);
+            saveReqVOList.add(saveReqVO);
+        }
+
+        // 2. 批量插入员工档案
+        List<HrmEmployeeDO> employees = convertList(saveReqVOList, this::buildEmployee);
+        employeeMapper.insertBatch(employees);
+
+        // 3. 事务提交后发送员工端开通通知，并按员工档案分别记录操作日志
+        sendEmployeeOpenedMessage(employees);
+        recordEmployeeCreatedLogs(employees);
+        return convertList(employees, HrmEmployeeDO::getId);
+    }
+
+    @Override
+    public List<Long> getBoundUserIdList() {
+        return convertList(employeeMapper.selectListWithUserId(), HrmEmployeeDO::getUserId);
+    }
+
+    @Override
+    public HrmEmployeeNotifyRespVO sendEmployeeProfileFillMessage(List<Long> employeeIds) {
+        // 1. 校验并加载员工
+        Set<Long> distinctEmployeeIds = new HashSet<>(employeeIds);
+        List<HrmEmployeeDO> employees = employeeMapper.selectByIds(distinctEmployeeIds);
+        if (employees.size() != distinctEmployeeIds.size()) {
+            throw exception(EMPLOYEE_NOT_EXISTS);
+        }
+
+        // 2. 向已经绑定后台账号的员工发送填写档案通知
+        int successCount = 0;
+        int skippedCount = 0;
+        int failureCount = 0;
+        List<HrmEmployeeDO> notifiedEmployees = new ArrayList<>();
+        for (HrmEmployeeDO employee : employees) {
+            if (employee.getUserId() == null) {
+                skippedCount++;
+                continue;
+            }
+            if (sendEmployeeMessage(employee, MessageTemplateConstants.EMPLOYEE_ARCHIVE_FILL)) {
+                successCount++;
+                notifiedEmployees.add(employee);
+            } else {
+                failureCount++;
+            }
+        }
+        HrmEmployeeNotifyRespVO notifyResult = new HrmEmployeeNotifyRespVO()
+                .setSuccessCount(successCount).setSkippedCount(skippedCount).setFailureCount(failureCount);
+
+        // 3. 按员工档案分别记录操作日志，确保可在员工详情中查询
+        recordEmployeeProfileFillMessageLogs(notifiedEmployees);
+
+        // 4. 返回通知结果
+        return notifyResult;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = HRM_EMPLOYEE_UPDATE_SUCCESS)
+    public void updateEmployee(HrmEmployeeSaveReqVO updateReqVO) {
+        // 1. 校验员工档案及其关联数据
+        HrmEmployeeDO employee = validateEmployeeForCreateOrUpdate(updateReqVO.getId(), updateReqVO);
+
+        // 2. 更新员工档案
+        HrmEmployeeDO updateObj = buildEmployeeForUpdate(updateReqVO, employee);
+        employeeMapper.updateById(updateObj);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(employee, HrmEmployeeSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_DELETE_SUB_TYPE,
+            bizNo = "{{#employee.id}}", success = HRM_EMPLOYEE_DELETE_SUCCESS)
+    public void deleteEmployee(Long id) {
+        // 1. 校验员工档案是否存在
+        HrmEmployeeDO employee = validateEmployeeExists(id);
+
+        // 2. 删除员工档案
+        employeeMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deleteEmployeeList(List<Long> ids) {
+        // 1. 查询员工
+        List<HrmEmployeeDO> employees = employeeMapper.selectByIds(ids);
+        if (CollUtil.isEmpty(employees)) {
+            return;
+        }
+
+        // 2. 删除员工
+        for (HrmEmployeeDO employee : employees) {
+            getSelf().deleteEmployee(employee.getId());
+        }
+    }
+
+    @Override
+    public void updateEmployeeChannelByChannelId(Long channelId, Long newChannelId) {
+        employeeMapper.updateChannelIdByChannelId(channelId, newChannelId);
+    }
+
+    @Override
+    public HrmEmployeeDO getEmployee(Long id) {
+        if (id == null) {
+            return null;
+        }
+        return employeeMapper.selectById(id);
+    }
+
+    @Override
+    public HrmEmployeeDO getEmployeeByUserId(Long userId) {
+        if (userId == null) {
+            return null;
+        }
+        return employeeMapper.selectByUserId(userId);
+    }
+
+    @Override
+    public HrmEmployeeDO getEmployeeByJobNumber(String jobNumber) {
+        return employeeMapper.selectByJobNumber(jobNumber);
+    }
+
+    @Override
+    public HrmEmployeeDO validateEmployeeExists(Long id) {
+        HrmEmployeeDO employee = employeeMapper.selectById(id);
+        if (employee == null) {
+            throw exception(EMPLOYEE_NOT_EXISTS);
+        }
+        return employee;
+    }
+
+    @Override
+    public HrmEmployeeDO validateEmployeeExistsForUpdate(Long id) {
+        HrmEmployeeDO employee = employeeMapper.selectByIdForUpdate(id);
+        if (employee == null) {
+            throw exception(EMPLOYEE_NOT_EXISTS);
+        }
+        return employee;
+    }
+
+    @Override
+    public void validateEmployeeListExists(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return;
+        }
+        Set<Long> employeeIds = new HashSet<>(ids);
+        if (getEmployeeListByIds(employeeIds).size() != employeeIds.size()) {
+            throw exception(EMPLOYEE_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public void validateEmployeeListByEntryStatus(Collection<Long> ids, Integer entryStatus) {
+        if (CollUtil.isEmpty(ids)) {
+            return;
+        }
+        Set<Long> employeeIds = new HashSet<>(ids);
+        List<HrmEmployeeDO> employees = getEmployeeListByIds(employeeIds);
+        if (employees.size() != employeeIds.size()) {
+            throw exception(EMPLOYEE_NOT_EXISTS);
+        }
+        HrmEmployeeDO invalidEmployee = CollUtil.findOne(employees,
+                employee -> ObjUtil.notEqual(employee.getEntryStatus(), entryStatus));
+        if (invalidEmployee != null) {
+            throw exception(EMPLOYEE_ENTRY_STATUS_INVALID, invalidEmployee.getName());
+        }
+    }
+
+    @Override
+    public HrmEmployeeDO getEmployeeByCandidateId(Long candidateId) {
+        return employeeMapper.selectByCandidateId(candidateId);
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getEmployeeListByCandidateIds(Collection<Long> candidateIds) {
+        if (CollUtil.isEmpty(candidateIds)) {
+            return Collections.emptyList();
+        }
+        return employeeMapper.selectListByCandidateIds(candidateIds);
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getEmployeeListByIds(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return employeeMapper.selectByIds(ids);
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getEmployeeListByEntryStatus(Collection<Integer> entryStatuses) {
+        if (CollUtil.isEmpty(entryStatuses)) {
+            return Collections.emptyList();
+        }
+        return employeeMapper.selectListByEntryStatus(entryStatuses);
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getEmployeeListByDeptIds(Collection<Long> deptIds) {
+        if (CollUtil.isEmpty(deptIds)) {
+            return Collections.emptyList();
+        }
+        return employeeMapper.selectListByDeptIds(deptIds);
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getEmployeeListByLeaderEmployeeId(Long leaderEmployeeId) {
+        return employeeMapper.selectListByLeaderEmployeeId(leaderEmployeeId);
+    }
+
+    @Override
+    public PageResult<HrmEmployeeDO> getEmployeePage(HrmEmployeePageReqVO pageReqVO) {
+        return employeeMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getEmployeeList(HrmEmployeeListReqVO listReqVO) {
+        return employeeMapper.selectList(BeanUtils.toBean(listReqVO, HrmEmployeePageReqVO.class));
+    }
+
+    @Override
+    public HrmEmployeeImportRespVO importEmployeeList(List<HrmEmployeeImportExcelVO> importEmployees,
+                                                      Integer duplicateStrategy) {
+        // 1. 参数校验
+        if (CollUtil.isEmpty(importEmployees)) {
+            throw exception(EMPLOYEE_IMPORT_LIST_IS_EMPTY);
+        }
+        HrmEmployeeImportDuplicateStrategyEnum strategy =
+                HrmEmployeeImportDuplicateStrategyEnum.valueOf(duplicateStrategy);
+        if (strategy == null) {
+            throw exception(EMPLOYEE_IMPORT_DUPLICATE_STRATEGY_INVALID);
+        }
+
+        // 2. 遍历，逐个创建 or 更新
+        HrmEmployeeImportRespVO respVO = HrmEmployeeImportRespVO.builder()
+                .createJobNumbers(new ArrayList<>()).updateJobNumbers(new ArrayList<>())
+                .skipJobNumbers(new ArrayList<>())
+                .failureJobNumbers(new LinkedHashMap<>()).build();
+        // 下拉选项的格式化与反向解析统一收敛到 HrmRecruitChannelExcelColumnSelectFunction。
+        List<HrmRecruitChannelDO> recruitChannels = recruitChannelService.getRecruitChannelSimpleList();
+        AtomicInteger index = new AtomicInteger(1);
+        importEmployees.forEach(importEmployee -> {
+            int currentIndex = index.getAndIncrement();
+            String employeeLabel = getImportEmployeeLabel(importEmployee, currentIndex);
+            String failureKey = getImportFailureKey(employeeLabel, currentIndex);
+            HrmEmployeeSaveReqVO saveReqVO = BeanUtils.toBean(importEmployee, HrmEmployeeSaveReqVO.class);
+            Long schemeId;
+            // 2.1 将 Excel 业务键解析为内部关联编号，并校验员工、工资卡和社保字段
+            try {
+                schemeId = resolveImportedEmployeeRelations(importEmployee, saveReqVO);
+                if (StrUtil.isNotBlank(importEmployee.getChannelName())) {
+                    HrmRecruitChannelDO recruitChannel = parseOption(
+                            recruitChannels, importEmployee.getChannelName());
+                    if (recruitChannel == null) {
+                        throw exception(RECRUIT_CHANNEL_NOT_EXISTS);
+                    }
+                    saveReqVO.setChannelId(recruitChannel.getId());
+                }
+                ValidationUtils.validate(saveReqVO);
+                validateImportedEmployeeResources(importEmployee, schemeId);
+            } catch (ConstraintViolationException | ServiceException ex) {
+                respVO.getFailureJobNumbers().put(failureKey, ex.getMessage());
+                return;
+            }
+
+            HrmEmployeeDO existEmployee = getImportExistEmployee(saveReqVO);
+            // 2.2 根据重复策略处理已经存在的员工
+            if (existEmployee != null) {
+                if (strategy == HrmEmployeeImportDuplicateStrategyEnum.SKIP) {
+                    respVO.getSkipJobNumbers().add(employeeLabel);
+                    return;
+                }
+                if (strategy == HrmEmployeeImportDuplicateStrategyEnum.FAIL) {
+                    respVO.getFailureJobNumbers().put(failureKey, "员工档案已存在");
+                    return;
+                }
+            }
+
+            // 2.3 在独立事务内保存员工及其工资卡、社保信息
+            try {
+                transactionTemplate.executeWithoutResult(status -> {
+                    validateEmployeeForCreateOrUpdate(
+                            existEmployee == null ? null : existEmployee.getId(), saveReqVO);
+                    HrmEmployeeDO importedEmployee = existEmployee == null
+                            ? buildImportedEmployee(saveReqVO)
+                            : buildEmployeeForUpdate(saveReqVO, existEmployee);
+                    if (existEmployee == null) {
+                        employeeMapper.insert(importedEmployee);
+                    } else {
+                        employeeMapper.updateById(importedEmployee);
+                    }
+                    saveImportedEmployeeResources(importedEmployee.getId(), importEmployee, schemeId);
+                });
+                if (existEmployee == null) {
+                    respVO.getCreateJobNumbers().add(employeeLabel);
+                } else {
+                    respVO.getUpdateJobNumbers().add(employeeLabel);
+                }
+            } catch (Exception ex) {
+                if (ex instanceof ConstraintViolationException || ex instanceof ServiceException) {
+                    respVO.getFailureJobNumbers().put(failureKey, ex.getMessage());
+                } else {
+                    log.error("[importEmployeeList][员工({}) 导入异常]", employeeLabel, ex);
+                    respVO.getFailureJobNumbers().put(failureKey, "导入异常");
+                }
+            }
+        });
+        return respVO;
+    }
+
+    @Override
+    public Map<Integer, Long> getEmployeeStatusCount(HrmEmployeePageReqVO pageReqVO) {
+        Map<Integer, Long> countMap = new LinkedHashMap<>();
+        for (HrmEmployeeStatusTabEnum statusTab : HrmEmployeeStatusTabEnum.values()) {
+            countMap.put(statusTab.getStatus(), 0L);
+        }
+        for (Map<String, Object> record : employeeMapper.selectCountListByStatus(pageReqVO)) {
+            Integer status = MapUtil.getInt(record, "status");
+            Integer entryStatus = MapUtil.getInt(record, "entryStatus");
+            Long count = MapUtil.getLong(record, "count");
+            if (count == null) {
+                continue;
+            }
+            // 在职人数包含“在职”和“待离职”，并继续按员工状态统计
+            if (HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(entryStatus)) {
+                addStatusCount(countMap, HrmEmployeeStatusTabEnum.ACTIVE.getStatus(), count);
+                if (HrmEmployeeStatusEnum.valueOf(status) != null) {
+                    addStatusCount(countMap, status, count);
+                }
+                if (HrmEmployeeStatusEnum.FULL_TIME_STATUSES.contains(status)) {
+                    addStatusCount(countMap, HrmEmployeeStatusTabEnum.FULL_TIME.getStatus(), count);
+                }
+            }
+            if (HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus().equals(entryStatus)) {
+                addStatusCount(countMap, HrmEmployeeStatusTabEnum.PENDING_ENTRY.getStatus(), count);
+            } else if (HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus().equals(entryStatus)) {
+                addStatusCount(countMap, HrmEmployeeStatusTabEnum.PENDING_LEAVE.getStatus(), count);
+            } else if (HrmEmployeeEntryStatusEnum.LEFT.getStatus().equals(entryStatus)) {
+                addStatusCount(countMap, HrmEmployeeStatusTabEnum.LEFT.getStatus(), count);
+            }
+        }
+        return countMap;
+    }
+
+    @Override
+    public Map<Long, Map<Integer, Long>> getEmployeeCountMapByDeptAndType() {
+        // 1. 查询各部门在职员工的聘用形式数量
+        List<Map<String, Object>> countList = employeeMapper.selectCountListByDeptIdAndType(
+                HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES);
+
+        // 2. 转换为部门编号、聘用形式与数量的映射
+        Map<Long, Map<Integer, Long>> countMap = new LinkedHashMap<>();
+        for (Map<String, Object> record : countList) {
+            Long deptId = MapUtil.getLong(record, "deptId");
+            Integer type = MapUtil.getInt(record, "type");
+            Long count = MapUtil.getLong(record, "count");
+            if (deptId == null || count == null) {
+                continue;
+            }
+            countMap.computeIfAbsent(deptId, key -> new LinkedHashMap<>()).put(type, count);
+        }
+        return countMap;
+    }
+
+    @Override
+    public Map<Integer, Long> getEmployeeSurveyCountMap() {
+        LocalDate now = LocalDate.now();
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(
+                now.getYear(), now.getMonthValue());
+        Map<Integer, Long> surveyCountMap = new HashMap<>();
+
+        // 1. 统计本月入职和待入职人数
+        for (Map<String, Object> record : employeeMapper.selectCountListByEntryStatusAndEntryTimeBetween(
+                monthTimes)) {
+            Integer entryStatus = MapUtil.getInt(record, "entryStatus");
+            Long count = MapUtil.getLong(record, "count");
+            if (HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus().equals(entryStatus)) {
+                surveyCountMap.put(HrmEmployeeSurveyTypeEnum.PENDING_ENTRY.getType(), count);
+            } else {
+                surveyCountMap.merge(HrmEmployeeSurveyTypeEnum.ENTRY.getType(), count, Long::sum);
+            }
+        }
+
+        // 2. 统计本月离职和待离职人数
+        for (Map<String, Object> record : employeeMapper.selectCountListByEntryStatusAndLeaveTimeBetween(
+                monthTimes)) {
+            Integer entryStatus = MapUtil.getInt(record, "entryStatus");
+            Integer surveyType = HrmEmployeeEntryStatusEnum.LEFT.getStatus().equals(entryStatus)
+                    ? HrmEmployeeSurveyTypeEnum.LEAVE.getType()
+                    : HrmEmployeeSurveyTypeEnum.PENDING_LEAVE.getType();
+            surveyCountMap.put(surveyType, MapUtil.getLong(record, "count"));
+        }
+
+        // 3. 统计本月转正和调岗人数
+        for (Map<String, Object> record : employeeMapper.selectCountListByChangeTypeAndEffectTimeBetween(
+                monthTimes)) {
+            Integer changeType = MapUtil.getInt(record, "changeType");
+            Integer surveyType = HrmEmployeeChangeTypeEnum.REGULAR.getType().equals(changeType)
+                    ? HrmEmployeeSurveyTypeEnum.REGULAR.getType()
+                    : HrmEmployeeSurveyTypeEnum.TRANSFER.getType();
+            surveyCountMap.put(surveyType, MapUtil.getLong(record, "count"));
+        }
+        return surveyCountMap;
+    }
+
+    // ==================== 员工个人操作 ====================
+
+    @Override
+    public HrmEmployeeDO validateEmployeeBySelf(Long userId) {
+        HrmEmployeeDO employee = getEmployeeByUserId(userId);
+        if (employee == null) {
+            throw exception(EMPLOYEE_NOT_EXISTS);
+        }
+        return employee;
+    }
+
+    @Override
+    @SuppressWarnings("ExtractMethodRecommender")
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_EMPLOYEE_TYPE, subType = HRM_EMPLOYEE_PROFILE_UPDATE_SUB_TYPE,
+            bizNo = "{{#employee.id}}", success = HRM_EMPLOYEE_PROFILE_UPDATE_SUCCESS)
+    public void updateEmployeeBySelf(Long userId, HrmPortalEmployeeUpdateReqVO updateReqVO) {
+        // 1. 校验员工档案和可编辑字段
+        HrmEmployeeDO employee = validateEmployeeBySelf(userId);
+        Set<String> editableFields = employeeFieldConfigService.getEditableArchiveFieldNames();
+        if (CollUtil.isEmpty(editableFields)) {
+            return;
+        }
+        if (editableFields.contains(HrmEmployeeArchiveFieldEnum.NAME.getName())
+                && StrUtil.isBlank(updateReqVO.getName())) {
+            throw exception(EMPLOYEE_PROFILE_FIELD_REQUIRED,
+                    HrmEmployeeArchiveFieldEnum.NAME.getTitle());
+        }
+        if (editableFields.contains(HrmEmployeeArchiveFieldEnum.MOBILE.getName())
+                && StrUtil.isNotBlank(updateReqVO.getMobile())) {
+            validateMobileUnique(employee.getId(), updateReqVO.getMobile());
+        }
+
+        // 2.1 按字段白名单构造员工档案
+        HrmEmployeeDO updateObj = new HrmEmployeeDO().setId(employee.getId())
+                .setName(editableFields.contains(HrmEmployeeArchiveFieldEnum.NAME.getName())
+                        ? updateReqVO.getName() : employee.getName())
+                .setMobile(editableFields.contains(HrmEmployeeArchiveFieldEnum.MOBILE.getName())
+                        ? updateReqVO.getMobile() : employee.getMobile())
+                .setEmail(editableFields.contains(HrmEmployeeArchiveFieldEnum.EMAIL.getName())
+                        ? updateReqVO.getEmail() : employee.getEmail())
+                .setCountry(editableFields.contains(HrmEmployeeArchiveFieldEnum.COUNTRY.getName())
+                        ? updateReqVO.getCountry() : employee.getCountry())
+                .setNation(editableFields.contains(HrmEmployeeArchiveFieldEnum.NATION.getName())
+                        ? updateReqVO.getNation() : employee.getNation())
+                .setIdType(editableFields.contains(HrmEmployeeArchiveFieldEnum.ID_TYPE.getName())
+                        ? updateReqVO.getIdType() : employee.getIdType())
+                .setIdNumber(editableFields.contains(HrmEmployeeArchiveFieldEnum.ID_NUMBER.getName())
+                        ? updateReqVO.getIdNumber() : employee.getIdNumber())
+                .setSex(editableFields.contains(HrmEmployeeArchiveFieldEnum.SEX.getName())
+                        ? updateReqVO.getSex() : employee.getSex())
+                .setNativePlace(editableFields.contains(HrmEmployeeArchiveFieldEnum.NATIVE_PLACE.getName())
+                        ? updateReqVO.getNativePlace() : employee.getNativePlace())
+                .setBirthday(editableFields.contains(HrmEmployeeArchiveFieldEnum.BIRTHDAY.getName())
+                        ? updateReqVO.getBirthday() : employee.getBirthday())
+                .setAddress(editableFields.contains(HrmEmployeeArchiveFieldEnum.ADDRESS.getName())
+                        ? updateReqVO.getAddress() : employee.getAddress())
+                .setHighestEducation(editableFields.contains(
+                        HrmEmployeeArchiveFieldEnum.HIGHEST_EDUCATION.getName())
+                        ? updateReqVO.getHighestEducation() : employee.getHighestEducation());
+        normalizeEmployeePersonalInfo(updateObj);
+        // 2.2 更新员工档案。出生日期和年龄随身份证信息联动更新
+        Set<String> updateFields = new HashSet<>(editableFields);
+        if (updateFields.contains(HrmEmployeeArchiveFieldEnum.ID_TYPE.getName())
+                || updateFields.contains(HrmEmployeeArchiveFieldEnum.ID_NUMBER.getName())) {
+            updateFields.add(HrmEmployeeArchiveFieldEnum.BIRTHDAY.getName());
+        }
+        if (updateFields.contains(HrmEmployeeArchiveFieldEnum.BIRTHDAY.getName())) {
+            updateFields.add(HrmEmployeeArchiveFieldEnum.AGE.getName());
+        }
+        employeeMapper.updateProfile(updateObj, updateFields);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(employee, HrmPortalEmployeeUpdateReqVO.class));
+    }
+
+    private HrmEmployeeDO validateEmployeeForCreateOrUpdate(Long id, HrmEmployeeSaveReqVO reqVO) {
+        // 1. 校验员工档案是否存在
+        HrmEmployeeDO employee = id != null ? validateEmployeeExists(id) : null;
+        // 2. 校验工号、后台用户和手机号的唯一性
+        validateEmployeeUnique(id, reqVO);
+        // 3. 校验关联的后台用户和部门
+        if (reqVO.getUserId() != null) {
+            adminUserApi.validateUser(reqVO.getUserId());
+        }
+        // 4. 校验部门和直属上级
+        validateDeptAndLeader(id, reqVO.getDeptId(), reqVO.getLeaderEmployeeId());
+        // 5. 校验招聘渠道和候选人
+        if (reqVO.getChannelId() != null) {
+            recruitChannelService.validateRecruitChannelExists(reqVO.getChannelId());
+        }
+        if (reqVO.getCandidateId() != null) {
+            recruitCandidateService.validateRecruitCandidateExists(reqVO.getCandidateId());
+        }
+        return employee;
+    }
+
+    private void validatePositionChange(HrmEmployeeDO employee, HrmEmployeeChangeTypeEnum changeType,
+                                        Long newDeptId, Long newLeaderEmployeeId) {
+        // 1. 校验员工处于在职状态
+        validateEmployeeInService(employee, changeType);
+        // 2. 校验新部门和新直属上级
+        validateDeptAndLeader(employee.getId(), newDeptId, newLeaderEmployeeId);
+    }
+
+    private void validateEmployeeInService(HrmEmployeeDO employee, HrmEmployeeChangeTypeEnum changeType) {
+        if (!HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(employee.getEntryStatus())) {
+            throw exception(EMPLOYEE_CHANGE_STATUS_INVALID, changeType.getName());
+        }
+    }
+
+    private void validateDeptAndLeader(Long employeeId, Long deptId, Long leaderEmployeeId) {
+        // 1. 校验部门是否存在
+        if (deptId != null) {
+            deptApi.validateDeptList(Collections.singleton(deptId));
+        }
+        // 2. 校验直属上级链路不存在自引用或环路
+        if (leaderEmployeeId == null) {
+            return;
+        }
+        Set<Long> visitedEmployeeIds = new HashSet<>();
+        Long currentLeaderEmployeeId = leaderEmployeeId;
+        while (currentLeaderEmployeeId != null) {
+            if (currentLeaderEmployeeId.equals(employeeId)
+                    || !visitedEmployeeIds.add(currentLeaderEmployeeId)) {
+                throw exception(EMPLOYEE_LEADER_INVALID);
+            }
+            currentLeaderEmployeeId = validateEmployeeExists(currentLeaderEmployeeId).getLeaderEmployeeId();
+        }
+    }
+
+    private void validateEmployeeUnique(Long id, HrmEmployeeSaveReqVO reqVO) {
+        // 1. 校验工号唯一
+        validateJobNumberUnique(id, reqVO.getJobNumber());
+        // 2. 校验后台用户唯一
+        validateUserUnique(id, reqVO.getUserId());
+        // 3. 校验手机号唯一
+        validateMobileUnique(id, reqVO.getMobile());
+    }
+
+    private void validateJobNumberUnique(Long id, String jobNumber) {
+        if (StrUtil.isBlank(jobNumber)) {
+            return;
+        }
+        HrmEmployeeDO employee = employeeMapper.selectByJobNumber(jobNumber);
+        if (employee == null) {
+            return;
+        }
+        if (id == null || ObjUtil.notEqual(id, employee.getId())) {
+            throw exception(EMPLOYEE_JOB_NUMBER_DUPLICATE);
+        }
+    }
+
+    private void validateUserUnique(Long id, Long userId) {
+        if (userId == null) {
+            return;
+        }
+        HrmEmployeeDO employee = employeeMapper.selectByUserId(userId);
+        if (employee == null) {
+            return;
+        }
+        if (id == null || ObjUtil.notEqual(id, employee.getId())) {
+            throw exception(EMPLOYEE_USER_DUPLICATE);
+        }
+    }
+
+    private void validateMobileUnique(Long id, String mobile) {
+        if (StrUtil.isBlank(mobile)) {
+            return;
+        }
+        HrmEmployeeDO employee = employeeMapper.selectByMobile(mobile);
+        if (employee == null) {
+            return;
+        }
+        if (id == null || ObjUtil.notEqual(id, employee.getId())) {
+            throw exception(EMPLOYEE_MOBILE_DUPLICATE);
+        }
+    }
+
+    /**
+     * 构建员工档案，并补充由业务规则计算的状态、日期和司龄
+     *
+     * @param reqVO 员工档案保存请求对象
+     * @return 构建后的员工档案对象
+     */
+    private HrmEmployeeDO buildEmployee(HrmEmployeeSaveReqVO reqVO) {
+        HrmEmployeeDO employee = BeanUtils.toBean(reqVO, HrmEmployeeDO.class);
+        normalizeEmployeePersonalInfo(employee);
+        LocalDate today = LocalDate.now();
+        // 正式员工根据入职日期和试用期计算员工状态、转正日期
+        if (HrmEmployeeTypeEnum.FORMAL.getType().equals(employee.getType())) {
+            int probation = employee.getProbation() != null ? employee.getProbation() : 0;
+            LocalDateTime regularTime = employee.getEntryTime().plusMonths(probation);
+            employee.setProbation(probation).setRegularTime(regularTime)
+                    .setStatus(probation > 0 && regularTime.isAfter(LocalDateTime.now())
+                            ? HrmEmployeeStatusEnum.PROBATION.getStatus()
+                            : HrmEmployeeStatusEnum.REGULAR.getStatus());
+        } else {
+            employee.setProbation(0).setRegularTime(null);
+        }
+        // 根据司龄开始日期计算司龄
+        if (employee.getCompanyAgeStartTime() == null) {
+            employee.setCompanyAgeStartTime(employee.getEntryTime());
+        }
+        employee.setCompanyAge(getYearsBetween(employee.getCompanyAgeStartTime().toLocalDate(), today));
+        return employee;
+    }
+
+    /**
+     * 构建员工档案更新对象，并保留只能通过专用流程修改的生命周期字段
+     *
+     * @param reqVO 员工档案保存请求对象
+     * @param employee 原员工档案
+     * @return 构建后的员工档案更新对象
+     */
+    private HrmEmployeeDO buildEmployeeForUpdate(HrmEmployeeSaveReqVO reqVO, HrmEmployeeDO employee) {
+        HrmEmployeeSaveReqVO normalizedReqVO = BeanUtils.toBean(reqVO, HrmEmployeeSaveReqVO.class)
+                .setEntryStatus(employee.getEntryStatus()).setType(employee.getType())
+                .setStatus(employee.getStatus()).setProbation(employee.getProbation());
+        return buildEmployee(normalizedReqVO).setId(employee.getId())
+                .setEntryStatus(employee.getEntryStatus()).setType(employee.getType())
+                .setStatus(employee.getStatus()).setProbation(employee.getProbation())
+                .setRegularTime(employee.getRegularTime()).setLeaveTime(employee.getLeaveTime());
+    }
+
+    /**
+     * 构建导入员工档案。导入允许覆盖完整固定字段，正式员工填写转正时间时以导入值为准。
+     *
+     * @param reqVO 员工导入请求
+     * @return 员工档案
+     */
+    private HrmEmployeeDO buildImportedEmployee(HrmEmployeeSaveReqVO reqVO) {
+        HrmEmployeeDO employee = buildEmployee(reqVO);
+        if (HrmEmployeeTypeEnum.FORMAL.getType().equals(employee.getType()) && reqVO.getRegularTime() != null) {
+            employee.setRegularTime(reqVO.getRegularTime())
+                    .setStatus(employee.getProbation() > 0 && reqVO.getRegularTime().isAfter(LocalDateTime.now())
+                            ? HrmEmployeeStatusEnum.PROBATION.getStatus()
+                            : HrmEmployeeStatusEnum.REGULAR.getStatus());
+        }
+        return employee;
+    }
+
+    /**
+     * 校验导入的工资卡和社保字段组
+     *
+     * @param importEmployee 导入员工
+     * @param schemeId 社保方案编号
+     */
+    private void validateImportedEmployeeResources(HrmEmployeeImportExcelVO importEmployee, Long schemeId) {
+        HrmEmployeeSalaryCardSaveReqVO salaryCard = buildImportedSalaryCard(0L, importEmployee);
+        if (salaryCard != null) {
+            ValidationUtils.validate(salaryCard);
+        }
+        HrmInsuranceEmployeeInfoSaveReqVO insuranceEmployeeInfo =
+                buildImportedInsuranceEmployeeInfo(0L, importEmployee, schemeId);
+        if (insuranceEmployeeInfo != null) {
+            ValidationUtils.validate(insuranceEmployeeInfo);
+        }
+    }
+
+    /**
+     * 保存导入员工的工资卡和社保字段组
+     *
+     * @param employeeId 员工编号
+     * @param importEmployee 导入员工
+     * @param schemeId 社保方案编号
+     */
+    private void saveImportedEmployeeResources(
+            Long employeeId, HrmEmployeeImportExcelVO importEmployee, Long schemeId) {
+        HrmEmployeeSalaryCardSaveReqVO salaryCard = buildImportedSalaryCard(employeeId, importEmployee);
+        if (salaryCard != null) {
+            employeeSalaryCardService.saveSalaryCard(salaryCard);
+        }
+        HrmInsuranceEmployeeInfoSaveReqVO insuranceEmployeeInfo =
+                buildImportedInsuranceEmployeeInfo(employeeId, importEmployee, schemeId);
+        if (insuranceEmployeeInfo != null) {
+            insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(insuranceEmployeeInfo);
+        }
+    }
+
+    /**
+     * 在员工档案事务提交后发送员工端开通通知，避免回滚的数据产生误通知
+     *
+     * @param employees 已创建员工列表
+     */
+    private void sendEmployeeOpenedMessage(List<HrmEmployeeDO> employees) {
+        executeAfterCommit(() -> employees.forEach(employee -> {
+            if (employee.getUserId() != null) {
+                sendEmployeeMessage(employee, MessageTemplateConstants.EMPLOYEE_OPENED);
+            }
+        }));
+    }
+
+    /**
+     * 在批量建档事务提交后，按员工档案分别记录操作日志
+     *
+     * @param employees 已创建员工列表
+     */
+    private void recordEmployeeCreatedLogs(List<HrmEmployeeDO> employees) {
+        executeAfterCommit(() -> employees.forEach(employee -> logRecordService.record(
+                com.mzt.logapi.beans.LogRecord.builder()
+                        .type(HRM_EMPLOYEE_TYPE).subType(HRM_EMPLOYEE_CREATE_FROM_USER_LIST_SUB_TYPE)
+                        .bizNo(String.valueOf(employee.getId()))
+                        .action("从后台用户创建了员工档案【" + employee.getName() + "】")
+                        .build())));
+    }
+
+    /**
+     * 按员工档案分别记录发送填写档案通知的操作日志
+     *
+     * @param employees 通知发送成功的员工列表
+     */
+    private void recordEmployeeProfileFillMessageLogs(List<HrmEmployeeDO> employees) {
+        employees.forEach(employee -> logRecordService.record(
+                com.mzt.logapi.beans.LogRecord.builder()
+                        .type(HRM_EMPLOYEE_TYPE).subType(HRM_EMPLOYEE_ARCHIVE_FILL_MESSAGE_SUB_TYPE)
+                        .bizNo(String.valueOf(employee.getId()))
+                        .action("向员工【" + employee.getName() + "】发送了填写档案通知")
+                        .build()));
+    }
+
+    /**
+     * 在当前事务提交后执行任务；无事务时立即执行
+     *
+     * @param task 待执行任务
+     */
+    private void executeAfterCommit(Runnable task) {
+        if (!TransactionSynchronizationManager.isSynchronizationActive()) {
+            task.run();
+            return;
+        }
+        TransactionSynchronizationManager.registerSynchronization(new TransactionSynchronization() {
+
+            @Override
+            public void afterCommit() {
+                task.run();
+            }
+
+        });
+    }
+
+    /**
+     * 向员工绑定的后台账号发送站内信。消息失败不回滚员工业务。
+     *
+     * @param employee 员工
+     * @param templateCode 消息模板编码
+     * @return 是否发送成功
+     */
+    private boolean sendEmployeeMessage(HrmEmployeeDO employee, String templateCode) {
+        try {
+            notifyMessageSendApi.sendSingleMessageToAdmin(new NotifySendSingleToUserReqDTO()
+                    .setUserId(employee.getUserId()).setTemplateCode(templateCode)
+                    .setTemplateParams(Collections.singletonMap("employeeName", employee.getName())));
+            return true;
+        } catch (RuntimeException ex) {
+            log.warn("[sendEmployeeMessage][employeeId({}) userId({}) templateCode({}) 发送失败]",
+                    employee.getId(), employee.getUserId(), templateCode, ex);
+            return false;
+        }
+    }
+
+    private HrmEmployeeSalaryCardSaveReqVO buildImportedSalaryCard(
+            Long employeeId, HrmEmployeeImportExcelVO importEmployee) {
+        if (StrUtil.isAllBlank(importEmployee.getBankCardNumber(), importEmployee.getBankName(),
+                importEmployee.getBankBranchName()) && importEmployee.getBankAreaId() == null) {
+            return null;
+        }
+        return new HrmEmployeeSalaryCardSaveReqVO().setEmployeeId(employeeId)
+                .setBankCardNumber(importEmployee.getBankCardNumber()).setBankAreaId(importEmployee.getBankAreaId())
+                .setBankName(importEmployee.getBankName()).setBankBranchName(importEmployee.getBankBranchName());
+    }
+
+    private HrmInsuranceEmployeeInfoSaveReqVO buildImportedInsuranceEmployeeInfo(
+            Long employeeId, HrmEmployeeImportExcelVO importEmployee, Long schemeId) {
+        if (importEmployee.getFirstSocialSecurity() == null && importEmployee.getFirstAccumulationFund() == null
+                && StrUtil.isAllBlank(importEmployee.getSocialSecurityNumber(),
+                importEmployee.getAccumulationFundNumber())
+                && importEmployee.getSocialSecurityStartMonth() == null && schemeId == null) {
+            return null;
+        }
+        return new HrmInsuranceEmployeeInfoSaveReqVO().setEmployeeId(employeeId)
+                .setFirstSocialSecurity(importEmployee.getFirstSocialSecurity())
+                .setFirstAccumulationFund(importEmployee.getFirstAccumulationFund())
+                .setSocialSecurityNumber(importEmployee.getSocialSecurityNumber())
+                .setAccumulationFundNumber(importEmployee.getAccumulationFundNumber())
+                .setSocialSecurityStartMonth(importEmployee.getSocialSecurityStartMonth())
+                .setSchemeId(schemeId);
+    }
+
+    /**
+     * 规范化员工个人信息，并根据身份证信息补充出生日期、计算年龄
+     */
+    private void normalizeEmployeePersonalInfo(HrmEmployeeDO employee) {
+        LocalDate today = LocalDate.now();
+        // 根据身份证补充出生日期
+        if (HrmEmployeeIdTypeEnum.ID_CARD.getType().equals(employee.getIdType())
+                && StrUtil.isNotBlank(employee.getIdNumber())) {
+            LocalDate birthdayDate = LocalDate.parse(IdcardUtil.getBirthByIdCard(employee.getIdNumber()),
+                    DateTimeFormatter.BASIC_ISO_DATE);
+            employee.setBirthday(birthdayDate.atStartOfDay());
+        }
+        // 根据出生日期计算年龄
+        if (employee.getBirthday() == null) {
+            employee.setAge(null);
+            return;
+        }
+        employee.setAge(getYearsBetween(employee.getBirthday().toLocalDate(), today));
+    }
+
+    /**
+     * 创建员工异动记录
+     *
+     * @param record 异动记录
+     * @param employee 员工
+     * @param type 异动类型
+     * @return 已保存的异动记录
+     */
+    private HrmEmployeeChangeRecordDO createEmployeeChangeRecord(
+            HrmEmployeeChangeRecordCreateReqVO record, HrmEmployeeDO employee, Integer type) {
+        record.setEmployeeId(employee.getId()).setType(type)
+                .setOldDeptId(employee.getDeptId()).setOldPostName(employee.getPostName())
+                .setOldPostLevel(employee.getPostLevel()).setOldWorkAddress(employee.getWorkAddress())
+                .setOldLeaderEmployeeId(employee.getLeaderEmployeeId());
+        return employeeChangeRecordService.createEmployeeChangeRecord(record);
+    }
+
+    /**
+     * 将未填写的任职字段补充为员工当前值，避免转正、转全职误清空主档。
+     *
+     * @param record 异动请求
+     * @param employee 员工
+     * @return 补充后的异动请求
+     */
+    private HrmEmployeeChangeRecordCreateReqVO fillUnchangedPositionFields(
+            HrmEmployeeChangeRecordCreateReqVO record, HrmEmployeeDO employee) {
+        record.setNewDeptId(defaultIfNull(record.getNewDeptId(), employee.getDeptId()))
+                .setNewPostName(StrUtil.blankToDefault(record.getNewPostName(), employee.getPostName()))
+                .setNewPostLevel(StrUtil.blankToDefault(record.getNewPostLevel(), employee.getPostLevel()))
+                .setNewWorkAddress(StrUtil.blankToDefault(record.getNewWorkAddress(), employee.getWorkAddress()))
+                .setNewLeaderEmployeeId(defaultIfNull(
+                        record.getNewLeaderEmployeeId(), employee.getLeaderEmployeeId()));
+        return record;
+    }
+
+    /**
+     * 将历史异动记录中缺省的任职字段补充为员工当前值。
+     *
+     * @param record 异动记录
+     * @param employee 员工
+     */
+    private void fillUnchangedPositionFields(HrmEmployeeChangeRecordDO record, HrmEmployeeDO employee) {
+        record.setNewDeptId(defaultIfNull(record.getNewDeptId(), employee.getDeptId()))
+                .setNewPostName(StrUtil.blankToDefault(record.getNewPostName(), employee.getPostName()))
+                .setNewPostLevel(StrUtil.blankToDefault(record.getNewPostLevel(), employee.getPostLevel()))
+                .setNewWorkAddress(StrUtil.blankToDefault(record.getNewWorkAddress(), employee.getWorkAddress()))
+                .setNewLeaderEmployeeId(defaultIfNull(
+                        record.getNewLeaderEmployeeId(), employee.getLeaderEmployeeId()));
+    }
+
+    private void addStatusCount(Map<Integer, Long> countMap, Integer status, Long count) {
+        countMap.put(status, countMap.getOrDefault(status, 0L) + count);
+    }
+
+    /**
+     * 将导入模板中的业务键解析为员工档案关联编号
+     *
+     * @param importEmployee 导入员工
+     * @param saveReqVO 员工保存参数
+     * @return 社保方案编号
+     */
+    private Long resolveImportedEmployeeRelations(HrmEmployeeImportExcelVO importEmployee,
+                                                  HrmEmployeeSaveReqVO saveReqVO) {
+        // 1. 根据直属上级工号解析员工编号
+        if (StrUtil.isNotBlank(importEmployee.getLeaderJobNumber())) {
+            String leaderJobNumber = StrUtil.trim(importEmployee.getLeaderJobNumber());
+            HrmEmployeeDO leaderEmployee = employeeMapper.selectByJobNumber(leaderJobNumber);
+            if (leaderEmployee == null) {
+                throw exception(EMPLOYEE_IMPORT_REFERENCE_NOT_EXISTS, "直属上级工号", leaderJobNumber);
+            }
+            saveReqVO.setLeaderEmployeeId(leaderEmployee.getId());
+        }
+
+        // 2. 根据后台用户手机号解析绑定用户编号
+        if (StrUtil.isNotBlank(importEmployee.getUserMobile())) {
+            String userMobile = StrUtil.trim(importEmployee.getUserMobile());
+            AdminUserRespDTO user = adminUserApi.getUserByMobile(userMobile);
+            if (user == null) {
+                throw exception(EMPLOYEE_IMPORT_REFERENCE_NOT_EXISTS, "绑定用户手机号", userMobile);
+            }
+            saveReqVO.setUserId(user.getId());
+        }
+
+        // 3. 根据社保方案名称解析方案编号
+        if (StrUtil.isBlank(importEmployee.getSchemeName())) {
+            return null;
+        }
+        String schemeName = StrUtil.trim(importEmployee.getSchemeName());
+        HrmInsuranceSchemeDO scheme = insuranceSchemeService.getSchemeByName(schemeName);
+        if (scheme == null) {
+            throw exception(EMPLOYEE_IMPORT_REFERENCE_NOT_EXISTS, "参保方案名称", schemeName);
+        }
+        return scheme.getId();
+    }
+
+    private String getImportEmployeeLabel(HrmEmployeeImportExcelVO importEmployee, int index) {
+        if (StrUtil.isNotBlank(importEmployee.getJobNumber())) {
+            return importEmployee.getJobNumber();
+        }
+        if (StrUtil.isNotBlank(importEmployee.getUserMobile())) {
+            return "用户 " + importEmployee.getUserMobile();
+        }
+        return "第 " + (index + 1) + " 行";
+    }
+
+    private String getImportFailureKey(String employeeLabel, int index) {
+        String rowLabel = "第 " + (index + 1) + " 行";
+        return rowLabel.equals(employeeLabel) ? rowLabel : rowLabel + "（" + employeeLabel + "）";
+    }
+
+    private HrmEmployeeDO getImportExistEmployee(HrmEmployeeSaveReqVO saveReqVO) {
+        if (StrUtil.isNotBlank(saveReqVO.getJobNumber())) {
+            return employeeMapper.selectByJobNumber(saveReqVO.getJobNumber());
+        }
+        if (saveReqVO.getUserId() != null) {
+            return employeeMapper.selectByUserId(saveReqVO.getUserId());
+        }
+        return null;
+    }
+
+    /**
+     * 获得自身的代理对象，解决 AOP 生效问题
+     *
+     * @return 自己
+     */
+    private HrmEmployeeServiceImpl getSelf() {
+        return SpringUtil.getBean(getClass());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeService.java
new file mode 100644
index 0000000..2518e41
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeService.java
@@ -0,0 +1,65 @@
+package cn.iocoder.yudao.module.hrm.service.home;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHomeCalendarItemRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmTeamHomeStatisticsRespVO;
+
+import java.time.LocalDate;
+import java.util.List;
+
+/**
+ * HRM 首页 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmHomeService {
+
+    /**
+     * 获得 HR 工作台统计
+     *
+     * @return HR 工作台统计
+     */
+    HrmHrHomeStatisticsRespVO getHrHomeStatisticsSummary();
+
+    /**
+     * 获得当前登录员工的团队工作台统计
+     *
+     * @param loginUserId 登录用户编号
+     * @return 团队工作台统计
+     */
+    HrmTeamHomeStatisticsRespVO getTeamHomeStatisticsSummary(Long loginUserId);
+
+    /**
+     * 获得 HR 工作台日期范围内的日历
+     *
+     * @param loginUserId 登录用户编号
+     * @param startDate 开始日期
+     * @param endDate 结束日期
+     * @return 日历事项列表
+     */
+    List<HrmHomeCalendarItemRespVO> getHrHomeCalendar(
+            Long loginUserId, LocalDate startDate, LocalDate endDate);
+
+    /**
+     * 获得当前登录员工的团队日历
+     *
+     * @param loginUserId 登录用户编号
+     * @param startDate 开始日期
+     * @param endDate 结束日期
+     * @return 团队日历事项列表
+     */
+    List<HrmHomeCalendarItemRespVO> getTeamHomeCalendar(
+            Long loginUserId, LocalDate startDate, LocalDate endDate);
+
+    /**
+     * 获得员工端首页日期范围内的日历
+     *
+     * @param loginUserId 登录用户编号
+     * @param startDate 开始日期
+     * @param endDate 结束日期
+     * @return 日历事项列表
+     */
+    List<HrmHomeCalendarItemRespVO> getEmployeeCalendar(
+            Long loginUserId, LocalDate startDate, LocalDate endDate);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeServiceImpl.java
new file mode 100644
index 0000000..d316bb1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeServiceImpl.java
@@ -0,0 +1,623 @@
+package cn.iocoder.yudao.module.hrm.service.home;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.date.DatePattern;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHomeCalendarItemRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmTeamHomeStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmTeamHomeStatisticsRespVO.AnalysisItem;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmTeamHomeStatisticsRespVO.TeamOverview;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmTeamHomeStatisticsRespVO.TeamSurvey;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO.EmployeeSurvey;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO.RecruitSurvey;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO.SalaryDept;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO.SalarySurvey;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO.TodoSurvey;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeePersonalNoteDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeSurveyTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTodoTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.home.HrmHomeAgeRangeEnum;
+import cn.iocoder.yudao.module.hrm.enums.home.HrmHomeCalendarItemTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.home.HrmHomeCompanyAgeRangeEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceClockService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeContractService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeQuitInfoService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeePersonalNoteService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitInterviewService;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.enums.common.SexEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.MonthDay;
+import java.time.format.DateTimeFormatter;
+import java.time.temporal.ChronoUnit;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.TreeSet;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetBySupplier;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.count;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.distinctCount;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.sum;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.HOME_CALENDAR_DATE_RANGE_ILLEGAL;
+
+/**
+ * HRM 首页 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmHomeServiceImpl implements HrmHomeService {
+
+    /**
+     * 首页日历面试时间格式
+     */
+    private static final DateTimeFormatter INTERVIEW_TIME_FORMATTER = DatePattern.createFormatter("HH:mm");
+
+    @Resource
+    private HrmEmployeeContractService employeeContractService;
+    @Resource
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @Resource
+    private HrmEmployeeQuitInfoService employeeQuitInfoService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmEmployeePersonalNoteService personalNoteService;
+    @Resource
+    private HrmRecruitPostService recruitPostService;
+    @Resource
+    private HrmRecruitCandidateService recruitCandidateService;
+    @Resource
+    private HrmRecruitInterviewService recruitInterviewService;
+    @Resource
+    private HrmAttendanceClockService attendanceClockService;
+    @Resource
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+    @Resource
+    private HrmSalaryMonthEmployeeRecordService salaryMonthEmployeeRecordService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    public HrmHrHomeStatisticsRespVO getHrHomeStatisticsSummary() {
+        // 1. 统计人事、招聘和薪资概况
+        HrmHrHomeStatisticsRespVO summary = new HrmHrHomeStatisticsRespVO();
+        EmployeeSurvey employeeSurvey = buildEmployeeSurvey();
+        summary.setEmployeeSurvey(employeeSurvey);
+        summary.setRecruitSurvey(buildRecruitSurvey());
+        summary.setSalarySurvey(buildSalarySurvey());
+
+        // 2. 基于人事概况统计待办提醒
+        summary.setTodoSurvey(buildTodoSurvey(employeeSurvey));
+        return summary;
+    }
+
+    @Override
+    public HrmTeamHomeStatisticsRespVO getTeamHomeStatisticsSummary(Long loginUserId) {
+        // 1. 查询当前登录员工及其直属下属
+        HrmEmployeeDO loginEmployee = employeeService.getEmployeeByUserId(loginUserId);
+        List<HrmEmployeeDO> teamEmployees = loginEmployee == null ? Collections.emptyList()
+                : employeeService.getEmployeeListByLeaderEmployeeId(loginEmployee.getId());
+        List<HrmEmployeeDO> activeTeamEmployees = filterList(teamEmployees,
+                employee -> HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(employee.getEntryStatus()));
+
+        // 2. 统计本月团队人数变动
+        HrmTeamHomeStatisticsRespVO summary = new HrmTeamHomeStatisticsRespVO();
+        summary.setLeaderEmployeeId(loginEmployee == null ? null : loginEmployee.getId());
+        summary.setTeamOverview(buildTeamOverview(teamEmployees, activeTeamEmployees));
+
+        // 3. 统计当前在职团队的人员结构
+        summary.setTeamSurvey(buildTeamSurvey(activeTeamEmployees));
+        return summary;
+    }
+
+    @Override
+    public List<HrmHomeCalendarItemRespVO> getHrHomeCalendar(
+            Long loginUserId, LocalDate startDate, LocalDate endDate) {
+        validateDateRange(startDate, endDate);
+        return getCalendarItemList(loginUserId, startDate, endDate);
+    }
+
+    @Override
+    public List<HrmHomeCalendarItemRespVO> getTeamHomeCalendar(
+            Long loginUserId, LocalDate startDate, LocalDate endDate) {
+        // 1. 校验日期范围并查询当前登录员工
+        validateDateRange(startDate, endDate);
+        HrmEmployeeDO loginEmployee = employeeService.getEmployeeByUserId(loginUserId);
+        if (loginEmployee == null) {
+            return Collections.emptyList();
+        }
+
+        // 2. 收集本人备忘及直属下属的人事日历事项
+        List<HrmHomeCalendarItemRespVO> items = new ArrayList<>();
+        addPersonalNoteItems(items, loginEmployee, startDate, endDate);
+        addEmployeeItems(items, employeeService.getEmployeeListByLeaderEmployeeId(
+                loginEmployee.getId()), startDate, endDate);
+
+        // 3. 对日历事项稳定排序
+        sortCalendarItems(items);
+        return items;
+    }
+
+    @Override
+    public List<HrmHomeCalendarItemRespVO> getEmployeeCalendar(
+            Long loginUserId, LocalDate startDate, LocalDate endDate) {
+        validateDateRange(startDate, endDate);
+        HrmEmployeeDO loginEmployee = employeeService.getEmployeeByUserId(loginUserId);
+        List<HrmHomeCalendarItemRespVO> items = new ArrayList<>();
+        addPersonalNoteItems(items, loginEmployee, startDate, endDate);
+        addAttendanceItems(items, loginEmployee, startDate, endDate);
+        sortCalendarItems(items);
+        return items;
+    }
+
+    // ==================== HR 工作台统计 ====================
+
+    /**
+     * 构建直属团队的人员变动概况
+     *
+     * @param teamEmployees 直属团队员工列表
+     * @param activeTeamEmployees 当前在职的直属团队员工列表
+     * @return 团队人员变动概况
+     */
+    private TeamOverview buildTeamOverview(List<HrmEmployeeDO> teamEmployees,
+                                           List<HrmEmployeeDO> activeTeamEmployees) {
+        // 1. 统计团队人数和本月入离职人数
+        LocalDate now = LocalDate.now();
+        LocalDateTime[] monthTimes = LocalDateTimeUtils.getMonthDateTimeRange(
+                now.getYear(), now.getMonthValue());
+        TeamOverview overview = new TeamOverview();
+        overview.setEmployeeCount((long) activeTeamEmployees.size());
+        overview.setEntryThisMonthCount(count(teamEmployees,
+                employee -> !HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus()
+                        .equals(employee.getEntryStatus())
+                        && LocalDateTimeUtils.isBetween(monthTimes[0], monthTimes[1], employee.getEntryTime())));
+        overview.setLeaveThisMonthCount(count(teamEmployees,
+                employee -> HrmEmployeeEntryStatusEnum.LEFT.getStatus().equals(employee.getEntryStatus())
+                        && LocalDateTimeUtils.isBetween(monthTimes[0], monthTimes[1], employee.getLeaveTime())));
+
+        // 2. 按异动记录去重统计本月转正人数
+        if (CollUtil.isEmpty(teamEmployees)) {
+            overview.setRegularThisMonthCount(0L);
+            return overview;
+        }
+        List<HrmEmployeeChangeRecordDO> changeRecords = employeeChangeRecordService
+                .getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                        convertSet(teamEmployees, HrmEmployeeDO::getId), monthTimes);
+        overview.setRegularThisMonthCount(distinctCount(filterList(changeRecords,
+                        record -> HrmEmployeeChangeTypeEnum.REGULAR.getType().equals(record.getType())),
+                HrmEmployeeChangeRecordDO::getEmployeeId));
+        return overview;
+    }
+
+    private TeamSurvey buildTeamSurvey(List<HrmEmployeeDO> teamEmployees) {
+        return new TeamSurvey()
+                .setStatusAnalysis(buildAnalysis(buildStatusCountMap(teamEmployees)))
+                .setSexAnalysis(buildAnalysis(buildSexCountMap(teamEmployees)))
+                .setAgeAnalysis(buildAnalysis(buildAgeCountMap(teamEmployees)))
+                .setCompanyAgeAnalysis(buildAnalysis(buildCompanyAgeCountMap(teamEmployees)));
+    }
+
+    private Map<Integer, Long> buildStatusCountMap(List<HrmEmployeeDO> teamEmployees) {
+        Map<Integer, Long> countMap = new LinkedHashMap<>();
+        for (HrmEmployeeStatusEnum status : HrmEmployeeStatusEnum.values()) {
+            countMap.put(status.getStatus(), 0L);
+        }
+        countMap.put(null, 0L);
+        for (HrmEmployeeDO employee : teamEmployees) {
+            countMap.merge(employee.getStatus(), 1L, Long::sum);
+        }
+        return countMap;
+    }
+
+    private Map<Integer, Long> buildSexCountMap(List<HrmEmployeeDO> teamEmployees) {
+        Map<Integer, Long> countMap = new LinkedHashMap<>();
+        countMap.put(SexEnum.MALE.getSex(), 0L);
+        countMap.put(SexEnum.FEMALE.getSex(), 0L);
+        countMap.put(SexEnum.UNKNOWN.getSex(), 0L);
+        countMap.put(null, 0L);
+        for (HrmEmployeeDO employee : teamEmployees) {
+            countMap.merge(employee.getSex(), 1L, Long::sum);
+        }
+        return countMap;
+    }
+
+    private Map<Integer, Long> buildAgeCountMap(List<HrmEmployeeDO> teamEmployees) {
+        Map<Integer, Long> countMap = new LinkedHashMap<>();
+        countMap.put(null, 0L);
+        for (HrmHomeAgeRangeEnum range : HrmHomeAgeRangeEnum.values()) {
+            countMap.put(range.getType(), 0L);
+        }
+        for (HrmEmployeeDO employee : teamEmployees) {
+            Integer age = employee.getAge();
+            if (employee.getBirthday() != null) {
+                age = LocalDateTimeUtils.getYearsBetween(employee.getBirthday().toLocalDate(), LocalDate.now());
+            }
+            countMap.merge(HrmHomeAgeRangeEnum.getType(age), 1L, Long::sum);
+        }
+        return countMap;
+    }
+
+    private Map<Integer, Long> buildCompanyAgeCountMap(List<HrmEmployeeDO> teamEmployees) {
+        Map<Integer, Long> countMap = new LinkedHashMap<>();
+        countMap.put(null, 0L);
+        for (HrmHomeCompanyAgeRangeEnum range : HrmHomeCompanyAgeRangeEnum.values()) {
+            countMap.put(range.getType(), 0L);
+        }
+        for (HrmEmployeeDO employee : teamEmployees) {
+            long companyAgeDays = employee.getCompanyAgeStartTime() != null
+                    ? ChronoUnit.DAYS.between(employee.getCompanyAgeStartTime().toLocalDate(), LocalDate.now())
+                    : employee.getCompanyAge() == null ? -1L : employee.getCompanyAge() * 365L;
+            countMap.merge(HrmHomeCompanyAgeRangeEnum.getType(companyAgeDays), 1L, Long::sum);
+        }
+        return countMap;
+    }
+
+    private List<AnalysisItem> buildAnalysis(Map<Integer, Long> countMap) {
+        return convertList(countMap.entrySet(), entry -> new AnalysisItem()
+                .setType(entry.getKey()).setCount(entry.getValue()));
+    }
+
+    private EmployeeSurvey buildEmployeeSurvey() {
+        EmployeeSurvey survey = new EmployeeSurvey();
+        // 1. 统计当前在职员工总数
+        survey.setActiveCount(employeeService.getEmployeeStatusCount(new HrmEmployeePageReqVO())
+                .getOrDefault(HrmEmployeeStatusTabEnum.ACTIVE.getStatus(), 0L));
+        // 2. 按员工主档、离职状态和异动记录聚合统计本月六类人员变动
+        Map<Integer, Long> surveyCountMap = employeeService.getEmployeeSurveyCountMap();
+        survey.setEntryThisMonthCount(surveyCountMap.getOrDefault(
+                HrmEmployeeSurveyTypeEnum.ENTRY.getType(), 0L));
+        survey.setPendingEntryThisMonthCount(surveyCountMap.getOrDefault(
+                HrmEmployeeSurveyTypeEnum.PENDING_ENTRY.getType(), 0L));
+        survey.setLeaveThisMonthCount(surveyCountMap.getOrDefault(
+                HrmEmployeeSurveyTypeEnum.LEAVE.getType(), 0L));
+        survey.setPendingLeaveThisMonthCount(surveyCountMap.getOrDefault(
+                HrmEmployeeSurveyTypeEnum.PENDING_LEAVE.getType(), 0L));
+        survey.setRegularThisMonthCount(surveyCountMap.getOrDefault(
+                HrmEmployeeSurveyTypeEnum.REGULAR.getType(), 0L));
+        survey.setTransferThisMonthCount(surveyCountMap.getOrDefault(
+                HrmEmployeeSurveyTypeEnum.TRANSFER.getType(), 0L));
+        return survey;
+    }
+
+    private RecruitSurvey buildRecruitSurvey() {
+        // 1. 统计招聘中的职位和流程中的候选人
+        LocalDateTime currentTime = LocalDateTime.now();
+        LocalDateTime[] recentSixMonthTimes = new LocalDateTime[]{currentTime.minusMonths(6), currentTime};
+        RecruitSurvey survey = new RecruitSurvey();
+        survey.setRecruitingPostCount(recruitPostService.getRecruitPostStatusCount(new HrmRecruitPostPageReqVO())
+                .getOrDefault(HrmRecruitPostStatusEnum.RECRUITING.getStatus(), 0L));
+        Map<Integer, Long> candidateStatusCount = recruitCandidateService.getRecruitCandidateStatusCount(new HrmRecruitCandidatePageReqVO());
+        survey.setCandidateInProcessCount(sum(candidateStatusCount.entrySet(), entry ->
+                HrmRecruitCandidateStatusEnum.PROCESSING_STATUSES.contains(entry.getKey()) ? entry.getValue() : 0L));
+
+        // 2. 统计近六个月待入职和已入职候选人
+        survey.setPendingEntryCount(recruitCandidateService.getRecruitCandidateCountByStatusAndStatusUpdateTimeBetween(
+                HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus(), recentSixMonthTimes));
+        survey.setJoinedCount(recruitCandidateService.getRecruitCandidateCountByStatusAndEntryTimeBetween(
+                HrmRecruitCandidateStatusEnum.JOINED.getStatus(), recentSixMonthTimes));
+        return survey;
+    }
+
+    private SalarySurvey buildSalarySurvey() {
+        SalarySurvey survey = new SalarySurvey();
+        LocalDate lastMonth = LocalDate.now().minusMonths(1);
+        HrmSalaryMonthRecordDO record = salaryMonthRecordService.getMonthRecordByYearMonth(
+                lastMonth.getYear(), lastMonth.getMonthValue());
+        if (record == null || ObjUtil.notEqual(HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus(),
+                record.getStatus())) {
+            fillSalaryDefaults(survey);
+            return survey;
+        }
+        survey.setMonthRecordId(record.getId());
+        fillSalaryDeptProportion(survey, record);
+        return survey;
+    }
+
+    /**
+     * 拼接上月工资表的计薪人数、实发工资和部门薪资占比
+     *
+     * @param survey 薪资概况
+     * @param record 月度工资表
+     */
+    private void fillSalaryDeptProportion(SalarySurvey survey,
+                                          HrmSalaryMonthRecordDO record) {
+        // 1. 查询员工工资明细和员工部门
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords = salaryMonthEmployeeRecordService
+                .getMonthEmployeeRecordListByMonthRecordId(record.getId());
+        if (CollUtil.isEmpty(employeeRecords)) {
+            fillSalaryDefaults(survey);
+            return;
+        }
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeRecords.stream()
+                .map(HrmSalaryMonthEmployeeRecordDO::getEmployeeId).collect(Collectors.toSet()));
+
+        // 2. 按员工当前部门汇总实发工资
+        Map<Long, BigDecimal> deptSalaryMap = new LinkedHashMap<>();
+        BigDecimal totalSalary = BigDecimal.ZERO;
+        for (HrmSalaryMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            BigDecimal realPaySalary = defaultAmount(employeeRecord.getRealPaySalary());
+            HrmEmployeeDO employee = employeeMap.get(employeeRecord.getEmployeeId());
+            Long deptId = employee == null || employee.getDeptId() == null ? 0L : employee.getDeptId();
+            deptSalaryMap.merge(deptId, realPaySalary, BigDecimal::add);
+            totalSalary = totalSalary.add(realPaySalary);
+        }
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(deptSalaryMap.keySet().stream()
+                .filter(deptId -> ObjUtil.notEqual(deptId, 0L)).collect(Collectors.toSet()));
+
+        // 3. 计算部门薪资占比
+        List<SalaryDept> deptProportions = new ArrayList<>();
+        for (Map.Entry<Long, BigDecimal> entry : deptSalaryMap.entrySet()) {
+            SalaryDept deptProportion = new SalaryDept();
+            deptProportion.setDeptId(entry.getKey());
+            DeptRespDTO dept = deptMap.get(entry.getKey());
+            deptProportion.setDeptName(Objects.equals(entry.getKey(), 0L)
+                    ? "无部门" : dept == null ? "部门已删除" : dept.getName());
+            deptProportion.setTotalSalary(entry.getValue());
+            deptProportion.setProportion(totalSalary.signum() == 0 ? BigDecimal.ZERO
+                    : entry.getValue().divide(totalSalary, 4, RoundingMode.UP));
+            deptProportions.add(deptProportion);
+        }
+        deptProportions.sort((first, second) ->
+                second.getTotalSalary().compareTo(first.getTotalSalary()));
+        survey.setEmployeeCount(employeeRecords.size());
+        survey.setRealPaySalary(totalSalary);
+        survey.setDeptProportions(deptProportions);
+    }
+
+    private TodoSurvey buildTodoSurvey(EmployeeSurvey employeeSurvey) {
+        LocalDate monthStartDate = LocalDate.now().withDayOfMonth(1);
+        TodoSurvey survey = new TodoSurvey();
+        survey.setToEntryCount(employeeSurvey.getPendingEntryThisMonthCount());
+        survey.setToLeaveCount(employeeSurvey.getPendingLeaveThisMonthCount());
+        survey.setToExpireContractCount(employeeContractService.getExpireEmployeeCountInMonth(
+                LocalDateTimeUtils.getMonthDateTimeRange(monthStartDate.getYear(), monthStartDate.getMonthValue())));
+        survey.setToRegularCount(getEmployeeTodoCount(
+                HrmEmployeeTodoTypeEnum.REGULAR));
+        survey.setToSalaryComputeCount((long) salaryMonthRecordService.getMonthRecordListByStatus(
+                HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus()).size());
+        survey.setToBirthdayCount(getEmployeeTodoCount(
+                HrmEmployeeTodoTypeEnum.BIRTHDAY));
+        return survey;
+    }
+
+    private Long getEmployeeTodoCount(HrmEmployeeTodoTypeEnum todoType) {
+        Map<Integer, Long> employeeStatusCountMap = employeeService.getEmployeeStatusCount(new HrmEmployeePageReqVO()
+                .setTodoType(todoType.getType()).setStatusCategory(HrmEmployeeStatusTabEnum.ACTIVE.getStatus()));
+        return employeeStatusCountMap.getOrDefault(HrmEmployeeStatusTabEnum.ACTIVE.getStatus(), 0L);
+    }
+
+    private BigDecimal defaultAmount(BigDecimal amount) {
+        return amount == null ? BigDecimal.ZERO : amount;
+    }
+
+    private void fillSalaryDefaults(SalarySurvey survey) {
+        survey.setEmployeeCount(0).setRealPaySalary(BigDecimal.ZERO).setDeptProportions(Collections.emptyList());
+    }
+
+    // ==================== 首页日历 ====================
+
+    private List<HrmHomeCalendarItemRespVO> getCalendarItemList(
+            Long loginUserId, LocalDate startDate, LocalDate endDate) {
+        // 1. 收集各业务域的日历事项
+        List<HrmHomeCalendarItemRespVO> items = new ArrayList<>();
+        addPersonalNoteItems(items, employeeService.getEmployeeByUserId(loginUserId), startDate, endDate);
+        addEmployeeItems(items, startDate, endDate);
+        addRecruitItems(items, startDate, endDate);
+
+        // 2. 对日历事项稳定排序
+        sortCalendarItems(items);
+        return items;
+    }
+
+    private void addPersonalNoteItems(
+            List<HrmHomeCalendarItemRespVO> items, HrmEmployeeDO loginEmployee,
+            LocalDate startDate, LocalDate endDate) {
+        if (loginEmployee == null) {
+            return;
+        }
+        List<HrmEmployeePersonalNoteDO> personalNotes = personalNoteService.getPersonalNoteList(
+                loginEmployee.getId(), LocalDateTimeUtils.getDateTimeRange(startDate, endDate));
+        for (HrmEmployeePersonalNoteDO personalNote : personalNotes) {
+            items.add(buildPersonalNoteItem(personalNote));
+        }
+    }
+
+    private void addEmployeeItems(List<HrmHomeCalendarItemRespVO> items, LocalDate startDate, LocalDate endDate) {
+        addEmployeeItems(items, employeeService.getEmployeeList(new HrmEmployeeListReqVO()),
+                startDate, endDate);
+    }
+
+    private void addEmployeeItems(List<HrmHomeCalendarItemRespVO> items,
+                                  List<HrmEmployeeDO> employees,
+                                  LocalDate startDate, LocalDate endDate) {
+        Set<Long> pendingLeaveEmployeeIds = convertSet(filterList(employees, employee ->
+                        HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus().equals(employee.getEntryStatus())),
+                HrmEmployeeDO::getId);
+        Map<Long, HrmEmployeeQuitInfoDO> quitInfoMap = CollUtil.isEmpty(pendingLeaveEmployeeIds)
+                ? Collections.emptyMap()
+                : convertMap(employeeQuitInfoService.getQuitInfoListByEmployeeIds(pendingLeaveEmployeeIds),
+                        HrmEmployeeQuitInfoDO::getEmployeeId);
+        for (HrmEmployeeDO employee : employees) {
+            Integer entryStatus = employee.getEntryStatus();
+            if (!HrmEmployeeEntryStatusEnum.LEFT.getStatus().equals(entryStatus)) {
+                addBirthdayItems(items, employee, startDate, endDate);
+            }
+            if (HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus().equals(entryStatus)) {
+                addEmployeeDateItem(items, HrmHomeCalendarItemTypeEnum.ENTRY,
+                        employee, employee.getEntryTime(), startDate, endDate);
+            }
+            if (HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(entryStatus)) {
+                addEmployeeDateItem(items, HrmHomeCalendarItemTypeEnum.REGULAR,
+                        employee, employee.getRegularTime(), startDate, endDate);
+            }
+            HrmEmployeeQuitInfoDO quitInfo = quitInfoMap.get(employee.getId());
+            if (quitInfo != null) {
+                addEmployeeDateItem(items, HrmHomeCalendarItemTypeEnum.LEAVE,
+                        employee, quitInfo.getPlanQuitTime(), startDate, endDate);
+            }
+        }
+    }
+
+    private void addBirthdayItems(
+            List<HrmHomeCalendarItemRespVO> items, HrmEmployeeDO employee,
+            LocalDate startDate, LocalDate endDate) {
+        if (employee.getBirthday() == null) {
+            return;
+        }
+        LocalDate birthDate = employee.getBirthday().toLocalDate();
+        MonthDay employeeBirthday = MonthDay.from(birthDate);
+        for (int year = startDate.getYear(); year <= endDate.getYear(); year++) {
+            if (!employeeBirthday.isValidYear(year)) {
+                continue;
+            }
+            LocalDate birthdayDate = employeeBirthday.atYear(year);
+            if (birthdayDate.isBefore(birthDate)
+                    || birthdayDate.isBefore(startDate) || birthdayDate.isAfter(endDate)) {
+                continue;
+            }
+            String content = employee.getName()
+                    + LocalDateTimeUtils.getYearsBetween(birthDate, birthdayDate) + "岁生日";
+            items.add(buildCalendarItem(HrmHomeCalendarItemTypeEnum.BIRTHDAY, content,
+                    employee.getId(), birthdayDate, birthdayDate.atStartOfDay()));
+        }
+    }
+
+    private void addEmployeeDateItem(
+            List<HrmHomeCalendarItemRespVO> items, HrmHomeCalendarItemTypeEnum type,
+            HrmEmployeeDO employee, LocalDateTime eventTime,
+            LocalDate startDate, LocalDate endDate) {
+        if (eventTime == null || eventTime.toLocalDate().isBefore(startDate)
+                || eventTime.toLocalDate().isAfter(endDate)) {
+            return;
+        }
+        items.add(buildCalendarItem(type, employee.getName() + type.getName() + "日",
+                employee.getId(), eventTime.toLocalDate(), eventTime));
+    }
+
+    private void addRecruitItems(
+            List<HrmHomeCalendarItemRespVO> items, LocalDate startDate, LocalDate endDate) {
+        List<HrmRecruitInterviewDO> interviews =
+                recruitInterviewService.getRecruitInterviewListByInterviewTimeBetween(
+                        LocalDateTimeUtils.getDateTimeRange(startDate, endDate));
+        Map<Long, HrmRecruitCandidateDO> candidateMap = recruitCandidateService.getRecruitCandidateMap(
+                convertSet(interviews, HrmRecruitInterviewDO::getCandidateId));
+
+        // 根据候选人当前状态过滤已结束或已取消展示的历史面试
+        for (HrmRecruitInterviewDO interview : interviews) {
+            HrmRecruitCandidateDO candidate = candidateMap.get(interview.getCandidateId());
+            if (candidate == null
+                    || !HrmRecruitCandidateStatusEnum.CALENDAR_STATUSES.contains(candidate.getStatus())
+                    || HrmRecruitInterviewResultEnum.CANCEL.getResult().equals(interview.getResult())
+                    || !Objects.equals(candidate.getStageNumber(), interview.getStageNumber())) {
+                continue;
+            }
+            LocalDateTime interviewTime = interview.getInterviewTime();
+            String period = interviewTime.getHour() < 12 ? "上午" : "下午";
+            String content = candidate.getName() + period + interviewTime.format(INTERVIEW_TIME_FORMATTER) + "面试";
+            items.add(buildCalendarItem(HrmHomeCalendarItemTypeEnum.RECRUIT, content, candidate.getId(), interviewTime.toLocalDate(), interviewTime));
+        }
+    }
+
+    private void addAttendanceItems(
+            List<HrmHomeCalendarItemRespVO> items, HrmEmployeeDO loginEmployee,
+            LocalDate startDate, LocalDate endDate) {
+        if (loginEmployee == null) {
+            return;
+        }
+        List<HrmAttendanceClockDO> attendanceClocks = attendanceClockService
+                .getAttendanceClockListByEmployeeIdAndClockTime(loginEmployee.getId(),
+                        LocalDateTimeUtils.getDateTimeRange(startDate, endDate));
+        Set<LocalDate> attendanceDates = convertSetBySupplier(attendanceClocks,
+                clock -> clock.getClockTime() == null ? null : clock.getClockTime().toLocalDate(), TreeSet::new);
+        // 按去重且有序的打卡日期生成考勤事项
+        attendanceDates.forEach(date -> items.add(buildCalendarItem(
+                HrmHomeCalendarItemTypeEnum.ATTENDANCE, "考勤打卡", loginEmployee.getId(), date, date.atStartOfDay())));
+    }
+
+    private HrmHomeCalendarItemRespVO buildPersonalNoteItem(
+            HrmEmployeePersonalNoteDO personalNote) {
+        return buildCalendarItem(
+                HrmHomeCalendarItemTypeEnum.NOTE, personalNote.getContent(), null,
+                personalNote.getReminderTime().toLocalDate(), personalNote.getReminderTime())
+                .setPersonalNoteId(personalNote.getId());
+    }
+
+    private HrmHomeCalendarItemRespVO buildCalendarItem(
+            HrmHomeCalendarItemTypeEnum type, String content, Long typeId,
+            LocalDate date, LocalDateTime eventTime) {
+        return new HrmHomeCalendarItemRespVO().setType(type.getType()).setTypeName(type.getName())
+                .setContent(content).setTypeId(typeId).setDate(date).setEventTime(eventTime);
+    }
+
+    /**
+     * 按事项时间、类型和内容稳定排序
+     *
+     * @param items 日历事项
+     */
+    private void sortCalendarItems(List<HrmHomeCalendarItemRespVO> items) {
+        items.sort(Comparator
+                .comparing(HrmHomeCalendarItemRespVO::getEventTime,
+                        Comparator.nullsLast(Comparator.naturalOrder()))
+                .thenComparing(HrmHomeCalendarItemRespVO::getType)
+                .thenComparing(HrmHomeCalendarItemRespVO::getContent));
+    }
+
+    private void validateDateRange(LocalDate startDate, LocalDate endDate) {
+        if (startDate == null || endDate == null || endDate.isBefore(startDate)
+                || ChronoUnit.DAYS.between(startDate, endDate) > 370) {
+            throw exception(HOME_CALENDAR_DATE_RANGE_ILLEGAL);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeService.java
new file mode 100644
index 0000000..59a4b72
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeService.java
@@ -0,0 +1,115 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 社保方案 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmInsuranceSchemeService {
+
+    /**
+     * 创建社保方案
+     *
+     * @param reqVO 社保方案信息
+     * @return 社保方案编号
+     */
+    Long createScheme(HrmInsuranceSchemeSaveReqVO reqVO);
+
+    /**
+     * 更新社保方案
+     *
+     * @param reqVO 社保方案信息
+     */
+    void updateScheme(HrmInsuranceSchemeSaveReqVO reqVO);
+
+    /**
+     * 删除社保方案
+     *
+     * @param id 社保方案编号
+     */
+    void deleteScheme(Long id);
+
+    /**
+     * 获得社保方案
+     *
+     * @param id 社保方案编号
+     * @return 社保方案
+     */
+    HrmInsuranceSchemeDO getScheme(Long id);
+
+    /**
+     * 根据名称获得社保方案
+     *
+     * @param name 方案名称
+     * @return 社保方案
+     */
+    HrmInsuranceSchemeDO getSchemeByName(String name);
+
+    /**
+     * 校验社保方案是否存在
+     *
+     * @param id 社保方案编号
+     * @return 社保方案
+     */
+    HrmInsuranceSchemeDO validateSchemeExists(Long id);
+
+    /**
+     * 获得社保方案列表
+     *
+     * @return 社保方案列表
+     */
+    List<HrmInsuranceSchemeDO> getSchemeList();
+
+    /**
+     * 获得指定编号的社保方案列表
+     *
+     * @param ids 社保方案编号集合
+     * @return 社保方案列表
+     */
+    List<HrmInsuranceSchemeDO> getSchemeListByIds(Collection<Long> ids);
+
+    /**
+     * 获得指定编号的社保方案 Map
+     *
+     * @param ids 社保方案编号集合
+     * @return 社保方案 Map
+     */
+    default Map<Long, HrmInsuranceSchemeDO> getSchemeMap(Collection<Long> ids) {
+        return convertMap(getSchemeListByIds(ids), HrmInsuranceSchemeDO::getId);
+    }
+
+    /**
+     * 获得指定地区的社保方案列表
+     *
+     * @param areaId 地区编号
+     * @return 社保方案列表
+     */
+    List<HrmInsuranceSchemeDO> getSchemeListByAreaId(Integer areaId);
+
+    /**
+     * 获得社保方案项目列表
+     *
+     * @param schemeId 社保方案编号
+     * @return 社保方案项目列表
+     */
+    List<HrmInsuranceSchemeProjectDO> getSchemeProjectList(Long schemeId);
+
+    /**
+     * 获得指定方案的项目 Map
+     *
+     * @param schemeIds 社保方案编号集合
+     * @return 社保方案编号与项目列表的映射
+     */
+    Map<Long, List<HrmInsuranceSchemeProjectDO>> getSchemeProjectListMap(Collection<Long> schemeIds);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeServiceImpl.java
new file mode 100644
index 0000000..21bad06
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeServiceImpl.java
@@ -0,0 +1,282 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.ip.core.enums.AreaTypeEnum;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeProjectSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.config.HrmInsuranceSchemeProjectMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.config.HrmInsuranceSchemeMapper;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceSchemeTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceMultiplyPercent;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceScale;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_AREA_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_PROJECT_EMPTY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_PROJECT_TYPE_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_USED;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_SCHEME_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_SCHEME_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_SCHEME_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_SCHEME_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_SCHEME_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_SCHEME_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_SCHEME_UPDATE_SUCCESS;
+
+/**
+ * HRM 社保方案 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmInsuranceSchemeServiceImpl implements HrmInsuranceSchemeService {
+
+    @Resource
+    private HrmInsuranceSchemeMapper insuranceSchemeMapper;
+    @Resource
+    private HrmInsuranceSchemeProjectMapper insuranceSchemeProjectMapper;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmInsuranceMonthEmployeeRecordService insuranceMonthEmployeeRecordService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_SCHEME_TYPE, subType = HRM_INSURANCE_SCHEME_CREATE_SUB_TYPE,
+            bizNo = "{{#insuranceScheme.id}}", success = HRM_INSURANCE_SCHEME_CREATE_SUCCESS)
+    public Long createScheme(HrmInsuranceSchemeSaveReqVO reqVO) {
+        // 1. 校验方案名称和项目
+        validateNameUnique(null, reqVO.getName());
+        validateSchemeProjects(reqVO.getProjectList());
+        Integer cityAreaId = validateAndGetCityAreaId(reqVO.getAreaId());
+
+        // 2.1 创建社保方案
+        HrmInsuranceSchemeDO scheme = BeanUtils.toBean(reqVO, HrmInsuranceSchemeDO.class)
+                .setAreaId(cityAreaId);
+        insuranceSchemeMapper.insert(scheme);
+        // 2.2 创建社保方案项目
+        insuranceSchemeProjectMapper.insertBatch(convertList(reqVO.getProjectList(),
+                project -> buildSchemeProjectDO(scheme.getId(), reqVO.getType(), project).setId(null)));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("insuranceScheme", scheme);
+        return scheme.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_SCHEME_TYPE, subType = HRM_INSURANCE_SCHEME_UPDATE_SUB_TYPE,
+            bizNo = "{{#insuranceScheme.id}}", success = HRM_INSURANCE_SCHEME_UPDATE_SUCCESS)
+    public void updateScheme(HrmInsuranceSchemeSaveReqVO reqVO) {
+        // 1. 校验社保方案
+        HrmInsuranceSchemeDO oldScheme = validateSchemeExistsForUpdate(reqVO.getId());
+        validateNameUnique(reqVO.getId(), reqVO.getName());
+        validateSchemeProjects(reqVO.getProjectList());
+        Integer cityAreaId = validateAndGetCityAreaId(reqVO.getAreaId());
+
+        // 2.1 删除旧方案及项目，避免修改员工和月度记录已经使用的方案版本
+        insuranceSchemeProjectMapper.deleteBySchemeId(oldScheme.getId());
+        insuranceSchemeMapper.deleteById(oldScheme.getId());
+        // 2.2 创建新方案及项目
+        HrmInsuranceSchemeDO scheme = BeanUtils.toBean(reqVO, HrmInsuranceSchemeDO.class)
+                .setId(null).setAreaId(cityAreaId);
+        insuranceSchemeMapper.insert(scheme);
+        insuranceSchemeProjectMapper.insertBatch(convertList(reqVO.getProjectList(),
+                project -> buildSchemeProjectDO(scheme.getId(), reqVO.getType(), project).setId(null)));
+
+        // 3. 将员工和月度记录迁移到新方案，历史月度金额及项目快照保持不变
+        insuranceEmployeeInfoService.updateInsuranceEmployeeInfoSchemeIdBySchemeId(
+                oldScheme.getId(), scheme.getId());
+        insuranceMonthEmployeeRecordService.updateInsuranceMonthEmployeeRecordSchemeIdBySchemeId(
+                oldScheme.getId(), scheme.getId());
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("insuranceScheme", scheme);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_SCHEME_TYPE, subType = HRM_INSURANCE_SCHEME_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = HRM_INSURANCE_SCHEME_DELETE_SUCCESS)
+    public void deleteScheme(Long id) {
+        // 1. 校验社保方案及使用情况
+        HrmInsuranceSchemeDO scheme = validateSchemeExists(id);
+        long usedByEmployee = insuranceEmployeeInfoService.getInsuranceEmployeeInfoCountBySchemeId(id);
+        long usedByMonth = insuranceMonthEmployeeRecordService.getMonthEmployeeRecordCountBySchemeId(id);
+        if (usedByEmployee > 0 || usedByMonth > 0) {
+            throw exception(INSURANCE_SCHEME_USED);
+        }
+
+        // 2. 删除社保方案及项目
+        insuranceSchemeProjectMapper.deleteBySchemeId(id);
+        insuranceSchemeMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("insuranceScheme", scheme);
+    }
+
+    @Override
+    public HrmInsuranceSchemeDO getScheme(Long id) {
+        return insuranceSchemeMapper.selectById(id);
+    }
+
+    @Override
+    public HrmInsuranceSchemeDO getSchemeByName(String name) {
+        return insuranceSchemeMapper.selectByName(name);
+    }
+
+    @Override
+    public HrmInsuranceSchemeDO validateSchemeExists(Long id) {
+        HrmInsuranceSchemeDO scheme = insuranceSchemeMapper.selectById(id);
+        if (scheme == null) {
+            throw exception(INSURANCE_SCHEME_NOT_EXISTS);
+        }
+        return scheme;
+    }
+
+    @Override
+    public List<HrmInsuranceSchemeDO> getSchemeList() {
+        return insuranceSchemeMapper.selectListByIdDesc();
+    }
+
+    @Override
+    public List<HrmInsuranceSchemeDO> getSchemeListByIds(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return insuranceSchemeMapper.selectByIds(ids);
+    }
+
+    @Override
+    public List<HrmInsuranceSchemeDO> getSchemeListByAreaId(Integer areaId) {
+        Integer cityAreaId = AreaUtils.getParentIdByType(areaId, AreaTypeEnum.CITY);
+        return cityAreaId == null ? Collections.emptyList()
+                : insuranceSchemeMapper.selectListByAreaId(cityAreaId);
+    }
+
+    @Override
+    public List<HrmInsuranceSchemeProjectDO> getSchemeProjectList(Long schemeId) {
+        return insuranceSchemeProjectMapper.selectListBySchemeId(schemeId);
+    }
+
+    @Override
+    public Map<Long, List<HrmInsuranceSchemeProjectDO>> getSchemeProjectListMap(Collection<Long> schemeIds) {
+        if (CollUtil.isEmpty(schemeIds)) {
+            return Collections.emptyMap();
+        }
+        return convertMultiMap(insuranceSchemeProjectMapper.selectListBySchemeIds(schemeIds),
+                HrmInsuranceSchemeProjectDO::getSchemeId);
+    }
+
+    /**
+     * 校验社保方案名称是否重复
+     *
+     * @param id   社保方案编号
+     * @param name 社保方案名称
+     */
+    private void validateNameUnique(Long id, String name) {
+        HrmInsuranceSchemeDO scheme = insuranceSchemeMapper.selectByName(name);
+        if (scheme != null && ObjectUtil.notEqual(scheme.getId(), id)) {
+            throw exception(INSURANCE_SCHEME_NAME_DUPLICATE);
+        }
+    }
+
+    /**
+     * 校验社保方案项目的业务规则
+     *
+     * @param projects 社保方案项目列表
+     */
+    private void validateSchemeProjects(List<HrmInsuranceSchemeProjectSaveReqVO> projects) {
+        // 1. 校验标准项目类型不可重复
+        boolean hasSocialSecurityProject = false;
+        Set<Integer> standardProjectTypes = new HashSet<>();
+        for (HrmInsuranceSchemeProjectSaveReqVO project : projects) {
+            HrmInsuranceProjectTypeEnum projectType = HrmInsuranceProjectTypeEnum.valueOf(project.getType());
+            if (projectType == null) {
+                throw exception(INSURANCE_DATA_ILLEGAL);
+            }
+            if (projectType.isSocialSecurity()) {
+                hasSocialSecurityProject = true;
+            }
+            if (!projectType.isCustom() && !standardProjectTypes.add(projectType.getType())) {
+                throw exception(INSURANCE_SCHEME_PROJECT_TYPE_DUPLICATE);
+            }
+        }
+        // 2. 校验至少配置一个社保项目
+        if (!hasSocialSecurityProject) {
+            throw exception(INSURANCE_SCHEME_PROJECT_EMPTY);
+        }
+    }
+
+    private HrmInsuranceSchemeDO validateSchemeExistsForUpdate(Long id) {
+        HrmInsuranceSchemeDO scheme = insuranceSchemeMapper.selectByIdForUpdate(id);
+        if (scheme == null) {
+            throw exception(INSURANCE_SCHEME_NOT_EXISTS);
+        }
+        return scheme;
+    }
+
+    private Integer validateAndGetCityAreaId(Integer areaId) {
+        Integer cityAreaId = AreaUtils.getParentIdByType(areaId, AreaTypeEnum.CITY);
+        if (cityAreaId == null) {
+            throw exception(INSURANCE_SCHEME_AREA_INVALID);
+        }
+        return cityAreaId;
+    }
+
+    /**
+     * 构建社保方案项目
+     *
+     * @param schemeId 社保方案编号
+     * @param type     社保方案类型
+     * @param reqVO    社保方案项目
+     * @return 社保方案项目
+     */
+    private HrmInsuranceSchemeProjectDO buildSchemeProjectDO(Long schemeId, Integer type,
+                                                              HrmInsuranceSchemeProjectSaveReqVO reqVO) {
+        // 1. 统一金额和比例精度
+        HrmInsuranceSchemeProjectDO project = BeanUtils.toBean(reqVO, HrmInsuranceSchemeProjectDO.class)
+                .setSchemeId(schemeId)
+                .setBaseAmount(priceScale(reqVO.getBaseAmount()))
+                .setCorporateRate(priceScale(reqVO.getCorporateRate()))
+                .setPersonalRate(priceScale(reqVO.getPersonalRate()));
+        // 2. 按比例方案自动计算金额，固定金额方案保留填写金额
+        if (ObjectUtil.equal(type, HrmInsuranceSchemeTypeEnum.PROPORTION.getType())) {
+            return project.setCorporateAmount(priceMultiplyPercent(project.getBaseAmount(), project.getCorporateRate()))
+                    .setPersonalAmount(priceMultiplyPercent(project.getBaseAmount(), project.getPersonalRate()));
+        }
+        return project.setCorporateAmount(priceScale(project.getCorporateAmount()))
+                .setPersonalAmount(priceScale(project.getPersonalAmount()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardService.java
new file mode 100644
index 0000000..31a0375
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardService.java
@@ -0,0 +1,32 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardProjectRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardTypeRespVO;
+
+import java.util.List;
+
+/**
+ * HRM 标准参保数据 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmInsuranceStandardService {
+
+    /**
+     * 获得指定地区的标准参保方案类型
+     *
+     * @param areaId 地区编号
+     * @return 标准参保方案类型列表
+     */
+    List<HrmInsuranceStandardTypeRespVO> getStandardTypeList(Integer areaId);
+
+    /**
+     * 获得指定地区和方案类型的标准参保项目
+     *
+     * @param areaId 地区编号
+     * @param typeCode 方案类型编码
+     * @return 标准参保项目列表
+     */
+    List<HrmInsuranceStandardProjectRespVO> getStandardProjectList(Integer areaId, String typeCode);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardServiceImpl.java
new file mode 100644
index 0000000..d94a05a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardServiceImpl.java
@@ -0,0 +1,216 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.config;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.hutool.http.HttpRequest;
+import cn.hutool.http.HttpResponse;
+import cn.hutool.json.JSONArray;
+import cn.hutool.json.JSONObject;
+import cn.hutool.json.JSONUtil;
+import cn.iocoder.yudao.framework.common.util.number.NumberUtils;
+import cn.iocoder.yudao.framework.ip.core.Area;
+import cn.iocoder.yudao.framework.ip.core.enums.AreaTypeEnum;
+import cn.iocoder.yudao.framework.ip.core.utils.AreaUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardProjectRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardTypeRespVO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import lombok.extern.slf4j.Slf4j;
+import org.jsoup.Jsoup;
+import org.jsoup.nodes.Element;
+import org.jsoup.select.Elements;
+import org.springframework.cache.annotation.Cacheable;
+import org.springframework.stereotype.Service;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.module.hrm.dal.redis.RedisKeyConstants.INSURANCE_STANDARD_PROJECT;
+import static cn.iocoder.yudao.module.hrm.dal.redis.RedisKeyConstants.INSURANCE_STANDARD_TYPE;
+
+/**
+ * HRM 标准参保数据 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Slf4j
+public class HrmInsuranceStandardServiceImpl implements HrmInsuranceStandardService {
+
+    private static final String INSURANCE_TYPE_URL =
+            "https://user.1renshi.com/Home/GetSocialTypeAndHouseRange";
+    private static final String INSURANCE_SCALE_URL =
+            "https://www.shebao100.cn/user/funbasequery";
+
+    private static final int HTTP_TIMEOUT_MILLIS = 5000;
+
+    /**
+     * 获得指定地区的标准参保类型
+     *
+     * @param areaId 地区编号
+     * @return 标准参保类型列表
+     */
+    @Override
+    @Cacheable(cacheNames = INSURANCE_STANDARD_TYPE + "#7d", key = "#areaId",
+            unless = "#result.isEmpty()")
+    public List<HrmInsuranceStandardTypeRespVO> getStandardTypeList(Integer areaId) {
+        String cityName = getCityName(areaId);
+        if (StrUtil.isBlank(cityName)) {
+            return Collections.emptyList();
+        }
+        try (HttpResponse response = HttpRequest.get(INSURANCE_TYPE_URL)
+                .form(Collections.singletonMap("cityName", cityName))
+                .timeout(HTTP_TIMEOUT_MILLIS)
+                .execute()) {
+            if (!response.isOk()) {
+                log.warn("[getStandardTypeList][areaId({}) cityName({}) 查询失败，响应状态码为 {}]",
+                        areaId, cityName, response.getStatus());
+                return Collections.emptyList();
+            }
+            return parseTypeList(response.body());
+        } catch (Exception ex) {
+            log.warn("[getStandardTypeList][areaId({}) cityName({}) 查询失败]", areaId, cityName, ex);
+            return Collections.emptyList();
+        }
+    }
+
+    /**
+     * 获得指定地区和参保类型的标准参保项目
+     *
+     * @param areaId 地区编号
+     * @param typeCode 参保类型编码
+     * @return 标准参保项目列表
+     */
+    @Override
+    @Cacheable(cacheNames = INSURANCE_STANDARD_PROJECT + "#7d", key = "#areaId + ':' + #typeCode",
+            unless = "#result.isEmpty()")
+    public List<HrmInsuranceStandardProjectRespVO> getStandardProjectList(Integer areaId, String typeCode) {
+        String cityName = getCityName(areaId);
+        if (StrUtil.isBlank(cityName) || StrUtil.isBlank(typeCode)) {
+            return Collections.emptyList();
+        }
+        Map<String, Object> params = new HashMap<>();
+        params.put("js_cityid_name", cityName);
+        params.put("cs_classtype", typeCode);
+        params.put("X-Requested-With", "XMLHttpRequest");
+        try (HttpResponse response = HttpRequest.get(INSURANCE_SCALE_URL)
+                .header("X-Requested-With", "XMLHttpRequest")
+                .form(params)
+                .timeout(HTTP_TIMEOUT_MILLIS)
+                .execute()) {
+            if (!response.isOk()) {
+                log.warn("[getStandardProjectList][areaId({}) cityName({}) typeCode({}) 查询失败，响应状态码为 {}]",
+                        areaId, cityName, typeCode, response.getStatus());
+                return Collections.emptyList();
+            }
+            return parseProjectList(response.body());
+        } catch (Exception ex) {
+            log.warn("[getStandardProjectList][areaId({}) cityName({}) typeCode({}) 查询失败]",
+                    areaId, cityName, typeCode, ex);
+            return Collections.emptyList();
+        }
+    }
+
+    /**
+     * 解析标准参保类型响应
+     *
+     * @param body 响应内容
+     * @return 标准参保类型列表
+     */
+    List<HrmInsuranceStandardTypeRespVO> parseTypeList(String body) {
+        JSONObject data = JSONUtil.parseObj(body).getJSONObject("data");
+        JSONArray socialTypes = data == null ? null : data.getJSONArray("SocialTypes");
+        if (socialTypes == null || socialTypes.isEmpty()) {
+            return Collections.emptyList();
+        }
+        List<HrmInsuranceStandardTypeRespVO> result = new ArrayList<>(socialTypes.size());
+        for (int i = 0; i < socialTypes.size(); i++) {
+            JSONObject item = socialTypes.getJSONObject(i);
+            String code = item.getStr("AccountNo");
+            String name = item.getStr("InsuredType");
+            if (StrUtil.isNotBlank(code) && StrUtil.isNotBlank(name)) {
+                result.add(new HrmInsuranceStandardTypeRespVO().setCode(code).setName(name));
+            }
+        }
+        return result;
+    }
+
+    /**
+     * 解析标准参保项目响应
+     *
+     * @param body 响应内容
+     * @return 标准参保项目列表
+     */
+    List<HrmInsuranceStandardProjectRespVO> parseProjectList(String body) {
+        Map<Integer, HrmInsuranceStandardProjectRespVO> projectMap = new LinkedHashMap<>();
+        for (Element row : Jsoup.parse(body).select("tr")) {
+            Elements cells = row.children();
+            if (cells.size() < 7 || ObjUtil.notEqual("td", cells.get(0).normalName())) {
+                continue;
+            }
+            HrmInsuranceProjectTypeEnum projectType = getProjectType(cells.get(0).text());
+            if (projectType == null) {
+                continue;
+            }
+            projectMap.putIfAbsent(projectType.getType(), new HrmInsuranceStandardProjectRespVO()
+                    .setType(projectType.getType()).setName(projectType.getName())
+                    .setBaseAmount(NumberUtils.parseFirstBigDecimal(cells.get(1).text()))
+                    .setCorporateRate(NumberUtils.parseFirstBigDecimal(cells.get(3).text()))
+                    .setPersonalRate(NumberUtils.parseFirstBigDecimal(cells.get(4).text()))
+                    .setCorporateAmount(NumberUtils.parseFirstBigDecimal(cells.get(5).text()))
+                    .setPersonalAmount(NumberUtils.parseFirstBigDecimal(cells.get(6).text())));
+        }
+        return new ArrayList<>(projectMap.values());
+    }
+
+    private HrmInsuranceProjectTypeEnum getProjectType(String name) {
+        if (name.contains("大病") || name.contains("大额医疗")
+                || name.contains("补充") && name.contains("医疗")) {
+            return HrmInsuranceProjectTypeEnum.SUPPLEMENTARY_MEDICAL_INSURANCE;
+        }
+        if (name.contains("补充") && name.contains("养老")) {
+            return HrmInsuranceProjectTypeEnum.SUPPLEMENTARY_PENSION_INSURANCE;
+        }
+        if (name.contains("养老")) {
+            return HrmInsuranceProjectTypeEnum.PENSION_INSURANCE;
+        }
+        if (name.contains("医疗")) {
+            return HrmInsuranceProjectTypeEnum.MEDICAL_INSURANCE;
+        }
+        if (name.contains("失业")) {
+            return HrmInsuranceProjectTypeEnum.UNEMPLOYMENT_INSURANCE;
+        }
+        if (name.contains("工伤")) {
+            return HrmInsuranceProjectTypeEnum.WORK_INJURY_INSURANCE;
+        }
+        if (name.contains("生育")) {
+            return HrmInsuranceProjectTypeEnum.MATERNITY_INSURANCE;
+        }
+        if (name.contains("残保")) {
+            return HrmInsuranceProjectTypeEnum.DISABILITY_INSURANCE;
+        }
+        if (name.contains("公积金")) {
+            return HrmInsuranceProjectTypeEnum.PROVIDENT_FUND;
+        }
+        return null;
+    }
+
+    /**
+     * 获得标准参保数据使用的城市名称
+     *
+     * @param areaId 地区编号
+     * @return 城市名称
+     */
+    static String getCityName(Integer areaId) {
+        Integer cityAreaId = AreaUtils.getParentIdByType(areaId, AreaTypeEnum.CITY);
+        Area area = AreaUtils.getArea(cityAreaId != null ? cityAreaId : areaId);
+        if (area == null) {
+            return null;
+        }
+        return StrUtil.removeSuffix(StrUtil.removeSuffix(area.getName(), "城区"), "市");
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoService.java
new file mode 100644
index 0000000..43167cc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoService.java
@@ -0,0 +1,110 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.employee;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo.HrmInsuranceEmployeeInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 员工参保信息 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmInsuranceEmployeeInfoService {
+
+    /**
+     * 保存员工参保信息
+     *
+     * @param reqVO 员工参保信息
+     * @return 员工参保信息编号
+     */
+    Long saveInsuranceEmployeeInfo(@Valid HrmInsuranceEmployeeInfoSaveReqVO reqVO);
+
+    /**
+     * 校验员工参保信息是否存在
+     *
+     * @param id 员工参保信息编号
+     * @return 员工参保信息
+     */
+    HrmInsuranceEmployeeInfoDO validateInsuranceEmployeeInfoExists(Long id);
+
+    /**
+     * 获得员工参保信息
+     *
+     * @param employeeId 员工编号
+     * @return 员工参保信息
+     */
+    HrmInsuranceEmployeeInfoDO getInsuranceEmployeeInfoByEmployeeId(Long employeeId);
+
+    /**
+     * 获得全部员工参保信息
+     *
+     * @return 员工参保信息列表
+     */
+    List<HrmInsuranceEmployeeInfoDO> getInsuranceEmployeeInfoList();
+
+    /**
+     * 获得员工参保信息列表
+     *
+     * @param employeeIds 员工编号集合
+     * @return 员工参保信息列表
+     */
+    List<HrmInsuranceEmployeeInfoDO> getInsuranceEmployeeInfoList(Collection<Long> employeeIds);
+
+    /**
+     * 获得员工参保信息 Map
+     *
+     * @param employeeIds 员工编号集合
+     * @return 员工编号与参保信息的映射
+     */
+    default Map<Long, HrmInsuranceEmployeeInfoDO> getInsuranceEmployeeInfoMap(Collection<Long> employeeIds) {
+        return convertMap(getInsuranceEmployeeInfoList(employeeIds), HrmInsuranceEmployeeInfoDO::getEmployeeId);
+    }
+
+    /**
+     * 获得使用指定社保方案的员工数量
+     *
+     * @param schemeId 社保方案编号
+     * @return 员工数量
+     */
+    long getInsuranceEmployeeInfoCountBySchemeId(Long schemeId);
+
+    /**
+     * 获得各社保方案的使用员工数量
+     *
+     * @param schemeIds 社保方案编号集合
+     * @return 社保方案编号与员工数量的映射
+     */
+    Map<Long, Long> getInsuranceEmployeeInfoCountMapBySchemeIds(Collection<Long> schemeIds);
+
+    /**
+     * 更新员工参保方案
+     *
+     * @param employeeId 员工编号
+     * @param schemeId 社保方案编号
+     */
+    void updateEmployeeScheme(Long employeeId, Long schemeId);
+
+    /**
+     * 将指定社保方案下的员工参保信息迁移到新方案
+     *
+     * @param schemeId 旧社保方案编号
+     * @param newSchemeId 新社保方案编号
+     */
+    void updateInsuranceEmployeeInfoSchemeIdBySchemeId(Long schemeId, Long newSchemeId);
+
+    /**
+     * 在员工尚未设置社保起缴月份时进行回填
+     *
+     * @param employeeId 员工编号
+     * @param startMonth 社保起缴月份
+     */
+    void updateSocialSecurityStartMonthIfAbsent(Long employeeId, LocalDateTime startMonth);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoServiceImpl.java
new file mode 100644
index 0000000..c9661a3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoServiceImpl.java
@@ -0,0 +1,229 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.employee;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo.HrmInsuranceEmployeeInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.employee.HrmInsuranceEmployeeInfoMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.hutool.core.util.ObjectUtil.notEqual;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_EMPLOYEE_INFO_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_EMP_STATUS_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_EMPLOYEE_INFO_UPDATE_SCHEME_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_EMPLOYEE_INFO_UPDATE_SCHEME_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_EMPLOYEE_INFO_SAVE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_EMPLOYEE_INFO_SAVE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_EMPLOYEE_INFO_TYPE;
+
+/**
+ * HRM 员工参保信息 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmInsuranceEmployeeInfoServiceImpl implements HrmInsuranceEmployeeInfoService {
+
+    @Resource
+    private HrmInsuranceEmployeeInfoMapper insuranceEmployeeInfoMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmInsuranceSchemeService insuranceSchemeService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_EMPLOYEE_INFO_TYPE, subType = HRM_INSURANCE_EMPLOYEE_INFO_SAVE_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_INSURANCE_EMPLOYEE_INFO_SAVE_SUCCESS)
+    public Long saveInsuranceEmployeeInfo(HrmInsuranceEmployeeInfoSaveReqVO reqVO) {
+        // 1. 校验员工、参保信息和参保方案
+        HrmEmployeeDO employee = employeeService.validateEmployeeExistsForUpdate(reqVO.getEmployeeId());
+        HrmInsuranceEmployeeInfoDO oldEmployeeInfo = insuranceEmployeeInfoMapper
+                .selectByEmployeeId(reqVO.getEmployeeId());
+        if (reqVO.getId() != null) {
+            oldEmployeeInfo = validateInsuranceEmployeeInfoExists(reqVO.getId());
+            if (notEqual(oldEmployeeInfo.getEmployeeId(), reqVO.getEmployeeId())) {
+                throw exception(EMPLOYEE_RESOURCE_BELONG_INVALID, "参保信息");
+            }
+        }
+        if (reqVO.getSchemeId() != null
+                && (oldEmployeeInfo == null || notEqual(oldEmployeeInfo.getSchemeId(), reqVO.getSchemeId()))) {
+            validateEmployeeEligible(employee);
+            insuranceSchemeService.validateSchemeExists(reqVO.getSchemeId());
+        }
+
+        // 2. 保存员工参保信息
+        HrmInsuranceEmployeeInfoDO employeeInfo = BeanUtils.toBean(
+                reqVO, HrmInsuranceEmployeeInfoDO.class);
+        if (employeeInfo.getSocialSecurityStartMonth() != null) {
+            employeeInfo.setSocialSecurityStartMonth(
+                    LocalDateTimeUtils.beginOfMonth(employeeInfo.getSocialSecurityStartMonth()));
+        }
+        if (employeeInfo.getId() == null && oldEmployeeInfo != null) {
+            employeeInfo.setId(oldEmployeeInfo.getId());
+        }
+        insuranceEmployeeInfoMapper.insertOrUpdate(employeeInfo);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, oldEmployeeInfo == null
+                ? new HrmInsuranceEmployeeInfoSaveReqVO()
+                : BeanUtils.toBean(oldEmployeeInfo, HrmInsuranceEmployeeInfoSaveReqVO.class));
+        return employeeInfo.getId();
+    }
+
+    @Override
+    public HrmInsuranceEmployeeInfoDO validateInsuranceEmployeeInfoExists(Long id) {
+        HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoMapper.selectById(id);
+        if (employeeInfo == null) {
+            throw exception(INSURANCE_EMPLOYEE_INFO_NOT_EXISTS);
+        }
+        return employeeInfo;
+    }
+
+    @Override
+    public HrmInsuranceEmployeeInfoDO getInsuranceEmployeeInfoByEmployeeId(Long employeeId) {
+        return insuranceEmployeeInfoMapper.selectByEmployeeId(employeeId);
+    }
+
+    @Override
+    public List<HrmInsuranceEmployeeInfoDO> getInsuranceEmployeeInfoList() {
+        return getLatestEmployeeInfoList(insuranceEmployeeInfoMapper.selectListByIdDesc());
+    }
+
+    @Override
+    public List<HrmInsuranceEmployeeInfoDO> getInsuranceEmployeeInfoList(Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        return getLatestEmployeeInfoList(insuranceEmployeeInfoMapper.selectListByEmployeeIds(employeeIds));
+    }
+
+    @Override
+    public long getInsuranceEmployeeInfoCountBySchemeId(Long schemeId) {
+        return getInsuranceEmployeeInfoCountMapBySchemeIds(Collections.singleton(schemeId))
+                .getOrDefault(schemeId, 0L);
+    }
+
+    @Override
+    public Map<Long, Long> getInsuranceEmployeeInfoCountMapBySchemeIds(Collection<Long> schemeIds) {
+        if (CollUtil.isEmpty(schemeIds)) {
+            return Collections.emptyMap();
+        }
+        List<HrmInsuranceEmployeeInfoDO> employeeInfos = getInsuranceEmployeeInfoList();
+        employeeInfos.removeIf(employeeInfo -> !schemeIds.contains(employeeInfo.getSchemeId()));
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(employeeInfos, HrmInsuranceEmployeeInfoDO::getEmployeeId));
+        Map<Long, Long> countMap = new HashMap<>();
+        for (HrmInsuranceEmployeeInfoDO employeeInfo : employeeInfos) {
+            if (employeeMap.containsKey(employeeInfo.getEmployeeId())) {
+                countMap.merge(employeeInfo.getSchemeId(), 1L, Long::sum);
+            }
+        }
+        return countMap;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_EMPLOYEE_INFO_TYPE,
+            subType = HRM_INSURANCE_EMPLOYEE_INFO_UPDATE_SCHEME_SUB_TYPE,
+            bizNo = "{{#employeeId}}", success = HRM_INSURANCE_EMPLOYEE_INFO_UPDATE_SCHEME_SUCCESS)
+    public void updateEmployeeScheme(Long employeeId, Long schemeId) {
+        // 1. 校验员工和社保方案
+        HrmEmployeeDO employee = employeeService.validateEmployeeExistsForUpdate(employeeId);
+        validateEmployeeEligible(employee);
+        HrmInsuranceSchemeDO newScheme = insuranceSchemeService.validateSchemeExists(schemeId);
+
+        // 2. 创建或更新员工参保方案
+        HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoMapper.selectByEmployeeId(employeeId);
+        HrmInsuranceSchemeDO oldScheme = employeeInfo == null || employeeInfo.getSchemeId() == null ? null
+                : insuranceSchemeService.getScheme(employeeInfo.getSchemeId());
+        if (employeeInfo == null) {
+            employeeInfo = HrmInsuranceEmployeeInfoDO.builder().employeeId(employeeId).schemeId(schemeId)
+                    .firstSocialSecurity(false).firstAccumulationFund(false).build();
+            insuranceEmployeeInfoMapper.insert(employeeInfo);
+        } else {
+            insuranceEmployeeInfoMapper.updateById(new HrmInsuranceEmployeeInfoDO()
+                    .setId(employeeInfo.getId()).setSchemeId(schemeId));
+        }
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+        LogRecordContext.putVariable("oldSchemeName", oldScheme == null ? "未设置" : oldScheme.getName());
+        LogRecordContext.putVariable("newSchemeName", newScheme.getName());
+    }
+
+    @Override
+    public void updateInsuranceEmployeeInfoSchemeIdBySchemeId(Long schemeId, Long newSchemeId) {
+        insuranceEmployeeInfoMapper.updateBySchemeId(schemeId,
+                new HrmInsuranceEmployeeInfoDO().setSchemeId(newSchemeId));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updateSocialSecurityStartMonthIfAbsent(Long employeeId, LocalDateTime startMonth) {
+        // 1. 锁定员工，并检查起缴月份
+        employeeService.validateEmployeeExistsForUpdate(employeeId);
+        HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoMapper.selectByEmployeeId(employeeId);
+        if (employeeInfo != null && employeeInfo.getSocialSecurityStartMonth() != null) {
+            return;
+        }
+
+        // 2. 创建员工参保信息或回填起缴月份
+        LocalDateTime socialSecurityStartMonth = LocalDateTimeUtils.beginOfMonth(startMonth);
+        if (employeeInfo == null) {
+            employeeInfo = HrmInsuranceEmployeeInfoDO.builder().employeeId(employeeId)
+                    .firstSocialSecurity(false).firstAccumulationFund(false)
+                    .socialSecurityStartMonth(socialSecurityStartMonth).build();
+            insuranceEmployeeInfoMapper.insert(employeeInfo);
+            return;
+        }
+        insuranceEmployeeInfoMapper.updateById(new HrmInsuranceEmployeeInfoDO().setId(employeeInfo.getId())
+                .setSocialSecurityStartMonth(socialSecurityStartMonth));
+    }
+
+    private List<HrmInsuranceEmployeeInfoDO> getLatestEmployeeInfoList(
+            List<HrmInsuranceEmployeeInfoDO> employeeInfos) {
+        return new ArrayList<>(convertMap(employeeInfos,
+                HrmInsuranceEmployeeInfoDO::getEmployeeId).values());
+    }
+
+    /**
+     * 校验员工是否可以设置参保方案
+     *
+     * @param employee 员工
+     */
+    private void validateEmployeeEligible(HrmEmployeeDO employee) {
+        if (!HrmEmployeeStatusEnum.FULL_TIME_STATUSES.contains(employee.getStatus())
+                || !HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(employee.getEntryStatus())) {
+            throw exception(INSURANCE_EMP_STATUS_ILLEGAL);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordService.java
new file mode 100644
index 0000000..e498673
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordService.java
@@ -0,0 +1,133 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.monthrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordCreateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * HRM 员工月度社保 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmInsuranceMonthEmployeeRecordService {
+
+    /**
+     * 创建月度员工社保记录
+     *
+     * @param monthRecord 月度社保表
+     */
+    void createMonthEmployeeRecordList(HrmInsuranceMonthRecordDO monthRecord);
+
+    /**
+     * 添加月度参保员工
+     *
+     * @param reqVO 添加信息
+     */
+    void createMonthEmployeeRecordList(HrmInsuranceMonthEmployeeRecordCreateListReqVO reqVO);
+
+    /**
+     * 更新员工月度社保记录
+     *
+     * @param reqVO 更新信息
+     */
+    void updateMonthEmployeeRecord(HrmInsuranceMonthEmployeeRecordUpdateReqVO reqVO);
+
+    /**
+     * 停止员工参保
+     *
+     * @param ids 员工月度社保记录编号集合
+     */
+    void stopMonthEmployeeRecordList(Collection<Long> ids);
+
+    /**
+     * 删除指定月度社保表的员工记录
+     *
+     * @param monthRecordId 月度社保表编号
+     */
+    void deleteMonthEmployeeRecordListByMonthRecordId(Long monthRecordId);
+
+    /**
+     * 获得员工月度社保分页
+     *
+     * @param reqVO 分页查询
+     * @return 员工月度社保分页
+     */
+    PageResult<HrmInsuranceMonthEmployeeRecordDO> getMonthEmployeeRecordPage(
+            HrmInsuranceMonthEmployeeRecordPageReqVO reqVO);
+
+    /**
+     * 获得员工月度社保记录
+     *
+     * @param id 员工月度社保记录编号
+     * @return 员工月度社保记录
+     */
+    HrmInsuranceMonthEmployeeRecordDO getMonthEmployeeRecord(Long id);
+
+    /**
+     * 获得指定员工的月度社保记录
+     *
+     * @param employeeId 员工编号
+     * @param year 年份
+     * @return 月度社保记录列表
+     */
+    List<HrmInsuranceMonthEmployeeRecordDO> getMonthEmployeeRecordListByEmployeeIdAndYear(
+            Long employeeId, Integer year);
+
+    /**
+     * 获得指定月度社保表的员工记录
+     *
+     * @param monthRecordId 月度社保表编号
+     * @return 员工月度社保记录列表
+     */
+    List<HrmInsuranceMonthEmployeeRecordDO> getMonthEmployeeRecordListByMonthRecordId(Long monthRecordId);
+
+    /**
+     * 获得使用指定社保方案的月度记录数量
+     *
+     * @param schemeId 社保方案编号
+     * @return 月度记录数量
+     */
+    long getMonthEmployeeRecordCountBySchemeId(Long schemeId);
+
+    /**
+     * 获得各社保方案的历史月记录数量
+     *
+     * @param schemeIds 社保方案编号集合
+     * @return 社保方案编号与历史月记录数量的映射
+     */
+    Map<Long, Long> getMonthEmployeeRecordCountMapBySchemeIds(Collection<Long> schemeIds);
+
+    /**
+     * 将指定社保方案下的月度员工记录迁移到新方案
+     *
+     * @param schemeId 旧社保方案编号
+     * @param newSchemeId 新社保方案编号
+     */
+    void updateInsuranceMonthEmployeeRecordSchemeIdBySchemeId(Long schemeId, Long newSchemeId);
+
+    /**
+     * 获得指定月度社保表的未参保员工列表
+     *
+     * @param monthRecordId 月度社保表编号
+     * @return 未参保员工列表
+     */
+    List<HrmEmployeeDO> getUninsuredEmployeeList(Long monthRecordId);
+
+    /**
+     * 获得指定月份正常参保的员工记录 Map
+     *
+     * @param year 年份
+     * @param month 月份
+     * @return 员工编号与月度社保记录的映射
+     */
+    Map<Long, HrmInsuranceMonthEmployeeRecordDO> getNormalMonthEmployeeRecordMap(Integer year, Integer month);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordServiceImpl.java
new file mode 100644
index 0000000..e00530f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordServiceImpl.java
@@ -0,0 +1,542 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.monthrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeProjectUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordCreateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO.Project;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceSchemeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.employee.HrmInsuranceEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceMultiplyPercent;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceScale;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_EMPLOYEE_SCHEME_NOT_CONFIGURED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_EMPLOYEE_NOT_ELIGIBLE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_EMP_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_EMPLOYEE_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_EMPLOYEE_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_EMPLOYEE_STOP_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_EMPLOYEE_STOP_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_EMPLOYEE_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_EMPLOYEE_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_TYPE;
+
+/**
+ * HRM 员工月度社保 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmInsuranceMonthEmployeeRecordServiceImpl implements HrmInsuranceMonthEmployeeRecordService {
+
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordMapper monthEmployeeRecordMapper;
+
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmInsuranceMonthRecordService monthRecordService;
+    @Resource
+    private HrmInsuranceSchemeService insuranceSchemeService;
+    @Resource
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void createMonthEmployeeRecordList(HrmInsuranceMonthRecordDO monthRecord) {
+        // 1. 批量加载已配置参保方案的员工社保资料
+        List<HrmInsuranceEmployeeInfoDO> insuranceEmployeeInfos = convertList(
+                insuranceEmployeeInfoService.getInsuranceEmployeeInfoList(), info -> info,
+                info -> info.getSchemeId() != null);
+        Set<Long> schemeIds = convertSet(insuranceEmployeeInfos, HrmInsuranceEmployeeInfoDO::getSchemeId);
+        Map<Long, HrmInsuranceSchemeDO> schemeMap = convertMap(
+                insuranceSchemeService.getSchemeListByIds(schemeIds), HrmInsuranceSchemeDO::getId);
+        Map<Long, List<HrmInsuranceSchemeProjectDO>> schemeProjectMap =
+                insuranceSchemeService.getSchemeProjectListMap(schemeIds);
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(insuranceEmployeeInfos, HrmInsuranceEmployeeInfoDO::getEmployeeId));
+
+        // 2. 生成员工月记录
+        List<HrmInsuranceMonthEmployeeRecordDO> employeeRecords = new ArrayList<>();
+        for (HrmInsuranceEmployeeInfoDO insuranceEmployeeInfo : insuranceEmployeeInfos) {
+            HrmInsuranceSchemeDO scheme = schemeMap.get(insuranceEmployeeInfo.getSchemeId());
+            HrmEmployeeDO employee = employeeMap.get(insuranceEmployeeInfo.getEmployeeId());
+            List<HrmInsuranceSchemeProjectDO> schemeProjects = scheme == null ? Collections.emptyList()
+                    : schemeProjectMap.getOrDefault(scheme.getId(), Collections.emptyList());
+            if (scheme == null || employee == null || CollUtil.isEmpty(schemeProjects)
+                    || !isAvailableForInsuranceMonth(employee, monthRecord)) {
+                continue;
+            }
+            List<Project> projects = buildProjectsFromScheme(schemeProjects, scheme.getType());
+            employeeRecords.add(buildMonthEmployeeRecord(monthRecord, employee.getId(), scheme, projects,
+                    HrmInsuranceEmployeeStatusEnum.NORMAL.getStatus()));
+        }
+        if (CollUtil.isNotEmpty(employeeRecords)) {
+            monthEmployeeRecordMapper.insertBatch(employeeRecords);
+        }
+
+        // 3. 回填员工社保起缴月份
+        LocalDateTime startMonth = YearMonth.of(monthRecord.getYear(), monthRecord.getMonth())
+                .atDay(1).atStartOfDay();
+        for (HrmInsuranceMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            insuranceEmployeeInfoService.updateSocialSecurityStartMonthIfAbsent(
+                    employeeRecord.getEmployeeId(), startMonth);
+            sendInsuranceMonthRecordMessage(employeeMap.get(employeeRecord.getEmployeeId()), monthRecord);
+        }
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_MONTH_TYPE, subType = HRM_INSURANCE_MONTH_EMPLOYEE_CREATE_SUB_TYPE,
+            bizNo = "{{#reqVO.monthRecordId}}", success = HRM_INSURANCE_MONTH_EMPLOYEE_CREATE_SUCCESS)
+    public void createMonthEmployeeRecordList(HrmInsuranceMonthEmployeeRecordCreateListReqVO reqVO) {
+        // 1. 校验月表和员工
+        HrmInsuranceMonthRecordDO monthRecord = monthRecordService.validateMonthRecordEditableForUpdate(
+                reqVO.getMonthRecordId());
+        employeeService.validateEmployeeListExists(reqVO.getEmployeeIds());
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(reqVO.getEmployeeIds());
+
+        // 2. 批量加载员工社保资料、方案和项目
+        Map<Long, HrmInsuranceEmployeeInfoDO> insuranceEmployeeInfoMap =
+                insuranceEmployeeInfoService.getInsuranceEmployeeInfoMap(reqVO.getEmployeeIds());
+        Set<Long> schemeIds = convertSet(insuranceEmployeeInfoMap.values(),
+                HrmInsuranceEmployeeInfoDO::getSchemeId);
+        Map<Long, HrmInsuranceSchemeDO> schemeMap = convertMap(
+                insuranceSchemeService.getSchemeListByIds(schemeIds), HrmInsuranceSchemeDO::getId);
+        Map<Long, List<HrmInsuranceSchemeProjectDO>> schemeProjectMap =
+                insuranceSchemeService.getSchemeProjectListMap(schemeIds);
+
+        // 3. 新增或更新员工月记录
+        for (Long employeeId : reqVO.getEmployeeIds()) {
+            HrmInsuranceEmployeeInfoDO insuranceEmployeeInfo = insuranceEmployeeInfoMap.get(employeeId);
+            HrmInsuranceSchemeDO scheme = insuranceEmployeeInfo == null
+                    ? null : schemeMap.get(insuranceEmployeeInfo.getSchemeId());
+            List<HrmInsuranceSchemeProjectDO> schemeProjects = scheme == null ? Collections.emptyList()
+                    : schemeProjectMap.getOrDefault(scheme.getId(), Collections.emptyList());
+            if (scheme == null || CollUtil.isEmpty(schemeProjects)) {
+                throw exception(INSURANCE_EMPLOYEE_SCHEME_NOT_CONFIGURED);
+            }
+            if (!isAvailableForInsuranceMonth(employeeMap.get(employeeId), monthRecord)) {
+                throw exception(INSURANCE_MONTH_EMPLOYEE_NOT_ELIGIBLE);
+            }
+            List<Project> projects = buildProjectsFromScheme(schemeProjects, scheme.getType());
+            createOrUpdateMonthEmployeeRecord(monthRecord, employeeId, scheme, projects,
+                    HrmInsuranceEmployeeStatusEnum.NORMAL.getStatus());
+        }
+
+        // 4. 更新月表汇总
+        monthRecordService.updateMonthRecordSummary(monthRecord.getId());
+
+        // 5. 记录操作日志上下文
+        LogRecordContext.putVariable("monthRecord", monthRecord);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_MONTH_TYPE, subType = HRM_INSURANCE_MONTH_EMPLOYEE_UPDATE_SUB_TYPE,
+            bizNo = "{{#employeeRecord.monthRecordId}}", success = HRM_INSURANCE_MONTH_EMPLOYEE_UPDATE_SUCCESS)
+    public void updateMonthEmployeeRecord(HrmInsuranceMonthEmployeeRecordUpdateReqVO reqVO) {
+        // 1. 校验员工月记录和社保方案
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = validateMonthEmployeeRecordEditable(reqVO.getId());
+        HrmInsuranceSchemeDO scheme = insuranceSchemeService.validateSchemeExists(reqVO.getSchemeId());
+
+        // 2. 更新员工月记录和当前参保方案
+        updateSingleMonthEmployeeRecord(employeeRecord, scheme,
+                buildProjectsFromUpdateReqVO(employeeRecord, scheme, reqVO.getProjects()));
+
+        // 3. 更新月表汇总
+        monthRecordService.updateMonthRecordSummary(employeeRecord.getMonthRecordId());
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("employeeRecord", employeeRecord);
+        LogRecordContext.putVariable("scheme", scheme);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_MONTH_TYPE, subType = HRM_INSURANCE_MONTH_EMPLOYEE_STOP_SUB_TYPE,
+            bizNo = "{{#monthRecord.id}}", success = HRM_INSURANCE_MONTH_EMPLOYEE_STOP_SUCCESS)
+    public void stopMonthEmployeeRecordList(Collection<Long> ids) {
+        // 1. 校验员工月记录
+        List<HrmInsuranceMonthEmployeeRecordDO> employeeRecords =
+                convertList(ids, this::validateMonthEmployeeRecordEditable);
+
+        // 2. 批量停止参保
+        for (HrmInsuranceMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            monthEmployeeRecordMapper.updateById(new HrmInsuranceMonthEmployeeRecordDO()
+                    .setId(employeeRecord.getId())
+                    .setStatus(HrmInsuranceEmployeeStatusEnum.STOPPED.getStatus()));
+        }
+
+        // 3. 更新涉及的月表汇总
+        for (Long monthRecordId : convertSet(employeeRecords,
+                HrmInsuranceMonthEmployeeRecordDO::getMonthRecordId)) {
+            monthRecordService.updateMonthRecordSummary(monthRecordId);
+        }
+
+        // 4. 记录操作日志上下文
+        HrmInsuranceMonthRecordDO monthRecord = monthRecordService.validateMonthRecordExists(
+                CollUtil.getFirst(employeeRecords).getMonthRecordId());
+        LogRecordContext.putVariable("monthRecord", monthRecord);
+    }
+
+    @Override
+    public void deleteMonthEmployeeRecordListByMonthRecordId(Long monthRecordId) {
+        monthEmployeeRecordMapper.deleteByMonthRecordId(monthRecordId);
+    }
+
+    @Override
+    public PageResult<HrmInsuranceMonthEmployeeRecordDO> getMonthEmployeeRecordPage(
+            HrmInsuranceMonthEmployeeRecordPageReqVO reqVO) {
+        // 1.1 获得员工姓名关联的员工编号
+        Collection<Long> employeeIds = null;
+        if (StrUtil.isNotBlank(reqVO.getEmployeeName())) {
+            employeeIds = convertList(employeeService.getEmployeeList(
+                    new HrmEmployeeListReqVO().setName(reqVO.getEmployeeName())), HrmEmployeeDO::getId);
+            if (CollUtil.isEmpty(employeeIds)) {
+                return PageResult.empty();
+            }
+        }
+        // 1.2 获得参保地区关联的方案编号
+        Collection<Long> schemeIds = null;
+        if (reqVO.getAreaId() != null) {
+            schemeIds = convertList(insuranceSchemeService.getSchemeListByAreaId(reqVO.getAreaId()),
+                    HrmInsuranceSchemeDO::getId);
+            if (CollUtil.isEmpty(schemeIds)) {
+                return PageResult.empty();
+            }
+        }
+
+        // 2. 查询员工月记录
+        return monthEmployeeRecordMapper.selectPage(reqVO, employeeIds, schemeIds);
+    }
+
+    @Override
+    public HrmInsuranceMonthEmployeeRecordDO getMonthEmployeeRecord(Long id) {
+        return monthEmployeeRecordMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmInsuranceMonthEmployeeRecordDO> getMonthEmployeeRecordListByEmployeeIdAndYear(
+            Long employeeId, Integer year) {
+        return monthEmployeeRecordMapper.selectListByEmployeeIdAndYear(employeeId, year);
+    }
+
+    @Override
+    public List<HrmInsuranceMonthEmployeeRecordDO> getMonthEmployeeRecordListByMonthRecordId(Long monthRecordId) {
+        return monthEmployeeRecordMapper.selectListByMonthRecordId(monthRecordId);
+    }
+
+    @Override
+    public long getMonthEmployeeRecordCountBySchemeId(Long schemeId) {
+        return monthEmployeeRecordMapper.selectCountBySchemeId(schemeId);
+    }
+
+    @Override
+    public Map<Long, Long> getMonthEmployeeRecordCountMapBySchemeIds(Collection<Long> schemeIds) {
+        if (CollUtil.isEmpty(schemeIds)) {
+            return Collections.emptyMap();
+        }
+        return monthEmployeeRecordMapper.selectCountMapBySchemeIds(schemeIds);
+    }
+
+    @Override
+    public void updateInsuranceMonthEmployeeRecordSchemeIdBySchemeId(Long schemeId, Long newSchemeId) {
+        monthEmployeeRecordMapper.updateBySchemeId(schemeId,
+                new HrmInsuranceMonthEmployeeRecordDO().setSchemeId(newSchemeId));
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getUninsuredEmployeeList(Long monthRecordId) {
+        // 1. 获得月表和当前正常参保员工
+        HrmInsuranceMonthRecordDO monthRecord = monthRecordService.getMonthRecord(monthRecordId);
+        if (monthRecord == null) {
+            return Collections.emptyList();
+        }
+        Set<Long> insuredEmployeeIds = convertSet(
+                monthEmployeeRecordMapper.selectListByMonthRecordIdAndStatus(
+                        monthRecordId, HrmInsuranceEmployeeStatusEnum.NORMAL.getStatus()),
+                HrmInsuranceMonthEmployeeRecordDO::getEmployeeId);
+
+        // 2. 加载员工当前参保方案
+        List<HrmEmployeeDO> employees = employeeService.getEmployeeList(new HrmEmployeeListReqVO());
+        Map<Long, HrmInsuranceEmployeeInfoDO> insuranceEmployeeInfoMap = insuranceEmployeeInfoService
+                .getInsuranceEmployeeInfoMap(convertSet(employees, HrmEmployeeDO::getId));
+        Set<Long> schemeIds = convertSet(insuranceEmployeeInfoMap.values(), HrmInsuranceEmployeeInfoDO::getSchemeId);
+        Set<Long> validSchemeIds = convertSet(insuranceSchemeService.getSchemeListByIds(schemeIds),
+                HrmInsuranceSchemeDO::getId);
+
+        // 3. 筛选本月可参保员工
+        return convertList(employees, employee -> employee, employee -> {
+            HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoMap.get(employee.getId());
+            return !insuredEmployeeIds.contains(employee.getId())
+                    && employeeInfo != null && validSchemeIds.contains(employeeInfo.getSchemeId())
+                    && isAvailableForInsuranceMonth(employee, monthRecord);
+        });
+    }
+
+    @Override
+    public Map<Long, HrmInsuranceMonthEmployeeRecordDO> getNormalMonthEmployeeRecordMap(Integer year, Integer month) {
+        List<HrmInsuranceMonthEmployeeRecordDO> list = monthEmployeeRecordMapper.selectListByYearAndMonthAndStatus(
+                year, month, HrmInsuranceEmployeeStatusEnum.NORMAL.getStatus());
+        return convertMap(list, HrmInsuranceMonthEmployeeRecordDO::getEmployeeId);
+    }
+
+    private HrmInsuranceMonthEmployeeRecordDO validateMonthEmployeeRecordExists(Long id) {
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = monthEmployeeRecordMapper.selectById(id);
+        if (employeeRecord == null) {
+            throw exception(INSURANCE_MONTH_EMP_RECORD_NOT_EXISTS);
+        }
+        return employeeRecord;
+    }
+
+    private HrmInsuranceMonthEmployeeRecordDO validateMonthEmployeeRecordEditable(Long id) {
+        // 1. 校验员工月记录存在
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = validateMonthEmployeeRecordExists(id);
+        // 2. 校验月表可编辑
+        monthRecordService.validateMonthRecordEditableForUpdate(employeeRecord.getMonthRecordId());
+        return employeeRecord;
+    }
+
+    private boolean isAvailableForInsuranceMonth(HrmEmployeeDO employee,
+                                                  HrmInsuranceMonthRecordDO monthRecord) {
+        if (employee == null
+                || Objects.equals(employee.getEntryStatus(), HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())) {
+            return false;
+        }
+        YearMonth yearMonth = YearMonth.of(monthRecord.getYear(), monthRecord.getMonth());
+        LocalDateTime monthBeginTime = yearMonth.atDay(1).atStartOfDay();
+        LocalDateTime monthEndTime = yearMonth.atEndOfMonth().atTime(LocalTime.MAX);
+        if (employee.getEntryTime() != null && employee.getEntryTime().isAfter(monthEndTime)) {
+            return false;
+        }
+        if (employee.getLeaveTime() != null) {
+            return !employee.getLeaveTime().isBefore(monthBeginTime);
+        }
+        return ObjUtil.notEqual(employee.getEntryStatus(), HrmEmployeeEntryStatusEnum.LEFT.getStatus());
+    }
+
+    private List<Project> buildProjectsFromScheme(List<HrmInsuranceSchemeProjectDO> schemeProjects, Integer schemeType) {
+        return convertList(schemeProjects, schemeProject -> buildProject(schemeProject, schemeType));
+    }
+
+    private Project buildProject(HrmInsuranceSchemeProjectDO schemeProject, Integer schemeType) {
+        Project project = Project.builder()
+                .schemeProjectId(schemeProject.getId())
+                .type(schemeProject.getType()).name(schemeProject.getName())
+                .baseAmount(schemeProject.getBaseAmount())
+                .corporateRate(schemeProject.getCorporateRate()).personalRate(schemeProject.getPersonalRate())
+                .corporateAmount(schemeProject.getCorporateAmount()).personalAmount(schemeProject.getPersonalAmount())
+                .build();
+        calculateProjectAmount(schemeType, project);
+        return project;
+    }
+
+    private List<Project> buildProjectsFromUpdateReqVO(
+            HrmInsuranceMonthEmployeeRecordDO employeeRecord, HrmInsuranceSchemeDO scheme,
+            List<HrmInsuranceMonthEmployeeProjectUpdateReqVO> projectUpdates) {
+        // 1. 校验请求项目编号不重复
+        Map<Long, HrmInsuranceMonthEmployeeProjectUpdateReqVO> updateMap = new LinkedHashMap<>();
+        for (HrmInsuranceMonthEmployeeProjectUpdateReqVO projectUpdate : projectUpdates) {
+            if (updateMap.put(projectUpdate.getSchemeProjectId(), projectUpdate) != null) {
+                throw exception(INSURANCE_DATA_ILLEGAL);
+            }
+        }
+        // 2. 未切换方案时沿用月度快照；切换方案时加载新方案项目
+        List<Project> projects = Objects.equals(employeeRecord.getSchemeId(), scheme.getId())
+                && CollUtil.isNotEmpty(employeeRecord.getProjects())
+                ? convertList(employeeRecord.getProjects(), project -> BeanUtils.toBean(project, Project.class))
+                : buildProjectsFromScheme(insuranceSchemeService.getSchemeProjectList(scheme.getId()),
+                        scheme.getType());
+        // 3. 校验请求项目均属于月度快照或新方案
+        if (!convertSet(projects, Project::getSchemeProjectId).containsAll(updateMap.keySet())) {
+            throw exception(INSURANCE_DATA_ILLEGAL);
+        }
+        // 4. 使用请求数据覆盖可编辑金额并重新计算
+        for (Project project : projects) {
+            HrmInsuranceMonthEmployeeProjectUpdateReqVO projectUpdate =
+                    updateMap.get(project.getSchemeProjectId());
+            if (projectUpdate == null) {
+                continue;
+            }
+            if (Objects.equals(scheme.getType(), HrmInsuranceSchemeTypeEnum.PROPORTION.getType())) {
+                project.setBaseAmount(projectUpdate.getBaseAmount());
+            } else {
+                project.setCorporateAmount(projectUpdate.getCorporateAmount())
+                        .setPersonalAmount(projectUpdate.getPersonalAmount());
+            }
+            calculateProjectAmount(scheme.getType(), project);
+        }
+        return projects;
+    }
+
+    private HrmInsuranceMonthEmployeeRecordDO buildMonthEmployeeRecord(
+            HrmInsuranceMonthRecordDO monthRecord, Long employeeId, HrmInsuranceSchemeDO scheme,
+            List<Project> projects, Integer status) {
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = new HrmInsuranceMonthEmployeeRecordDO()
+                .setMonthRecordId(monthRecord.getId()).setEmployeeId(employeeId)
+                .setSchemeId(scheme == null ? null : scheme.getId())
+                .setYear(monthRecord.getYear()).setMonth(monthRecord.getMonth())
+                .setStatus(status).setProjects(projects);
+        fillEmployeeRecordAmounts(employeeRecord, projects);
+        return employeeRecord;
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    private Long createOrUpdateMonthEmployeeRecord(
+            HrmInsuranceMonthRecordDO monthRecord, Long employeeId, HrmInsuranceSchemeDO scheme,
+            List<Project> projects, Integer status) {
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = monthEmployeeRecordMapper
+                .selectByMonthRecordIdAndEmployeeId(monthRecord.getId(), employeeId);
+        if (employeeRecord == null) {
+            employeeRecord = buildMonthEmployeeRecord(monthRecord, employeeId, scheme, projects, status);
+            monthEmployeeRecordMapper.insert(employeeRecord);
+        } else {
+            employeeRecord.setSchemeId(scheme == null ? null : scheme.getId())
+                    .setStatus(status).setProjects(projects);
+            fillEmployeeRecordAmounts(employeeRecord, projects);
+            monthEmployeeRecordMapper.updateById(employeeRecord);
+        }
+        insuranceEmployeeInfoService.updateSocialSecurityStartMonthIfAbsent(employeeId,
+                YearMonth.of(monthRecord.getYear(), monthRecord.getMonth()).atDay(1).atStartOfDay());
+        return employeeRecord.getId();
+    }
+
+    /**
+     * 更新单个员工月度社保记录，并同步员工当前参保方案
+     *
+     * @param employeeRecord 员工月度社保记录
+     * @param scheme 社保方案
+     * @param projects 月度参保项目
+     */
+    private void updateSingleMonthEmployeeRecord(HrmInsuranceMonthEmployeeRecordDO employeeRecord,
+                                                 HrmInsuranceSchemeDO scheme, List<Project> projects) {
+        // 1. 更新员工月度社保记录
+        employeeRecord.setSchemeId(scheme.getId()).setProjects(projects);
+        fillEmployeeRecordAmounts(employeeRecord, projects);
+        monthEmployeeRecordMapper.updateById(employeeRecord);
+
+        // 2. 同步员工当前参保方案
+        HrmEmployeeDO employee = employeeService.getEmployee(employeeRecord.getEmployeeId());
+        if (employee != null && HrmEmployeeStatusEnum.FULL_TIME_STATUSES.contains(employee.getStatus())
+                && HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(employee.getEntryStatus())) {
+            insuranceEmployeeInfoService.updateEmployeeScheme(employeeRecord.getEmployeeId(), scheme.getId());
+        }
+    }
+
+    private void fillEmployeeRecordAmounts(HrmInsuranceMonthEmployeeRecordDO employeeRecord, List<Project> projects) {
+        BigDecimal personalInsuranceAmount = BigDecimal.ZERO;
+        BigDecimal personalProvidentFundAmount = BigDecimal.ZERO;
+        BigDecimal corporateInsuranceAmount = BigDecimal.ZERO;
+        BigDecimal corporateProvidentFundAmount = BigDecimal.ZERO;
+        for (Project project : projects) {
+            HrmInsuranceProjectTypeEnum projectType = HrmInsuranceProjectTypeEnum.valueOf(project.getType());
+            if (projectType == null) {
+                continue;
+            }
+            if (projectType.isProvidentFund()) {
+                personalProvidentFundAmount = personalProvidentFundAmount.add(
+                        ObjUtil.defaultIfNull(project.getPersonalAmount(), BigDecimal.ZERO));
+                corporateProvidentFundAmount = corporateProvidentFundAmount.add(
+                        ObjUtil.defaultIfNull(project.getCorporateAmount(), BigDecimal.ZERO));
+            } else {
+                personalInsuranceAmount = personalInsuranceAmount.add(
+                        ObjUtil.defaultIfNull(project.getPersonalAmount(), BigDecimal.ZERO));
+                corporateInsuranceAmount = corporateInsuranceAmount.add(
+                        ObjUtil.defaultIfNull(project.getCorporateAmount(), BigDecimal.ZERO));
+            }
+        }
+        employeeRecord.setPersonalInsuranceAmount(priceScale(personalInsuranceAmount))
+                .setPersonalProvidentFundAmount(priceScale(personalProvidentFundAmount))
+                .setCorporateInsuranceAmount(priceScale(corporateInsuranceAmount))
+                .setCorporateProvidentFundAmount(priceScale(corporateProvidentFundAmount));
+    }
+
+    private void calculateProjectAmount(Integer type, Project project) {
+        project.setBaseAmount(priceScale(project.getBaseAmount()))
+                .setCorporateRate(priceScale(project.getCorporateRate()))
+                .setPersonalRate(priceScale(project.getPersonalRate()));
+        if (Objects.equals(type, HrmInsuranceSchemeTypeEnum.PROPORTION.getType())) {
+            project.setCorporateAmount(priceMultiplyPercent(project.getBaseAmount(), project.getCorporateRate()))
+                    .setPersonalAmount(priceMultiplyPercent(project.getBaseAmount(), project.getPersonalRate()));
+        } else {
+            project.setCorporateAmount(priceScale(project.getCorporateAmount()))
+                    .setPersonalAmount(priceScale(project.getPersonalAmount()));
+        }
+    }
+
+    /**
+     * 发送月度社保表生成通知
+     *
+     * @param employee 员工
+     * @param monthRecord 月度社保表
+     */
+    private void sendInsuranceMonthRecordMessage(HrmEmployeeDO employee, HrmInsuranceMonthRecordDO monthRecord) {
+        if (employee == null || employee.getUserId() == null) {
+            return;
+        }
+        Map<String, Object> templateParams = new HashMap<>(4);
+        templateParams.put("employeeName", employee.getName());
+        templateParams.put("year", monthRecord.getYear());
+        templateParams.put("month", monthRecord.getMonth());
+        templateParams.put("route", "/hrm/portal/insurance/record");
+        notifyMessageSendApi.sendSingleMessageToAdmin(new NotifySendSingleToUserReqDTO()
+                .setUserId(employee.getUserId())
+                .setTemplateCode(MessageTemplateConstants.INSURANCE_MONTH_RECORD_CREATED)
+                .setTemplateParams(templateParams));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordService.java
new file mode 100644
index 0000000..f37c7af
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordService.java
@@ -0,0 +1,92 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.HrmInsuranceMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+
+import java.util.List;
+
+/**
+ * HRM 月度社保 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmInsuranceMonthRecordService {
+
+    /**
+     * 创建首月社保表
+     *
+     * @param reqVO 首月年月
+     * @return 月度社保表编号
+     */
+    Long createFirstMonthRecord(HrmInsuranceMonthRecordCreateReqVO reqVO);
+
+    /**
+     * 创建次月社保表
+     *
+     * @return 月度社保表编号
+     */
+    Long createNextMonthRecord();
+
+    /**
+     * 删除月度社保表
+     *
+     * @param id 月度社保表编号
+     */
+    void deleteMonthRecord(Long id);
+
+    /**
+     * 获得月度社保表
+     *
+     * @param id 月度社保表编号
+     * @return 月度社保表
+     */
+    HrmInsuranceMonthRecordDO getMonthRecord(Long id);
+
+    /**
+     * 获得最近月度社保表
+     *
+     * @return 最近月度社保表
+     */
+    HrmInsuranceMonthRecordDO getLastMonthRecord();
+
+    /**
+     * 获得月度社保表列表
+     *
+     * @param year 年份
+     * @return 月度社保表列表
+     */
+    List<HrmInsuranceMonthRecordDO> getMonthRecordList(Integer year);
+
+    /**
+     * 校验月度社保表是否存在
+     *
+     * @param id 月度社保表编号
+     * @return 月度社保表
+     */
+    HrmInsuranceMonthRecordDO validateMonthRecordExists(Long id);
+
+    /**
+     * 校验指定年月的月度社保表是否存在
+     *
+     * @param year 年份
+     * @param month 月份
+     * @return 月度社保表
+     */
+    HrmInsuranceMonthRecordDO validateMonthRecordExists(Integer year, Integer month);
+
+    /**
+     * 校验月度社保表是否可编辑，并锁定记录
+     *
+     * @param id 月度社保表编号
+     * @return 月度社保表
+     */
+    HrmInsuranceMonthRecordDO validateMonthRecordEditableForUpdate(Long id);
+
+    /**
+     * 更新月度社保表汇总
+     *
+     * @param id 月度社保表编号
+     */
+    void updateMonthRecordSummary(Long id);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordServiceImpl.java
new file mode 100644
index 0000000..e4dced0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordServiceImpl.java
@@ -0,0 +1,241 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.monthrecord;
+
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.HrmInsuranceMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.monthrecord.HrmInsuranceMonthRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.insurance.employee.HrmInsuranceEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.monthrecord.HrmInsuranceMonthStatusEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.List;
+import java.util.Objects;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceScale;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_FIRST_MONTH_RECORD_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_RECORD_ARCHIVED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_RECORD_CANNOT_DELETE_ONLY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_RECORD_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_RECORD_NOT_LATEST;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_INSURANCE_MONTH_TYPE;
+
+/**
+ * HRM 月度社保 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmInsuranceMonthRecordServiceImpl implements HrmInsuranceMonthRecordService {
+
+    private static final String MONTH_RECORD_TITLE_TEMPLATE = "%d年%d月社保表";
+    @Resource
+    private HrmInsuranceMonthRecordMapper monthRecordMapper;
+
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordService monthEmployeeRecordService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_MONTH_TYPE, subType = HRM_INSURANCE_MONTH_CREATE_SUB_TYPE,
+            bizNo = "{{#monthRecord.id}}", success = HRM_INSURANCE_MONTH_CREATE_SUCCESS)
+    public Long createFirstMonthRecord(HrmInsuranceMonthRecordCreateReqVO reqVO) {
+        // 1. 校验尚未生成社保表
+        if (monthRecordMapper.selectLastForUpdate() != null) {
+            throw exception(INSURANCE_FIRST_MONTH_RECORD_EXISTS);
+        }
+
+        // 2.1 创建首月社保表
+        HrmInsuranceMonthRecordDO monthRecord = createMonthRecord(reqVO);
+        // 2.2 生成员工月记录并更新汇总
+        computeMonthRecord(monthRecord);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("monthRecord", monthRecord);
+        return monthRecord.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_MONTH_TYPE, subType = HRM_INSURANCE_MONTH_CREATE_SUB_TYPE,
+            bizNo = "{{#monthRecord.id}}", success = HRM_INSURANCE_MONTH_CREATE_SUCCESS)
+    public Long createNextMonthRecord() {
+        // 1. 校验最近月度社保表
+        HrmInsuranceMonthRecordDO lastMonthRecord = monthRecordMapper.selectLastForUpdate();
+        if (lastMonthRecord == null) {
+            throw exception(INSURANCE_MONTH_RECORD_NOT_EXISTS);
+        }
+
+        // 2. 归档最近月度社保表
+        if (Objects.equals(lastMonthRecord.getStatus(), HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus())) {
+            archiveMonthRecord(lastMonthRecord);
+        }
+
+        // 3.1 创建次月社保表
+        YearMonth nextMonth = YearMonth.of(lastMonthRecord.getYear(), lastMonthRecord.getMonth()).plusMonths(1);
+        HrmInsuranceMonthRecordDO monthRecord = createMonthRecord(new HrmInsuranceMonthRecordCreateReqVO()
+                .setYear(nextMonth.getYear()).setMonth(nextMonth.getMonthValue()));
+        // 3.2 生成员工月记录并更新汇总
+        computeMonthRecord(monthRecord);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("monthRecord", monthRecord);
+        return monthRecord.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_INSURANCE_MONTH_TYPE, subType = HRM_INSURANCE_MONTH_DELETE_SUB_TYPE,
+            bizNo = "{{#monthRecord.id}}", success = HRM_INSURANCE_MONTH_DELETE_SUCCESS)
+    public void deleteMonthRecord(Long id) {
+        // 1. 校验仅删除最新社保表，并至少保留一张社保表
+        HrmInsuranceMonthRecordDO monthRecord = validateMonthRecordEditableForUpdate(id);
+        HrmInsuranceMonthRecordDO lastMonthRecord = monthRecordMapper.selectLast();
+        if (lastMonthRecord == null || ObjectUtil.notEqual(lastMonthRecord.getId(), monthRecord.getId())) {
+            throw exception(INSURANCE_MONTH_RECORD_NOT_LATEST);
+        }
+        if (monthRecordMapper.selectCount() <= 1) {
+            throw exception(INSURANCE_MONTH_RECORD_CANNOT_DELETE_ONLY);
+        }
+
+        // 2.1 删除当前月员工记录和月表
+        monthEmployeeRecordService.deleteMonthEmployeeRecordListByMonthRecordId(id);
+        monthRecordMapper.deleteById(id);
+        // 2.2 将上一月调整为可编辑状态
+        HrmInsuranceMonthRecordDO previousMonthRecord = monthRecordMapper.selectLast();
+        monthRecordMapper.updateById(new HrmInsuranceMonthRecordDO()
+                .setId(previousMonthRecord.getId())
+                .setStatus(HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus()));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("monthRecord", monthRecord);
+    }
+
+    @Override
+    public HrmInsuranceMonthRecordDO getMonthRecord(Long id) {
+        return monthRecordMapper.selectById(id);
+    }
+
+    @Override
+    public HrmInsuranceMonthRecordDO getLastMonthRecord() {
+        return monthRecordMapper.selectLast();
+    }
+
+    @Override
+    public List<HrmInsuranceMonthRecordDO> getMonthRecordList(Integer year) {
+        return monthRecordMapper.selectListByYear(year);
+    }
+
+    @Override
+    public HrmInsuranceMonthRecordDO validateMonthRecordExists(Long id) {
+        HrmInsuranceMonthRecordDO monthRecord = monthRecordMapper.selectById(id);
+        if (monthRecord == null) {
+            throw exception(INSURANCE_MONTH_RECORD_NOT_EXISTS);
+        }
+        return monthRecord;
+    }
+
+    @Override
+    public HrmInsuranceMonthRecordDO validateMonthRecordExists(Integer year, Integer month) {
+        HrmInsuranceMonthRecordDO monthRecord = monthRecordMapper.selectByYearMonth(year, month);
+        if (monthRecord == null) {
+            throw exception(INSURANCE_MONTH_RECORD_NOT_EXISTS);
+        }
+        return monthRecord;
+    }
+
+    @Override
+    public HrmInsuranceMonthRecordDO validateMonthRecordEditableForUpdate(Long id) {
+        HrmInsuranceMonthRecordDO monthRecord = monthRecordMapper.selectByIdForUpdate(id);
+        if (monthRecord == null) {
+            throw exception(INSURANCE_MONTH_RECORD_NOT_EXISTS);
+        }
+        if (Objects.equals(monthRecord.getStatus(), HrmInsuranceMonthStatusEnum.ARCHIVED.getStatus())) {
+            throw exception(INSURANCE_MONTH_RECORD_ARCHIVED);
+        }
+        return monthRecord;
+    }
+
+    /**
+     * 根据员工月记录重新计算月度社保表汇总
+     *
+     * @param id 月度社保表编号
+     */
+    @Override
+    public void updateMonthRecordSummary(Long id) {
+        validateMonthRecordExists(id);
+        List<HrmInsuranceMonthEmployeeRecordDO> employeeRecords =
+                monthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(id);
+        BigDecimal personalInsuranceAmount = BigDecimal.ZERO;
+        BigDecimal personalProvidentFundAmount = BigDecimal.ZERO;
+        BigDecimal corporateInsuranceAmount = BigDecimal.ZERO;
+        BigDecimal corporateProvidentFundAmount = BigDecimal.ZERO;
+        int stoppedEmployeeCount = 0;
+        for (HrmInsuranceMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            if (Objects.equals(employeeRecord.getStatus(), HrmInsuranceEmployeeStatusEnum.STOPPED.getStatus())) {
+                stoppedEmployeeCount++;
+                continue;
+            }
+            personalInsuranceAmount = personalInsuranceAmount.add(
+                    ObjectUtil.defaultIfNull(employeeRecord.getPersonalInsuranceAmount(), BigDecimal.ZERO));
+            personalProvidentFundAmount = personalProvidentFundAmount.add(
+                    ObjectUtil.defaultIfNull(employeeRecord.getPersonalProvidentFundAmount(), BigDecimal.ZERO));
+            corporateInsuranceAmount = corporateInsuranceAmount.add(
+                    ObjectUtil.defaultIfNull(employeeRecord.getCorporateInsuranceAmount(), BigDecimal.ZERO));
+            corporateProvidentFundAmount = corporateProvidentFundAmount.add(
+                    ObjectUtil.defaultIfNull(employeeRecord.getCorporateProvidentFundAmount(), BigDecimal.ZERO));
+        }
+        monthRecordMapper.updateById(new HrmInsuranceMonthRecordDO().setId(id)
+                .setInsuredEmployeeCount(employeeRecords.size() - stoppedEmployeeCount)
+                .setStoppedEmployeeCount(stoppedEmployeeCount)
+                .setPersonalInsuranceAmount(priceScale(personalInsuranceAmount))
+                .setPersonalProvidentFundAmount(priceScale(personalProvidentFundAmount))
+                .setCorporateInsuranceAmount(priceScale(corporateInsuranceAmount))
+                .setCorporateProvidentFundAmount(priceScale(corporateProvidentFundAmount)));
+    }
+
+    private HrmInsuranceMonthRecordDO createMonthRecord(HrmInsuranceMonthRecordCreateReqVO reqVO) {
+        // 1. 校验年月唯一性
+        if (monthRecordMapper.selectByYearMonth(reqVO.getYear(), reqVO.getMonth()) != null) {
+            throw exception(INSURANCE_MONTH_RECORD_EXISTS);
+        }
+
+        // 2. 创建月度社保表
+        HrmInsuranceMonthRecordDO monthRecord = BeanUtils.toBean(reqVO, HrmInsuranceMonthRecordDO.class)
+                .setTitle(String.format(MONTH_RECORD_TITLE_TEMPLATE, reqVO.getYear(), reqVO.getMonth()))
+                .setInsuredEmployeeCount(0).setStoppedEmployeeCount(0)
+                .setStatus(HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus())
+                .setPersonalInsuranceAmount(BigDecimal.ZERO).setPersonalProvidentFundAmount(BigDecimal.ZERO)
+                .setCorporateInsuranceAmount(BigDecimal.ZERO).setCorporateProvidentFundAmount(BigDecimal.ZERO);
+        monthRecordMapper.insert(monthRecord);
+        return monthRecord;
+    }
+
+    private void computeMonthRecord(HrmInsuranceMonthRecordDO monthRecord) {
+        // 1. 生成员工月记录
+        monthEmployeeRecordService.createMonthEmployeeRecordList(monthRecord);
+        // 2. 更新月表汇总
+        updateMonthRecordSummary(monthRecord.getId());
+    }
+
+    private void archiveMonthRecord(HrmInsuranceMonthRecordDO monthRecord) {
+        monthRecordMapper.updateById(new HrmInsuranceMonthRecordDO()
+                .setId(monthRecord.getId()).setStatus(HrmInsuranceMonthStatusEnum.ARCHIVED.getStatus()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordService.java
new file mode 100644
index 0000000..771bf8c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordService.java
@@ -0,0 +1,47 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentActionRecordDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+
+import java.util.Collection;
+import java.util.List;
+
+/**
+ * HRM 员工绩效考核动作记录 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformanceAssessmentActionRecordService {
+
+    /**
+     * 创建员工绩效考核动作记录
+     *
+     * @param employeeId 操作员工编号；系统自动动作时为空
+     * @param assessmentId 员工绩效考核编号
+     * @param stageId 员工绩效考核阶段编号
+     * @param actionType 动作类型
+     * @param fileUrls 附件地址列表
+     * @param status 动作完成后的阶段状态
+     * @param contentArgs 动作内容参数
+     */
+    void createPerformanceAssessmentActionRecord(
+            Long employeeId, Long assessmentId, Long stageId,
+            HrmPerformanceAssessmentActionTypeEnum actionType,
+            List<String> fileUrls, Integer status, Object... contentArgs);
+
+    /**
+     * 获得员工绩效考核动作记录列表
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @return 动作记录列表
+     */
+    List<HrmPerformanceAssessmentActionRecordDO> getPerformanceAssessmentActionRecordList(Long assessmentId);
+
+    /**
+     * 删除员工绩效考核动作记录
+     *
+     * @param assessmentIds 员工绩效考核编号集合
+     */
+    void deletePerformanceAssessmentActionRecordList(Collection<Long> assessmentIds);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordServiceImpl.java
new file mode 100644
index 0000000..bace5b6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordServiceImpl.java
@@ -0,0 +1,53 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentActionRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentActionRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+/**
+ * HRM 员工绩效考核动作记录 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+public class HrmPerformanceAssessmentActionRecordServiceImpl
+        implements HrmPerformanceAssessmentActionRecordService {
+
+    @Resource
+    private HrmPerformanceAssessmentActionRecordMapper assessmentActionRecordMapper;
+
+    @Override
+    public void createPerformanceAssessmentActionRecord(
+            Long employeeId, Long assessmentId, Long stageId,
+            HrmPerformanceAssessmentActionTypeEnum actionType,
+            List<String> fileUrls, Integer status, Object... contentArgs) {
+        assessmentActionRecordMapper.insert(new HrmPerformanceAssessmentActionRecordDO()
+                .setAssessmentId(assessmentId).setStageId(stageId)
+                .setEmployeeId(employeeId).setType(actionType.getType())
+                .setTitle(actionType.getTitle()).setContent(actionType.formatContent(contentArgs))
+                .setFileUrls(CollUtil.isEmpty(fileUrls) ? null : fileUrls).setStatus(status));
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentActionRecordDO> getPerformanceAssessmentActionRecordList(
+            Long assessmentId) {
+        return assessmentId == null ? Collections.emptyList()
+                : assessmentActionRecordMapper.selectListByAssessmentId(assessmentId);
+    }
+
+    @Override
+    public void deletePerformanceAssessmentActionRecordList(Collection<Long> assessmentIds) {
+        if (CollUtil.isEmpty(assessmentIds)) {
+            return;
+        }
+        assessmentActionRecordMapper.deleteByAssessmentIds(assessmentIds);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessService.java
new file mode 100644
index 0000000..4aeb3d2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessService.java
@@ -0,0 +1,205 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceAppealReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceConfirmReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceHandleStageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceProcessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * HRM 绩效流程 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformanceAssessmentProcessService {
+
+    /**
+     * 初始化员工绩效考核阶段
+     *
+     * @param plan 绩效计划
+     * @param assessment 员工绩效考核
+     */
+    void initializeAssessmentStages(
+            HrmPerformancePlanDO plan, HrmPerformanceAssessmentDO assessment);
+
+    /**
+     * 激活首个绩效评分阶段
+     *
+     * @param assessment 员工绩效考核
+     * @return 激活的绩效考核阶段
+     */
+    HrmPerformanceAssessmentStageDO activateFirstReviewStage(
+            HrmPerformanceAssessmentDO assessment);
+
+    /**
+     * 激活指定类型的绩效考核阶段
+     *
+     * @param assessment 员工绩效考核
+     * @param type 阶段类型
+     * @return 激活的绩效考核阶段
+     */
+    HrmPerformanceAssessmentStageDO activateAssessmentStage(
+            HrmPerformanceAssessmentDO assessment, Integer type);
+
+    /**
+     * 获得当前用户的绩效目标确认任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @return 绩效考核阶段分页
+     */
+    PageResult<HrmPerformanceAssessmentStageDO> getMyTargetConfirmationTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO);
+
+    /**
+     * 获得当前用户的绩效结果审核任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @return 绩效考核阶段分页
+     */
+    PageResult<HrmPerformanceAssessmentStageDO> getMyResultAuditTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO);
+
+    /**
+     * 获得当前用户的绩效结果确认任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @return 绩效考核阶段分页
+     */
+    PageResult<HrmPerformanceAssessmentStageDO> getMyResultConfirmationTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO);
+
+    /**
+     * 获得当前用户的绩效申诉处理任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @return 绩效考核阶段分页
+     */
+    PageResult<HrmPerformanceAssessmentStageDO> getMyAppealTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO);
+
+    /**
+     * 获得当前用户各类绩效任务数量
+     *
+     * @param userId 用户编号
+     * @param search 绩效计划名称、员工姓名或工号
+     * @return 阶段类型、处理状态与数量的映射
+     */
+    Map<Integer, Map<Integer, Long>> getMyTaskCountMap(Long userId, String search);
+
+    /**
+     * 校验当前用户可查看指定绩效任务阶段
+     *
+     * @param userId 用户编号
+     * @param assessmentId 员工绩效考核编号
+     * @param stageId 绩效考核阶段编号
+     * @return 绩效考核阶段
+     */
+    HrmPerformanceAssessmentStageDO validateTaskStage(
+            Long userId, Long assessmentId, Long stageId);
+
+    /**
+     * 通知待处理绩效阶段的处理人
+     *
+     * @param assessment 员工绩效考核
+     * @param stage 待处理阶段
+     */
+    void notifyPendingStage(
+            HrmPerformanceAssessmentDO assessment, HrmPerformanceAssessmentStageDO stage);
+
+    /**
+     * 通知绩效流程处理结果
+     *
+     * @param assessment 员工绩效考核
+     * @param employeeIds 接收通知的员工编号列表
+     * @param actionName 处理动作名称
+     * @param result 处理结果
+     */
+    void notifyProcessResult(HrmPerformanceAssessmentDO assessment,
+                             Collection<Long> employeeIds, String actionName, String result);
+
+    /**
+     * 确认绩效目标
+     *
+     * @param userId 用户编号
+     * @param reqVO 确认信息
+     */
+    void confirmTarget(Long userId, HrmPortalPerformanceConfirmReqVO reqVO);
+
+    /**
+     * 确认绩效结果
+     *
+     * @param userId 用户编号
+     * @param reqVO 确认信息
+     */
+    void confirmResult(Long userId, HrmPortalPerformanceConfirmReqVO reqVO);
+
+    /**
+     * 提交绩效申诉
+     *
+     * @param userId 用户编号
+     * @param reqVO 申诉信息
+     * @return 流程处理结果
+     */
+    HrmPortalPerformanceProcessRespVO submitAppeal(Long userId, HrmPortalPerformanceAppealReqVO reqVO);
+
+    /**
+     * 启动绩效结果审核
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @return 流程处理结果
+     */
+    HrmPortalPerformanceProcessRespVO startResultAudit(Long assessmentId);
+
+    /**
+     * 处理绩效结果审核
+     *
+     * @param userId 用户编号
+     * @param reqVO 阶段处理信息
+     */
+    void handleResultAudit(Long userId, HrmPortalPerformanceHandleStageReqVO reqVO);
+
+    /**
+     * 处理绩效申诉
+     *
+     * @param userId 用户编号
+     * @param reqVO 阶段处理信息
+     */
+    void handleAppeal(Long userId, HrmPortalPerformanceHandleStageReqVO reqVO);
+
+    /**
+     * 刷新绩效计划的完成状态
+     *
+     * @param planId 绩效计划编号
+     */
+    void refreshPlanCompletionState(Long planId);
+
+    /**
+     * 获得超时的绩效申诉阶段列表
+     *
+     * @param deadlineTime 截止时间
+     * @return 绩效申诉阶段列表
+     */
+    List<HrmPerformanceAssessmentStageDO> getAppealTimeoutStageList(LocalDateTime deadlineTime);
+
+    /**
+     * 处理超时的绩效申诉
+     *
+     * @param stageId 绩效阶段编号
+     * @return 是否处理成功
+     */
+    boolean processAppealTimeout(Long stageId);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessServiceImpl.java
new file mode 100644
index 0000000..c65cd5c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessServiceImpl.java
@@ -0,0 +1,1368 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceAppealReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceConfirmReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceHandleStageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceProcessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentAppealRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.HandlerStage;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ReviewStage;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentAppealRecordMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaScoreMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentStageMapper;
+import cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealTimeoutActionEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentProcessStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceConfirmationResultEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanOperationTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaSettingTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceResultAuditStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ASSESSMENT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_PROCESS_CONFIG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_PROCESS_RUNNING_CANNOT_MODIFY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_REVIEW_STAGE_CONFIG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_REVIEW_STAGE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_ACTION_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_HANDLER_USER_NOT_BOUND;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_NO_PERMISSION;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_TARGET_CONFIRM_CONFIG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_TARGET_CONFIRM_NO_PERMISSION;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_APPEAL_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_APPEAL_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_APPEAL_HANDLE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_APPEAL_HANDLE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_APPEAL_TIMEOUT_HANDLE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_APPEAL_TIMEOUT_HANDLE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_CONFIRM_RESULT_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_CONFIRM_RESULT_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_CONFIRM_TARGET_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_CONFIRM_TARGET_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_RESULT_AUDIT_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_RESULT_AUDIT_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_TYPE;
+
+/**
+ * HRM 绩效流程 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmPerformanceAssessmentProcessServiceImpl
+        implements HrmPerformanceAssessmentProcessService {
+
+    @Resource
+    private HrmPerformanceAssessmentMapper assessmentMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaMapper assessmentQuotaMapper;
+    @Resource
+    private HrmPerformanceAssessmentStageMapper assessmentStageMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaScoreMapper assessmentQuotaScoreMapper;
+    @Resource
+    private HrmPerformanceAssessmentAppealRecordMapper assessmentAppealRecordMapper;
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmPerformancePlanService planService;
+    @Resource
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+
+    @Resource
+    private DeptApi deptApi;
+    @Resource
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    // ==================== 阶段管理 ====================
+
+    @Override
+    public void initializeAssessmentStages(
+            HrmPerformancePlanDO plan, HrmPerformanceAssessmentDO assessment) {
+        // 1. 校验绩效阶段是否已初始化
+        List<HrmPerformanceAssessmentStageDO> existingStages =
+                assessmentStageMapper.selectListByAssessmentId(assessment.getId());
+        if (CollUtil.isNotEmpty(existingStages)) {
+            return;
+        }
+        HrmEmployeeDO employee = employeeService.validateEmployeeExists(
+                assessment.getEmployeeId());
+
+        // 重要：收集所有阶段，统一设置阶段顺序后批量插入，避免阶段顺序不一致导致的流程异常。
+        List<HrmPerformanceAssessmentStageDO> stages = new ArrayList<>();
+
+        // 2.1 初始化指标制定、目标确认阶段
+        if (Objects.equals(plan.getQuotaSettingType(), HrmPerformanceQuotaSettingTypeEnum.EMPLOYEE.getType())) {
+            stages.add(buildAssessmentStage(assessment.getId(), HrmPerformanceStageTypeEnum.FILL_QUOTA,
+                    employee.getId()));
+        }
+        if (Boolean.TRUE.equals(plan.getTargetConfirmation())) {
+            HrmEmployeeDO handler = resolveReviewer(employee, plan.getTargetConfirmationStage());
+            if (handler == null) {
+                throw exception(PERFORMANCE_TARGET_CONFIRM_CONFIG_INVALID);
+            }
+            stages.add(buildAssessmentStage(assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM,
+                    handler.getId()));
+        }
+        // 2.2 初始化评分阶段。无法解析的评分人权重合并到相邻可执行阶段
+        List<HrmPerformanceAssessmentStageDO> reviewStages = new ArrayList<>();
+        BigDecimal carriedWeight = BigDecimal.ZERO;
+        for (ReviewStage planStage : plan.getReviewStages()) {
+            HrmEmployeeDO reviewer = resolveReviewer(employee, planStage.getRater());
+            // 特殊：无法生成可执行任务时，将权重合并到相邻阶段，保证实际评分阶段权重合计为 100%。
+            if (reviewer == null) {
+                if (CollUtil.isEmpty(reviewStages)) {
+                    carriedWeight = carriedWeight.add(planStage.getWeight());
+                } else {
+                    HrmPerformanceAssessmentStageDO lastStage = CollUtil.getLast(reviewStages);
+                    lastStage.setWeight(lastStage.getWeight().add(planStage.getWeight()));
+                }
+                continue;
+            }
+            // 同一员工命中多个评分人配置时，复用已有阶段并累计评分权重
+            HrmPerformanceAssessmentStageDO existingStage = CollUtil.findOne(reviewStages,
+                    stage -> Objects.equals(stage.getHandlerEmployeeId(), reviewer.getId()));
+            if (existingStage != null) {
+                existingStage.setWeight(existingStage.getWeight().add(planStage.getWeight()));
+                continue;
+            }
+            HrmPerformanceAssessmentStageDO assessmentStage = BeanUtils.toBean(
+                    planStage, HrmPerformanceAssessmentStageDO.class);
+            assessmentStage.setId(null).setAssessmentId(assessment.getId())
+                    .setName(StringUtils.hasText(planStage.getName())
+                            ? planStage.getName() : buildReviewName(planStage))
+                    .setRaterType(planStage.getRater().getType())
+                    .setType(Objects.equals(planStage.getRater().getType(),
+                            HrmPerformanceRaterTypeEnum.SELF.getType())
+                            ? HrmPerformanceStageTypeEnum.SELF_SCORE.getType()
+                            : HrmPerformanceStageTypeEnum.OTHER_SCORE.getType())
+                    .setHandlerEmployeeId(reviewer.getId())
+                    .setWeight(planStage.getWeight().add(carriedWeight))
+                    .setStatus(HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+            carriedWeight = BigDecimal.ZERO;
+            reviewStages.add(assessmentStage);
+        }
+        if (CollUtil.isEmpty(reviewStages)) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_CONFIG_INVALID);
+        }
+        if (carriedWeight.signum() > 0) {
+            HrmPerformanceAssessmentStageDO lastStage = CollUtil.getLast(reviewStages);
+            lastStage.setWeight(lastStage.getWeight().add(carriedWeight));
+        }
+        stages.addAll(reviewStages);
+        // 2.3 初始化结果审核、结果确认、申诉和结束阶段
+        if (Boolean.TRUE.equals(plan.getResultAudit())) {
+            addHandlerStages(stages, plan.getResultAuditStages(), assessment, employee,
+                    HrmPerformanceStageTypeEnum.RESULT_AUDIT);
+        }
+        if (Boolean.TRUE.equals(plan.getResultConfirmation())) {
+            stages.add(buildAssessmentStage(assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM,
+                    employee.getId()));
+            addHandlerStages(stages, plan.getAppealStages(), assessment, employee,
+                    HrmPerformanceStageTypeEnum.APPEAL_CONFIRM);
+        }
+        stages.add(buildAssessmentStage(assessment.getId(), HrmPerformanceStageTypeEnum.END, null));
+
+        // 3.1 校验所有必办节点处理人均已绑定后台账号
+        Set<Long> handlerEmployeeIds = convertSet(stages,
+                HrmPerformanceAssessmentStageDO::getHandlerEmployeeId, Objects::nonNull);
+        Map<Long, HrmEmployeeDO> handlerEmployeeMap = employeeService.getEmployeeMap(handlerEmployeeIds);
+        for (Long handlerEmployeeId : handlerEmployeeIds) {
+            HrmEmployeeDO handler = handlerEmployeeMap.get(handlerEmployeeId);
+            if (handler == null || handler.getUserId() == null) {
+                throw exception(PERFORMANCE_STAGE_HANDLER_USER_NOT_BOUND,
+                        handler == null ? handlerEmployeeId : handler.getName());
+            }
+        }
+        // 3.2 统一设置阶段顺序并批量插入
+        for (int i = 0; i < stages.size(); i++) {
+            stages.get(i).setSort(i + 1);
+        }
+        assessmentStageMapper.insertBatch(stages);
+    }
+
+    @Override
+    public HrmPerformanceAssessmentStageDO activateFirstReviewStage(HrmPerformanceAssessmentDO assessment) {
+        // 1. 查询待激活的首个评分阶段
+        List<HrmPerformanceAssessmentStageDO> stages = assessmentStageMapper
+                .selectListByAssessmentIdAndTypes(assessment.getId(), HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+        HrmPerformanceAssessmentStageDO stage = CollUtil.findOne(stages,
+                item -> Objects.equals(item.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        if (stage == null) {
+            stage = CollUtil.findOne(stages, item -> Objects.equals(item.getStatus(),
+                    HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus()));
+        }
+        if (stage == null) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+
+        // 2. 激活尚未处理的评分阶段
+        boolean activated = false;
+        if (Objects.equals(stage.getStatus(),
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus())) {
+            stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+            assessmentStageMapper.updateById(stage);
+            activated = true;
+        }
+
+        // 3. 同步员工绩效考核的当前阶段
+        assessment.setStageSort(stage.getSort()).setStageType(stage.getType());
+        if (activated) {
+            notifyPendingStage(assessment, stage);
+        }
+        return stage;
+    }
+
+    @Override
+    public HrmPerformanceAssessmentStageDO activateAssessmentStage(HrmPerformanceAssessmentDO assessment, Integer type) {
+        return activateStage(assessment, type, null);
+    }
+
+    // ==================== 流程处理 ====================
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentStageDO> getMyTargetConfirmationTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO) {
+        return getMyTaskPage(userId, reqVO,
+                Collections.singleton(HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType()));
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentStageDO> getMyResultAuditTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO) {
+        return getMyTaskPage(userId, reqVO,
+                Collections.singleton(HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType()));
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentStageDO> getMyResultConfirmationTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO) {
+        return getMyTaskPage(userId, reqVO,
+                Collections.singleton(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType()));
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentStageDO> getMyAppealTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO) {
+        return getMyTaskPage(userId, reqVO,
+                Collections.singleton(HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType()));
+    }
+
+    @Override
+    public Map<Integer, Map<Integer, Long>> getMyTaskCountMap(
+            Long userId, String search) {
+        HrmEmployeeDO employee = employeeService.getEmployeeByUserId(userId);
+        if (employee == null) {
+            return Collections.emptyMap();
+        }
+        return assessmentStageMapper.selectPortalTaskCountMap(employee.getId(), search);
+    }
+
+    @Override
+    public HrmPerformanceAssessmentStageDO validateTaskStage(
+            Long userId, Long assessmentId, Long stageId) {
+        // 1. 校验员工绩效考核和阶段
+        validatePerformanceAssessmentExists(assessmentId);
+        HrmPerformanceAssessmentStageDO stage = assessmentStageMapper.selectById(stageId);
+        if (stage == null || ObjUtil.notEqual(stage.getAssessmentId(), assessmentId)) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+        // 2. 校验当前账号绑定的员工是阶段处理人
+        HrmEmployeeDO employee = employeeService.getEmployeeByUserId(userId);
+        if (employee == null || ObjUtil.notEqual(stage.getHandlerEmployeeId(), employee.getId())) {
+            throw exception(PERFORMANCE_STAGE_NO_PERMISSION);
+        }
+        return stage;
+    }
+
+    @Override
+    public void notifyPendingStage(
+            HrmPerformanceAssessmentDO assessment, HrmPerformanceAssessmentStageDO stage) {
+        if (stage == null || ObjUtil.notEqual(stage.getStatus(),
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                || stage.getHandlerEmployeeId() == null) {
+            return;
+        }
+        // 1. 获得阶段处理员工和绩效计划
+        HrmEmployeeDO handler = employeeService.getEmployee(stage.getHandlerEmployeeId());
+        HrmPerformancePlanDO plan = planService.getPerformancePlan(assessment.getPlanId());
+        if (handler == null || handler.getUserId() == null || plan == null) {
+            return;
+        }
+        // 2. 发送绩效待办通知
+        Map<String, Object> templateParams = new HashMap<>();
+        templateParams.put("planName", plan.getName());
+        templateParams.put("stageName", stage.getName());
+        templateParams.put("assessmentId", assessment.getId());
+        // TODO DONE @芋艿：通知模板保留员工绩效入口，接收人进入页面后按待办页签处理。
+        templateParams.put("route", "/hrm/portal/performance/assessment");
+        notifyMessageSendApi.sendSingleMessageToAdmin(new NotifySendSingleToUserReqDTO()
+                .setUserId(handler.getUserId())
+                .setTemplateCode(MessageTemplateConstants.PERFORMANCE_TASK_PENDING)
+                .setTemplateParams(templateParams));
+    }
+
+    @Override
+    public void notifyProcessResult(HrmPerformanceAssessmentDO assessment,
+                                    Collection<Long> employeeIds, String actionName, String result) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return;
+        }
+        // 1. 批量获得接收通知的员工和绩效计划
+        Set<Long> validEmployeeIds = convertSet(employeeIds, employeeId -> employeeId,
+                Objects::nonNull);
+        if (CollUtil.isEmpty(validEmployeeIds)) {
+            return;
+        }
+        List<HrmEmployeeDO> employees = employeeService.getEmployeeListByIds(validEmployeeIds);
+        HrmPerformancePlanDO plan = planService.getPerformancePlan(assessment.getPlanId());
+        if (CollUtil.isEmpty(employees) || plan == null) {
+            return;
+        }
+
+        // 2. 发送绩效处理结果通知
+        Map<String, Object> templateParams = new HashMap<>();
+        templateParams.put("planName", plan.getName());
+        templateParams.put("actionName", actionName);
+        templateParams.put("result", result);
+        templateParams.put("assessmentId", assessment.getId());
+        // TODO DONE @芋艿：处理结果与待办共用员工绩效入口，避免维护不同阶段的临时地址。
+        templateParams.put("route", "/hrm/portal/performance/assessment");
+        for (HrmEmployeeDO employee : employees) {
+            if (employee.getUserId() == null) {
+                continue;
+            }
+            notifyMessageSendApi.sendSingleMessageToAdmin(new NotifySendSingleToUserReqDTO()
+                    .setUserId(employee.getUserId())
+                    .setTemplateCode(MessageTemplateConstants.PERFORMANCE_PROCESS_RESULT)
+                    .setTemplateParams(templateParams));
+        }
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_CONFIRM_TARGET_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_CONFIRM_TARGET_SUCCESS)
+    public void confirmTarget(Long userId, HrmPortalPerformanceConfirmReqVO reqVO) {
+        // 1. 校验目标确认阶段
+        HrmPerformanceAssessmentDO assessment = validatePerformanceAssessmentExists(reqVO.getAssessmentId());
+        validatePlanRunning(assessment);
+        validateStageType(assessment, HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType());
+        HrmPerformanceAssessmentStageDO stage = validatePendingStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(), null);
+        if (!isStageHandler(userId, stage)) {
+            throw exception(PERFORMANCE_TARGET_CONFIRM_NO_PERMISSION);
+        }
+        validateConfirmValue(reqVO.getPass(), true);
+
+        // 2. 更新目标确认结果
+        LocalDateTime currentTime = LocalDateTime.now();
+        boolean pass = Objects.equals(reqVO.getPass(), HrmPerformanceConfirmationResultEnum.PASS.getResult());
+        // 2.1 完成目标确认阶段
+        stage.setStatus(pass ? HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()
+                : HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus())
+                .setComment(reqVO.getComment()).setSubmitTime(currentTime);
+        assessmentStageMapper.updateById(stage);
+        // 2.2 根据确认结果切换员工绩效考核阶段
+        assessment.setTargetConfirmationResult(reqVO.getPass())
+                .setTargetConfirmationComment(reqVO.getComment()).setTargetConfirmationTime(currentTime);
+        if (pass) {
+            assessment.setStageType(HrmPerformanceStageTypeEnum.EXECUTING.getType());
+        } else {
+            List<HrmPerformanceAssessmentStageDO> fillStages =
+                    assessmentStageMapper.selectListByAssessmentIdAndType(
+                            assessment.getId(), HrmPerformanceStageTypeEnum.FILL_QUOTA.getType());
+            HrmPerformanceAssessmentStageDO fillStage = CollUtil.getFirst(fillStages);
+            if (fillStage == null) {
+                throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+            }
+            assessmentStageMapper.updateToResetByAssessmentIdAndType(
+                    assessment.getId(), HrmPerformanceStageTypeEnum.FILL_QUOTA.getType(),
+                    HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+            fillStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                    .setComment(null).setRejectReason(null).setSubmitTime(null).setDeadlineTime(null);
+            assessment.setStageType(HrmPerformanceStageTypeEnum.FILL_QUOTA.getType())
+                    .setStageSort(fillStage.getSort());
+            notifyPendingStage(assessment, fillStage);
+            notifyProcessResult(assessment, Collections.singleton(assessment.getEmployeeId()),
+                    "目标确认", "已驳回，请重新填写指标");
+        }
+        // 2.3 保存员工绩效考核
+        assessmentMapper.updateById(assessment);
+
+        // 3. 刷新绩效计划的完成状态
+        refreshPlanCompletionState(assessment.getPlanId());
+
+        // 4. 追加绩效动作记录
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                stage.getHandlerEmployeeId(), assessment.getId(), stage.getId(),
+                pass ? HrmPerformanceAssessmentActionTypeEnum.CONFIRM_TARGET
+                        : HrmPerformanceAssessmentActionTypeEnum.REJECT_TARGET,
+                null, stage.getStatus(), buildActionComment(reqVO.getComment()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_CONFIRM_RESULT_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_CONFIRM_RESULT_SUCCESS)
+    public void confirmResult(Long userId, HrmPortalPerformanceConfirmReqVO reqVO) {
+        // 1. 校验结果确认阶段
+        HrmPerformanceAssessmentDO assessment = validatePerformanceAssessmentExists(reqVO.getAssessmentId());
+        validatePlanRunning(assessment);
+        validateOwnAssessment(userId, assessment);
+        validateStageType(assessment, HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        validateConfirmValue(reqVO.getPass(), false);
+        HrmPerformanceAssessmentStageDO stage = validatePendingStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), null);
+
+        // 2. 完成结果确认
+        LocalDateTime currentTime = LocalDateTime.now();
+        // 2.1 完成结果确认阶段
+        stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus())
+                .setComment(reqVO.getComment()).setSubmitTime(currentTime);
+        assessmentStageMapper.updateById(stage);
+        // 2.2 关闭不再执行的申诉确认阶段
+        assessmentStageMapper.updateToProcessedByAssessmentIdAndTypeAndSortGreaterThan(
+                assessment.getId(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(), stage.getSort(),
+                currentTime);
+        // 2.3 完成绩效结束阶段
+        HrmPerformanceAssessmentStageDO endStage = completeEndStage(assessment, currentTime);
+        // 2.4 保存员工绩效考核的结束状态
+        assessment.setResultComment(reqVO.getComment()).setResultConfirmationTime(currentTime)
+                .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus())
+                .setStageType(HrmPerformanceStageTypeEnum.END.getType()).setStageSort(endStage.getSort());
+        assessmentMapper.updateById(assessment);
+
+        // 3. 刷新绩效计划的完成状态
+        refreshPlanCompletionState(assessment.getPlanId());
+
+        // 4. 追加绩效动作记录
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                stage.getHandlerEmployeeId(), assessment.getId(), stage.getId(),
+                HrmPerformanceAssessmentActionTypeEnum.CONFIRM_RESULT,
+                null, stage.getStatus(), buildActionComment(reqVO.getComment()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_APPEAL_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_APPEAL_SUCCESS)
+    public HrmPortalPerformanceProcessRespVO submitAppeal(Long userId, HrmPortalPerformanceAppealReqVO reqVO) {
+        // 1. 校验申诉条件
+        HrmPerformanceAssessmentDO assessment = validatePerformanceAssessmentExists(reqVO.getAssessmentId());
+        HrmPerformancePlanDO plan = validatePlanRunning(assessment);
+        validateOwnAssessment(userId, assessment);
+        validateStageType(assessment, HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        if (Objects.equals(assessment.getAppealStatus(), HrmPerformanceAppealStatusEnum.PENDING.getStatus())) {
+            throw exception(PERFORMANCE_PROCESS_RUNNING_CANNOT_MODIFY);
+        }
+        validateReviewStageIds(assessment.getId(), reqVO.getReviewStageIds());
+
+        // 2. 启动申诉确认阶段
+        // 2.1 标记结果确认阶段已申诉
+        HrmPerformanceAssessmentStageDO resultConfirmStage = validatePendingStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), null);
+        resultConfirmStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.APPEALED.getStatus());
+        assessmentStageMapper.updateById(resultConfirmStage);
+        // 2.2 激活首个申诉确认阶段
+        LocalDateTime currentTime = LocalDateTime.now();
+        HrmPerformanceAssessmentStageDO appealStage = activateStage(assessment,
+                HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(),
+                currentTime.plusDays(plan.getAppealTimeoutDays()));
+        // 2.3 批量保存申诉涉及的评分阶段
+        assessmentAppealRecordMapper.insertBatch(convertList(reqVO.getReviewStageIds(), reviewStageId ->
+                new HrmPerformanceAssessmentAppealRecordDO().setAssessmentId(assessment.getId())
+                        .setStageId(reviewStageId)
+                        .setStatus(HrmPerformanceAppealRecordStatusEnum.NOT_PROCESSED.getStatus())));
+        // 2.4 使用独立更新对象保存申诉信息
+        HrmPerformanceAssessmentDO updateObj = new HrmPerformanceAssessmentDO().setId(assessment.getId())
+                .setAppealReason(reqVO.getAppealReason()).setAppealFileUrls(reqVO.getAppealFileUrls())
+                .setAppealSubmitTime(currentTime).setAppealStatus(HrmPerformanceAppealStatusEnum.PENDING.getStatus())
+                .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                .setStageType(HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType())
+                .setStageSort(appealStage.getSort());
+        assessmentMapper.updateById(updateObj);
+        assessmentMapper.updateAppealResultToClearById(assessment.getId());
+
+        // 3. 刷新绩效计划的完成状态
+        refreshPlanCompletionState(assessment.getPlanId());
+
+        // 4. 追加绩效动作记录
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                assessment.getEmployeeId(), assessment.getId(), resultConfirmStage.getId(),
+                HrmPerformanceAssessmentActionTypeEnum.SUBMIT_APPEAL,
+                reqVO.getAppealFileUrls(), resultConfirmStage.getStatus(), reqVO.getAppealReason());
+        return new HrmPortalPerformanceProcessRespVO().setId(assessment.getId()).setNextStageId(appealStage.getId());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public HrmPortalPerformanceProcessRespVO startResultAudit(Long assessmentId) {
+        // 1. 初始化结果审核阶段
+        HrmPerformanceAssessmentDO assessment = validatePerformanceAssessmentExists(assessmentId);
+        HrmPerformancePlanDO plan = validatePlanRunning(assessment);
+        LocalDateTime currentTime = LocalDateTime.now();
+        // 结果审核驳回重评时保留已通过的前置审核节点，只激活首个未处理节点。
+        assessment.setStatus(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                .setStageType(HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType())
+                .setResultAuditTime(null).setResultAuditReason(null);
+
+        // 2. 根据计划配置启动首个处理节点
+        HrmPerformanceAssessmentStageDO stage;
+        if (Boolean.TRUE.equals(plan.getResultAudit())) {
+            stage = activateStage(assessment, HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(), null);
+            assessment.setResultAuditStatus(HrmPerformanceResultAuditStatusEnum.PENDING.getStatus());
+        } else {
+            assessment.setResultAuditStatus(HrmPerformanceResultAuditStatusEnum.PASS.getStatus())
+                    .setResultAuditTime(currentTime).setResultAuditReason("无需结果审核");
+            stage = completeResultAudit(plan, assessment, currentTime);
+        }
+        assessmentMapper.updateById(assessment);
+
+        // 3. 刷新绩效计划的完成状态
+        refreshPlanCompletionState(assessment.getPlanId());
+
+        // 4. 返回下一个待处理阶段
+        return new HrmPortalPerformanceProcessRespVO().setId(assessmentId)
+                .setNextStageId(stage == null ? null : stage.getId());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_RESULT_AUDIT_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_RESULT_AUDIT_SUCCESS)
+    public void handleResultAudit(Long userId, HrmPortalPerformanceHandleStageReqVO reqVO) {
+        // 1. 校验结果审核阶段
+        HrmPerformanceAssessmentDO assessment = validatePerformanceAssessmentExists(reqVO.getAssessmentId());
+        HrmPerformancePlanDO plan = validatePlanRunning(assessment);
+        validateStageType(assessment, HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        HrmPerformanceAssessmentStageDO stage = validatePendingStage(assessment.getId(),
+                HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(), reqVO.getStageId());
+        validateStageHandler(userId, stage);
+
+        // 2. 处理结果审核
+        handleResultAudit(userId, plan, assessment, stage, reqVO.getPass(), reqVO.getComment(),
+                reqVO.getReviewStageIds());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_APPEAL_HANDLE_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_APPEAL_HANDLE_SUCCESS)
+    public void handleAppeal(Long userId, HrmPortalPerformanceHandleStageReqVO reqVO) {
+        // 1. 校验申诉处理阶段
+        HrmPerformanceAssessmentDO assessment = validatePerformanceAssessmentExists(reqVO.getAssessmentId());
+        HrmPerformancePlanDO plan = validatePlanRunning(assessment);
+        validateStageType(assessment, HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType());
+        HrmPerformanceAssessmentStageDO stage = validatePendingStage(assessment.getId(),
+                HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(), reqVO.getStageId());
+        validateStageHandler(userId, stage);
+
+        // 2. 处理绩效申诉
+        handleAppeal(userId, plan, assessment, stage, reqVO.getPass(), reqVO.getComment());
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentStageDO> getAppealTimeoutStageList(LocalDateTime deadlineTime) {
+        return assessmentStageMapper.selectListByTypeAndStatusAndDeadlineTimeBeforeOrEqual(
+                HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(),
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(), deadlineTime);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_APPEAL_TIMEOUT_HANDLE_SUB_TYPE,
+            bizNo = "{{#assessment.id}}", success = HRM_PERFORMANCE_APPEAL_TIMEOUT_HANDLE_SUCCESS,
+            condition = "{{#_ret}}")
+    public boolean processAppealTimeout(Long stageId) {
+        // 1.1 校验申诉阶段仍处于待处理状态
+        HrmPerformanceAssessmentStageDO stage = assessmentStageMapper.selectOneForUpdate(
+                HrmPerformanceAssessmentStageDO::getId, stageId);
+        if (stage == null
+                || ObjUtil.notEqual(stage.getType(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType())
+                || ObjUtil.notEqual(stage.getStatus(),
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                || stage.getDeadlineTime() == null || stage.getDeadlineTime().isAfter(LocalDateTime.now())) {
+            return false;
+        }
+        // 1.2 校验员工绩效考核和绩效计划仍处于运行状态
+        HrmPerformanceAssessmentDO assessment = assessmentMapper.selectById(stage.getAssessmentId());
+        if (assessment == null || ObjUtil.notEqual(assessment.getStageType(),
+                HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType())) {
+            return false;
+        }
+        HrmPerformancePlanDO plan = planService.getPerformancePlan(assessment.getPlanId());
+        if (plan == null || ObjUtil.notEqual(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())) {
+            return false;
+        }
+
+        // 2. 根据计划的超时策略处理绩效申诉
+        boolean appealPass = Objects.equals(plan.getAppealTimeoutAction(),
+                HrmPerformanceAppealTimeoutActionEnum.APPROVE.getAction());
+        Integer pass = appealPass
+                ? HrmPerformanceConfirmationResultEnum.PASS.getResult()
+                : HrmPerformanceConfirmationResultEnum.REJECT.getResult();
+        String comment = appealPass ? "申诉确认超期，系统自动通过" : "申诉确认超期，系统自动驳回";
+        handleAppeal(null, plan, assessment, stage, pass, comment);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("assessment", assessment);
+        LogRecordContext.putVariable("appealPass", appealPass);
+        return true;
+    }
+
+    /**
+     * 处理绩效结果审核阶段
+     *
+     * @param userId 用户编号
+     * @param plan 绩效计划
+     * @param assessment 员工绩效考核
+     * @param stage 当前审核阶段
+     * @param pass 审核结果
+     * @param comment 审核意见
+     * @param reviewStageIds 需要重新评分的阶段编号列表
+     */
+    private void handleResultAudit(Long userId, HrmPerformancePlanDO plan,
+                                   HrmPerformanceAssessmentDO assessment,
+                                   HrmPerformanceAssessmentStageDO stage, Integer pass,
+                                   String comment, List<Long> reviewStageIds) {
+        // 1. 校验审核结果
+        validateConfirmValue(pass, true);
+
+        // 2. 根据审核结果推进流程或退回评分阶段
+        LocalDateTime currentTime = LocalDateTime.now();
+        if (Objects.equals(pass, HrmPerformanceConfirmationResultEnum.PASS.getResult())) {
+            stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus())
+                    .setComment(comment).setSubmitTime(currentTime);
+            assessmentStageMapper.updateById(stage);
+            HrmPerformanceAssessmentStageDO nextStage = activateNextStage(assessment, stage, null);
+            if (nextStage == null) {
+                assessment.setResultAuditStatus(HrmPerformanceResultAuditStatusEnum.PASS.getStatus())
+                        .setResultAuditTime(currentTime).setResultAuditReason(comment);
+                completeResultAudit(plan, assessment, currentTime);
+            } else {
+                assessment.setStageSort(nextStage.getSort());
+            }
+        } else {
+            validateReviewStageIds(assessment.getId(), reviewStageIds);
+            stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus())
+                    .setComment(comment).setRejectReason(comment).setSubmitTime(currentTime);
+            assessmentStageMapper.updateById(stage);
+            assessment.setResultAuditStatus(HrmPerformanceResultAuditStatusEnum.REJECT.getStatus())
+                    .setResultAuditTime(currentTime).setResultAuditReason(comment);
+            clearFinalResult(assessment);
+            List<HrmPerformanceAssessmentStageDO> reopenStages =
+                    reopenReviewStages(assessment, reviewStageIds, stage.getSort());
+            notifyProcessResult(assessment, convertSet(reopenStages,
+                            HrmPerformanceAssessmentStageDO::getHandlerEmployeeId,
+                            reviewStage -> reviewStage.getHandlerEmployeeId() != null),
+                    "结果审核", "已驳回，请重新评分");
+        }
+
+        // 3. 保存员工绩效考核并刷新计划状态
+        assessmentMapper.updateById(assessment);
+        refreshPlanCompletionState(assessment.getPlanId());
+
+        // 4. 追加绩效动作记录
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                stage.getHandlerEmployeeId(), assessment.getId(), stage.getId(),
+                Objects.equals(pass, HrmPerformanceConfirmationResultEnum.PASS.getResult())
+                        ? HrmPerformanceAssessmentActionTypeEnum.PASS_RESULT_AUDIT
+                        : HrmPerformanceAssessmentActionTypeEnum.REJECT_RESULT_AUDIT,
+                null, stage.getStatus(), buildActionComment(comment));
+    }
+
+    /**
+     * 完成绩效结果审核，并进入结果确认或结束阶段
+     *
+     * @param plan 绩效计划
+     * @param assessment 员工绩效考核
+     * @param completeTime 完成时间
+     * @return 已激活的结果确认阶段；无需立即激活时返回 {@code null}
+     */
+    private HrmPerformanceAssessmentStageDO completeResultAudit(
+            HrmPerformancePlanDO plan, HrmPerformanceAssessmentDO assessment, LocalDateTime completeTime) {
+        // 1. 配置结果确认时，切换到结果确认阶段
+        if (Boolean.TRUE.equals(plan.getResultConfirmation())) {
+            List<HrmPerformanceAssessmentStageDO> resultConfirmStages = assessmentStageMapper
+                    .selectListByAssessmentIdAndType(assessment.getId(),
+                            HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+            HrmPerformanceAssessmentStageDO resultConfirmStage = CollUtil.getFirst(resultConfirmStages);
+            if (resultConfirmStage == null) {
+                throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+            }
+            boolean interviewStarted = resultConfirmStages.stream().anyMatch(stage -> ObjUtil.notEqual(
+                    stage.getStatus(), HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus()));
+            resetProcessStages(assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+            assessment.setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                    .setStageType(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType())
+                    .setStageSort(resultConfirmStage.getSort());
+            // 申诉重评已发起过面谈，审核完成后立即重新激活结果确认阶段。
+            if (interviewStarted) {
+                return activateStage(
+                        assessment, HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), null);
+            }
+            // 首次审核完成时保持结果确认未处理，等待管理员发起绩效面谈。
+            return null;
+        }
+
+        // 2. 未配置结果确认时，直接结束员工绩效考核
+        HrmPerformanceAssessmentStageDO endStage = completeEndStage(assessment, completeTime);
+        assessment.setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus())
+                .setStageType(HrmPerformanceStageTypeEnum.END.getType()).setStageSort(endStage.getSort());
+        return null;
+    }
+
+    /**
+     * 处理绩效申诉确认阶段
+     *
+     * @param userId 用户编号；系统自动处理时为空
+     * @param plan 绩效计划
+     * @param assessment 员工绩效考核
+     * @param stage 当前申诉确认阶段
+     * @param pass 确认结果
+     * @param comment 处理意见
+     */
+    private void handleAppeal(Long userId, HrmPerformancePlanDO plan,
+                              HrmPerformanceAssessmentDO assessment,
+                              HrmPerformanceAssessmentStageDO stage, Integer pass, String comment) {
+        // 1. 校验申诉确认结果
+        validateConfirmValue(pass, true);
+
+        // 2. 根据确认结果继续下一级处理、重新评分或结束考核
+        LocalDateTime currentTime = LocalDateTime.now();
+        if (Objects.equals(pass, HrmPerformanceConfirmationResultEnum.PASS.getResult())) {
+            stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus())
+                    .setComment(comment).setSubmitTime(currentTime);
+            assessmentStageMapper.updateById(stage);
+            HrmPerformanceAssessmentStageDO nextStage = activateNextStage(assessment, stage,
+                    currentTime.plusDays(plan.getAppealTimeoutDays()));
+            if (nextStage != null) {
+                assessment.setStageSort(nextStage.getSort());
+            } else {
+                assessment.setAppealStatus(HrmPerformanceAppealStatusEnum.PASS.getStatus())
+                        .setAppealTime(currentTime).setAppealComment(comment);
+                clearFinalResult(assessment);
+                reopenReviewStages(assessment, completeAppealRecords(assessment.getId()), null);
+                notifyProcessResult(assessment, Collections.singleton(assessment.getEmployeeId()),
+                        "绩效申诉", "已通过，相关评分将重新处理");
+            }
+        } else {
+            stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus())
+                    .setComment(comment).setRejectReason(comment).setSubmitTime(currentTime);
+            assessmentStageMapper.updateById(stage);
+            assessmentStageMapper.updateToProcessedByAssessmentIdAndTypeAndSortGreaterThan(
+                    assessment.getId(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(), stage.getSort(),
+                    currentTime);
+            HrmPerformanceAssessmentStageDO endStage = completeEndStage(assessment, currentTime);
+            assessment.setAppealStatus(HrmPerformanceAppealStatusEnum.REJECT.getStatus())
+                    .setAppealTime(currentTime).setAppealComment(comment)
+                    .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus())
+                    .setStageType(HrmPerformanceStageTypeEnum.END.getType()).setStageSort(endStage.getSort());
+            completeAppealRecords(assessment.getId());
+            notifyProcessResult(assessment, Collections.singleton(assessment.getEmployeeId()),
+                    "绩效申诉", "已驳回，考核流程已结束");
+        }
+
+        // 3. 保存员工绩效考核并刷新计划状态
+        assessmentMapper.updateById(assessment);
+        refreshPlanCompletionState(assessment.getPlanId());
+
+        // 4. 追加绩效动作记录
+        boolean passed = Objects.equals(pass, HrmPerformanceConfirmationResultEnum.PASS.getResult());
+        HrmPerformanceAssessmentActionTypeEnum actionType = userId == null
+                ? (passed ? HrmPerformanceAssessmentActionTypeEnum.APPEAL_TIMEOUT_PASS
+                : HrmPerformanceAssessmentActionTypeEnum.APPEAL_TIMEOUT_REJECT)
+                : (passed ? HrmPerformanceAssessmentActionTypeEnum.PASS_APPEAL
+                : HrmPerformanceAssessmentActionTypeEnum.REJECT_APPEAL);
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                userId == null ? null : stage.getHandlerEmployeeId(), assessment.getId(), stage.getId(),
+                actionType, null, stage.getStatus(), buildActionComment(comment));
+    }
+
+    /**
+     * 构建绩效动作的处理意见内容
+     *
+     * @param comment 处理意见
+     * @return 动作内容后缀
+     */
+    private String buildActionComment(String comment) {
+        return StringUtils.hasText(comment) ? "，意见：" + comment : "";
+    }
+
+    /**
+     * 重新打开指定评分阶段
+     *
+     * @param assessment 员工绩效考核
+     * @param selectedStageIds 指定评分阶段编号列表
+     * @param resultAuditResumeSort 结果审核恢复层级；为空时重新开始结果审核
+     * @return 重新打开的评分阶段列表
+     */
+    private List<HrmPerformanceAssessmentStageDO> reopenReviewStages(
+            HrmPerformanceAssessmentDO assessment, List<Long> selectedStageIds,
+            Integer resultAuditResumeSort) {
+        // 1. 获得明确选择的已完成评分阶段
+        List<HrmPerformanceAssessmentStageDO> reviewStages = assessmentStageMapper.selectListByAssessmentIdAndTypes(
+                assessment.getId(), HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+        List<HrmPerformanceAssessmentStageDO> completedStages = filterList(reviewStages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()));
+        Set<Long> selectedIdSet = selectedStageIds == null ? Collections.emptySet() : new HashSet<>(selectedStageIds);
+        List<HrmPerformanceAssessmentStageDO> reopenStages = filterList(completedStages,
+                stage -> selectedIdSet.contains(stage.getId()));
+        HrmPerformanceAssessmentStageDO firstStage = CollUtil.getFirst(reopenStages);
+        if (firstStage == null) {
+            return Collections.emptyList();
+        }
+
+        // 2. 仅清理并重新打开选中阶段的评分结果
+        // 2.1 删除重新评分阶段的指标评分
+        List<Long> reopenStageIds = convertList(reopenStages, HrmPerformanceAssessmentStageDO::getId);
+        assessmentQuotaScoreMapper.deleteByAssessmentStageIds(reopenStageIds);
+        // 2.2 将所有选中阶段设为待处理
+        assessmentStageMapper.updateToResetByIds(reopenStageIds,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        for (HrmPerformanceAssessmentStageDO reopenStage : reopenStages) {
+            reopenStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+            notifyPendingStage(assessment, reopenStage);
+        }
+
+        // 3. 重置后续流程阶段，并以首个重新评分阶段作为当前阶段
+        if (resultAuditResumeSort == null) {
+            resetProcessStages(assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        } else {
+            assessmentStageMapper.updateToResetByAssessmentIdAndTypeAndSortGreaterThanOrEqual(
+                    assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                    resultAuditResumeSort, HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        }
+        resetProcessStages(assessment.getId(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType());
+        assessment.setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                .setStageSort(firstStage.getSort()).setStageType(firstStage.getType());
+        return reopenStages;
+    }
+
+    /**
+     * 完成员工绩效考核的待处理申诉记录
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @return 申诉涉及的评分阶段编号列表
+     */
+    private List<Long> completeAppealRecords(Long assessmentId) {
+        // 1. 查询待处理的申诉记录
+        List<HrmPerformanceAssessmentAppealRecordDO> records = assessmentAppealRecordMapper
+                .selectListByAssessmentIdAndStatus(assessmentId,
+                        HrmPerformanceAppealRecordStatusEnum.NOT_PROCESSED.getStatus());
+        if (CollUtil.isEmpty(records)) {
+            return Collections.emptyList();
+        }
+
+        // 2. 批量完成申诉记录
+        records.forEach(record -> record.setStatus(HrmPerformanceAppealRecordStatusEnum.PROCESSED.getStatus()));
+        assessmentAppealRecordMapper.updateBatch(records);
+        return convertList(records, HrmPerformanceAssessmentAppealRecordDO::getStageId);
+    }
+
+    /**
+     * 重置员工绩效考核的指定流程阶段
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @param type 阶段类型
+     */
+    private void resetProcessStages(Long assessmentId, Integer type) {
+        assessmentStageMapper.updateToResetByAssessmentIdAndType(assessmentId, type,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+    }
+
+    /**
+     * 清空员工绩效考核及指标的最终结果
+     *
+     * @param assessment 员工绩效考核
+     */
+    private void clearFinalResult(HrmPerformanceAssessmentDO assessment) {
+        // 1. 同步清空内存中的最终结果
+        assessment.setScore(null).setResultLevel(null).setCoefficient(BigDecimal.ONE)
+                .setSelfComment(null).setReviewerComment(null);
+
+        // 2. 清空员工绩效考核和指标结果
+        assessmentMapper.updateResultToClearById(assessment.getId());
+        assessmentQuotaMapper.updateReviewScoreToNullByAssessmentId(assessment.getId());
+    }
+
+    /**
+     * 完成员工绩效考核的结束阶段
+     *
+     * @param assessment 员工绩效考核
+     * @param submitTime 完成时间
+     * @return 结束阶段
+     */
+    private HrmPerformanceAssessmentStageDO completeEndStage(
+            HrmPerformanceAssessmentDO assessment, LocalDateTime submitTime) {
+        // 1. 查询结束阶段
+        List<HrmPerformanceAssessmentStageDO> stages =
+                assessmentStageMapper.selectListByAssessmentIdAndType(
+                        assessment.getId(), HrmPerformanceStageTypeEnum.END.getType());
+        HrmPerformanceAssessmentStageDO stage = CollUtil.getFirst(stages);
+        if (stage == null) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+
+        // 2. 完成结束阶段
+        stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus())
+                .setSubmitTime(submitTime);
+        assessmentStageMapper.updateById(stage);
+        return stage;
+    }
+
+    /**
+     * 添加多级处理人阶段
+     *
+     * @param stages 员工绩效考核阶段列表
+     * @param handlerStages 处理人配置列表
+     * @param assessment 员工绩效考核
+     * @param employee 被考核员工
+     * @param stageType 阶段类型
+     */
+    private void addHandlerStages(
+            List<HrmPerformanceAssessmentStageDO> stages,
+            List<HandlerStage> handlerStages, HrmPerformanceAssessmentDO assessment,
+            HrmEmployeeDO employee, HrmPerformanceStageTypeEnum stageType) {
+        // 1. 校验处理人阶段配置
+        if (CollUtil.isEmpty(handlerStages)) {
+            throw exception(PERFORMANCE_PROCESS_CONFIG_INVALID);
+        }
+
+        // 2. 解析并添加处理人阶段
+        for (int i = 0; i < handlerStages.size(); i++) {
+            HrmEmployeeDO handler = resolveReviewer(employee, handlerStages.get(i));
+            if (handler == null) {
+                throw exception(PERFORMANCE_PROCESS_CONFIG_INVALID);
+            }
+            HrmPerformanceAssessmentStageDO existingStage = CollUtil.findOne(stages,
+                    stage -> Objects.equals(stage.getType(), stageType.getType())
+                            && Objects.equals(stage.getHandlerEmployeeId(), handler.getId()));
+            if (existingStage != null) {
+                continue;
+            }
+            String name = handlerStages.size() == 1 ? stageType.getName()
+                    : stageType.getName() + "（第" + (i + 1) + "级）";
+            stages.add(buildAssessmentStage(assessment.getId(), stageType, name,
+                    handler.getId()));
+        }
+    }
+
+    private HrmPerformanceAssessmentStageDO buildAssessmentStage(
+            Long assessmentId, HrmPerformanceStageTypeEnum type,
+            Long handlerEmployeeId) {
+        return buildAssessmentStage(assessmentId, type, type.getName(), handlerEmployeeId);
+    }
+
+    private HrmPerformanceAssessmentStageDO buildAssessmentStage(
+            Long assessmentId, HrmPerformanceStageTypeEnum type, String name,
+            Long handlerEmployeeId) {
+        return new HrmPerformanceAssessmentStageDO().setAssessmentId(assessmentId)
+                .setType(type.getType()).setName(name)
+                .setHandlerEmployeeId(handlerEmployeeId)
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+    }
+
+    private String buildReviewName(ReviewStage stage) {
+        HandlerStage rater = stage.getRater();
+        if (Objects.equals(rater.getType(), HrmPerformanceRaterTypeEnum.SELF.getType())) {
+            return "员工自评";
+        }
+        if (Objects.equals(rater.getType(), HrmPerformanceRaterTypeEnum.SUPERIOR.getType())) {
+            return Objects.equals(rater.getLevel(), 1)
+                    ? "直属上级评分" : "第" + rater.getLevel() + "级上级评分";
+        }
+        if (Objects.equals(rater.getType(), HrmPerformanceRaterTypeEnum.DEPT_LEADER.getType())) {
+            return Objects.equals(rater.getLevel(), 1)
+                    ? "直属部门负责人评分" : "第" + rater.getLevel() + "级部门负责人评分";
+        }
+        HrmEmployeeDO employee = employeeService.getEmployee(rater.getEmployeeId());
+        return employee == null ? "指定员工评分" : employee.getName() + "评分";
+    }
+
+    private HrmEmployeeDO resolveReviewer(
+            HrmEmployeeDO employee, HandlerStage handlerStage) {
+        return resolveReviewer(employee, handlerStage.getType(), handlerStage.getLevel(), handlerStage.getEmployeeId());
+    }
+
+    /**
+     * 根据评分人配置解析实际处理员工
+     *
+     * @param employee 被考核员工
+     * @param raterType 评分人类型
+     * @param raterLevel 评分人层级
+     * @param raterEmployeeId 指定评分员工编号
+     * @return 实际处理人；无法解析时返回 {@code null}
+     */
+    @SuppressWarnings("ReassignedVariable")
+    private HrmEmployeeDO resolveReviewer(
+            HrmEmployeeDO employee, Integer raterType, Integer raterLevel,
+            Long raterEmployeeId) {
+        // 1. 解析员工本人或指定员工
+        if (Objects.equals(raterType, HrmPerformanceRaterTypeEnum.SELF.getType())) {
+            return employee;
+        }
+        if (Objects.equals(raterType, HrmPerformanceRaterTypeEnum.SPECIFIED.getType())) {
+            return employeeService.getEmployee(raterEmployeeId);
+        }
+
+        // 2. 按层级解析员工直属上级
+        if (Objects.equals(raterType, HrmPerformanceRaterTypeEnum.SUPERIOR.getType())) {
+            HrmEmployeeDO reviewer = employee;
+            for (int level = 0; level < ObjUtil.defaultIfNull(raterLevel, 1); level++) {
+                reviewer = reviewer.getLeaderEmployeeId() == null
+                        ? null : employeeService.getEmployee(reviewer.getLeaderEmployeeId());
+                if (reviewer == null) {
+                    return null;
+                }
+            }
+            return reviewer;
+        }
+
+        // 3. 按层级解析部门负责人
+        if (Objects.equals(raterType, HrmPerformanceRaterTypeEnum.DEPT_LEADER.getType())) {
+            Long deptId = employee.getDeptId();
+            DeptRespDTO dept = null;
+            for (int level = 0; level < ObjUtil.defaultIfNull(raterLevel, 1); level++) {
+                dept = deptId == null ? null : deptApi.getDept(deptId);
+                if (dept == null) {
+                    return null;
+                }
+                deptId = dept.getParentId();
+            }
+            if (dept.getLeaderUserId() == null) {
+                return null;
+            }
+            return employeeService.getEmployeeByUserId(dept.getLeaderUserId());
+        }
+        return null;
+    }
+
+    /**
+     * 获得当前用户指定类型的绩效任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @param types 阶段类型集合
+     * @return 员工绩效考核阶段分页
+     */
+    private PageResult<HrmPerformanceAssessmentStageDO> getMyTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO,
+            Collection<Integer> types) {
+        // 1. 根据当前登录账号查询员工
+        HrmEmployeeDO employee = employeeService.getEmployeeByUserId(userId);
+        if (employee == null) {
+            return PageResult.empty();
+        }
+        // 2. 分页查询当前员工的阶段任务
+        return assessmentStageMapper.selectPortalTaskPage(
+                reqVO, employee.getId(), types);
+    }
+
+    /**
+     * 激活员工绩效考核的指定类型阶段
+     *
+     * @param assessment 员工绩效考核
+     * @param type 阶段类型
+     * @param deadlineTime 截止时间
+     * @return 已激活的阶段
+     */
+    private HrmPerformanceAssessmentStageDO activateStage(
+            HrmPerformanceAssessmentDO assessment, Integer type, LocalDateTime deadlineTime) {
+        // 1. 查询首个可激活阶段
+        List<HrmPerformanceAssessmentStageDO> stages =
+                assessmentStageMapper.selectListByAssessmentIdAndType(assessment.getId(), type);
+        HrmPerformanceAssessmentStageDO stage = CollUtil.findOne(stages,
+                item -> ObjectUtils.equalsAny(item.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus()));
+        if (stage == null) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+
+        // 2. 激活阶段并同步员工绩效考核的当前阶段
+        stage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                .setDeadlineTime(deadlineTime).setComment(null).setRejectReason(null).setSubmitTime(null);
+        assessmentStageMapper.updateById(stage);
+        assessment.setStageType(type).setStageSort(stage.getSort());
+        notifyPendingStage(assessment, stage);
+        return stage;
+    }
+
+    /**
+     * 激活同类型的下一个员工绩效考核阶段
+     *
+     * @param assessment 员工绩效考核
+     * @param currentStage 当前阶段
+     * @param deadlineTime 截止时间
+     * @return 下一个阶段；不存在时返回 {@code null}
+     */
+    private HrmPerformanceAssessmentStageDO activateNextStage(
+            HrmPerformanceAssessmentDO assessment, HrmPerformanceAssessmentStageDO currentStage,
+            LocalDateTime deadlineTime) {
+        // 1. 查询当前阶段之后的首个未处理阶段
+        List<HrmPerformanceAssessmentStageDO> stages = assessmentStageMapper
+                .selectListByAssessmentIdAndType(assessment.getId(), currentStage.getType());
+        HrmPerformanceAssessmentStageDO nextStage = CollUtil.findOne(stages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus())
+                        && ObjUtil.defaultIfNull(stage.getSort(), 0)
+                        > ObjUtil.defaultIfNull(currentStage.getSort(), 0));
+        if (nextStage == null) {
+            return null;
+        }
+
+        // 2. 激活下一个阶段
+        nextStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                .setDeadlineTime(deadlineTime);
+        assessmentStageMapper.updateById(nextStage);
+        notifyPendingStage(assessment, nextStage);
+        return nextStage;
+    }
+
+    /**
+     * 校验并获得待处理的员工绩效考核阶段
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @param type 阶段类型
+     * @param stageId 阶段编号
+     * @return 待处理阶段
+     */
+    private HrmPerformanceAssessmentStageDO validatePendingStage(
+            Long assessmentId, Integer type, Long stageId) {
+        // 1. 查询指定类型的员工绩效考核阶段
+        List<HrmPerformanceAssessmentStageDO> stages =
+                assessmentStageMapper.selectListByAssessmentIdAndType(assessmentId, type);
+        HrmPerformanceAssessmentStageDO stage = CollUtil.findOne(stages,
+                item -> (stageId == null || Objects.equals(item.getId(), stageId))
+                        && Objects.equals(item.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+
+        // 2. 校验待处理阶段存在
+        if (stage == null) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+        HrmPerformanceAssessmentStageDO lockedStage = assessmentStageMapper.selectOneForUpdate(
+                HrmPerformanceAssessmentStageDO::getId, stage.getId());
+        if (lockedStage == null || ObjUtil.notEqual(lockedStage.getAssessmentId(), assessmentId)
+                || ObjUtil.notEqual(lockedStage.getType(), type)
+                || ObjUtil.notEqual(lockedStage.getStatus(),
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+        return lockedStage;
+    }
+
+    private void validateStageHandler(Long userId, HrmPerformanceAssessmentStageDO stage) {
+        if (!isStageHandler(userId, stage)) {
+            throw exception(PERFORMANCE_STAGE_NO_PERMISSION);
+        }
+    }
+
+    private boolean isStageHandler(Long userId, HrmPerformanceAssessmentStageDO stage) {
+        HrmEmployeeDO employee = employeeService.getEmployeeByUserId(userId);
+        return employee != null
+                && Objects.equals(stage.getHandlerEmployeeId(), employee.getId());
+    }
+
+    /**
+     * 校验重新评分的阶段编号列表
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @param reviewStageIds 评分阶段编号列表
+     */
+    private void validateReviewStageIds(Long assessmentId, List<Long> reviewStageIds) {
+        // 1. 校验评分阶段编号列表非空
+        if (CollUtil.isEmpty(reviewStageIds)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2. 校验所有评分阶段均属于当前考核且已经完成
+        List<HrmPerformanceAssessmentStageDO> stages =
+                assessmentStageMapper.selectListByAssessmentIdAndTypes(assessmentId, HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+        Set<Long> completedStageIds = convertSet(stages, HrmPerformanceAssessmentStageDO::getId,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()));
+        if (!completedStageIds.containsAll(reviewStageIds)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+    }
+
+    /**
+     * 根据全部员工绩效考核进度刷新绩效计划阶段和操作类型
+     *
+     * @param planId 绩效计划编号
+     */
+    @Override
+    public void refreshPlanCompletionState(Long planId) {
+        // 1. 校验绩效计划仍在运行
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(planId);
+        if (ObjUtil.notEqual(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())) {
+            return;
+        }
+
+        // 2. 查询计划下的员工绩效考核
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(planId);
+        if (CollUtil.isEmpty(assessments)) {
+            return;
+        }
+
+        // 3. 根据全部考核进度计算计划阶段和下一操作
+        Integer stageType = assessments.stream().map(HrmPerformanceAssessmentDO::getStageType)
+                .filter(Objects::nonNull).min(Integer::compareTo).orElse(plan.getStageType());
+        Integer operationType = null;
+        if (assessments.stream().allMatch(assessment -> Objects.equals(
+                assessment.getStageType(), HrmPerformanceStageTypeEnum.END.getType()))) {
+            stageType = HrmPerformanceStageTypeEnum.END.getType();
+            operationType = Boolean.TRUE.equals(plan.getResultConfirmation())
+                    || Objects.equals(plan.getOperationType(), HrmPerformancePlanOperationTypeEnum.ARCHIVE.getType())
+                    ? HrmPerformancePlanOperationTypeEnum.ARCHIVE.getType()
+                    : HrmPerformancePlanOperationTypeEnum.START_INTERVIEW.getType();
+        } else if (isInterviewReady(plan, assessments)) {
+            stageType = HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType();
+            operationType = HrmPerformancePlanOperationTypeEnum.START_INTERVIEW.getType();
+        } else if (assessments.stream().allMatch(assessment -> Objects.equals(
+                assessment.getStageType(), HrmPerformanceStageTypeEnum.EXECUTING.getType()))) {
+            stageType = HrmPerformanceStageTypeEnum.EXECUTING.getType();
+            operationType = HrmPerformancePlanOperationTypeEnum.START_SCORING.getType();
+        }
+
+        // 4. 更新绩效计划阶段和操作类型
+        planService.updatePerformancePlanStageTypeAndOperationType(planId, stageType, operationType);
+    }
+
+    /**
+     * 判断绩效计划是否已经可以发起结果面谈
+     *
+     * @param plan 绩效计划
+     * @param assessments 员工绩效考核列表
+     * @return 是否可以发起结果面谈
+     */
+    private boolean isInterviewReady(HrmPerformancePlanDO plan,
+                                     List<HrmPerformanceAssessmentDO> assessments) {
+        // 1. 校验计划启用结果确认
+        if (ObjUtil.notEqual(Boolean.TRUE, plan.getResultConfirmation())) {
+            return false;
+        }
+
+        // 2. 校验全部考核已完成结果审核并等待结果确认
+        boolean assessmentReady = assessments.stream().allMatch(assessment ->
+                Objects.equals(assessment.getStageType(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType())
+                        && (ObjUtil.notEqual(Boolean.TRUE, plan.getResultAudit()) || Objects.equals(
+                        assessment.getResultAuditStatus(), HrmPerformanceResultAuditStatusEnum.PASS.getStatus())));
+        if (!assessmentReady) {
+            return false;
+        }
+
+        // 3. 校验全部结果确认阶段尚未开始
+        Set<Long> assessmentIds = convertSet(assessments, HrmPerformanceAssessmentDO::getId);
+        List<HrmPerformanceAssessmentStageDO> stages =
+                assessmentStageMapper.selectListByAssessmentIds(assessmentIds);
+        Set<Long> waitingAssessmentIds = convertSet(stages,
+                HrmPerformanceAssessmentStageDO::getAssessmentId,
+                stage -> Objects.equals(stage.getType(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType())
+                        && Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus()));
+        return waitingAssessmentIds.containsAll(assessmentIds);
+    }
+
+    private void validateConfirmValue(Integer pass, boolean allowReject) {
+        if (Objects.equals(pass, HrmPerformanceConfirmationResultEnum.PASS.getResult())) {
+            return;
+        }
+        if (allowReject && Objects.equals(pass, HrmPerformanceConfirmationResultEnum.REJECT.getResult())) {
+            return;
+        }
+        throw exception(PERFORMANCE_DATA_ILLEGAL);
+    }
+
+    private void validateStageType(HrmPerformanceAssessmentDO assessment, Integer expectedType) {
+        if (ObjUtil.notEqual(assessment.getStageType(), expectedType)) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+    }
+
+    private HrmPerformancePlanDO validatePlanRunning(HrmPerformanceAssessmentDO assessment) {
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(assessment.getPlanId());
+        if (ObjUtil.notEqual(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+        return plan;
+    }
+
+    private HrmPerformancePlanDO validatePerformancePlanExists(Long id) {
+        return planService.validatePerformancePlanExists(id);
+    }
+
+    private HrmPerformanceAssessmentDO validatePerformanceAssessmentExists(Long id) {
+        HrmPerformanceAssessmentDO assessment = assessmentMapper.selectById(id);
+        if (assessment == null) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        return assessment;
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    private HrmEmployeeDO validateOwnAssessment(Long userId, HrmPerformanceAssessmentDO assessment) {
+        HrmEmployeeDO employee = employeeService.getEmployee(assessment.getEmployeeId());
+        if (employee == null || ObjUtil.notEqual(employee.getUserId(), userId)) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        return employee;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryService.java
new file mode 100644
index 0000000..1606435
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryService.java
@@ -0,0 +1,126 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceProcessRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+
+import java.util.List;
+
+/**
+ * HRM 员工绩效考核查询 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformanceAssessmentQueryService {
+
+    /**
+     * 获得员工绩效考核响应
+     *
+     * @param assessment 员工绩效考核
+     * @return 员工绩效考核响应
+     */
+    HrmPerformanceAssessmentRespVO getPerformanceAssessmentRespVO(HrmPerformanceAssessmentDO assessment);
+
+    /**
+     * 获得员工绩效考核分页响应
+     *
+     * @param pageResult 员工绩效考核分页
+     * @return 员工绩效考核分页响应
+     */
+    PageResult<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentRespVOPage(
+            PageResult<HrmPerformanceAssessmentDO> pageResult);
+
+    /**
+     * 获得员工绩效考核响应列表
+     *
+     * @param assessments 员工绩效考核列表
+     * @return 员工绩效考核响应列表
+     */
+    List<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentRespVOList(
+            List<HrmPerformanceAssessmentDO> assessments);
+
+    /**
+     * 获得当前用户可操作的员工绩效考核响应
+     *
+     * @param assessment 员工绩效考核
+     * @param userId 用户编号
+     * @return 员工绩效考核响应
+     */
+    HrmPerformanceAssessmentRespVO getPerformanceAssessmentProcessRespVO(
+            HrmPerformanceAssessmentDO assessment, Long userId);
+
+    /**
+     * 获得当前用户可操作的员工绩效考核响应列表
+     *
+     * @param assessments 员工绩效考核列表
+     * @param userId 用户编号
+     * @return 员工绩效考核响应列表
+     */
+    List<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentProcessRespVOList(
+            List<HrmPerformanceAssessmentDO> assessments, Long userId);
+
+    /**
+     * 获得绩效任务响应
+     *
+     * @param assessment 员工绩效考核
+     * @param stageId 任务阶段编号
+     * @param userId 用户编号
+     * @return 员工绩效考核响应
+     */
+    HrmPerformanceAssessmentRespVO getPerformanceAssessmentTaskRespVO(
+            HrmPerformanceAssessmentDO assessment, Long stageId, Long userId);
+
+    /**
+     * 获得绩效任务响应列表
+     *
+     * @param assessments 员工绩效考核列表
+     * @param stageIds 任务阶段编号列表
+     * @param userId 用户编号
+     * @return 员工绩效考核响应列表
+     */
+    List<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentTaskRespVOList(
+            List<HrmPerformanceAssessmentDO> assessments, List<Long> stageIds, Long userId);
+
+    /**
+     * 获得绩效任务分页响应
+     *
+     * @param pageResult 绩效阶段任务分页
+     * @param userId 用户编号
+     * @return 绩效任务分页响应
+     */
+    PageResult<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentTaskRespVOPage(
+            PageResult<HrmPerformanceAssessmentStageDO> pageResult, Long userId);
+
+    /**
+     * 获得绩效流程记录列表
+     *
+     * @param assessment 员工绩效考核
+     * @return 绩效流程记录列表
+     */
+    List<HrmPerformanceProcessRecordRespVO> getPerformanceAssessmentProcessRecordList(
+            HrmPerformanceAssessmentDO assessment);
+
+    /**
+     * 获得员工端可见的绩效流程记录列表
+     *
+     * @param assessment 员工绩效考核
+     * @param userId 用户编号
+     * @return 绩效流程记录列表
+     */
+    List<HrmPerformanceProcessRecordRespVO> getPerformanceAssessmentProcessRecordList(
+            HrmPerformanceAssessmentDO assessment, Long userId);
+
+    /**
+     * 获得员工绩效档案分页响应
+     *
+     * @param pageResult 员工分页
+     * @return 员工绩效档案分页响应
+     */
+    PageResult<HrmPerformanceArchiveEmployeeRespVO> getPerformanceArchiveEmployeeRespVOPage(
+            PageResult<HrmEmployeeDO> pageResult);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryServiceImpl.java
new file mode 100644
index 0000000..0a2666e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryServiceImpl.java
@@ -0,0 +1,555 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.MapUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeeRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentDimensionRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentQuotaRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentQuotaScoreRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentStageRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceProcessRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentActionRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentAppealRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDimensionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewVisibleContentEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+
+/**
+ * HRM 员工绩效考核查询 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+public class HrmPerformanceAssessmentQueryServiceImpl
+        implements HrmPerformanceAssessmentQueryService {
+
+    private static final String PROCESS_RECORD_SOURCE_ACTION = "ACTION";
+
+    @Resource
+    private HrmPerformanceAssessmentService assessmentService;
+    @Resource
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+    @Resource
+    private HrmPerformancePlanService planService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    public HrmPerformanceAssessmentRespVO getPerformanceAssessmentRespVO(HrmPerformanceAssessmentDO assessment) {
+        if (assessment == null) {
+            return null;
+        }
+        List<HrmPerformanceAssessmentRespVO> respVOList =
+                getPerformanceAssessmentRespVOList(Collections.singletonList(assessment));
+        return CollUtil.getFirst(respVOList);
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentRespVOPage(
+            PageResult<HrmPerformanceAssessmentDO> pageResult) {
+        return new PageResult<>(getPerformanceAssessmentRespVOList(pageResult.getList()), pageResult.getTotal());
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentRespVOList(
+            List<HrmPerformanceAssessmentDO> assessments) {
+        if (CollUtil.isEmpty(assessments)) {
+            return Collections.emptyList();
+        }
+
+        // 1.1 绩效计划信息
+        Set<Long> planIds = convertSet(assessments, HrmPerformanceAssessmentDO::getPlanId);
+        Map<Long, HrmPerformancePlanDO> planMap = planService.getPerformancePlanMap(planIds);
+        // 1.2 维度和指标信息
+        Set<Long> assessmentIds = convertSet(assessments, HrmPerformanceAssessmentDO::getId);
+        List<HrmPerformanceAssessmentDimensionDO> dimensions =
+                assessmentService.getPerformanceAssessmentDimensionList(assessmentIds);
+        Map<Long, List<HrmPerformanceAssessmentDimensionDO>> dimensionMap =
+                convertMultiMap(dimensions, HrmPerformanceAssessmentDimensionDO::getAssessmentId);
+        Map<Long, HrmPerformanceAssessmentDimensionDO> dimensionDetailMap =
+                convertMap(dimensions, HrmPerformanceAssessmentDimensionDO::getId);
+        List<HrmPerformanceAssessmentQuotaDO> quotas =
+                assessmentService.getPerformanceAssessmentQuotaList(assessmentIds);
+        Map<Long, List<HrmPerformanceAssessmentQuotaDO>> quotaMap =
+                convertMultiMap(quotas, HrmPerformanceAssessmentQuotaDO::getAssessmentId);
+        // 1.3 流程阶段和评分信息
+        List<HrmPerformanceAssessmentStageDO> assessmentStages =
+                assessmentService.getPerformanceAssessmentStageList(assessmentIds);
+        Map<Long, List<HrmPerformanceAssessmentStageDO>> assessmentStageMap =
+                convertMultiMap(assessmentStages, HrmPerformanceAssessmentStageDO::getAssessmentId);
+        List<HrmPerformanceAssessmentQuotaScoreDO> quotaScores =
+                assessmentService.getPerformanceAssessmentQuotaScoreList(
+                        convertSet(assessmentStages, HrmPerformanceAssessmentStageDO::getId));
+        Map<Long, List<HrmPerformanceAssessmentQuotaScoreDO>> quotaScoreMap =
+                convertMultiMap(quotaScores, HrmPerformanceAssessmentQuotaScoreDO::getAssessmentStageId);
+        // 1.4 员工和部门信息
+        Set<Long> employeeIds = new HashSet<>(convertSet(assessments, HrmPerformanceAssessmentDO::getEmployeeId));
+        employeeIds.addAll(convertSet(assessmentStages, HrmPerformanceAssessmentStageDO::getHandlerEmployeeId));
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(employeeMap.values(), HrmEmployeeDO::getDeptId));
+
+        // 2. 拼接响应
+        return convertList(assessments, assessment -> {
+            HrmPerformanceAssessmentRespVO respVO = BeanUtils.toBean(assessment, HrmPerformanceAssessmentRespVO.class);
+            buildPlanInfo(respVO, planMap.get(assessment.getPlanId()));
+            buildEmployeeInfo(respVO, employeeMap.get(assessment.getEmployeeId()), deptMap);
+            respVO.setCanConfirmTarget(false);
+            respVO.setDimensions(BeanUtils.toBean(dimensionMap.getOrDefault(
+                    assessment.getId(), Collections.emptyList()),
+                    HrmPerformanceAssessmentDimensionRespVO.class));
+            respVO.setQuotas(BeanUtils.toBean(quotaMap.getOrDefault(
+                    assessment.getId(), Collections.emptyList()),
+                    HrmPerformanceAssessmentQuotaRespVO.class, quotaRespVO -> {
+                        MapUtils.findAndThen(dimensionDetailMap, quotaRespVO.getDimensionId(), dimension ->
+                            quotaRespVO.setDimensionName(dimension.getName())
+                                    .setDimensionWeight(dimension.getWeight())
+                                    .setAllowEdit(dimension.getAllowEdit()));
+                    }));
+            buildStageInfo(respVO, assessment, assessmentStageMap.getOrDefault(
+                    assessment.getId(), Collections.emptyList()), quotaScoreMap, employeeMap);
+            return respVO;
+        });
+    }
+
+    @Override
+    public HrmPerformanceAssessmentRespVO getPerformanceAssessmentProcessRespVO(
+            HrmPerformanceAssessmentDO assessment, Long userId) {
+        if (assessment == null) {
+            return null;
+        }
+        List<HrmPerformanceAssessmentRespVO> respVOList =
+                getPerformanceAssessmentProcessRespVOList(Collections.singletonList(assessment), userId);
+        return CollUtil.getFirst(respVOList);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentProcessRespVOList(
+            List<HrmPerformanceAssessmentDO> assessments, Long userId) {
+        List<HrmPerformanceAssessmentRespVO> result = getPerformanceAssessmentRespVOList(assessments);
+        if (CollUtil.isEmpty(result)) {
+            return result;
+        }
+        Set<Long> assessmentIds = convertSet(assessments, HrmPerformanceAssessmentDO::getId);
+        List<HrmPerformanceAssessmentAppealRecordDO> appealRecords =
+                assessmentService.getPerformanceAssessmentAppealRecordList(
+                        assessmentIds, HrmPerformanceAppealRecordStatusEnum.NOT_PROCESSED.getStatus());
+        Map<Long, List<HrmPerformanceAssessmentAppealRecordDO>> appealRecordMap =
+                convertMultiMap(appealRecords, HrmPerformanceAssessmentAppealRecordDO::getAssessmentId);
+        HrmEmployeeDO currentEmployee = employeeService.getEmployeeByUserId(userId);
+        Long currentEmployeeId = currentEmployee == null ? null : currentEmployee.getId();
+        for (HrmPerformanceAssessmentRespVO respVO : result) {
+            List<HrmPerformanceAssessmentAppealRecordDO> assessmentAppealRecords =
+                    appealRecordMap.getOrDefault(respVO.getId(), Collections.emptyList());
+            markStageAccess(respVO, currentEmployeeId, assessmentAppealRecords);
+            HrmPerformanceAssessmentStageRespVO viewerReviewStage = findReviewStageRespVOByHandler(
+                    respVO.getReviewStages(), currentEmployeeId);
+            if (viewerReviewStage != null) {
+                filterReviewVisibility(respVO, viewerReviewStage);
+            }
+        }
+        return result;
+    }
+
+    @Override
+    public HrmPerformanceAssessmentRespVO getPerformanceAssessmentTaskRespVO(
+            HrmPerformanceAssessmentDO assessment, Long stageId, Long userId) {
+        if (assessment == null) {
+            return null;
+        }
+        List<HrmPerformanceAssessmentRespVO> respVOList = getPerformanceAssessmentTaskRespVOList(
+                Collections.singletonList(assessment), Collections.singletonList(stageId), userId);
+        return CollUtil.getFirst(respVOList);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentTaskRespVOList(
+            List<HrmPerformanceAssessmentDO> assessments, List<Long> stageIds, Long userId) {
+        List<HrmPerformanceAssessmentRespVO> result = getPerformanceAssessmentRespVOList(assessments);
+        if (CollUtil.isEmpty(result)) {
+            return result;
+        }
+        Set<Long> assessmentIds = convertSet(assessments, HrmPerformanceAssessmentDO::getId);
+        List<HrmPerformanceAssessmentAppealRecordDO> appealRecords =
+                assessmentService.getPerformanceAssessmentAppealRecordList(
+                        assessmentIds, HrmPerformanceAppealRecordStatusEnum.NOT_PROCESSED.getStatus());
+        Map<Long, List<HrmPerformanceAssessmentAppealRecordDO>> appealRecordMap =
+                convertMultiMap(appealRecords, HrmPerformanceAssessmentAppealRecordDO::getAssessmentId);
+        HrmEmployeeDO currentEmployee = employeeService.getEmployeeByUserId(userId);
+        Long currentEmployeeId = currentEmployee == null ? null : currentEmployee.getId();
+        for (int i = 0; i < result.size(); i++) {
+            HrmPerformanceAssessmentRespVO respVO = result.get(i);
+            HrmPerformanceAssessmentStageRespVO selectedStage = markTaskStageAccess(
+                    respVO, currentEmployeeId, stageIds.get(i),
+                    appealRecordMap.getOrDefault(respVO.getId(), Collections.emptyList()));
+            if (selectedStage != null && HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(selectedStage.getType())) {
+                filterReviewVisibility(respVO, selectedStage);
+            }
+        }
+        return result;
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentRespVO> getPerformanceAssessmentTaskRespVOPage(
+            PageResult<HrmPerformanceAssessmentStageDO> pageResult, Long userId) {
+        List<HrmPerformanceAssessmentStageDO> stages = pageResult.getList();
+        if (CollUtil.isEmpty(stages)) {
+            return PageResult.empty(pageResult.getTotal());
+        }
+
+        // 1. 批量查询任务关联的绩效考核，并过滤已不存在的考核
+        Map<Long, HrmPerformanceAssessmentDO> assessmentMap = assessmentService.getPerformanceAssessmentMap(
+                convertSet(stages, HrmPerformanceAssessmentStageDO::getAssessmentId));
+        List<HrmPerformanceAssessmentStageDO> validStages = filterList(stages,
+                stage -> assessmentMap.containsKey(stage.getAssessmentId()));
+
+        // 2. 按任务顺序拼接可操作的绩效考核响应
+        List<HrmPerformanceAssessmentRespVO> respVOList = getPerformanceAssessmentTaskRespVOList(
+                convertList(validStages, stage -> assessmentMap.get(stage.getAssessmentId())),
+                convertList(validStages, HrmPerformanceAssessmentStageDO::getId), userId);
+        return new PageResult<>(respVOList, pageResult.getTotal());
+    }
+
+    @Override
+    public List<HrmPerformanceProcessRecordRespVO> getPerformanceAssessmentProcessRecordList(
+            HrmPerformanceAssessmentDO assessment) {
+        return getPerformanceAssessmentProcessRecordList(assessment, null, false);
+    }
+
+    @Override
+    public List<HrmPerformanceProcessRecordRespVO> getPerformanceAssessmentProcessRecordList(
+            HrmPerformanceAssessmentDO assessment, Long userId) {
+        return getPerformanceAssessmentProcessRecordList(assessment, userId, true);
+    }
+
+    private List<HrmPerformanceProcessRecordRespVO> getPerformanceAssessmentProcessRecordList(
+            HrmPerformanceAssessmentDO assessment, Long userId, boolean filterVisibility) {
+        if (assessment == null) {
+            return Collections.emptyList();
+        }
+        // 1. 查询追加式动作记录和操作员工
+        List<HrmPerformanceAssessmentActionRecordDO> actionRecords = assessmentActionRecordService
+                .getPerformanceAssessmentActionRecordList(assessment.getId());
+        if (filterVisibility) {
+            HrmEmployeeDO currentEmployee = employeeService.getEmployeeByUserId(userId);
+            Long currentEmployeeId = currentEmployee == null ? null : currentEmployee.getId();
+            HrmPerformanceAssessmentStageDO viewerReviewStage = findReviewStageDOByHandler(
+                    assessmentService.getPerformanceAssessmentStageList(
+                            Collections.singleton(assessment.getId())), currentEmployeeId);
+            if (isReviewContentRestricted(viewerReviewStage)) {
+                actionRecords = filterList(actionRecords, actionRecord ->
+                        ObjUtil.notEqual(actionRecord.getType(),
+                                HrmPerformanceAssessmentActionTypeEnum.SCORE.getType())
+                                || Objects.equals(actionRecord.getEmployeeId(), currentEmployeeId));
+            }
+        }
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(actionRecords, HrmPerformanceAssessmentActionRecordDO::getEmployeeId));
+
+        // 2. 拼接追加式动作并按操作时间排序
+        List<HrmPerformanceProcessRecordRespVO> records = new ArrayList<>();
+        addActionRecords(records, actionRecords, employeeMap);
+        records.sort(Comparator.comparing(HrmPerformanceProcessRecordRespVO::getOperateTime,
+                Comparator.nullsLast(Comparator.naturalOrder())));
+        return records;
+    }
+
+    @Override
+    public PageResult<HrmPerformanceArchiveEmployeeRespVO> getPerformanceArchiveEmployeeRespVOPage(
+            PageResult<HrmEmployeeDO> pageResult) {
+        return new PageResult<>(buildArchiveEmployeeRespVOList(pageResult.getList()), pageResult.getTotal());
+    }
+
+    /**
+     * 添加追加式绩效动作记录
+     *
+     * @param records 流程记录列表
+     * @param actionRecords 动作记录列表
+     * @param employeeMap 员工 Map
+     */
+    private void addActionRecords(
+            List<HrmPerformanceProcessRecordRespVO> records,
+            List<HrmPerformanceAssessmentActionRecordDO> actionRecords,
+            Map<Long, HrmEmployeeDO> employeeMap) {
+        for (HrmPerformanceAssessmentActionRecordDO actionRecord : actionRecords) {
+            records.add(new HrmPerformanceProcessRecordRespVO()
+                    .setTitle(actionRecord.getTitle())
+                    .setContent(actionRecord.getContent())
+                    .setSource(PROCESS_RECORD_SOURCE_ACTION).setStatus(actionRecord.getStatus())
+                    .setOperatorName(getEmployeeName(employeeMap, actionRecord.getEmployeeId()))
+                    .setOperateTime(actionRecord.getCreateTime()).setFileUrls(actionRecord.getFileUrls()));
+        }
+    }
+
+    private String getEmployeeName(Map<Long, HrmEmployeeDO> employeeMap, Long employeeId) {
+        HrmEmployeeDO employee = employeeMap.get(employeeId);
+        return employee == null ? null : employee.getName();
+    }
+
+    private List<HrmPerformanceArchiveEmployeeRespVO> buildArchiveEmployeeRespVOList(
+            List<HrmEmployeeDO> employees) {
+        if (CollUtil.isEmpty(employees)) {
+            return Collections.emptyList();
+        }
+        // 1.1 归档考核信息
+        List<HrmPerformanceAssessmentDO> assessments =
+                assessmentService.getPerformanceAssessmentListByEmployeeIdsAndStatus(
+                        convertSet(employees, HrmEmployeeDO::getId),
+                        HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+        Map<Long, List<HrmPerformanceAssessmentDO>> assessmentMap =
+                convertMultiMap(assessments, HrmPerformanceAssessmentDO::getEmployeeId);
+        // 1.2 绩效计划信息
+        Map<Long, HrmPerformancePlanDO> planMap =
+                planService.getPerformancePlanMap(convertSet(assessments, HrmPerformanceAssessmentDO::getPlanId));
+        // 1.3 部门信息
+        Map<Long, DeptRespDTO> deptMap = deptApi.getDeptMap(
+                convertSet(employees, HrmEmployeeDO::getDeptId));
+
+        // 2. 拼接响应
+        return convertList(employees, employee -> {
+            HrmPerformanceArchiveEmployeeRespVO respVO = BeanUtils.toBean(
+                    employee, HrmPerformanceArchiveEmployeeRespVO.class);
+            respVO.setEmployeeId(employee.getId()).setEmployeeName(employee.getName())
+                    .setEmployeeStatus(employee.getStatus()).setEmployeeType(employee.getType());
+            MapUtils.findAndThen(deptMap, employee.getDeptId(), dept -> respVO.setDeptName(dept.getName()));
+            List<HrmPerformanceAssessmentDO> employeeAssessments = assessmentMap.getOrDefault(
+                    employee.getId(), Collections.emptyList());
+            respVO.setAssessmentCount((long) employeeAssessments.size());
+            HrmPerformanceAssessmentDO latestAssessment = CollUtil.getFirst(employeeAssessments);
+            if (latestAssessment != null) {
+                respVO.setLatestAssessmentId(latestAssessment.getId())
+                        .setLatestScore(latestAssessment.getScore())
+                        .setLatestResultLevel(latestAssessment.getResultLevel());
+                MapUtils.findAndThen(planMap, latestAssessment.getPlanId(),
+                        plan -> respVO.setLatestPlanName(plan.getName()));
+            }
+            return respVO;
+        });
+    }
+
+    private void buildPlanInfo(HrmPerformanceAssessmentRespVO respVO, HrmPerformancePlanDO plan) {
+        if (plan == null) {
+            return;
+        }
+        respVO.setName(plan.getName()).setCycleType(plan.getCycleType()).setCycle(plan.getCycle())
+                .setStartTime(plan.getStartTime()).setEndTime(plan.getEndTime());
+        if (plan.getAssessmentConfig() != null) {
+            respVO.setUpperLimitScore(plan.getAssessmentConfig().getUpperLimitScore());
+        }
+    }
+
+    private void buildEmployeeInfo(HrmPerformanceAssessmentRespVO respVO, HrmEmployeeDO employee,
+                                   Map<Long, DeptRespDTO> deptMap) {
+        if (employee == null) {
+            return;
+        }
+        respVO.setEmployeeName(employee.getName()).setJobNumber(employee.getJobNumber())
+                .setMobile(employee.getMobile()).setDeptId(employee.getDeptId())
+                .setPostName(employee.getPostName()).setEmployeeType(employee.getType())
+                .setEmployeeStatus(employee.getStatus());
+        MapUtils.findAndThen(deptMap, employee.getDeptId(), dept -> respVO.setDeptName(dept.getName()));
+    }
+
+    private void buildStageInfo(HrmPerformanceAssessmentRespVO respVO,
+                                HrmPerformanceAssessmentDO assessment,
+                                List<HrmPerformanceAssessmentStageDO> assessmentStages,
+                                Map<Long, List<HrmPerformanceAssessmentQuotaScoreDO>> quotaScoreMap,
+                                Map<Long, HrmEmployeeDO> employeeMap) {
+        List<HrmPerformanceAssessmentStageRespVO> stageRespVOs = convertList(assessmentStages, assessmentStage -> {
+            HrmPerformanceAssessmentStageRespVO stageRespVO = BeanUtils.toBean(
+                    assessmentStage, HrmPerformanceAssessmentStageRespVO.class);
+            MapUtils.findAndThen(employeeMap, assessmentStage.getHandlerEmployeeId(),
+                    handler -> stageRespVO.setHandlerName(handler.getName()));
+            stageRespVO.setCanHandle(false).setCanScore(false);
+            stageRespVO.setQuotaScoreList(BeanUtils.toBean(quotaScoreMap.getOrDefault(
+                    assessmentStage.getId(), Collections.emptyList()),
+                    HrmPerformanceAssessmentQuotaScoreRespVO.class));
+            return stageRespVO;
+        });
+        respVO.setStages(stageRespVOs);
+        respVO.setCurrentStage(CollUtil.findOne(stageRespVOs,
+                stage -> Objects.equals(stage.getType(), assessment.getStageType())
+                        && Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())));
+        List<HrmPerformanceAssessmentStageRespVO> reviewStageRespVOs =
+                filterList(stageRespVOs, stage -> HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(stage.getType()));
+        respVO.setReviewStages(reviewStageRespVOs);
+        respVO.setCurrentReviewStage(respVO.getCurrentStage() != null
+                && HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(respVO.getCurrentStage().getType())
+                ? respVO.getCurrentStage() : null);
+        HrmPerformanceAssessmentStageRespVO targetStage = CollUtil.findOne(stageRespVOs,
+                stage -> Objects.equals(stage.getType(),
+                        HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType()));
+        respVO.setTargetConfirmationEmployeeName(targetStage == null ? null : targetStage.getHandlerName());
+        respVO.setCurrentHandlerName(resolveCurrentHandlerName(respVO, assessment, employeeMap));
+    }
+
+    /**
+     * 标记员工绩效流程的当前处理权限
+     *
+     * @param respVO 绩效考核响应
+     * @param employeeId 员工编号
+     * @param appealRecords 待处理申诉记录
+     */
+    private void markStageAccess(HrmPerformanceAssessmentRespVO respVO, Long employeeId,
+                                 List<HrmPerformanceAssessmentAppealRecordDO> appealRecords) {
+        // 1. 标记当前用户可处理的阶段
+        HrmPerformanceAssessmentStageRespVO currentStage = null;
+        for (HrmPerformanceAssessmentStageRespVO stage : respVO.getStages()) {
+            boolean canHandle = Objects.equals(stage.getStatus(),
+                    HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                    && employeeId != null
+                    && Objects.equals(stage.getHandlerEmployeeId(), employeeId);
+            stage.setCanHandle(canHandle).setCanScore(canHandle && HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(stage.getType()));
+            if (canHandle) {
+                currentStage = stage;
+            }
+        }
+        // 2. 设置当前阶段和对应操作权限
+        respVO.setCurrentStage(currentStage);
+        respVO.setCurrentReviewStage(currentStage != null && HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(currentStage.getType())
+                ? currentStage : null);
+        respVO.setCanConfirmTarget(currentStage != null
+                && Objects.equals(currentStage.getType(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType()));
+        if (currentStage != null
+                && Objects.equals(currentStage.getType(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType())) {
+            respVO.setAppealReviewStageIds(convertList(
+                    appealRecords, HrmPerformanceAssessmentAppealRecordDO::getStageId));
+        }
+    }
+
+    /**
+     * 标记指定绩效任务的处理权限
+     *
+     * @param respVO 绩效考核响应
+     * @param employeeId 员工编号
+     * @param stageId 任务阶段编号
+     * @param appealRecords 待处理申诉记录
+     * @return 指定的任务阶段
+     */
+    private HrmPerformanceAssessmentStageRespVO markTaskStageAccess(
+            HrmPerformanceAssessmentRespVO respVO, Long employeeId, Long stageId,
+            List<HrmPerformanceAssessmentAppealRecordDO> appealRecords) {
+        // 1. 标记各阶段的处理和评分权限，并定位当前任务阶段
+        HrmPerformanceAssessmentStageRespVO selectedStage = null;
+        for (HrmPerformanceAssessmentStageRespVO stage : respVO.getStages()) {
+            boolean canHandle = Objects.equals(stage.getStatus(),
+                    HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                    && employeeId != null
+                    && Objects.equals(stage.getHandlerEmployeeId(), employeeId);
+            stage.setCanHandle(canHandle).setCanScore(canHandle && HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(stage.getType()));
+            if (Objects.equals(stage.getId(), stageId)) {
+                selectedStage = stage;
+            }
+        }
+        respVO.setCurrentStage(selectedStage);
+
+        // 2. 设置评分、目标确认和申诉处理信息
+        respVO.setCurrentReviewStage(selectedStage != null
+                && HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(selectedStage.getType()) ? selectedStage : null);
+        respVO.setCanConfirmTarget(selectedStage != null && Boolean.TRUE.equals(selectedStage.getCanHandle())
+                && Objects.equals(selectedStage.getType(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType()));
+        if (selectedStage != null && Objects.equals(
+                selectedStage.getType(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType())) {
+            respVO.setAppealReviewStageIds(convertList(
+                    appealRecords, HrmPerformanceAssessmentAppealRecordDO::getStageId));
+        }
+        return selectedStage;
+    }
+
+    /**
+     * 根据评分阶段的可见范围过滤其他评分结果
+     *
+     * @param respVO 绩效考核响应
+     * @param selectedStage 评分阶段
+     */
+    private void filterReviewVisibility(HrmPerformanceAssessmentRespVO respVO,
+                                        HrmPerformanceAssessmentStageRespVO selectedStage) {
+        if (Objects.equals(selectedStage.getVisibleContent(),
+                HrmPerformanceReviewVisibleContentEnum.ALL.getContent())) {
+            return;
+        }
+        respVO.setReviewStages(Collections.singletonList(selectedStage));
+        respVO.setSelfComment(null).setReviewerComment(null);
+        respVO.getQuotas().forEach(quota -> quota.setSelfScore(null).setReviewerScore(null)
+                .setFinalScore(null).setComment(null));
+    }
+
+    private HrmPerformanceAssessmentStageDO findReviewStageDOByHandler(
+            List<HrmPerformanceAssessmentStageDO> stages, Long employeeId) {
+        if (employeeId == null) {
+            return null;
+        }
+        return CollUtil.findOne(stages, stage -> HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(stage.getType())
+                && Objects.equals(stage.getHandlerEmployeeId(), employeeId));
+    }
+
+    private HrmPerformanceAssessmentStageRespVO findReviewStageRespVOByHandler(
+            List<HrmPerformanceAssessmentStageRespVO> stages, Long employeeId) {
+        if (employeeId == null) {
+            return null;
+        }
+        return CollUtil.findOne(stages, stage -> HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(stage.getType())
+                && Objects.equals(stage.getHandlerEmployeeId(), employeeId));
+    }
+
+    private boolean isReviewContentRestricted(HrmPerformanceAssessmentStageDO stage) {
+        return stage != null && Objects.equals(stage.getVisibleContent(),
+                HrmPerformanceReviewVisibleContentEnum.SELF.getContent());
+    }
+
+    private String resolveCurrentHandlerName(HrmPerformanceAssessmentRespVO respVO,
+                                             HrmPerformanceAssessmentDO assessment,
+                                             Map<Long, HrmEmployeeDO> employeeMap) {
+        if (respVO.getCurrentStage() != null) {
+            return respVO.getCurrentStage().getHandlerName();
+        }
+        if (ObjectUtils.notEqualsAny(assessment.getStageType(),
+                HrmPerformanceStageTypeEnum.FILL_QUOTA.getType(),
+                HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType())) {
+            return null;
+        }
+        HrmEmployeeDO employee = employeeMap.get(assessment.getEmployeeId());
+        return employee == null ? null : employee.getName();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewService.java
new file mode 100644
index 0000000..504d69c
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewService.java
@@ -0,0 +1,84 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceFillQuotaReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceProcessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceReviewRejectReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScorePreviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScoreReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+
+/**
+ * HRM 绩效评分 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformanceAssessmentReviewService {
+
+    /**
+     * 获得当前用户的绩效指标填写任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @return 员工绩效考核阶段分页
+     */
+    PageResult<HrmPerformanceAssessmentStageDO> getMyFillQuotaTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO);
+
+    /**
+     * 获得当前用户的绩效评分任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @return 员工绩效考核阶段分页
+     */
+    PageResult<HrmPerformanceAssessmentStageDO> getMyReviewTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO);
+
+    /**
+     * 确保员工绩效考核已初始化指标
+     *
+     * @param plan 绩效计划
+     * @param assessment 员工绩效考核
+     */
+    void ensureAssessmentQuotaList(
+            HrmPerformancePlanDO plan, HrmPerformanceAssessmentDO assessment);
+
+    /**
+     * 填写绩效指标
+     *
+     * @param userId 用户编号
+     * @param reqVO 指标信息
+     */
+    void fillQuota(Long userId, HrmPortalPerformanceFillQuotaReqVO reqVO);
+
+    /**
+     * 预览绩效评分结果
+     *
+     * @param userId 用户编号
+     * @param reqVO 评分信息
+     * @return 评分试算结果
+     */
+    HrmPortalPerformanceScorePreviewRespVO previewScore(Long userId, HrmPortalPerformanceScoreReqVO reqVO);
+
+    /**
+     * 提交绩效评分
+     *
+     * @param userId 用户编号
+     * @param reqVO 评分信息
+     * @return 流程处理结果
+     */
+    HrmPortalPerformanceProcessRespVO scoreAssessment(Long userId, HrmPortalPerformanceScoreReqVO reqVO);
+
+    /**
+     * 驳回绩效评分阶段
+     *
+     * @param userId 用户编号
+     * @param reqVO 驳回信息
+     */
+    void rejectReviewStage(Long userId, HrmPortalPerformanceReviewRejectReqVO reqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewServiceImpl.java
new file mode 100644
index 0000000..3b076c1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewServiceImpl.java
@@ -0,0 +1,1000 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceFillQuotaReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceProcessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceQuotaSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceReviewRejectReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScorePreviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScoreReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDimensionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ResultConfig;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO.Level;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentDimensionMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaScoreMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentStageMapper;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentProcessStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaSettingTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceUpperLimitTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getSumValue;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.PERCENT_100;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ASSESSMENT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_QUOTA_SETTING_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_REVIEW_STAGE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_REVIEW_STAGE_NO_PERMISSION;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_REVIEW_STAGE_REJECT_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_RESULT_LEVEL_NOT_MATCH;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_ACTION_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_TARGET_CONFIRM_CONFIG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_FILL_QUOTA_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_FILL_QUOTA_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_REJECT_SCORE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_REJECT_SCORE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_SCORE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_SCORE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_TYPE;
+
+/**
+ * HRM 绩效评分 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmPerformanceAssessmentReviewServiceImpl
+        implements HrmPerformanceAssessmentReviewService {
+
+    @Resource
+    private HrmPerformanceAssessmentMapper assessmentMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaMapper assessmentQuotaMapper;
+    @Resource
+    private HrmPerformanceAssessmentDimensionMapper assessmentDimensionMapper;
+    @Resource
+    private HrmPerformanceAssessmentStageMapper assessmentStageMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaScoreMapper assessmentQuotaScoreMapper;
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmPerformanceAssessmentProcessService assessmentProcessService;
+    @Resource
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+    @Resource
+    private HrmPerformancePlanService planService;
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentStageDO> getMyFillQuotaTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO) {
+        return getMyTaskPage(userId, reqVO,
+                Collections.singleton(HrmPerformanceStageTypeEnum.FILL_QUOTA.getType()));
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentStageDO> getMyReviewTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO) {
+        return getMyTaskPage(userId, reqVO, HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+    }
+
+    /**
+     * 获得当前用户指定类型的绩效任务分页
+     *
+     * @param userId 用户编号
+     * @param reqVO 分页查询
+     * @param types 阶段类型集合
+     * @return 员工绩效考核阶段分页
+     */
+    private PageResult<HrmPerformanceAssessmentStageDO> getMyTaskPage(
+            Long userId, HrmPortalPerformanceTaskPageReqVO reqVO,
+            Collection<Integer> types) {
+        // 1. 根据当前登录账号查询员工
+        HrmEmployeeDO employee = employeeService.getEmployeeByUserId(userId);
+        if (employee == null) {
+            return PageResult.empty();
+        }
+        // 2. 分页查询当前员工的指定阶段
+        return assessmentStageMapper.selectPortalTaskPage(
+                reqVO, employee.getId(), types);
+    }
+
+    // ==================== 指标管理 ====================
+
+    @Override
+    public void ensureAssessmentQuotaList(
+            HrmPerformancePlanDO plan, HrmPerformanceAssessmentDO assessment) {
+        // 1.1 已初始化指标时，无需重复处理
+        List<HrmPerformanceAssessmentQuotaDO> existingQuotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId());
+        if (CollUtil.isNotEmpty(existingQuotas)) {
+            return;
+        }
+        // 1.2 校验计划的考核配置
+        if (plan.getAssessmentConfig() == null
+                || CollUtil.isEmpty(plan.getAssessmentConfig().getDimensions())) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2.1 构造并批量插入考核维度
+        List<HrmPerformanceAssessmentTemplateDO.Dimension> dimensions = plan.getAssessmentConfig().getDimensions();
+        List<HrmPerformanceAssessmentDimensionDO> assessmentDimensions =
+                new ArrayList<>(dimensions.size());
+        for (int i = 0; i < dimensions.size(); i++) {
+            HrmPerformanceAssessmentTemplateDO.Dimension dimension = dimensions.get(i);
+            assessmentDimensions.add(new HrmPerformanceAssessmentDimensionDO()
+                    .setAssessmentId(assessment.getId()).setName(dimension.getName())
+                    .setQuotaType(dimension.getQuotaType()).setWeight(dimension.getWeight())
+                    .setRemark(dimension.getRemark())
+                    .setAllowEdit(Boolean.TRUE.equals(dimension.getAllowEdit())).setSort(i + 1));
+        }
+        assessmentDimensionMapper.insertBatch(assessmentDimensions);
+
+        // 2.2 构造并批量插入考核指标
+        int quotaSort = 1;
+        List<HrmPerformanceAssessmentQuotaDO> assessmentQuotas = new ArrayList<>();
+        for (int i = 0; i < dimensions.size(); i++) {
+            HrmPerformanceAssessmentTemplateDO.Dimension dimension = dimensions.get(i);
+            HrmPerformanceAssessmentDimensionDO assessmentDimension =
+                    assessmentDimensions.get(i);
+            for (HrmPerformanceAssessmentTemplateDO.Quota quota : dimension.getQuotas()) {
+                assessmentQuotas.add(new HrmPerformanceAssessmentQuotaDO()
+                        .setAssessmentId(assessment.getId())
+                        .setDimensionId(assessmentDimension.getId()).setPreset(true)
+                        .setName(quota.getName()).setDescription(quota.getIllustrate())
+                        .setStandard(quota.getStandard())
+                        .setWeight(ObjUtil.defaultIfNull(quota.getWeight(), PERCENT_100))
+                        .setScoreType(quota.getScoreType())
+                        .setSelfScore(BigDecimal.ZERO).setReviewerScore(BigDecimal.ZERO)
+                        .setFinalScore(BigDecimal.ZERO).setSort(quotaSort++));
+            }
+        }
+        assessmentQuotaMapper.insertBatch(assessmentQuotas);
+    }
+
+    /**
+     * 使用员工提交的指标替换当前自定义指标
+     *
+     * @param plan 绩效计划
+     * @param assessment 员工绩效考核
+     * @param quotaList 指标列表
+     */
+    void replaceAssessmentQuotaList(
+            HrmPerformancePlanDO plan, HrmPerformanceAssessmentDO assessment,
+            List<HrmPortalPerformanceQuotaSaveReqVO> quotaList) {
+        // 1. 校验已有指标和请求指标
+        if (quotaList == null) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+        ensureAssessmentQuotaList(plan, assessment);
+        List<HrmPerformanceAssessmentDimensionDO> dimensions =
+                assessmentDimensionMapper.selectListByAssessmentId(assessment.getId());
+        Map<Long, HrmPerformanceAssessmentDimensionDO> dimensionMap =
+                convertMap(dimensions, HrmPerformanceAssessmentDimensionDO::getId);
+        List<HrmPerformanceAssessmentQuotaDO> existingQuotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId());
+        Map<Long, HrmPerformanceAssessmentQuotaDO> existingQuotaMap =
+                convertMap(existingQuotas, HrmPerformanceAssessmentQuotaDO::getId);
+        Set<Long> presetQuotaIds = convertSet(existingQuotas, HrmPerformanceAssessmentQuotaDO::getId,
+                quota -> Boolean.TRUE.equals(quota.getPreset()));
+        // 拆分请求中的预置指标和自定义指标，并校验请求编号不重复且属于当前考核。
+        Set<Long> requestIds = new HashSet<>();
+        List<HrmPortalPerformanceQuotaSaveReqVO> customRequests = new ArrayList<>();
+        for (HrmPortalPerformanceQuotaSaveReqVO request : quotaList) {
+            if (request.getId() != null) {
+                if (!requestIds.add(request.getId())
+                        || !existingQuotaMap.containsKey(request.getId())) {
+                    throw exception(PERFORMANCE_DATA_ILLEGAL);
+                }
+                if (presetQuotaIds.contains(request.getId())) {
+                    continue;
+                }
+            }
+            customRequests.add(request);
+        }
+        if (!requestIds.containsAll(presetQuotaIds)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2. 构造自定义指标，并校验各维度的指标配置
+        List<HrmPerformanceAssessmentQuotaDO> presetQuotas = filterList(existingQuotas,
+                quota -> presetQuotaIds.contains(quota.getId()));
+        Map<Long, List<HrmPerformanceAssessmentQuotaDO>> finalQuotaMap =
+                convertMultiMap(presetQuotas, HrmPerformanceAssessmentQuotaDO::getDimensionId);
+        List<HrmPerformanceAssessmentQuotaDO> customQuotas = new ArrayList<>();
+        int nextSort = existingQuotas.stream().map(HrmPerformanceAssessmentQuotaDO::getSort)
+                .filter(Objects::nonNull).max(Integer::compareTo).orElse(0) + 1;
+        for (HrmPortalPerformanceQuotaSaveReqVO request : customRequests) {
+            HrmPerformanceAssessmentDimensionDO dimension = dimensionMap.get(request.getDimensionId());
+            validateCustomQuota(request, dimension);
+            HrmPerformanceAssessmentQuotaDO quota = new HrmPerformanceAssessmentQuotaDO()
+                    .setAssessmentId(assessment.getId()).setDimensionId(dimension.getId())
+                    .setPreset(false)
+                    .setName(request.getName().trim()).setDescription(request.getDescription())
+                    .setStandard(request.getStandard().trim())
+                    .setWeight(request.getWeight()).setScoreType(request.getScoreType())
+                    .setTargetValue(request.getTargetValue()).setActualValue(request.getActualValue())
+                    .setSelfScore(BigDecimal.ZERO).setReviewerScore(BigDecimal.ZERO)
+                    .setFinalScore(BigDecimal.ZERO).setSort(nextSort++);
+            customQuotas.add(quota);
+            finalQuotaMap.computeIfAbsent(
+                    request.getDimensionId(), key -> new ArrayList<>()).add(quota);
+        }
+
+        // 3. 批量替换自定义指标
+        validateDimensionQuotaList(dimensions, finalQuotaMap);
+        List<Long> oldCustomQuotaIds = convertList(existingQuotas, HrmPerformanceAssessmentQuotaDO::getId,
+                quota -> Boolean.FALSE.equals(quota.getPreset()));
+        if (CollUtil.isNotEmpty(oldCustomQuotaIds)) {
+            assessmentQuotaMapper.deleteByIds(oldCustomQuotaIds);
+        }
+        if (CollUtil.isNotEmpty(customQuotas)) {
+            assessmentQuotaMapper.insertBatch(customQuotas);
+        }
+    }
+
+    /**
+     * 更新绩效考核的全部指标
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @param quotaList 指标列表
+     */
+    void updateAssessmentQuotaList(
+            Long assessmentId, List<HrmPortalPerformanceQuotaSaveReqVO> quotaList) {
+        // 1. 校验指标编号完整且不重复
+        List<HrmPerformanceAssessmentQuotaDO> oldQuotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessmentId);
+        if (CollUtil.isEmpty(oldQuotas) || quotaList == null) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+        Map<Long, HrmPerformanceAssessmentQuotaDO> oldQuotaMap =
+                convertMap(oldQuotas, HrmPerformanceAssessmentQuotaDO::getId);
+        Map<Long, HrmPortalPerformanceQuotaSaveReqVO> requestQuotaMap = new HashMap<>();
+        for (HrmPortalPerformanceQuotaSaveReqVO quota : quotaList) {
+            if (quota.getId() == null || requestQuotaMap.put(quota.getId(), quota) != null) {
+                throw exception(PERFORMANCE_DATA_ILLEGAL);
+            }
+        }
+        if (ObjUtil.notEqual(requestQuotaMap.keySet(), oldQuotaMap.keySet())) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2. 批量更新指标
+        List<HrmPerformanceAssessmentQuotaDO> updateQuotas = new ArrayList<>(quotaList.size());
+        for (int i = 0; i < quotaList.size(); i++) {
+            HrmPerformanceAssessmentQuotaDO quota = BeanUtils.toBean(quotaList.get(i), HrmPerformanceAssessmentQuotaDO.class)
+                    .setAssessmentId(assessmentId).setSort(ObjUtil.defaultIfNull(quotaList.get(i).getSort(), i + 1));
+            updateQuotas.add(quota);
+        }
+        assessmentQuotaMapper.updateBatch(updateQuotas);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_FILL_QUOTA_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_FILL_QUOTA_SUCCESS)
+    public void fillQuota(Long userId, HrmPortalPerformanceFillQuotaReqVO reqVO) {
+        // 1. 校验员工绩效考核
+        HrmPerformanceAssessmentDO assessment =
+                validatePerformanceAssessmentExistsForUpdate(reqVO.getAssessmentId());
+        // 2. 校验当前用户是被考核员工
+        validateOwnAssessment(userId, assessment);
+        // 3. 填写指标并推进流程
+        HrmPerformanceAssessmentStageDO fillStage = fillQuotaInternal(assessment, reqVO);
+
+        // 4. 追加绩效动作记录
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                assessment.getEmployeeId(), assessment.getId(), fillStage.getId(),
+                HrmPerformanceAssessmentActionTypeEnum.FILL_QUOTA,
+                null, HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+    }
+
+    /**
+     * 填写绩效指标，并推动员工绩效考核进入下一阶段
+     *
+     * @param assessment 员工绩效考核
+     * @param reqVO 指标信息
+     * @return 已完成的指标填写阶段
+     */
+    private HrmPerformanceAssessmentStageDO fillQuotaInternal(
+            HrmPerformanceAssessmentDO assessment,
+            HrmPortalPerformanceFillQuotaReqVO reqVO) {
+        // 1. 校验绩效计划和指标填写阶段
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(assessment.getPlanId());
+        if (ObjUtil.notEqual(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                || ObjUtil.notEqual(plan.getQuotaSettingType(),
+                HrmPerformanceQuotaSettingTypeEnum.EMPLOYEE.getType())) {
+            throw exception(PERFORMANCE_QUOTA_SETTING_INVALID);
+        }
+        validateStage(assessment, HrmPerformanceStageTypeEnum.FILL_QUOTA.getType());
+
+        // 2.1 替换员工提交的自定义指标
+        replaceAssessmentQuotaList(plan, assessment, reqVO.getQuotas());
+        // 2.2 完成指标填写阶段，并清空历史目标确认结果
+        List<HrmPerformanceAssessmentStageDO> fillStages =
+                assessmentStageMapper.selectListByAssessmentIdAndType(
+                        assessment.getId(), HrmPerformanceStageTypeEnum.FILL_QUOTA.getType());
+        HrmPerformanceAssessmentStageDO fillStage = CollUtil.findOne(fillStages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        if (fillStage == null) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+        fillStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()).setSubmitTime(LocalDateTime.now());
+        assessmentStageMapper.updateById(fillStage);
+        assessment.setTargetConfirmationResult(null).setTargetConfirmationComment(null).setTargetConfirmationTime(null);
+
+        // 3. 进入目标确认或绩效执行阶段
+        if (Boolean.TRUE.equals(plan.getTargetConfirmation())) {
+            // 3.1 已启用目标确认时，激活目标确认阶段
+            List<HrmPerformanceAssessmentStageDO> targetStages = assessmentStageMapper.selectListByAssessmentIdAndType(
+                    assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType());
+            HrmPerformanceAssessmentStageDO targetStage = CollUtil.getFirst(targetStages);
+            if (targetStage == null) {
+                throw exception(PERFORMANCE_TARGET_CONFIRM_CONFIG_INVALID);
+            }
+            assessmentStageMapper.updateToResetByAssessmentIdAndType(
+                    assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(),
+                    HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+            targetStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                    .setComment(null).setRejectReason(null).setSubmitTime(null).setDeadlineTime(null);
+            assessment.setStageType(HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType())
+                    .setStageSort(targetStage.getSort());
+            // 3.2 通知目标确认人处理待办
+            assessmentProcessService.notifyPendingStage(assessment, targetStage);
+        } else {
+            // 3.3 未启用目标确认时，直接进入绩效执行阶段
+            assessment.setStageType(HrmPerformanceStageTypeEnum.EXECUTING.getType());
+        }
+        assessmentMapper.updateById(assessment);
+
+        // 4. 刷新绩效计划的完成状态
+        assessmentProcessService.refreshPlanCompletionState(assessment.getPlanId());
+        return fillStage;
+    }
+
+    @Override
+    public HrmPortalPerformanceScorePreviewRespVO previewScore(Long userId, HrmPortalPerformanceScoreReqVO reqVO) {
+        // 1.1 校验评分阶段和评分人
+        HrmPerformanceAssessmentDO assessment = validatePerformanceAssessmentExists(reqVO.getAssessmentId());
+        validatePlanRunning(assessment);
+        List<HrmPerformanceAssessmentStageDO> reviewStages =
+                assessmentStageMapper.selectListByAssessmentIdAndTypes(
+                        assessment.getId(), HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+        HrmPerformanceAssessmentStageDO currentStage = CollUtil.findOne(reviewStages, stage ->
+                (reqVO.getReviewStageId() == null || Objects.equals(stage.getId(), reqVO.getReviewStageId()))
+                        && Objects.equals(stage.getStatus(), HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        if (currentStage == null) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+        if (!isStageHandler(userId, currentStage)) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NO_PERMISSION);
+        }
+        validateReviewStage(assessment);
+        // 1.2 校验评分指标
+        List<HrmPerformanceAssessmentQuotaDO> quotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId());
+        if (CollUtil.isEmpty(quotas) || reqVO.getQuotas() == null) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+        Map<Long, HrmPortalPerformanceQuotaSaveReqVO> requestQuotaMap = new HashMap<>();
+        for (HrmPortalPerformanceQuotaSaveReqVO requestQuota : reqVO.getQuotas()) {
+            if (requestQuota.getId() == null || requestQuotaMap.put(requestQuota.getId(), requestQuota) != null) {
+                throw exception(PERFORMANCE_DATA_ILLEGAL);
+            }
+        }
+        Set<Long> quotaIds = convertSet(quotas, HrmPerformanceAssessmentQuotaDO::getId);
+        if (ObjUtil.notEqual(requestQuotaMap.keySet(), quotaIds)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2. 计算当前阶段和当前累计得分
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(assessment.getPlanId());
+        BigDecimal maximumScore = getMaximumScore(plan);
+        Map<Long, BigDecimal> currentScoreMap = new HashMap<>();
+        for (HrmPerformanceAssessmentQuotaDO quota : quotas) {
+            BigDecimal score = getRequestedReviewScore(currentStage, requestQuotaMap.get(quota.getId()));
+            validateReviewScore(score, maximumScore);
+            currentScoreMap.put(quota.getId(), score);
+        }
+        BigDecimal stageScore = computeScore(plan, quotas, currentScoreMap);
+
+        // 按阶段权重合并当前输入和已完成阶段得分，不将尚未评分的阶段按零分推断为最终结果。
+        List<HrmPerformanceAssessmentStageDO> completedStages = filterList(reviewStages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()));
+        Map<Long, HrmPerformanceAssessmentStageDO> completedStageMap =
+                convertMap(completedStages, HrmPerformanceAssessmentStageDO::getId);
+        Map<Long, BigDecimal> cumulativeQuotaScoreMap = new HashMap<>();
+        for (HrmPerformanceAssessmentQuotaDO quota : quotas) {
+            cumulativeQuotaScoreMap.put(quota.getId(), currentScoreMap.get(quota.getId())
+                    .multiply(currentStage.getWeight()).divide(PERCENT_100, 4, RoundingMode.HALF_UP));
+        }
+        List<HrmPerformanceAssessmentQuotaScoreDO> completedScores = CollUtil.isEmpty(completedStageMap)
+                ? Collections.emptyList()
+                : assessmentQuotaScoreMapper.selectListByAssessmentStageIds(completedStageMap.keySet());
+        for (HrmPerformanceAssessmentQuotaScoreDO reviewScore : completedScores) {
+            HrmPerformanceAssessmentStageDO completedStage =
+                    completedStageMap.get(reviewScore.getAssessmentStageId());
+            cumulativeQuotaScoreMap.compute(reviewScore.getAssessmentQuotaId(), (quotaId, oldScore) ->
+                    ObjUtil.defaultIfNull(oldScore, BigDecimal.ZERO).add(reviewScore.getScore()
+                            .multiply(completedStage.getWeight()).divide(PERCENT_100, 4, RoundingMode.HALF_UP)));
+        }
+        BigDecimal cumulativeScore = computeScore(plan, quotas, cumulativeQuotaScoreMap);
+        Level stageLevel = matchResultLevel(plan.getResultConfig(), stageScore);
+        boolean allReviewStagesIncluded = completedStages.size() + 1 == reviewStages.size();
+        Level cumulativeLevel = allReviewStagesIncluded
+                ? matchResultLevel(plan.getResultConfig(), cumulativeScore) : null;
+        return new HrmPortalPerformanceScorePreviewRespVO()
+                .setStageScore(stageScore).setStageResultLevel(stageLevel == null ? null : stageLevel.getName())
+                .setCumulativeScore(cumulativeScore)
+                .setCumulativeResultLevel(cumulativeLevel == null ? null : cumulativeLevel.getName());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_SCORE_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_SCORE_SUCCESS)
+    public HrmPortalPerformanceProcessRespVO scoreAssessment(Long userId, HrmPortalPerformanceScoreReqVO reqVO) {
+        // 1. 校验员工绩效考核
+        HrmPerformanceAssessmentDO assessment =
+                validatePerformanceAssessmentExistsForUpdate(reqVO.getAssessmentId());
+        validatePlanRunning(assessment);
+
+        // 2. 提交当前阶段评分
+        List<HrmPerformanceAssessmentStageDO> reviewStages = assessmentStageMapper.selectListByAssessmentIdAndTypes(
+                assessment.getId(), HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+        // 评分阶段应在计划启动时完成初始化；缺失时无法继续评分。
+        if (CollUtil.isEmpty(reviewStages)) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+        return scoreReviewStage(userId, assessment, reviewStages, reqVO);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_TYPE, subType = HRM_PERFORMANCE_REJECT_SCORE_SUB_TYPE,
+            bizNo = "{{#reqVO.assessmentId}}", success = HRM_PERFORMANCE_REJECT_SCORE_SUCCESS)
+    public void rejectReviewStage(Long userId, HrmPortalPerformanceReviewRejectReqVO reqVO) {
+        // 1. 校验当前评分阶段
+        HrmPerformanceAssessmentDO assessment =
+                validatePerformanceAssessmentExistsForUpdate(reqVO.getAssessmentId());
+        validatePlanRunning(assessment);
+        List<HrmPerformanceAssessmentStageDO> reviewStages = assessmentStageMapper.selectListByAssessmentIdAndTypes(
+                assessment.getId(), HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+        HrmPerformanceAssessmentStageDO currentStageCandidate = CollUtil.findOne(reviewStages, stage ->
+                Objects.equals(stage.getId(), reqVO.getReviewStageId())
+                        && Objects.equals(stage.getStatus(), HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        if (currentStageCandidate == null) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+        HrmPerformanceAssessmentStageDO currentStage = assessmentStageMapper.selectOneForUpdate(
+                HrmPerformanceAssessmentStageDO::getId, currentStageCandidate.getId());
+        if (currentStage == null || ObjUtil.notEqual(currentStage.getStatus(),
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+        reviewStages.set(reviewStages.indexOf(currentStageCandidate), currentStage);
+        if (!isStageHandler(userId, currentStage)) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NO_PERMISSION);
+        }
+        validateReviewStage(assessment);
+        if (ObjUtil.notEqual(Boolean.TRUE, currentStage.getRejectAuthority())) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_REJECT_INVALID);
+        }
+        HrmPerformanceAssessmentStageDO previousStage = CollUtil.getLast(filterList(reviewStages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus())
+                        && stage.getSort() < currentStage.getSort()));
+        if (previousStage == null) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_REJECT_INVALID);
+        }
+
+        // 2. 驳回到上一评分阶段
+        assessmentQuotaScoreMapper.deleteByAssessmentStageId(previousStage.getId());
+        previousStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                .setScore(null).setComment(null).setRejectReason(reqVO.getReason()).setSubmitTime(null);
+        assessmentStageMapper.updateToResetForReject(previousStage.getId(),
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(), reqVO.getReason());
+        currentStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.updateById(currentStage);
+
+        // 3. 重新汇总指标得分和评语，并回退员工绩效考核的当前阶段
+        refreshPartialReviewAggregates(assessment.getId(), reviewStages);
+        assessment.setStageSort(previousStage.getSort()).setStageType(toPerformanceStageType(previousStage))
+                .setSelfComment(joinReviewComments(reviewStages, true))
+                .setReviewerComment(joinReviewComments(reviewStages, false));
+        assessmentMapper.updateById(assessment);
+        assessmentProcessService.notifyPendingStage(assessment, previousStage);
+        assessmentProcessService.notifyProcessResult(assessment,
+                Collections.singleton(previousStage.getHandlerEmployeeId()),
+                "考核评分", "已被驳回，请重新评分");
+
+        // 4. 追加绩效动作记录
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                currentStage.getHandlerEmployeeId(), assessment.getId(), previousStage.getId(),
+                HrmPerformanceAssessmentActionTypeEnum.REJECT_SCORE,
+                null, HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus(),
+                previousStage.getName(), reqVO.getReason());
+    }
+
+    /**
+     * 提交当前评分阶段，并激活下一评分阶段或完成评分
+     *
+     * @param userId 用户编号
+     * @param assessment 员工绩效考核
+     * @param reviewStages 评分阶段列表
+     * @param reqVO 评分信息
+     * @return 流程处理结果
+     */
+    private HrmPortalPerformanceProcessRespVO scoreReviewStage(
+            Long userId, HrmPerformanceAssessmentDO assessment,
+            List<HrmPerformanceAssessmentStageDO> reviewStages,
+            HrmPortalPerformanceScoreReqVO reqVO) {
+        // 1. 校验当前评分阶段和评分人
+        HrmPerformanceAssessmentStageDO reviewStageCandidate = CollUtil.findOne(reviewStages,
+                stage -> (reqVO.getReviewStageId() == null
+                        || Objects.equals(stage.getId(), reqVO.getReviewStageId()))
+                        && Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        if (reviewStageCandidate == null) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+        HrmPerformanceAssessmentStageDO reviewStage = assessmentStageMapper.selectOneForUpdate(
+                HrmPerformanceAssessmentStageDO::getId, reviewStageCandidate.getId());
+        if (reviewStage == null || ObjUtil.notEqual(reviewStage.getStatus(),
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+        reviewStages.set(reviewStages.indexOf(reviewStageCandidate), reviewStage);
+        if (!isStageHandler(userId, reviewStage)) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NO_PERMISSION);
+        }
+        validateReviewStage(assessment);
+
+        // 2. 校验评分指标和评语
+        // 2.1 校验评分指标
+        List<HrmPerformanceAssessmentQuotaDO> quotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId());
+        if (CollUtil.isEmpty(quotas) || reqVO.getQuotas() == null) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+        Map<Long, HrmPortalPerformanceQuotaSaveReqVO> requestQuotaMap = new HashMap<>();
+        for (HrmPortalPerformanceQuotaSaveReqVO requestQuota : reqVO.getQuotas()) {
+            if (requestQuota.getId() == null || requestQuotaMap.put(requestQuota.getId(), requestQuota) != null) {
+                throw exception(PERFORMANCE_DATA_ILLEGAL);
+            }
+        }
+        Set<Long> quotaIds = convertSet(quotas, HrmPerformanceAssessmentQuotaDO::getId);
+        if (ObjUtil.notEqual(requestQuotaMap.keySet(), quotaIds)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2.2 获得并校验当前评分阶段的评语
+        String roleComment = Objects.equals(
+                reviewStage.getRaterType(), HrmPerformanceRaterTypeEnum.SELF.getType())
+                ? reqVO.getSelfComment() : reqVO.getReviewerComment();
+        String stageComment = StringUtils.hasText(reqVO.getComment())
+                ? reqVO.getComment() : roleComment;
+        if (Boolean.TRUE.equals(reviewStage.getRequiredSetting())
+                && !StringUtils.hasText(stageComment)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 3. 保存当前阶段的指标评分
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(assessment.getPlanId());
+        BigDecimal maximumScore = getMaximumScore(plan);
+        assessmentQuotaScoreMapper.deleteByAssessmentStageId(reviewStage.getId());
+        Map<Long, BigDecimal> stageQuotaScoreMap = new HashMap<>();
+        List<HrmPerformanceAssessmentQuotaScoreDO> reviewScores = new ArrayList<>(quotas.size());
+        for (HrmPerformanceAssessmentQuotaDO quota : quotas) {
+            HrmPortalPerformanceQuotaSaveReqVO requestQuota = requestQuotaMap.get(quota.getId());
+            BigDecimal quotaScore = getRequestedReviewScore(reviewStage, requestQuota);
+            validateReviewScore(quotaScore, maximumScore);
+            reviewScores.add(new HrmPerformanceAssessmentQuotaScoreDO()
+                    .setAssessmentStageId(reviewStage.getId()).setAssessmentQuotaId(quota.getId())
+                    .setScore(quotaScore).setComment(requestQuota.getComment()));
+            stageQuotaScoreMap.put(quota.getId(), quotaScore);
+            // 同步指标实际值以及当前评分角色对应的得分。
+            if (requestQuota.getActualValue() != null) {
+                quota.setActualValue(requestQuota.getActualValue());
+            }
+            if (Objects.equals(reviewStage.getRaterType(), HrmPerformanceRaterTypeEnum.SELF.getType())) {
+                quota.setSelfScore(quotaScore);
+            } else {
+                quota.setReviewerScore(quotaScore);
+            }
+        }
+        assessmentQuotaScoreMapper.insertBatch(reviewScores);
+        assessmentQuotaMapper.updateBatch(quotas);
+
+        // 4. 完成当前评分阶段
+        reviewStage.setScore(computeScore(plan, quotas, stageQuotaScoreMap)).setComment(stageComment)
+                .setSubmitTime(LocalDateTime.now())
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.updateById(reviewStage);
+        assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                reviewStage.getHandlerEmployeeId(), assessment.getId(), reviewStage.getId(),
+                HrmPerformanceAssessmentActionTypeEnum.SCORE,
+                null, HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                reviewStage.getScore(), StringUtils.hasText(stageComment) ? "，说明：" + stageComment : "");
+        assessment.setSelfComment(joinReviewComments(reviewStages, true))
+                .setReviewerComment(joinReviewComments(reviewStages, false));
+
+        // 5. 激活下一评分阶段；全部评分完成时汇总结果
+        HrmPerformanceAssessmentStageDO nextStage = CollUtil.findOne(reviewStages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus())
+                        && stage.getSort() > reviewStage.getSort());
+        if (nextStage != null) {
+            nextStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+            assessmentStageMapper.updateById(nextStage);
+            refreshPartialReviewAggregates(assessment.getId(), reviewStages);
+            assessment.setStageSort(nextStage.getSort()).setStageType(toPerformanceStageType(nextStage));
+            assessmentMapper.updateById(assessment);
+            assessmentProcessService.notifyPendingStage(assessment, nextStage);
+            return new HrmPortalPerformanceProcessRespVO().setId(assessment.getId());
+        }
+        HrmPerformanceAssessmentStageDO pendingStage = CollUtil.findOne(reviewStages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        if (pendingStage != null) {
+            refreshPartialReviewAggregates(assessment.getId(), reviewStages);
+            assessment.setStageSort(pendingStage.getSort())
+                    .setStageType(toPerformanceStageType(pendingStage));
+            assessmentMapper.updateById(assessment);
+            return new HrmPortalPerformanceProcessRespVO().setId(assessment.getId());
+        }
+        return finishReviewScoring(plan, assessment);
+    }
+
+    /**
+     * 汇总全部评分阶段，并启动结果审核
+     *
+     * @param plan 绩效计划
+     * @param assessment 员工绩效考核
+     * @return 流程处理结果
+     */
+    private HrmPortalPerformanceProcessRespVO finishReviewScoring(
+            HrmPerformancePlanDO plan, HrmPerformanceAssessmentDO assessment) {
+        // 1. 校验全部评分阶段已经完成
+        List<HrmPerformanceAssessmentStageDO> reviewStages =
+                assessmentStageMapper.selectListByAssessmentIdAndTypes(
+                        assessment.getId(), HrmPerformanceStageTypeEnum.REVIEW_TYPES);
+        if (CollUtil.isEmpty(reviewStages) || reviewStages.stream()
+                .anyMatch(stage -> ObjUtil.notEqual(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()))) {
+            throw exception(PERFORMANCE_REVIEW_STAGE_NOT_EXISTS);
+        }
+        Map<Long, HrmPerformanceAssessmentStageDO> stageMap =
+                convertMap(reviewStages, HrmPerformanceAssessmentStageDO::getId);
+        List<HrmPerformanceAssessmentQuotaScoreDO> reviewScores = assessmentQuotaScoreMapper
+                .selectListByAssessmentStageIds(stageMap.keySet());
+        Map<Long, List<HrmPerformanceAssessmentQuotaScoreDO>> quotaScoreMap =
+                convertMultiMap(reviewScores, HrmPerformanceAssessmentQuotaScoreDO::getAssessmentQuotaId);
+
+        // 2. 汇总每个指标的自评、他评和最终得分
+        List<HrmPerformanceAssessmentQuotaDO> quotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId());
+        assessmentQuotaMapper.updateReviewScoreToNullByAssessmentId(assessment.getId());
+        for (HrmPerformanceAssessmentQuotaDO quota : quotas) {
+            quota.setSelfScore(null).setReviewerScore(null).setFinalScore(null);
+            List<HrmPerformanceAssessmentQuotaScoreDO> quotaScores =
+                    quotaScoreMap.getOrDefault(quota.getId(), Collections.emptyList());
+            if (quotaScores.size() != reviewStages.size()) {
+                throw exception(PERFORMANCE_DATA_ILLEGAL);
+            }
+            BigDecimal finalScore = BigDecimal.ZERO;
+            BigDecimal reviewerWeightedScore = BigDecimal.ZERO;
+            BigDecimal reviewerWeight = BigDecimal.ZERO;
+            for (HrmPerformanceAssessmentQuotaScoreDO quotaScore : quotaScores) {
+                HrmPerformanceAssessmentStageDO stage = stageMap.get(quotaScore.getAssessmentStageId());
+                BigDecimal weightedScore = quotaScore.getScore().multiply(stage.getWeight())
+                        .divide(PERCENT_100, 4, RoundingMode.HALF_UP);
+                finalScore = finalScore.add(weightedScore);
+                if (Objects.equals(stage.getRaterType(), HrmPerformanceRaterTypeEnum.SELF.getType())) {
+                    quota.setSelfScore(quotaScore.getScore());
+                } else {
+                    reviewerWeightedScore = reviewerWeightedScore.add(weightedScore);
+                    reviewerWeight = reviewerWeight.add(stage.getWeight());
+                }
+            }
+            quota.setReviewerScore(reviewerWeight.signum() == 0 ? null
+                    : reviewerWeightedScore.multiply(PERCENT_100)
+                    .divide(reviewerWeight, 2, RoundingMode.HALF_UP));
+            quota.setFinalScore(finalScore.setScale(2, RoundingMode.HALF_UP));
+        }
+        assessmentQuotaMapper.updateBatch(quotas);
+
+        // 3. 汇总员工绩效考核结果，并启动结果审核
+        BigDecimal score = computeScore(plan, quotas,
+                convertMap(quotas, HrmPerformanceAssessmentQuotaDO::getId,
+                        HrmPerformanceAssessmentQuotaDO::getFinalScore));
+        Level level = matchResultLevel(plan.getResultConfig(), score);
+        if (level == null) {
+            throw exception(PERFORMANCE_RESULT_LEVEL_NOT_MATCH);
+        }
+        assessment.setScore(score).setResultLevel(level.getName())
+                .setCoefficient(ObjUtil.defaultIfNull(level.getCoefficient(), BigDecimal.ONE))
+                .setSelfComment(joinReviewComments(reviewStages, true))
+                .setReviewerComment(joinReviewComments(reviewStages, false));
+        assessmentMapper.updateById(assessment);
+        return assessmentProcessService.startResultAudit(assessment.getId());
+    }
+
+    /**
+     * 根据已完成的评分阶段刷新指标汇总分数
+     *
+     * @param assessmentId 员工绩效考核编号
+     * @param reviewStages 评分阶段列表
+     */
+    private void refreshPartialReviewAggregates(Long assessmentId,
+                                                List<HrmPerformanceAssessmentStageDO> reviewStages) {
+        List<HrmPerformanceAssessmentStageDO> completedStages = filterList(reviewStages,
+                stage -> Objects.equals(stage.getStatus(),
+                        HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()));
+        Map<Long, HrmPerformanceAssessmentStageDO> completedStageMap =
+                convertMap(completedStages, HrmPerformanceAssessmentStageDO::getId);
+        List<HrmPerformanceAssessmentQuotaScoreDO> completedScores = CollUtil.isEmpty(completedStageMap)
+                ? Collections.emptyList()
+                : assessmentQuotaScoreMapper.selectListByAssessmentStageIds(completedStageMap.keySet());
+        Map<Long, List<HrmPerformanceAssessmentQuotaScoreDO>> quotaScoreMap =
+                convertMultiMap(completedScores, HrmPerformanceAssessmentQuotaScoreDO::getAssessmentQuotaId);
+        List<HrmPerformanceAssessmentQuotaDO> quotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessmentId);
+        assessmentQuotaMapper.updateReviewScoreToNullByAssessmentId(assessmentId);
+        for (HrmPerformanceAssessmentQuotaDO quota : quotas) {
+            BigDecimal selfScore = null;
+            BigDecimal reviewerWeightedScore = BigDecimal.ZERO;
+            BigDecimal reviewerWeight = BigDecimal.ZERO;
+            for (HrmPerformanceAssessmentQuotaScoreDO score
+                    : quotaScoreMap.getOrDefault(quota.getId(), Collections.emptyList())) {
+                HrmPerformanceAssessmentStageDO stage = completedStageMap.get(score.getAssessmentStageId());
+                if (stage == null) {
+                    continue;
+                }
+                if (Objects.equals(stage.getRaterType(), HrmPerformanceRaterTypeEnum.SELF.getType())) {
+                    selfScore = score.getScore();
+                } else {
+                    reviewerWeightedScore = reviewerWeightedScore.add(score.getScore().multiply(stage.getWeight()));
+                    reviewerWeight = reviewerWeight.add(stage.getWeight());
+                }
+            }
+            quota.setSelfScore(selfScore)
+                    .setReviewerScore(reviewerWeight.signum() == 0 ? null
+                            : reviewerWeightedScore.divide(reviewerWeight, 2, RoundingMode.HALF_UP))
+                    .setFinalScore(null);
+        }
+        assessmentQuotaMapper.updateBatch(quotas);
+    }
+
+    private BigDecimal getRequestedReviewScore(HrmPerformanceAssessmentStageDO reviewStage,
+                                               HrmPortalPerformanceQuotaSaveReqVO quota) {
+        return Objects.equals(reviewStage.getRaterType(), HrmPerformanceRaterTypeEnum.SELF.getType())
+                ? ObjUtil.defaultIfNull(quota.getFinalScore(), quota.getSelfScore())
+                : ObjUtil.defaultIfNull(quota.getFinalScore(), quota.getReviewerScore());
+    }
+
+    private void validateReviewScore(BigDecimal score, BigDecimal maximumScore) {
+        if (score == null || score.signum() < 0
+                || (maximumScore != null && score.compareTo(maximumScore) > 0)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+    }
+
+    private BigDecimal getMaximumScore(HrmPerformancePlanDO plan) {
+        HrmPerformanceAssessmentTemplateDO.AssessmentConfig config = plan.getAssessmentConfig();
+        if (config != null && Objects.equals(config.getUpperLimitType(),
+                HrmPerformanceUpperLimitTypeEnum.UNIFIED.getType())) {
+            return config.getUpperLimitScore();
+        }
+        return null;
+    }
+
+    private String joinReviewComments(List<HrmPerformanceAssessmentStageDO> reviewStages, boolean self) {
+        List<HrmPerformanceAssessmentStageDO> stages = filterList(reviewStages, stage ->
+                Objects.equals(stage.getStatus(), HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus())
+                        && Objects.equals(stage.getRaterType(), HrmPerformanceRaterTypeEnum.SELF.getType()) == self && StringUtils.hasText(stage.getComment()));
+        if (CollUtil.isEmpty(stages)) {
+            return null;
+        }
+        return CollUtil.join(convertList(stages,
+                stage -> stage.getName() + "：" + stage.getComment()), "；");
+    }
+
+    private Integer toPerformanceStageType(HrmPerformanceAssessmentStageDO stage) {
+        return Objects.equals(stage.getRaterType(), HrmPerformanceRaterTypeEnum.SELF.getType())
+                ? HrmPerformanceStageTypeEnum.SELF_SCORE.getType()
+                : HrmPerformanceStageTypeEnum.OTHER_SCORE.getType();
+    }
+
+    private BigDecimal computeScore(HrmPerformancePlanDO plan, List<HrmPerformanceAssessmentQuotaDO> quotaList,
+                                    Map<Long, BigDecimal> scoreMap) {
+        // 1. 查询指标所属维度，用于应用维度权重
+        Map<Long, HrmPerformanceAssessmentDimensionDO> dimensionMap = Collections.emptyMap();
+        if (CollUtil.isNotEmpty(quotaList)) {
+            List<HrmPerformanceAssessmentDimensionDO> dimensions =
+                    assessmentDimensionMapper.selectListByAssessmentId(
+                            CollUtil.getFirst(quotaList).getAssessmentId());
+            dimensionMap = convertMap(dimensions, HrmPerformanceAssessmentDimensionDO::getId);
+        }
+        // 2. 按“指标得分 × 维度权重 × 指标权重”汇总总分
+        BigDecimal total = BigDecimal.ZERO;
+        for (HrmPerformanceAssessmentQuotaDO quota : quotaList) {
+            BigDecimal score = ObjUtil.defaultIfNull(scoreMap.get(quota.getId()), BigDecimal.ZERO);
+            HrmPerformanceAssessmentDimensionDO dimension = dimensionMap.get(quota.getDimensionId());
+            BigDecimal weightedScore = score
+                    .multiply(dimension == null ? PERCENT_100
+                            : ObjUtil.defaultIfNull(dimension.getWeight(), PERCENT_100))
+                    .divide(PERCENT_100, 4, RoundingMode.HALF_UP)
+                    .multiply(ObjUtil.defaultIfNull(quota.getWeight(), PERCENT_100))
+                    .divide(PERCENT_100, 4, RoundingMode.HALF_UP);
+            total = total.add(weightedScore);
+        }
+        // 3. 应用统一评分上限，并保留两位小数
+        BigDecimal maximumScore = getMaximumScore(plan);
+        if (maximumScore != null && total.compareTo(maximumScore) > 0) {
+            total = maximumScore;
+        }
+        return total.setScale(2, RoundingMode.HALF_UP);
+    }
+
+    private Level matchResultLevel(ResultConfig resultConfig, BigDecimal score) {
+        if (resultConfig == null || CollUtil.isEmpty(resultConfig.getLevels())) {
+            return null;
+        }
+        return CollUtil.findOne(resultConfig.getLevels(), level -> isInLevel(score, level));
+    }
+
+    private boolean isInLevel(BigDecimal score, Level level) {
+        boolean lowerOk = level.getMinScore() == null || score.compareTo(level.getMinScore()) >= 0;
+        boolean upperOk = level.getMaxScore() == null || score.compareTo(level.getMaxScore()) <= 0;
+        return lowerOk && upperOk;
+    }
+
+    private void validateStage(HrmPerformanceAssessmentDO assessment, Integer expectedStage) {
+        if (ObjUtil.notEqual(assessment.getStageType(), expectedStage)) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+    }
+
+    private void validateReviewStage(HrmPerformanceAssessmentDO assessment) {
+        if (!HrmPerformanceStageTypeEnum.REVIEW_TYPES.contains(assessment.getStageType())) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    private HrmEmployeeDO validateOwnAssessment(Long userId, HrmPerformanceAssessmentDO assessment) {
+        HrmEmployeeDO employee = employeeService.getEmployee(assessment.getEmployeeId());
+        if (employee == null) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        if (ObjUtil.notEqual(employee.getUserId(), userId)) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        return employee;
+    }
+
+    private HrmPerformancePlanDO validatePerformancePlanExists(Long id) {
+        return planService.validatePerformancePlanExists(id);
+    }
+
+    @SuppressWarnings("BooleanMethodIsAlwaysInverted")
+    private boolean isStageHandler(Long userId, HrmPerformanceAssessmentStageDO stage) {
+        HrmEmployeeDO employee = employeeService.getEmployeeByUserId(userId);
+        return employee != null
+                && Objects.equals(stage.getHandlerEmployeeId(), employee.getId());
+    }
+
+    @SuppressWarnings("UnusedReturnValue")
+    private HrmPerformancePlanDO validatePlanRunning(HrmPerformanceAssessmentDO assessment) {
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(assessment.getPlanId());
+        return validatePlanRunning(plan);
+    }
+
+    private HrmPerformancePlanDO validatePlanRunning(HrmPerformancePlanDO plan) {
+        if (ObjUtil.notEqual(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+        return plan;
+    }
+
+    private void validateCustomQuota(HrmPortalPerformanceQuotaSaveReqVO request,
+                                     HrmPerformanceAssessmentDimensionDO dimension) {
+        if (dimension == null || ObjUtil.notEqual(Boolean.TRUE, dimension.getAllowEdit())
+                || request.getDimensionId() == null
+                || !StringUtils.hasText(request.getName())
+                || !StringUtils.hasText(request.getStandard())
+                || request.getWeight() == null || request.getWeight().signum() <= 0
+                || request.getWeight().compareTo(PERCENT_100) > 0
+                || request.getScoreType() == null) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+    }
+
+    private void validateDimensionQuotaList(
+            List<HrmPerformanceAssessmentDimensionDO> dimensions,
+            Map<Long, List<HrmPerformanceAssessmentQuotaDO>> quotaMap) {
+        for (HrmPerformanceAssessmentDimensionDO dimension : dimensions) {
+            List<HrmPerformanceAssessmentQuotaDO> dimensionQuotas =
+                    quotaMap.getOrDefault(dimension.getId(), Collections.emptyList());
+            BigDecimal totalWeight = getSumValue(dimensionQuotas,
+                    HrmPerformanceAssessmentQuotaDO::getWeight, BigDecimal::add, BigDecimal.ZERO);
+            Set<String> quotaNames = convertSet(dimensionQuotas,
+                    quota -> StringUtils.hasText(quota.getName())
+                            ? quota.getName().trim() : null);
+            if (CollUtil.isEmpty(dimensionQuotas)
+                    || totalWeight.compareTo(PERCENT_100) != 0
+                    || quotaNames.size() != dimensionQuotas.size()) {
+                throw exception(PERFORMANCE_DATA_ILLEGAL);
+            }
+        }
+    }
+
+    private HrmPerformanceAssessmentDO validatePerformanceAssessmentExists(Long id) {
+        HrmPerformanceAssessmentDO assessment = assessmentMapper.selectById(id);
+        if (assessment == null) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        return assessment;
+    }
+
+    private HrmPerformanceAssessmentDO validatePerformanceAssessmentExistsForUpdate(Long id) {
+        HrmPerformanceAssessmentDO assessment = assessmentMapper.selectOneForUpdate(
+                HrmPerformanceAssessmentDO::getId, id);
+        if (assessment == null) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        return assessment;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentService.java
new file mode 100644
index 0000000..cca95f4
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentService.java
@@ -0,0 +1,335 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchivePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment.HrmPortalPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentAppealRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDimensionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+
+import java.math.BigDecimal;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 员工绩效考核 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformanceAssessmentService {
+
+    /**
+     * 获得员工绩效考核
+     *
+     * @param id 员工绩效考核编号
+     * @return 员工绩效考核
+     */
+    HrmPerformanceAssessmentDO getPerformanceAssessment(Long id);
+
+    /**
+     * 获得员工绩效考核列表
+     *
+     * @param ids 员工绩效考核编号集合
+     * @return 员工绩效考核列表
+     */
+    List<HrmPerformanceAssessmentDO> getPerformanceAssessmentList(Collection<Long> ids);
+
+    /**
+     * 获得员工绩效考核 Map
+     *
+     * @param ids 员工绩效考核编号集合
+     * @return 员工绩效考核 Map
+     */
+    default Map<Long, HrmPerformanceAssessmentDO> getPerformanceAssessmentMap(Collection<Long> ids) {
+        return convertMap(getPerformanceAssessmentList(ids), HrmPerformanceAssessmentDO::getId);
+    }
+
+    /**
+     * 获得绩效计划的员工考核列表
+     *
+     * @param planId 绩效计划编号
+     * @return 员工考核列表
+     */
+    List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByPlanId(Long planId);
+
+    /**
+     * 获得多个绩效计划的员工考核列表
+     *
+     * @param planIds 绩效计划编号集合
+     * @return 员工考核列表
+     */
+    List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByPlanIds(Collection<Long> planIds);
+
+    /**
+     * 校验员工绩效考核是否存在
+     *
+     * @param id 员工绩效考核编号
+     * @return 员工绩效考核
+     */
+    HrmPerformanceAssessmentDO validatePerformanceAssessmentExists(Long id);
+
+    /**
+     * 校验参评记录属于指定员工
+     *
+     * @param id 参评记录编号
+     * @param employeeId 员工编号
+     * @return 参评记录
+     */
+    HrmPerformanceAssessmentDO validatePerformanceAssessmentByEmployeeId(Long id, Long employeeId);
+
+    /**
+     * 获得员工绩效考核分页
+     *
+     * @param reqVO 分页查询
+     * @return 员工绩效考核分页
+     */
+    PageResult<HrmPerformanceAssessmentDO> getPerformanceAssessmentPage(
+            HrmPerformanceAssessmentPageReqVO reqVO);
+
+    /**
+     * 获得员工自己的绩效考核分页
+     *
+     * @param reqVO 分页查询
+     * @param employeeId 员工编号
+     * @return 员工绩效考核分页
+     */
+    PageResult<HrmPerformanceAssessmentDO> getPortalPerformanceAssessmentPage(
+            HrmPortalPerformanceAssessmentPageReqVO reqVO, Long employeeId);
+
+    /**
+     * 获得员工自己的绩效考核状态数量
+     *
+     * @param employeeId 员工编号
+     * @param planName 绩效计划名称
+     * @return 考核状态与数量的映射
+     */
+    Map<Integer, Long> getPerformanceAssessmentStatusCountMapByEmployeeId(
+            Long employeeId, String planName);
+
+    /**
+     * 获得绩效归档分页
+     *
+     * @param reqVO 分页查询
+     * @return 绩效归档分页
+     */
+    PageResult<HrmPerformanceAssessmentDO> getPerformanceAssessmentArchivePage(
+            HrmPerformanceArchivePageReqVO reqVO);
+
+    /**
+     * 获得存在归档绩效的员工分页
+     *
+     * @param reqVO 分页查询
+     * @return 员工分页
+     */
+    PageResult<HrmEmployeeDO> getPerformanceArchiveEmployeePage(
+            HrmPerformanceArchiveEmployeePageReqVO reqVO);
+
+    /**
+     * 获得绩效归档记录
+     *
+     * @param id 员工绩效考核编号
+     * @return 绩效归档记录
+     */
+    HrmPerformanceAssessmentDO getPerformanceAssessmentArchive(Long id);
+
+    /**
+     * 获得指定员工和状态的绩效考核列表
+     *
+     * @param employeeIds 员工编号集合
+     * @param status 考核状态
+     * @return 绩效考核列表
+     */
+    List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByEmployeeIdsAndStatus(
+            Collection<Long> employeeIds, Integer status);
+
+    /**
+     * 获得绩效考核维度列表
+     *
+     * @param assessmentIds 员工绩效考核编号集合
+     * @return 绩效考核维度列表
+     */
+    List<HrmPerformanceAssessmentDimensionDO> getPerformanceAssessmentDimensionList(
+            Collection<Long> assessmentIds);
+
+    /**
+     * 获得绩效考核指标列表
+     *
+     * @param assessmentIds 员工绩效考核编号集合
+     * @return 绩效考核指标列表
+     */
+    List<HrmPerformanceAssessmentQuotaDO> getPerformanceAssessmentQuotaList(
+            Collection<Long> assessmentIds);
+
+    /**
+     * 获得绩效考核阶段列表
+     *
+     * @param assessmentIds 员工绩效考核编号集合
+     * @return 绩效考核阶段列表
+     */
+    List<HrmPerformanceAssessmentStageDO> getPerformanceAssessmentStageList(
+            Collection<Long> assessmentIds);
+
+    /**
+     * 获得绩效考核指标评分列表
+     *
+     * @param assessmentStageIds 员工绩效考核阶段编号集合
+     * @return 绩效考核指标评分列表
+     */
+    List<HrmPerformanceAssessmentQuotaScoreDO> getPerformanceAssessmentQuotaScoreList(
+            Collection<Long> assessmentStageIds);
+
+    /**
+     * 获得绩效考核申诉记录列表
+     *
+     * @param assessmentIds 员工绩效考核编号集合
+     * @param status 处理状态
+     * @return 绩效考核申诉记录列表
+     */
+    List<HrmPerformanceAssessmentAppealRecordDO> getPerformanceAssessmentAppealRecordList(
+            Collection<Long> assessmentIds, Integer status);
+
+    /**
+     * 获得指定状态的员工绩效考核列表
+     *
+     * @param status 考核状态
+     * @return 员工绩效考核列表
+     */
+    List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByStatus(Integer status);
+
+    /**
+     * 删除绩效归档记录
+     *
+     * @param ids 员工绩效考核编号集合
+     */
+    void deletePerformanceArchiveRecords(Collection<Long> ids);
+
+    /**
+     * 删除员工的全部绩效归档记录
+     *
+     * @param employeeIds 员工编号集合
+     */
+    void deletePerformanceArchiveRecordsByEmployeeIds(Collection<Long> employeeIds);
+
+    /**
+     * 获得指定计划和员工的已归档绩效系数
+     *
+     * @param planIds 绩效计划编号集合
+     * @param employeeIds 员工编号集合
+     * @return 员工编号与绩效系数的映射
+     */
+    Map<Long, BigDecimal> getPerformanceArchiveEmployeeCoefficientMap(
+            Collection<Long> planIds, Collection<Long> employeeIds);
+
+    /**
+     * 添加员工绩效考核
+     *
+     * @param plan 绩效计划
+     * @param employeeIds 员工编号集合
+     */
+    void addPerformanceAssessmentList(HrmPerformancePlanDO plan, Collection<Long> employeeIds);
+
+    /**
+     * 同步员工绩效考核
+     *
+     * @param plan 绩效计划
+     * @param employeeIds 员工编号集合
+     */
+    void syncPerformanceAssessmentList(HrmPerformancePlanDO plan, Collection<Long> employeeIds);
+
+    /**
+     * 删除指定员工的绩效考核
+     *
+     * @param planId 绩效计划编号
+     * @param employeeIds 员工编号集合
+     */
+    void deletePerformanceAssessmentList(Long planId, Collection<Long> employeeIds);
+
+    /**
+     * 删除绩效计划的全部员工考核
+     *
+     * @param planId 绩效计划编号
+     */
+    void deletePerformanceAssessmentListByPlanId(Long planId);
+
+    /**
+     * 终止绩效计划的全部员工考核
+     *
+     * @param planId 绩效计划编号
+     * @param operatorEmployeeId 操作员工编号；未绑定员工时为空
+     */
+    void terminatePerformanceAssessmentListByPlanId(Long planId, Long operatorEmployeeId);
+
+    /**
+     * 启动绩效计划下的员工考核
+     *
+     * @param plan 绩效计划
+     * @return 初始考核阶段
+     */
+    Integer startPerformanceAssessmentList(HrmPerformancePlanDO plan);
+
+    /**
+     * 开启绩效评分
+     *
+     * @param plan 绩效计划
+     * @return 当前评分阶段
+     */
+    Integer openPerformanceAssessmentScoring(HrmPerformancePlanDO plan);
+
+    /**
+     * 发起绩效面谈
+     *
+     * @param plan 绩效计划
+     * @return 下一个考核阶段
+     */
+    Integer startPerformanceAssessmentInterview(HrmPerformancePlanDO plan);
+
+    /**
+     * 归档绩效计划下的员工考核
+     *
+     * @param plan 绩效计划
+     */
+    void archivePerformanceAssessmentList(HrmPerformancePlanDO plan);
+
+    /**
+     * 判断绩效计划是否可以开启评分
+     *
+     * @param plan 绩效计划
+     * @param assessments 员工绩效考核列表
+     * @return 是否可以开启评分
+     */
+    boolean isPerformanceAssessmentScoringReady(
+            HrmPerformancePlanDO plan, List<HrmPerformanceAssessmentDO> assessments);
+
+    /**
+     * 判断绩效计划是否可以发起面谈
+     *
+     * @param plan 绩效计划
+     * @param assessments 员工绩效考核列表
+     * @param stages 员工绩效考核阶段列表
+     * @return 是否可以发起面谈
+     */
+    boolean isPerformanceAssessmentInterviewReady(
+            HrmPerformancePlanDO plan, List<HrmPerformanceAssessmentDO> assessments,
+            List<HrmPerformanceAssessmentStageDO> stages);
+
+    /**
+     * 判断绩效计划是否可以归档
+     *
+     * @param plan 绩效计划
+     * @param assessments 员工绩效考核列表
+     * @return 是否可以归档
+     */
+    boolean isPerformanceAssessmentArchiveReady(
+            HrmPerformancePlanDO plan, List<HrmPerformanceAssessmentDO> assessments);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentServiceImpl.java
new file mode 100644
index 0000000..54625f7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentServiceImpl.java
@@ -0,0 +1,573 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchivePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment.HrmPortalPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentAppealRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDimensionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentAppealRecordMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentDimensionMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaScoreMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentStageMapper;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentProcessStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanOperationTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaSettingTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceResultAuditStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ARCHIVE_NOT_READY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ASSESSMENT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_INTERVIEW_NOT_READY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_SCORING_NOT_READY;
+
+/**
+ * HRM 员工绩效考核 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmPerformanceAssessmentServiceImpl implements HrmPerformanceAssessmentService {
+
+    @Resource
+    private HrmPerformanceAssessmentMapper assessmentMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaMapper assessmentQuotaMapper;
+    @Resource
+    private HrmPerformanceAssessmentDimensionMapper assessmentDimensionMapper;
+    @Resource
+    private HrmPerformanceAssessmentStageMapper assessmentStageMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaScoreMapper assessmentQuotaScoreMapper;
+    @Resource
+    private HrmPerformanceAssessmentAppealRecordMapper assessmentAppealRecordMapper;
+    @Resource
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmPerformanceAssessmentProcessService assessmentProcessService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmPerformanceAssessmentReviewService assessmentReviewService;
+
+    @Override
+    public HrmPerformanceAssessmentDO getPerformanceAssessment(Long id) {
+        return assessmentMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentDO> getPerformanceAssessmentList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return assessmentMapper.selectByIds(ids);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByPlanId(Long planId) {
+        return assessmentMapper.selectListByPlanId(planId);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByPlanIds(Collection<Long> planIds) {
+        if (CollUtil.isEmpty(planIds)) {
+            return Collections.emptyList();
+        }
+        return assessmentMapper.selectListByPlanIds(planIds);
+    }
+
+    @Override
+    public HrmPerformanceAssessmentDO validatePerformanceAssessmentExists(Long id) {
+        HrmPerformanceAssessmentDO assessment = assessmentMapper.selectById(id);
+        if (assessment == null) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        return assessment;
+    }
+
+    @Override
+    public HrmPerformanceAssessmentDO validatePerformanceAssessmentByEmployeeId(Long id, Long employeeId) {
+        HrmPerformanceAssessmentDO assessment = assessmentMapper.selectById(id);
+        if (assessment == null || ObjUtil.notEqual(assessment.getEmployeeId(), employeeId)) {
+            throw exception(PERFORMANCE_ASSESSMENT_NOT_EXISTS);
+        }
+        return assessment;
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentDO> getPerformanceAssessmentPage(
+            HrmPerformanceAssessmentPageReqVO reqVO) {
+        if (StringUtils.hasText(reqVO.getSearch()) || reqVO.getDeptId() != null
+                || reqVO.getEmployeeType() != null || reqVO.getEmployeeStatus() != null) {
+            HrmEmployeeListReqVO employeeReqVO = new HrmEmployeeListReqVO()
+                    .setSearch(reqVO.getSearch()).setDeptId(reqVO.getDeptId())
+                    .setType(reqVO.getEmployeeType()).setStatus(reqVO.getEmployeeStatus());
+            List<HrmEmployeeDO> employees = employeeService.getEmployeeList(employeeReqVO);
+            List<Long> employeeIds = convertList(employees, HrmEmployeeDO::getId);
+            if (CollUtil.isEmpty(employeeIds)) {
+                return PageResult.empty();
+            }
+            reqVO.setEmployeeIds(employeeIds);
+        }
+        return assessmentMapper.selectPage(reqVO);
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentDO> getPortalPerformanceAssessmentPage(
+            HrmPortalPerformanceAssessmentPageReqVO reqVO, Long employeeId) {
+        return assessmentMapper.selectPortalPage(reqVO, employeeId);
+    }
+
+    @Override
+    public Map<Integer, Long> getPerformanceAssessmentStatusCountMapByEmployeeId(
+            Long employeeId, String planName) {
+        return assessmentMapper.selectCountMapByEmployeeIdAndPlanName(employeeId, planName);
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentDO> getPerformanceAssessmentArchivePage(
+            HrmPerformanceArchivePageReqVO reqVO) {
+        return assessmentMapper.selectPageByStatus(
+                reqVO, HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+    }
+
+    @Override
+    public PageResult<HrmEmployeeDO> getPerformanceArchiveEmployeePage(
+            HrmPerformanceArchiveEmployeePageReqVO reqVO) {
+        return assessmentMapper.selectArchiveEmployeePage(
+                reqVO, HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+    }
+
+    @Override
+    public HrmPerformanceAssessmentDO getPerformanceAssessmentArchive(Long id) {
+        HrmPerformanceAssessmentDO assessment = assessmentMapper.selectById(id);
+        if (assessment == null
+                || ObjUtil.notEqual(assessment.getStatus(), HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())) {
+            return null;
+        }
+        return assessment;
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByEmployeeIdsAndStatus(
+            Collection<Long> employeeIds, Integer status) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        return assessmentMapper.selectListByEmployeeIdsAndStatus(employeeIds, status);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentDimensionDO> getPerformanceAssessmentDimensionList(
+            Collection<Long> assessmentIds) {
+        if (CollUtil.isEmpty(assessmentIds)) {
+            return Collections.emptyList();
+        }
+        return assessmentDimensionMapper.selectListByAssessmentIds(assessmentIds);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentQuotaDO> getPerformanceAssessmentQuotaList(
+            Collection<Long> assessmentIds) {
+        if (CollUtil.isEmpty(assessmentIds)) {
+            return Collections.emptyList();
+        }
+        return assessmentQuotaMapper.selectListByAssessmentIds(assessmentIds);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentStageDO> getPerformanceAssessmentStageList(
+            Collection<Long> assessmentIds) {
+        if (CollUtil.isEmpty(assessmentIds)) {
+            return Collections.emptyList();
+        }
+        return assessmentStageMapper.selectListByAssessmentIds(assessmentIds);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentQuotaScoreDO> getPerformanceAssessmentQuotaScoreList(
+            Collection<Long> assessmentStageIds) {
+        if (CollUtil.isEmpty(assessmentStageIds)) {
+            return Collections.emptyList();
+        }
+        return assessmentQuotaScoreMapper.selectListByAssessmentStageIds(assessmentStageIds);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentAppealRecordDO> getPerformanceAssessmentAppealRecordList(
+            Collection<Long> assessmentIds, Integer status) {
+        if (CollUtil.isEmpty(assessmentIds)) {
+            return Collections.emptyList();
+        }
+        return assessmentAppealRecordMapper.selectListByAssessmentIdsAndStatus(assessmentIds, status);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentDO> getPerformanceAssessmentListByStatus(Integer status) {
+        return assessmentMapper.selectListByStatus(status);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deletePerformanceArchiveRecords(Collection<Long> archiveIds) {
+        if (CollUtil.isEmpty(archiveIds)) {
+            return;
+        }
+        // 1. 只查询已归档的员工考核
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByIdsAndStatus(
+                archiveIds, HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+        // 2. 删除员工考核及其关联数据
+        deleteAssessmentData(convertSet(assessments, HrmPerformanceAssessmentDO::getId));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deletePerformanceArchiveRecordsByEmployeeIds(Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return;
+        }
+        // 1. 查询指定员工的已归档员工考核
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByEmployeeIdsAndStatus(
+                employeeIds, HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+        // 2. 删除员工考核及其关联数据
+        deleteAssessmentData(convertSet(assessments, HrmPerformanceAssessmentDO::getId));
+    }
+
+    @Override
+    public Map<Long, BigDecimal> getPerformanceArchiveEmployeeCoefficientMap(
+            Collection<Long> planIds, Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(planIds) || CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyMap();
+        }
+        List<HrmPerformanceAssessmentDO> assessments =
+                assessmentMapper.selectListByPlanIdsAndEmployeeIdsAndStatus(
+                        planIds, employeeIds, HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+        Map<Long, BigDecimal> coefficientMap = new LinkedHashMap<>();
+        for (HrmPerformanceAssessmentDO assessment : assessments) {
+            coefficientMap.putIfAbsent(assessment.getEmployeeId(),
+                    ObjUtil.defaultIfNull(assessment.getCoefficient(), BigDecimal.ONE));
+        }
+        return coefficientMap;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void addPerformanceAssessmentList(HrmPerformancePlanDO plan, Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return;
+        }
+        // 1. 查询已经参与计划的员工
+        List<HrmPerformanceAssessmentDO> existingAssessments =
+                assessmentMapper.selectListByPlanId(plan.getId());
+        Set<Long> existingEmployeeIds = convertSet(
+                existingAssessments, HrmPerformanceAssessmentDO::getEmployeeId);
+        // 2. 为新增员工创建考核
+        for (Long employeeId : employeeIds) {
+            if (!existingEmployeeIds.add(employeeId)) {
+                continue;
+            }
+            HrmPerformanceAssessmentDO assessment = new HrmPerformanceAssessmentDO()
+                    .setPlanId(plan.getId()).setEmployeeId(employeeId)
+                    .setStatus(plan.getStatus())
+                    .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                    .setStageType(plan.getStageType())
+                    .setStageSort(0).setScore(BigDecimal.ZERO).setCoefficient(BigDecimal.ONE)
+                    .setAppealStatus(HrmPerformanceAppealStatusEnum.NONE.getStatus());
+            assessmentMapper.insert(assessment);
+
+            // 3. 运行中的计划需要同步初始化指标
+            if (Objects.equals(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())) {
+                assessmentReviewService.ensureAssessmentQuotaList(plan, assessment);
+            }
+        }
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void syncPerformanceAssessmentList(HrmPerformancePlanDO plan, Collection<Long> employeeIds) {
+        // 1. 删除不再参与计划的员工考核
+        Set<Long> addedEmployeeIds = CollUtil.isEmpty(employeeIds)
+                ? new LinkedHashSet<>() : new LinkedHashSet<>(employeeIds);
+        List<Long> deletedAssessmentIds = new ArrayList<>();
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(plan.getId());
+        for (HrmPerformanceAssessmentDO assessment : assessments) {
+            if (addedEmployeeIds.remove(assessment.getEmployeeId())) {
+                continue;
+            }
+            deletedAssessmentIds.add(assessment.getId());
+        }
+        deleteAssessmentData(deletedAssessmentIds);
+
+        // 2. 添加新参与计划的员工考核
+        addPerformanceAssessmentList(plan, addedEmployeeIds);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deletePerformanceAssessmentList(Long planId, Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return;
+        }
+        // 1. 查询指定员工的考核
+        Set<Long> employeeIdSet = new LinkedHashSet<>(employeeIds);
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(planId);
+        assessments = filterList(assessments,
+                assessment -> employeeIdSet.contains(assessment.getEmployeeId()));
+
+        // 2. 删除员工考核及其关联数据
+        List<Long> assessmentIds = convertList(assessments, HrmPerformanceAssessmentDO::getId);
+        deleteAssessmentData(assessmentIds);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deletePerformanceAssessmentListByPlanId(Long planId) {
+        // 1. 查询计划的员工考核
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(planId);
+
+        // 2. 删除员工考核及其关联数据
+        List<Long> assessmentIds = convertList(assessments, HrmPerformanceAssessmentDO::getId);
+        deleteAssessmentData(assessmentIds);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void terminatePerformanceAssessmentListByPlanId(Long planId, Long operatorEmployeeId) {
+        // 1. 查询绩效计划的员工考核
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(planId);
+
+        // 2. 终止员工考核并保留流程快照
+        for (HrmPerformanceAssessmentDO assessment : assessments) {
+            assessmentMapper.updateById(new HrmPerformanceAssessmentDO().setId(assessment.getId())
+                    .setStatus(HrmPerformancePlanStatusEnum.TERMINATED.getStatus())
+                    .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus()));
+            assessmentActionRecordService.createPerformanceAssessmentActionRecord(
+                    operatorEmployeeId, assessment.getId(), null,
+                    HrmPerformanceAssessmentActionTypeEnum.TERMINATE, null, null);
+        }
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Integer startPerformanceAssessmentList(HrmPerformancePlanDO plan) {
+        // 1. 校验计划存在员工考核
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(plan.getId());
+        if (CollUtil.isEmpty(assessments)) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+        Integer initialStage = Objects.equals(plan.getQuotaSettingType(), HrmPerformanceQuotaSettingTypeEnum.EMPLOYEE.getType())
+                ? HrmPerformanceStageTypeEnum.FILL_QUOTA.getType() : HrmPerformanceStageTypeEnum.EXECUTING.getType();
+
+        // 2. 初始化每个员工考核的指标和流程阶段
+        for (HrmPerformanceAssessmentDO assessment : assessments) {
+            assessmentReviewService.ensureAssessmentQuotaList(plan, assessment);
+            assessmentProcessService.initializeAssessmentStages(plan, assessment);
+            HrmPerformanceAssessmentDO updateObj = new HrmPerformanceAssessmentDO().setId(assessment.getId())
+                    .setStatus(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                    .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                    .setStageType(initialStage).setStageSort(0);
+            if (Objects.equals(initialStage, HrmPerformanceStageTypeEnum.FILL_QUOTA.getType())) {
+                updateObj.setStageSort(assessmentProcessService.activateAssessmentStage(assessment,
+                        HrmPerformanceStageTypeEnum.FILL_QUOTA.getType()).getSort());
+            }
+            assessmentMapper.updateById(updateObj);
+        }
+        return initialStage;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Integer openPerformanceAssessmentScoring(HrmPerformancePlanDO plan) {
+        // 1. 校验全部员工考核可以开启评分
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(plan.getId());
+        if (!isPerformanceAssessmentScoringReady(plan, assessments)) {
+            throw exception(PERFORMANCE_SCORING_NOT_READY);
+        }
+
+        // 2. 初始化指标和阶段，并激活首个评分阶段
+        Integer planStageType = null;
+        for (HrmPerformanceAssessmentDO assessment : assessments) {
+            assessmentReviewService.ensureAssessmentQuotaList(plan, assessment);
+            assessmentProcessService.initializeAssessmentStages(plan, assessment);
+            HrmPerformanceAssessmentStageDO firstReviewStage = assessmentProcessService.activateFirstReviewStage(assessment);
+            HrmPerformanceAssessmentDO updateObj = new HrmPerformanceAssessmentDO().setId(assessment.getId())
+                    .setStatus(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                    .setStageType(firstReviewStage.getType()).setStageSort(firstReviewStage.getSort());
+            assessmentMapper.updateById(updateObj);
+            if (planStageType == null) {
+                planStageType = firstReviewStage.getType();
+            }
+        }
+        return planStageType;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Integer startPerformanceAssessmentInterview(HrmPerformancePlanDO plan) {
+        // 1. 校验全部员工考核可以发起面谈
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(plan.getId());
+        List<HrmPerformanceAssessmentStageDO> stages = assessmentStageMapper.selectListByAssessmentIds(
+                convertSet(assessments, HrmPerformanceAssessmentDO::getId));
+        if (!isPerformanceAssessmentInterviewReady(plan, assessments, stages)) {
+            throw exception(PERFORMANCE_INTERVIEW_NOT_READY);
+        }
+
+        // 2. 需要员工确认结果时，激活结果确认阶段
+        boolean resultConfirmationEnabled = Boolean.TRUE.equals(plan.getResultConfirmation());
+        Integer nextStage = resultConfirmationEnabled
+                ? HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType()
+                : HrmPerformanceStageTypeEnum.END.getType();
+        if (resultConfirmationEnabled) {
+            for (HrmPerformanceAssessmentDO assessment : assessments) {
+                HrmPerformanceAssessmentStageDO assessmentStage =
+                        assessmentProcessService.activateAssessmentStage(
+                                assessment, HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+                HrmPerformanceAssessmentDO updateObj = new HrmPerformanceAssessmentDO().setId(assessment.getId())
+                        .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                        .setStageType(nextStage).setStageSort(assessmentStage.getSort());
+                assessmentMapper.updateById(updateObj);
+            }
+        }
+        return nextStage;
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void archivePerformanceAssessmentList(HrmPerformancePlanDO plan) {
+        // 1. 校验全部员工考核可以归档
+        List<HrmPerformanceAssessmentDO> assessments = assessmentMapper.selectListByPlanId(plan.getId());
+        if (!isPerformanceAssessmentArchiveReady(plan, assessments)) {
+            throw exception(PERFORMANCE_ARCHIVE_NOT_READY);
+        }
+
+        // 2. 归档全部员工考核
+        LocalDateTime archiveTime = LocalDateTime.now();
+        for (HrmPerformanceAssessmentDO assessment : assessments) {
+            HrmPerformanceAssessmentDO updateObj = new HrmPerformanceAssessmentDO().setId(assessment.getId())
+                    .setStatus(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())
+                    .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus())
+                    .setStageType(HrmPerformanceStageTypeEnum.ARCHIVED.getType())
+                    .setArchiveTime(archiveTime);
+            assessmentMapper.updateById(updateObj);
+        }
+    }
+
+    private void deleteAssessmentData(Collection<Long> assessmentIds) {
+        if (CollUtil.isEmpty(assessmentIds)) {
+            return;
+        }
+        // 1. 删除阶段的指标评分
+        List<HrmPerformanceAssessmentStageDO> stages =
+                assessmentStageMapper.selectListByAssessmentIds(assessmentIds);
+        Set<Long> stageIds = convertSet(stages, HrmPerformanceAssessmentStageDO::getId);
+        if (CollUtil.isNotEmpty(stageIds)) {
+            assessmentQuotaScoreMapper.deleteByAssessmentStageIds(stageIds);
+        }
+
+        // 2. 删除员工考核及其关联数据
+        assessmentActionRecordService.deletePerformanceAssessmentActionRecordList(assessmentIds);
+        assessmentAppealRecordMapper.deleteByAssessmentIds(assessmentIds);
+        assessmentStageMapper.deleteByAssessmentIds(assessmentIds);
+        assessmentQuotaMapper.deleteByAssessmentIds(assessmentIds);
+        assessmentDimensionMapper.deleteByAssessmentIds(assessmentIds);
+        assessmentMapper.deleteByIds(assessmentIds);
+    }
+
+    @Override
+    public boolean isPerformanceAssessmentScoringReady(
+            HrmPerformancePlanDO plan, List<HrmPerformanceAssessmentDO> assessments) {
+        return Objects.equals(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                && CollUtil.isNotEmpty(assessments)
+                && assessments.stream().allMatch(assessment -> Objects.equals(
+                        assessment.getStageType(), HrmPerformanceStageTypeEnum.EXECUTING.getType()));
+    }
+
+    @Override
+    public boolean isPerformanceAssessmentInterviewReady(
+            HrmPerformancePlanDO plan, List<HrmPerformanceAssessmentDO> assessments,
+            List<HrmPerformanceAssessmentStageDO> stages) {
+        // 1. 只有运行中且存在员工考核的计划，才允许发起绩效面谈
+        if (ObjUtil.notEqual(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                || CollUtil.isEmpty(assessments)) {
+            return false;
+        }
+        // 2. 未启用结果确认时，全部员工考核进入结束阶段后即可发起面谈
+        if (Boolean.FALSE.equals(plan.getResultConfirmation())) {
+            return Objects.equals(plan.getOperationType(), HrmPerformancePlanOperationTypeEnum.START_INTERVIEW.getType())
+                    && assessments.stream().allMatch(assessment -> Objects.equals(
+                            assessment.getStageType(), HrmPerformanceStageTypeEnum.END.getType()));
+        }
+        // 3. 启用结果确认时，全部员工考核必须进入结果确认阶段，且启用的结果审核均已通过
+        boolean resultAuditFinished = assessments.stream().allMatch(
+                assessment -> Objects.equals(assessment.getStageType(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType())
+                && (Boolean.FALSE.equals(plan.getResultAudit())
+                        || Objects.equals(assessment.getResultAuditStatus(), HrmPerformanceResultAuditStatusEnum.PASS.getStatus())));
+        if (!resultAuditFinished) {
+            return false;
+        }
+        // 4. 每个员工考核都必须存在未处理的结果确认节点，避免遗漏或重复发起面谈
+        Set<Long> assessmentIds = convertSet(assessments, HrmPerformanceAssessmentDO::getId);
+        stages = filterList(stages, stage -> Objects.equals(stage.getType(),
+                HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType())
+                && Objects.equals(stage.getStatus(),
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus()));
+        Set<Long> waitingAssessmentIds =
+                convertSet(stages, HrmPerformanceAssessmentStageDO::getAssessmentId);
+        return waitingAssessmentIds.containsAll(assessmentIds);
+    }
+
+    @Override
+    public boolean isPerformanceAssessmentArchiveReady(
+            HrmPerformancePlanDO plan, List<HrmPerformanceAssessmentDO> assessments) {
+        return Objects.equals(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                && CollUtil.isNotEmpty(assessments)
+                && Objects.equals(plan.getOperationType(), HrmPerformancePlanOperationTypeEnum.ARCHIVE.getType())
+                && assessments.stream().allMatch(assessment -> Objects.equals(
+                        assessment.getStageType(), HrmPerformanceStageTypeEnum.END.getType()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateService.java
new file mode 100644
index 0000000..1dce597
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateService.java
@@ -0,0 +1,88 @@
+package cn.iocoder.yudao.module.hrm.service.performance.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 绩效考核模板 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformanceAssessmentTemplateService {
+
+    /**
+     * 创建绩效考核模板
+     *
+     * @param createReqVO 创建信息
+     * @return 模板编号
+     */
+    Long createPerformanceAssessmentTemplate(@Valid HrmPerformanceAssessmentTemplateSaveReqVO createReqVO);
+
+    /**
+     * 更新绩效考核模板
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updatePerformanceAssessmentTemplate(@Valid HrmPerformanceAssessmentTemplateSaveReqVO updateReqVO);
+
+    /**
+     * 删除绩效考核模板
+     *
+     * @param id 模板编号
+     */
+    void deletePerformanceAssessmentTemplate(Long id);
+
+    /**
+     * 批量删除绩效考核模板
+     *
+     * @param ids 模板编号列表
+     */
+    void deletePerformanceAssessmentTemplateList(List<Long> ids);
+
+    /**
+     * 获得绩效考核模板
+     *
+     * @param id 模板编号
+     * @return 绩效考核模板
+     */
+    HrmPerformanceAssessmentTemplateDO getPerformanceAssessmentTemplate(Long id);
+
+    /**
+     * 获得绩效考核模板分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 绩效考核模板分页
+     */
+    PageResult<HrmPerformanceAssessmentTemplateDO> getPerformanceAssessmentTemplatePage(
+            HrmPerformanceAssessmentTemplatePageReqVO pageReqVO);
+
+    /**
+     * 获得指定状态的绩效考核模板列表
+     *
+     * @param status 状态
+     * @return 绩效考核模板列表
+     */
+    List<HrmPerformanceAssessmentTemplateDO> getPerformanceAssessmentTemplateListByStatus(Integer status);
+
+    /**
+     * 校验绩效考核模板存在
+     *
+     * @param id 模板编号
+     * @return 绩效考核模板
+     */
+    HrmPerformanceAssessmentTemplateDO validatePerformanceAssessmentTemplateExists(Long id);
+
+    /**
+     * 校验绩效考核模板有效
+     *
+     * @param id 模板编号
+     * @return 绩效考核模板
+     */
+    HrmPerformanceAssessmentTemplateDO validatePerformanceAssessmentTemplateEnabled(Long id);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateServiceImpl.java
new file mode 100644
index 0000000..7c66967
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateServiceImpl.java
@@ -0,0 +1,176 @@
+package cn.iocoder.yudao.module.hrm.service.performance.config;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.config.HrmPerformanceAssessmentTemplateMapper;
+import jakarta.annotation.Resource;
+import org.apache.commons.lang3.StringUtils;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.HashSet;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ASSESSMENT_TEMPLATE_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+
+/**
+ * HRM 绩效考核模板 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmPerformanceAssessmentTemplateServiceImpl implements HrmPerformanceAssessmentTemplateService {
+
+    @Resource
+    private HrmPerformanceAssessmentTemplateMapper assessmentTemplateMapper;
+
+    @Resource
+    @Lazy
+    private HrmPerformancePlanService performancePlanService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Long createPerformanceAssessmentTemplate(HrmPerformanceAssessmentTemplateSaveReqVO createReqVO) {
+        // 1. 校验模板名称唯一
+        validateAssessmentTemplateNameUnique(null, createReqVO.getName());
+
+        // 2. 创建考核模板
+        HrmPerformanceAssessmentTemplateDO template = BeanUtils.toBean(
+                createReqVO, HrmPerformanceAssessmentTemplateDO.class)
+                .setStatus(CommonStatusEnum.ENABLE.getStatus());
+        normalizeAssessmentTemplate(template);
+        assessmentTemplateMapper.insert(template);
+        return template.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updatePerformanceAssessmentTemplate(HrmPerformanceAssessmentTemplateSaveReqVO updateReqVO) {
+        // 1.1 校验模板存在
+        HrmPerformanceAssessmentTemplateDO oldTemplate =
+                validatePerformanceAssessmentTemplateEnabled(updateReqVO.getId());
+        // 1.2 校验模板名称唯一
+        validateAssessmentTemplateNameUnique(updateReqVO.getId(), updateReqVO.getName());
+
+        // 2. 停用旧模板，避免修改已被绩效计划引用的模板版本
+        assessmentTemplateMapper.updateById(new HrmPerformanceAssessmentTemplateDO()
+                .setId(oldTemplate.getId()).setStatus(CommonStatusEnum.DISABLE.getStatus()));
+
+        // 3. 创建新版本，既有绩效计划继续引用旧模板编号
+        HrmPerformanceAssessmentTemplateDO template = BeanUtils.toBean(
+                updateReqVO, HrmPerformanceAssessmentTemplateDO.class)
+                .setId(null).setStatus(CommonStatusEnum.ENABLE.getStatus());
+        template.setCreator(oldTemplate.getCreator());
+        template.setCreateTime(oldTemplate.getCreateTime());
+        normalizeAssessmentTemplate(template);
+        assessmentTemplateMapper.insert(template);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deletePerformanceAssessmentTemplate(Long id) {
+        // 1.1 校验模板存在
+        validatePerformanceAssessmentTemplateExists(id);
+        // 1.2 校验模板未被绩效计划使用
+        if (performancePlanService.getPerformancePlanCountByAssessmentTemplateId(id) > 0) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2. 删除考核模板
+        assessmentTemplateMapper.deleteById(id);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deletePerformanceAssessmentTemplateList(List<Long> ids) {
+        // 1.1 校验模板全部存在
+        List<HrmPerformanceAssessmentTemplateDO> templates = assessmentTemplateMapper.selectByIds(ids);
+        if (templates.size() != new HashSet<>(ids).size()) {
+            throw exception(PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS);
+        }
+        // 1.2 校验模板未被绩效计划使用
+        for (HrmPerformanceAssessmentTemplateDO template : templates) {
+            if (performancePlanService.getPerformancePlanCountByAssessmentTemplateId(template.getId()) > 0) {
+                throw exception(PERFORMANCE_DATA_ILLEGAL);
+            }
+        }
+
+        // 2. 批量删除考核模板
+        assessmentTemplateMapper.deleteByIds(ids);
+    }
+
+    @Override
+    public HrmPerformanceAssessmentTemplateDO getPerformanceAssessmentTemplate(Long id) {
+        return assessmentTemplateMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<HrmPerformanceAssessmentTemplateDO> getPerformanceAssessmentTemplatePage(
+            HrmPerformanceAssessmentTemplatePageReqVO pageReqVO) {
+        return assessmentTemplateMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmPerformanceAssessmentTemplateDO> getPerformanceAssessmentTemplateListByStatus(Integer status) {
+        return assessmentTemplateMapper.selectListByStatus(status);
+    }
+
+    @Override
+    public HrmPerformanceAssessmentTemplateDO validatePerformanceAssessmentTemplateExists(Long id) {
+        HrmPerformanceAssessmentTemplateDO template = assessmentTemplateMapper.selectById(id);
+        if (template == null) {
+            throw exception(PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    @Override
+    public HrmPerformanceAssessmentTemplateDO validatePerformanceAssessmentTemplateEnabled(Long id) {
+        HrmPerformanceAssessmentTemplateDO template = validatePerformanceAssessmentTemplateExists(id);
+        if (ObjectUtil.notEqual(template.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+            throw exception(PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    private void validateAssessmentTemplateNameUnique(Long id, String name) {
+        HrmPerformanceAssessmentTemplateDO template = assessmentTemplateMapper.selectByName(name);
+        if (template != null && ObjectUtil.notEqual(template.getId(), id)) {
+            throw exception(PERFORMANCE_ASSESSMENT_TEMPLATE_NAME_DUPLICATE);
+        }
+    }
+
+    /**
+     * 规范化考核模板，并重新计算维度、指标数量
+     *
+     * @param template 考核模板
+     */
+    private void normalizeAssessmentTemplate(HrmPerformanceAssessmentTemplateDO template) {
+        template.setName(template.getName().trim()).setIllustrate(StringUtils.trimToNull(template.getIllustrate()));
+        int quotaCount = 0;
+        for (HrmPerformanceAssessmentTemplateDO.Dimension dimension : template.getDimensions()) {
+            dimension.setName(dimension.getName().trim()).setRemark(StringUtils.trimToNull(dimension.getRemark()))
+                    .setAllowEdit(Boolean.TRUE.equals(dimension.getAllowEdit()));
+            for (HrmPerformanceAssessmentTemplateDO.Quota quota : dimension.getQuotas()) {
+                quota.setName(quota.getName().trim())
+                        .setIllustrate(StringUtils.trimToNull(quota.getIllustrate()))
+                        .setStandard(StringUtils.trimToNull(quota.getStandard()));
+                quotaCount++;
+            }
+        }
+        template.setDimensionCount(template.getDimensions().size()).setQuotaCount(quotaCount);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateService.java
new file mode 100644
index 0000000..0d97e6e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateService.java
@@ -0,0 +1,88 @@
+package cn.iocoder.yudao.module.hrm.service.performance.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 绩效结果模板 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformanceResultTemplateService {
+
+    /**
+     * 创建绩效结果模板
+     *
+     * @param createReqVO 创建信息
+     * @return 模板编号
+     */
+    Long createPerformanceResultTemplate(@Valid HrmPerformanceResultTemplateSaveReqVO createReqVO);
+
+    /**
+     * 更新绩效结果模板
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updatePerformanceResultTemplate(@Valid HrmPerformanceResultTemplateSaveReqVO updateReqVO);
+
+    /**
+     * 删除绩效结果模板
+     *
+     * @param id 模板编号
+     */
+    void deletePerformanceResultTemplate(Long id);
+
+    /**
+     * 批量删除绩效结果模板
+     *
+     * @param ids 模板编号列表
+     */
+    void deletePerformanceResultTemplateList(List<Long> ids);
+
+    /**
+     * 获得绩效结果模板
+     *
+     * @param id 模板编号
+     * @return 绩效结果模板
+     */
+    HrmPerformanceResultTemplateDO getPerformanceResultTemplate(Long id);
+
+    /**
+     * 获得绩效结果模板分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 绩效结果模板分页
+     */
+    PageResult<HrmPerformanceResultTemplateDO> getPerformanceResultTemplatePage(
+            HrmPerformanceResultTemplatePageReqVO pageReqVO);
+
+    /**
+     * 获得绩效结果模板列表
+     *
+     * @param status 状态
+     * @return 绩效结果模板列表
+     */
+    List<HrmPerformanceResultTemplateDO> getPerformanceResultTemplateList(Integer status);
+
+    /**
+     * 校验绩效结果模板存在
+     *
+     * @param id 模板编号
+     * @return 绩效结果模板
+     */
+    HrmPerformanceResultTemplateDO validatePerformanceResultTemplateExists(Long id);
+
+    /**
+     * 校验绩效结果模板已启用
+     *
+     * @param id 模板编号
+     * @return 绩效结果模板
+     */
+    HrmPerformanceResultTemplateDO validatePerformanceResultTemplateEnabled(Long id);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateServiceImpl.java
new file mode 100644
index 0000000..a76a8b9
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateServiceImpl.java
@@ -0,0 +1,150 @@
+package cn.iocoder.yudao.module.hrm.service.performance.config;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.config.HrmPerformanceResultTemplateMapper;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.HashSet;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_RESULT_TEMPLATE_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS;
+
+/**
+ * HRM 绩效结果模板 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmPerformanceResultTemplateServiceImpl implements HrmPerformanceResultTemplateService {
+
+    @Resource
+    private HrmPerformanceResultTemplateMapper resultTemplateMapper;
+
+    @Resource
+    @Lazy
+    private HrmPerformancePlanService performancePlanService;
+
+    @Override
+    public Long createPerformanceResultTemplate(HrmPerformanceResultTemplateSaveReqVO createReqVO) {
+        // 1. 校验结果模板名称唯一
+        validateResultTemplateNameUnique(null, createReqVO.getName());
+
+        // 2. 创建结果模板
+        HrmPerformanceResultTemplateDO template = BeanUtils.toBean(
+                createReqVO, HrmPerformanceResultTemplateDO.class)
+                .setStatus(CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template);
+        return template.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updatePerformanceResultTemplate(HrmPerformanceResultTemplateSaveReqVO updateReqVO) {
+        // 1.1 校验结果模板存在
+        HrmPerformanceResultTemplateDO oldTemplate =
+                validatePerformanceResultTemplateEnabled(updateReqVO.getId());
+        // 1.2 校验结果模板名称唯一
+        validateResultTemplateNameUnique(updateReqVO.getId(), updateReqVO.getName());
+
+        // 2. 停用旧模板，避免修改已被绩效计划引用的模板版本
+        resultTemplateMapper.updateById(new HrmPerformanceResultTemplateDO()
+                .setId(oldTemplate.getId()).setStatus(CommonStatusEnum.DISABLE.getStatus()));
+
+        // 3. 创建新版本，既有绩效计划继续引用旧模板编号和结果配置快照
+        HrmPerformanceResultTemplateDO template = BeanUtils.toBean(
+                updateReqVO, HrmPerformanceResultTemplateDO.class)
+                .setId(null).setStatus(CommonStatusEnum.ENABLE.getStatus());
+        template.setCreator(oldTemplate.getCreator());
+        template.setCreateTime(oldTemplate.getCreateTime());
+        resultTemplateMapper.insert(template);
+    }
+
+    @Override
+    public void deletePerformanceResultTemplate(Long id) {
+        // 1.1 校验结果模板存在
+        validatePerformanceResultTemplateExists(id);
+        // 1.2 校验结果模板未被绩效计划使用
+        if (performancePlanService.getPerformancePlanCountByResultTemplateId(id) > 0) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+
+        // 2. 删除结果模板
+        resultTemplateMapper.deleteById(id);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deletePerformanceResultTemplateList(List<Long> ids) {
+        // 1.1 校验结果模板全部存在
+        List<HrmPerformanceResultTemplateDO> templates = resultTemplateMapper.selectByIds(ids);
+        if (templates.size() != new HashSet<>(ids).size()) {
+            throw exception(PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS);
+        }
+        // 1.2 校验结果模板未被绩效计划使用
+        for (HrmPerformanceResultTemplateDO template : templates) {
+            if (performancePlanService.getPerformancePlanCountByResultTemplateId(template.getId()) > 0) {
+                throw exception(PERFORMANCE_DATA_ILLEGAL);
+            }
+        }
+
+        // 2. 批量删除结果模板
+        resultTemplateMapper.deleteByIds(ids);
+    }
+
+    @Override
+    public HrmPerformanceResultTemplateDO getPerformanceResultTemplate(Long id) {
+        return resultTemplateMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<HrmPerformanceResultTemplateDO> getPerformanceResultTemplatePage(
+            HrmPerformanceResultTemplatePageReqVO pageReqVO) {
+        return resultTemplateMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmPerformanceResultTemplateDO> getPerformanceResultTemplateList(Integer status) {
+        return resultTemplateMapper.selectListByStatus(status);
+    }
+
+    @Override
+    public HrmPerformanceResultTemplateDO validatePerformanceResultTemplateExists(Long id) {
+        HrmPerformanceResultTemplateDO template = resultTemplateMapper.selectById(id);
+        if (template == null) {
+            throw exception(PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    @Override
+    public HrmPerformanceResultTemplateDO validatePerformanceResultTemplateEnabled(Long id) {
+        HrmPerformanceResultTemplateDO template = validatePerformanceResultTemplateExists(id);
+        if (ObjectUtil.notEqual(template.getStatus(), CommonStatusEnum.ENABLE.getStatus())) {
+            throw exception(PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    private void validateResultTemplateNameUnique(Long id, String name) {
+        HrmPerformanceResultTemplateDO template = resultTemplateMapper.selectByName(name);
+        if (template != null && ObjectUtil.notEqual(template.getId(), id)) {
+            throw exception(PERFORMANCE_RESULT_TEMPLATE_NAME_DUPLICATE);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanService.java
new file mode 100644
index 0000000..d1b61cb
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanService.java
@@ -0,0 +1,178 @@
+package cn.iocoder.yudao.module.hrm.service.performance.plan;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentBatchReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 绩效计划 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmPerformancePlanService {
+
+    /**
+     * 创建绩效计划
+     *
+     * @param reqVO 绩效计划创建参数
+     * @return 绩效计划编号
+     */
+    Long createPerformancePlan(@Valid HrmPerformancePlanSaveReqVO reqVO);
+
+    /**
+     * 更新绩效计划
+     *
+     * @param reqVO 绩效计划更新参数
+     */
+    void updatePerformancePlan(@Valid HrmPerformancePlanSaveReqVO reqVO);
+
+    /**
+     * 删除绩效计划
+     *
+     * @param id 绩效计划编号
+     */
+    void deletePerformancePlan(Long id);
+
+    /**
+     * 获得绩效计划
+     *
+     * @param id 绩效计划编号
+     * @return 绩效计划
+     */
+    HrmPerformancePlanDO getPerformancePlan(Long id);
+
+    /**
+     * 获得绩效计划分页
+     *
+     * @param reqVO 分页查询参数
+     * @return 绩效计划分页
+     */
+    PageResult<HrmPerformancePlanDO> getPerformancePlanPage(HrmPerformancePlanPageReqVO reqVO);
+
+    /**
+     * 获得绩效计划列表
+     *
+     * @param ids 计划编号集合
+     * @return 绩效计划列表
+     */
+    List<HrmPerformancePlanDO> getPerformancePlanList(Collection<Long> ids);
+
+    /**
+     * 获得绩效计划 Map
+     *
+     * @param ids 计划编号集合
+     * @return 绩效计划 Map
+     */
+    default Map<Long, HrmPerformancePlanDO> getPerformancePlanMap(Collection<Long> ids) {
+        return convertMap(getPerformancePlanList(ids), HrmPerformancePlanDO::getId);
+    }
+
+    /**
+     * 添加参评员工
+     *
+     * @param reqVO 批量操作参数
+     */
+    void addPerformancePlanEmployees(HrmPerformanceAssessmentBatchReqVO reqVO);
+
+    /**
+     * 移除参评员工
+     *
+     * @param reqVO 批量操作参数
+     */
+    void removePerformancePlanEmployees(HrmPerformanceAssessmentBatchReqVO reqVO);
+
+    /**
+     * 启动绩效计划
+     *
+     * @param id 绩效计划编号
+     */
+    void startPerformancePlan(Long id);
+
+    /**
+     * 开启绩效评分
+     *
+     * @param id 绩效计划编号
+     */
+    void openPerformancePlanScoring(Long id);
+
+    /**
+     * 发起绩效面谈
+     *
+     * @param id 绩效计划编号
+     */
+    void startPerformancePlanInterview(Long id);
+
+    /**
+     * 归档绩效计划
+     *
+     * @param id 绩效计划编号
+     */
+    void archivePerformancePlan(Long id);
+
+    /**
+     * 终止绩效计划
+     *
+     * @param userId 后台用户编号
+     * @param id 绩效计划编号
+     */
+    void terminatePerformancePlan(Long userId, Long id);
+
+    /**
+     * 获得绩效计划状态统计
+     *
+     * @param reqVO 查询参数
+     * @return 状态数量 Map
+     */
+    Map<Integer, Long> getPerformancePlanStatusCount(HrmPerformancePlanPageReqVO reqVO);
+
+    /**
+     * 获得使用指定考核模板的绩效计划数量
+     *
+     * @param assessmentTemplateId 考核模板编号
+     * @return 绩效计划数量
+     */
+    long getPerformancePlanCountByAssessmentTemplateId(Long assessmentTemplateId);
+
+    /**
+     * 获得使用指定结果模板的绩效计划数量
+     *
+     * @param resultTemplateId 结果模板编号
+     * @return 绩效计划数量
+     */
+    long getPerformancePlanCountByResultTemplateId(Long resultTemplateId);
+
+    /**
+     * 获得指定计薪月份的绩效计划列表
+     *
+     * @param paidForMonth 计薪月份
+     * @return 绩效计划列表
+     */
+    List<HrmPerformancePlanDO> getPerformancePlanListByPaidForMonth(String paidForMonth);
+
+    /**
+     * 校验绩效计划是否存在
+     *
+     * @param id 绩效计划编号
+     * @return 绩效计划
+     */
+    HrmPerformancePlanDO validatePerformancePlanExists(Long id);
+
+    /**
+     * 更新绩效计划阶段和可执行操作
+     *
+     * @param id 绩效计划编号
+     * @param stageType 阶段类型
+     * @param operationType 可执行操作
+     */
+    void updatePerformancePlanStageTypeAndOperationType(Long id, Integer stageType, Integer operationType);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanServiceImpl.java
new file mode 100644
index 0000000..7bb36dd
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanServiceImpl.java
@@ -0,0 +1,598 @@
+package cn.iocoder.yudao.module.hrm.service.performance.plan;
+
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentService;
+import cn.iocoder.yudao.module.hrm.service.performance.config.HrmPerformanceAssessmentTemplateService;
+import cn.iocoder.yudao.module.hrm.service.performance.config.HrmPerformanceResultTemplateService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentBatchReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.Scope;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.plan.HrmPerformancePlanMapper;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanOperationTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanScopeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.ArrayList;
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.notEqualsAny;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_PLAN_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_PLAN_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_PLAN_STARTED_CANNOT_MODIFY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_PLAN_STATUS_NOT_ALLOW_DELETE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_ACTION_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_ARCHIVE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_ARCHIVE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_CREATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_CREATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_INTERVIEW_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_INTERVIEW_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_OPEN_SCORING_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_OPEN_SCORING_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_START_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_START_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_TERMINATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_TERMINATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_PERFORMANCE_PLAN_UPDATE_SUCCESS;
+
+/**
+ * HRM 绩效计划 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmPerformancePlanServiceImpl implements HrmPerformancePlanService {
+
+    @Resource
+    private HrmPerformancePlanMapper performancePlanMapper;
+
+    @Resource
+    private HrmPerformanceAssessmentService performanceAssessmentService;
+    @Resource
+    private HrmPerformanceAssessmentTemplateService performanceAssessmentTemplateService;
+    @Resource
+    private HrmPerformanceResultTemplateService performanceResultTemplateService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_CREATE_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_CREATE_SUCCESS)
+    public Long createPerformancePlan(HrmPerformancePlanSaveReqVO reqVO) {
+        // 1. 校验计划配置
+        validateNameUnique(null, reqVO.getName());
+        HrmPerformanceAssessmentTemplateDO assessmentTemplate = performanceAssessmentTemplateService
+                .validatePerformanceAssessmentTemplateEnabled(reqVO.getAssessmentTemplateId());
+        HrmPerformanceResultTemplateDO resultTemplate =
+                performanceResultTemplateService.validatePerformanceResultTemplateEnabled(reqVO.getResultTemplateId());
+        validatePlanReferences(reqVO);
+        validatePlanScoreRange(assessmentTemplate);
+
+        // 2. 创建绩效计划
+        HrmPerformancePlanDO plan = BeanUtils.toBean(reqVO, HrmPerformancePlanDO.class)
+                .setAssessmentConfig(BeanUtils.toBean(assessmentTemplate,
+                        HrmPerformanceAssessmentTemplateDO.AssessmentConfig.class))
+                .setResultConfig(BeanUtils.toBean(resultTemplate, HrmPerformancePlanDO.ResultConfig.class))
+                .setStatus(HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus())
+                .setStageType(HrmPerformanceStageTypeEnum.NOT_STARTED.getType())
+                .setOperationType(null);
+        if (!Boolean.TRUE.equals(plan.getSyncToSalary())) {
+            plan.setPaidForMonth(null);
+        }
+        performancePlanMapper.insert(plan);
+
+        // 3. 创建员工绩效考核
+        performanceAssessmentService.addPerformanceAssessmentList(plan, resolvePlanScopeEmployeeIds(plan));
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+        return plan.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_UPDATE_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_UPDATE_SUCCESS)
+    public void updatePerformancePlan(HrmPerformancePlanSaveReqVO reqVO) {
+        // 1. 校验计划配置
+        HrmPerformancePlanDO oldPlan = performancePlanMapper.selectOneForUpdate(
+                HrmPerformancePlanDO::getId, reqVO.getId());
+        validatePlanEditable(oldPlan);
+        validateNameUnique(reqVO.getId(), reqVO.getName());
+        HrmPerformanceAssessmentTemplateDO assessmentTemplate;
+        if (Objects.equals(oldPlan.getAssessmentTemplateId(), reqVO.getAssessmentTemplateId())) {
+            assessmentTemplate = performanceAssessmentTemplateService
+                    .validatePerformanceAssessmentTemplateExists(reqVO.getAssessmentTemplateId());
+        } else {
+            assessmentTemplate = performanceAssessmentTemplateService
+                    .validatePerformanceAssessmentTemplateEnabled(reqVO.getAssessmentTemplateId());
+        }
+        HrmPerformanceResultTemplateDO resultTemplate;
+        if (Objects.equals(oldPlan.getResultTemplateId(), reqVO.getResultTemplateId())) {
+            resultTemplate = performanceResultTemplateService
+                    .validatePerformanceResultTemplateExists(reqVO.getResultTemplateId());
+        } else {
+            resultTemplate = performanceResultTemplateService
+                    .validatePerformanceResultTemplateEnabled(reqVO.getResultTemplateId());
+        }
+        validatePlanReferences(reqVO);
+        validatePlanScoreRange(assessmentTemplate);
+
+        // 2. 更新绩效计划，并保留内部维护的排除员工范围
+        HrmPerformancePlanDO plan = BeanUtils.toBean(reqVO, HrmPerformancePlanDO.class)
+                .setAssessmentConfig(BeanUtils.toBean(assessmentTemplate,
+                        HrmPerformanceAssessmentTemplateDO.AssessmentConfig.class))
+                .setResultConfig(BeanUtils.toBean(resultTemplate, HrmPerformancePlanDO.ResultConfig.class))
+                .setStatus(oldPlan.getStatus()).setStageType(oldPlan.getStageType())
+                .setOperationType(oldPlan.getOperationType());
+        if (!Boolean.TRUE.equals(plan.getSyncToSalary())) {
+            plan.setPaidForMonth(null);
+        }
+        // 排除员工范围不由计划表单提交，需要从原计划合并到本次更新数据
+        List<Scope> scopes = new ArrayList<>(plan.getScopes());
+        scopes.addAll(filterList(oldPlan.getScopes(), scope -> Objects.equals(scope.getType(),
+                HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType())));
+        plan.setScopes(scopes);
+        performancePlanMapper.updateById(plan);
+
+        // 3. 同步员工绩效考核
+        performanceAssessmentService.syncPerformanceAssessmentList(plan, resolvePlanScopeEmployeeIds(plan));
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_DELETE_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_DELETE_SUCCESS)
+    public void deletePerformancePlan(Long id) {
+        // 1. 校验计划可以删除
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(id);
+        // 仅未开始或已归档的计划允许删除
+        if (notEqualsAny(plan.getStatus(),
+                HrmPerformancePlanStatusEnum.DRAFT.getStatus(),
+                HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(),
+                HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())) {
+            throw exception(PERFORMANCE_PLAN_STATUS_NOT_ALLOW_DELETE);
+        }
+
+        // 2. 删除员工绩效考核和计划
+        performanceAssessmentService.deletePerformanceAssessmentListByPlanId(id);
+        performancePlanMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+    }
+
+    @Override
+    public HrmPerformancePlanDO getPerformancePlan(Long id) {
+        return performancePlanMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<HrmPerformancePlanDO> getPerformancePlanPage(HrmPerformancePlanPageReqVO reqVO) {
+        return performancePlanMapper.selectPage(reqVO);
+    }
+
+    @Override
+    public List<HrmPerformancePlanDO> getPerformancePlanList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return performancePlanMapper.selectByIds(ids);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void addPerformancePlanEmployees(HrmPerformanceAssessmentBatchReqVO reqVO) {
+        // 1. 校验计划和员工
+        HrmPerformancePlanDO plan = performancePlanMapper.selectOneForUpdate(
+                HrmPerformancePlanDO::getId, reqVO.getPlanId());
+        validatePlanEditable(plan);
+        employeeService.validateEmployeeListExists(reqVO.getEmployeeIds());
+
+        // 2. 将手工加入员工写入普通员工范围，并从排除范围移除
+        updatePlanEmployeeScope(plan, reqVO.getEmployeeIds(), true);
+
+        // 3. 添加员工绩效考核
+        performanceAssessmentService.addPerformanceAssessmentList(plan, reqVO.getEmployeeIds());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void removePerformancePlanEmployees(HrmPerformanceAssessmentBatchReqVO reqVO) {
+        // 1. 校验计划和员工
+        HrmPerformancePlanDO plan = performancePlanMapper.selectOneForUpdate(
+                HrmPerformancePlanDO::getId, reqVO.getPlanId());
+        validatePlanEditable(plan);
+        if (CollUtil.isEmpty(reqVO.getEmployeeIds())) {
+            return;
+        }
+        employeeService.validateEmployeeListExists(reqVO.getEmployeeIds());
+
+        // 2. 从普通员工范围移除，并记录排除员工
+        updatePlanEmployeeScope(plan, reqVO.getEmployeeIds(), false);
+
+        // 3. 删除员工绩效考核
+        performanceAssessmentService.deletePerformanceAssessmentList(plan.getId(), reqVO.getEmployeeIds());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_START_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_START_SUCCESS)
+    public void startPerformancePlan(Long id) {
+        // 1. 校验计划并补齐参评员工
+        HrmPerformancePlanDO plan = performancePlanMapper.selectOneForUpdate(
+                HrmPerformancePlanDO::getId, id);
+        validatePlanEditable(plan);
+        performanceAssessmentService.addPerformanceAssessmentList(plan, resolvePlanScopeEmployeeIds(plan));
+
+        // 2. 启动员工绩效考核
+        Integer initialStage = performanceAssessmentService.startPerformanceAssessmentList(plan);
+
+        // 3. 更新计划状态
+        performancePlanMapper.updateById(new HrmPerformancePlanDO().setId(id)
+                .setStatus(HrmPerformancePlanStatusEnum.RUNNING.getStatus()));
+        performancePlanMapper.updateStageTypeAndOperationTypeById(id, initialStage,
+                Objects.equals(initialStage, HrmPerformanceStageTypeEnum.EXECUTING.getType())
+                        ? HrmPerformancePlanOperationTypeEnum.START_SCORING.getType() : null);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_OPEN_SCORING_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_OPEN_SCORING_SUCCESS)
+    public void openPerformancePlanScoring(Long id) {
+        // 1. 开启员工绩效评分
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(id);
+        Integer stageType = performanceAssessmentService.openPerformanceAssessmentScoring(plan);
+
+        // 2. 更新计划阶段
+        performancePlanMapper.updateStageTypeAndOperationTypeById(id, stageType, null);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_INTERVIEW_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_INTERVIEW_SUCCESS)
+    public void startPerformancePlanInterview(Long id) {
+        // 1. 发起员工绩效面谈
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(id);
+        Integer nextStage = performanceAssessmentService.startPerformanceAssessmentInterview(plan);
+
+        // 2. 更新计划阶段
+        performancePlanMapper.updateStageTypeAndOperationTypeById(id, nextStage,
+                Boolean.TRUE.equals(plan.getResultConfirmation())
+                        ? null : HrmPerformancePlanOperationTypeEnum.ARCHIVE.getType());
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_ARCHIVE_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_ARCHIVE_SUCCESS)
+    public void archivePerformancePlan(Long id) {
+        // 1. 归档员工绩效考核
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(id);
+        performanceAssessmentService.archivePerformanceAssessmentList(plan);
+
+        // 2. 归档绩效计划
+        performancePlanMapper.updateById(new HrmPerformancePlanDO().setId(id)
+                .setStatus(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())
+                .setStageType(HrmPerformanceStageTypeEnum.ARCHIVED.getType()));
+        performancePlanMapper.updateStageTypeAndOperationTypeById(
+                id, HrmPerformanceStageTypeEnum.ARCHIVED.getType(), null);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_PERFORMANCE_PLAN_TYPE, subType = HRM_PERFORMANCE_PLAN_TERMINATE_SUB_TYPE,
+            bizNo = "{{#performancePlan.id}}", success = HRM_PERFORMANCE_PLAN_TERMINATE_SUCCESS)
+    public void terminatePerformancePlan(Long userId, Long id) {
+        // 1. 校验计划运行中
+        HrmPerformancePlanDO plan = validatePerformancePlanExists(id);
+        // 只有运行中的计划允许终止
+        if (ObjUtil.notEqual(plan.getStatus(), HrmPerformancePlanStatusEnum.RUNNING.getStatus())) {
+            throw exception(PERFORMANCE_STAGE_ACTION_INVALID);
+        }
+
+        // 2. 终止员工绩效考核和计划，并保留流程历史
+        HrmEmployeeDO operator = employeeService.getEmployeeByUserId(userId);
+        performanceAssessmentService.terminatePerformanceAssessmentListByPlanId(
+                id, operator == null ? null : operator.getId());
+        performancePlanMapper.updateById(new HrmPerformancePlanDO().setId(id)
+                .setStatus(HrmPerformancePlanStatusEnum.TERMINATED.getStatus())
+                .setOperationType(null).setTerminateTime(LocalDateTime.now()));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("performancePlan", plan);
+    }
+
+    @Override
+    public Map<Integer, Long> getPerformancePlanStatusCount(HrmPerformancePlanPageReqVO reqVO) {
+        return performancePlanMapper.selectCountMapByStatus(reqVO);
+    }
+
+    @Override
+    public long getPerformancePlanCountByAssessmentTemplateId(Long assessmentTemplateId) {
+        return performancePlanMapper.selectCount(
+                HrmPerformancePlanDO::getAssessmentTemplateId, assessmentTemplateId);
+    }
+
+    @Override
+    public long getPerformancePlanCountByResultTemplateId(Long resultTemplateId) {
+        return performancePlanMapper.selectCount(
+                HrmPerformancePlanDO::getResultTemplateId, resultTemplateId);
+    }
+
+    @Override
+    public List<HrmPerformancePlanDO> getPerformancePlanListByPaidForMonth(String paidForMonth) {
+        return performancePlanMapper.selectListByPaidForMonth(paidForMonth);
+    }
+
+    @Override
+    public HrmPerformancePlanDO validatePerformancePlanExists(Long id) {
+        HrmPerformancePlanDO plan = performancePlanMapper.selectById(id);
+        if (plan == null) {
+            throw exception(PERFORMANCE_PLAN_NOT_EXISTS);
+        }
+        return plan;
+    }
+
+    @Override
+    public void updatePerformancePlanStageTypeAndOperationType(
+            Long id, Integer stageType, Integer operationType) {
+        performancePlanMapper.updateStageTypeAndOperationTypeById(id, stageType, operationType);
+    }
+
+    /**
+     * 根据计划考评范围解析参评员工
+     *
+     * @param plan 绩效计划
+     * @return 参评员工编号列表
+     */
+    private List<Long> resolvePlanScopeEmployeeIds(HrmPerformancePlanDO plan) {
+        Set<Long> directEmployeeIds = new LinkedHashSet<>();
+        Set<Long> employmentEmployeeIds = new LinkedHashSet<>();
+        Set<Long> excludedEmployeeIds = new HashSet<>();
+        boolean directScopeConfigured = false; // 是否配置员工或部门范围
+        boolean employmentScopeConfigured = false; // 是否配置聘用形式范围
+        for (Scope scope : plan.getScopes()) {
+            if (Objects.equals(scope.getType(),
+                    HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType())) {
+                if (CollUtil.isNotEmpty(scope.getEmployeeIds())) {
+                    excludedEmployeeIds.addAll(scope.getEmployeeIds());
+                }
+                continue;
+            }
+            if (Objects.equals(scope.getType(),
+                    HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType())) {
+                directScopeConfigured = true;
+                if (CollUtil.isNotEmpty(scope.getEmployeeIds())) {
+                    directEmployeeIds.addAll(scope.getEmployeeIds());
+                }
+                if (CollUtil.isNotEmpty(scope.getDeptIds())) {
+                    // 部门范围按当前部门员工展开
+                    List<HrmEmployeeDO> employees = employeeService.getEmployeeListByDeptIds(scope.getDeptIds());
+                    directEmployeeIds.addAll(convertSet(employees, HrmEmployeeDO::getId));
+                }
+                continue;
+            }
+            employmentScopeConfigured = true;
+            for (Integer status : scope.getEmployeeStatuses()) {
+                // 聘用形式范围按每个员工状态分别查询
+                HrmEmployeeListReqVO employeeReqVO = new HrmEmployeeListReqVO()
+                        .setType(scope.getEmployeeType()).setStatus(status);
+                List<HrmEmployeeDO> employees = employeeService.getEmployeeList(employeeReqVO);
+                employmentEmployeeIds.addAll(convertSet(employees, HrmEmployeeDO::getId));
+            }
+        }
+        Set<Long> resultEmployeeIds;
+        if (directScopeConfigured && employmentScopeConfigured) {
+            directEmployeeIds.retainAll(employmentEmployeeIds);
+            resultEmployeeIds = directEmployeeIds;
+        } else if (employmentScopeConfigured) {
+            resultEmployeeIds = employmentEmployeeIds;
+        } else {
+            resultEmployeeIds = directEmployeeIds;
+        }
+        resultEmployeeIds.removeAll(excludedEmployeeIds);
+        return new ArrayList<>(resultEmployeeIds);
+    }
+
+    /**
+     * 更新计划手工加入、排除的员工范围
+     *
+     * @param plan 绩效计划
+     * @param employeeIds 员工编号集合
+     * @param include 是否额外加入计划
+     */
+    private void updatePlanEmployeeScope(
+            HrmPerformancePlanDO plan, Collection<Long> employeeIds, boolean include) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return;
+        }
+
+        // 1. 获得当前普通员工范围和排除员工范围
+        List<Scope> scopes = new ArrayList<>(plan.getScopes());
+        Scope employeeScope = CollUtil.findOne(scopes,
+                scope -> Objects.equals(scope.getType(), HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType()));
+        Scope excludedScope = CollUtil.findOne(scopes,
+                scope -> Objects.equals(scope.getType(), HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType()));
+        Set<Long> directEmployeeIds = new LinkedHashSet<>();
+        Set<Long> excludedEmployeeIds = new LinkedHashSet<>();
+        if (employeeScope != null && CollUtil.isNotEmpty(employeeScope.getEmployeeIds())) {
+            directEmployeeIds.addAll(employeeScope.getEmployeeIds());
+        }
+        if (excludedScope != null && CollUtil.isNotEmpty(excludedScope.getEmployeeIds())) {
+            excludedEmployeeIds.addAll(excludedScope.getEmployeeIds());
+        }
+
+        // 2. 更新普通员工范围和排除员工范围
+        if (include) {
+            directEmployeeIds.addAll(employeeIds);
+            excludedEmployeeIds.removeAll(employeeIds);
+        } else {
+            directEmployeeIds.removeAll(employeeIds);
+            excludedEmployeeIds.addAll(employeeIds);
+        }
+        if (employeeScope == null && CollUtil.isNotEmpty(directEmployeeIds)) {
+            employeeScope = new Scope().setType(HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType());
+            scopes.add(employeeScope);
+        }
+        if (employeeScope != null) {
+            employeeScope.setEmployeeIds(new ArrayList<>(directEmployeeIds));
+            if (CollUtil.isEmpty(directEmployeeIds) && CollUtil.isEmpty(employeeScope.getDeptIds())) {
+                scopes.remove(employeeScope);
+            }
+        }
+        if (excludedScope == null && CollUtil.isNotEmpty(excludedEmployeeIds)) {
+            excludedScope = new Scope().setType(HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType());
+            scopes.add(excludedScope);
+        }
+        if (excludedScope != null) {
+            excludedScope.setEmployeeIds(new ArrayList<>(excludedEmployeeIds));
+            if (CollUtil.isEmpty(excludedEmployeeIds)) {
+                scopes.remove(excludedScope);
+            }
+        }
+
+        // 3. 保存排除范围
+        performancePlanMapper.updateById(
+                new HrmPerformancePlanDO().setId(plan.getId()).setScopes(scopes));
+        plan.setScopes(scopes);
+    }
+
+    /**
+     * 校验计划关联的员工和部门
+     *
+     * @param reqVO 计划保存参数
+     */
+    private void validatePlanReferences(HrmPerformancePlanSaveReqVO reqVO) {
+        // 1. 收集关联的员工和部门编号
+        Set<Long> employeeIds = new LinkedHashSet<>();
+        Set<Long> deptIds = new LinkedHashSet<>();
+        for (HrmPerformancePlanSaveReqVO.Scope scope : reqVO.getScopes()) {
+            if (ObjUtil.notEqual(scope.getType(),
+                    HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType())) {
+                continue;
+            }
+            if (CollUtil.isNotEmpty(scope.getEmployeeIds())) {
+                employeeIds.addAll(scope.getEmployeeIds());
+            }
+            if (CollUtil.isNotEmpty(scope.getDeptIds())) {
+                deptIds.addAll(scope.getDeptIds());
+            }
+        }
+        for (HrmPerformancePlanSaveReqVO.ReviewStage reviewStage : reqVO.getReviewStages()) {
+            addSpecifiedEmployeeId(employeeIds, reviewStage.getRater());
+        }
+        if (Boolean.TRUE.equals(reqVO.getTargetConfirmation())) {
+            addSpecifiedEmployeeId(employeeIds, reqVO.getTargetConfirmationStage());
+        }
+        if (Boolean.TRUE.equals(reqVO.getResultAudit())) {
+            reqVO.getResultAuditStages().forEach(stage -> addSpecifiedEmployeeId(employeeIds, stage));
+        }
+        if (Boolean.TRUE.equals(reqVO.getResultConfirmation())) {
+            reqVO.getAppealStages().forEach(stage -> addSpecifiedEmployeeId(employeeIds, stage));
+        }
+        // 2. 校验员工和部门存在
+        if (CollUtil.isNotEmpty(employeeIds)) {
+            employeeService.validateEmployeeListExists(employeeIds);
+        }
+        if (CollUtil.isNotEmpty(deptIds)) {
+            deptApi.validateDeptList(deptIds);
+        }
+    }
+
+    private void addSpecifiedEmployeeId(
+            Set<Long> employeeIds, HrmPerformancePlanSaveReqVO.HandlerStage stage) {
+        if (Objects.equals(stage.getType(), HrmPerformanceRaterTypeEnum.SPECIFIED.getType())) {
+            employeeIds.add(stage.getEmployeeId());
+        }
+    }
+
+    /**
+     * 校验绩效计划可以编辑
+     *
+     * @param plan 绩效计划
+     */
+    private void validatePlanEditable(HrmPerformancePlanDO plan) {
+        if (plan == null) {
+            throw exception(PERFORMANCE_PLAN_NOT_EXISTS);
+        }
+        if (notEqualsAny(plan.getStatus(),
+                HrmPerformancePlanStatusEnum.DRAFT.getStatus(), HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus())) {
+            throw exception(PERFORMANCE_PLAN_STARTED_CANNOT_MODIFY);
+        }
+    }
+
+    private void validatePlanScoreRange(HrmPerformanceAssessmentTemplateDO assessmentTemplate) {
+        if (assessmentTemplate.getUpperLimitScore() == null
+                || assessmentTemplate.getUpperLimitScore().compareTo(BigDecimal.valueOf(100)) > 0) {
+            throw exception(PERFORMANCE_DATA_ILLEGAL);
+        }
+    }
+
+    private void validateNameUnique(Long id, String name) {
+        HrmPerformancePlanDO plan = performancePlanMapper.selectByName(name);
+        if (plan != null && ObjUtil.notEqual(plan.getId(), id)) {
+            throw exception(PERFORMANCE_PLAN_NAME_DUPLICATE);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateService.java
new file mode 100644
index 0000000..1aeb000
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateService.java
@@ -0,0 +1,222 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.candidate;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateChannelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateEliminateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdatePostReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * 招聘候选人 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmRecruitCandidateService {
+
+    /**
+     * 创建招聘候选人
+     *
+     * @param createReqVO 候选人信息
+     * @return 候选人编号
+     */
+    Long createRecruitCandidate(HrmRecruitCandidateSaveReqVO createReqVO);
+
+    /**
+     * 更新招聘候选人
+     *
+     * @param updateReqVO 候选人信息
+     */
+    void updateRecruitCandidate(HrmRecruitCandidateSaveReqVO updateReqVO);
+
+    /**
+     * 删除招聘候选人
+     *
+     * @param id 候选人编号
+     */
+    void deleteRecruitCandidate(Long id);
+
+    /**
+     * 获得招聘候选人
+     *
+     * @param id 候选人编号
+     * @return 招聘候选人
+     */
+    HrmRecruitCandidateDO getRecruitCandidate(Long id);
+
+    /**
+     * 获得招聘候选人列表
+     *
+     * @param ids 候选人编号集合
+     * @return 候选人列表
+     */
+    List<HrmRecruitCandidateDO> getRecruitCandidateListByIds(Collection<Long> ids);
+
+    /**
+     * 获得招聘候选人 Map
+     *
+     * @param ids 候选人编号集合
+     * @return 候选人 Map
+     */
+    default Map<Long, HrmRecruitCandidateDO> getRecruitCandidateMap(Collection<Long> ids) {
+        return convertMap(getRecruitCandidateListByIds(ids), HrmRecruitCandidateDO::getId);
+    }
+
+    /**
+     * 获得招聘候选人分页列表
+     *
+     * @param pageReqVO 分页查询
+     * @return 招聘候选人分页列表
+     */
+    PageResult<HrmRecruitCandidateDO> getRecruitCandidatePage(HrmRecruitCandidatePageReqVO pageReqVO);
+
+    /**
+     * 校验招聘候选人是否存在
+     *
+     * @param id 候选人编号
+     * @return 招聘候选人
+     */
+    HrmRecruitCandidateDO validateRecruitCandidateExists(Long id);
+
+    /**
+     * 锁定并校验招聘候选人是否存在
+     *
+     * @param id 候选人编号
+     * @return 候选人
+     */
+    HrmRecruitCandidateDO validateRecruitCandidateExistsForUpdate(Long id);
+
+    /**
+     * 更新招聘候选人的面试状态和轮次
+     *
+     * @param id 候选人编号
+     * @param stageNumber 面试轮次
+     */
+    void updateRecruitCandidateInterview(Long id, Integer stageNumber);
+
+    /**
+     * 根据面试结果更新招聘候选人状态
+     *
+     * @param id 候选人编号
+     * @param status 候选人状态
+     */
+    void updateRecruitCandidateStatusByInterviewResult(Long id, Integer status);
+
+    /**
+     * 修复删除面试后的候选人状态和轮次
+     *
+     * @param id 候选人编号
+     * @param status 候选人状态
+     * @param stageNumber 面试轮次
+     */
+    void updateRecruitCandidateInterviewState(Long id, Integer status, Integer stageNumber);
+
+    /**
+     * 更新招聘候选人状态
+     *
+     * @param reqVO 候选人状态信息
+     */
+    void updateRecruitCandidateStatus(HrmRecruitCandidateUpdateStatusReqVO reqVO);
+
+    /**
+     * 确认招聘候选人入职
+     *
+     * @param id 候选人编号
+     * @param entryTime 实际入职时间
+     */
+    void confirmRecruitCandidateEntry(Long id, LocalDateTime entryTime);
+
+    /**
+     * 更新招聘候选人的招聘职位
+     *
+     * @param reqVO 候选人招聘职位信息
+     */
+    void updateRecruitCandidatePost(HrmRecruitCandidateUpdatePostReqVO reqVO);
+
+    /**
+     * 更新招聘候选人的招聘渠道
+     *
+     * @param reqVO 候选人招聘渠道信息
+     */
+    void updateRecruitCandidateChannel(HrmRecruitCandidateUpdateChannelReqVO reqVO);
+
+    /**
+     * 将指定招聘渠道的候选人迁移到新渠道
+     *
+     * @param channelId 原招聘渠道编号
+     * @param newChannelId 新招聘渠道编号
+     */
+    void updateRecruitCandidateChannelByChannelId(Long channelId, Long newChannelId);
+
+    /**
+     * 淘汰招聘候选人
+     *
+     * @param reqVO 候选人淘汰信息
+     */
+    void eliminateRecruitCandidate(HrmRecruitCandidateUpdateEliminateReqVO reqVO);
+
+    /**
+     * 将招聘候选人转为员工
+     *
+     * @param reqVO 候选人入职信息
+     * @return 员工编号
+     */
+    Long convertRecruitCandidateToEmployee(HrmRecruitCandidateEntryReqVO reqVO);
+
+    /**
+     * 获得招聘候选人列表
+     *
+     * @param statuses 候选人状态集合
+     * @param statusUpdateTime 状态更新时间上限
+     * @return 招聘候选人列表
+     */
+    List<HrmRecruitCandidateDO> getRecruitCandidateList(Collection<Integer> statuses,
+                                                        LocalDateTime statusUpdateTime);
+
+    /**
+     * 获得指定状态和状态更新时间范围的候选人数
+     *
+     * @param status 候选人状态
+     * @param statusUpdateTimes 状态更新时间范围
+     * @return 候选人数
+     */
+    Long getRecruitCandidateCountByStatusAndStatusUpdateTimeBetween(
+            Integer status, LocalDateTime[] statusUpdateTimes);
+
+    /**
+     * 获得指定状态和入职时间范围的候选人数
+     *
+     * @param status 候选人状态
+     * @param entryTimes 入职时间范围
+     * @return 候选人数
+     */
+    Long getRecruitCandidateCountByStatusAndEntryTimeBetween(
+            Integer status, LocalDateTime[] entryTimes);
+
+    /**
+     * 获得招聘职位的已入职候选人数
+     *
+     * @param postIds 招聘职位编号集合
+     * @return 招聘职位编号与已入职候选人数的映射
+     */
+    Map<Long, Long> getJoinedCandidateCountMap(Collection<Long> postIds);
+
+    /**
+     * 获得招聘候选人状态统计列表
+     *
+     * @param pageReqVO 分页查询
+     * @return 状态与数量的映射
+     */
+    Map<Integer, Long> getRecruitCandidateStatusCount(HrmRecruitCandidatePageReqVO pageReqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateServiceImpl.java
new file mode 100644
index 0000000..fb96c86
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateServiceImpl.java
@@ -0,0 +1,431 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.candidate;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateChannelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateEliminateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdatePostReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.candidate.HrmRecruitCandidateMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.equalsAny;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.notEqualsAny;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CANDIDATE_CONVERTED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_CONVERT_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_DELETE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_ELIMINATE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_HAS_EMPLOYEE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_STATUS_TRANSITION_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * 招聘候选人 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmRecruitCandidateServiceImpl implements HrmRecruitCandidateService {
+
+    @Resource
+    private HrmRecruitCandidateMapper recruitCandidateMapper;
+
+    @Resource
+    private HrmRecruitPostService recruitPostService;
+    @Resource
+    private HrmRecruitChannelService recruitChannelService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmRecruitInterviewService recruitInterviewService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_CREATE_SUB_TYPE,
+            bizNo = "{{#recruitCandidate.id}}", success = HRM_RECRUIT_CANDIDATE_CREATE_SUCCESS)
+    public Long createRecruitCandidate(HrmRecruitCandidateSaveReqVO createReqVO) {
+        // 1.1 校验招聘职位是否存在
+        recruitPostService.validateRecruitPostExists(createReqVO.getPostId());
+        // 1.2 校验招聘渠道是否存在
+        if (createReqVO.getChannelId() != null) {
+            recruitChannelService.validateRecruitChannelExists(createReqVO.getChannelId());
+        }
+
+        // 2. 创建候选人，初始状态由后端统一设置
+        HrmRecruitCandidateDO recruitCandidate = BeanUtils.toBean(createReqVO, HrmRecruitCandidateDO.class)
+                .setStatus(HrmRecruitCandidateStatusEnum.NEW.getStatus()).setStageNumber(0)
+                .setStatusUpdateTime(LocalDateTime.now());
+        recruitCandidateMapper.insert(recruitCandidate);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+        return recruitCandidate.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = HRM_RECRUIT_CANDIDATE_UPDATE_SUCCESS)
+    public void updateRecruitCandidate(HrmRecruitCandidateSaveReqVO updateReqVO) {
+        // 1.1 校验候选人是否存在
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExists(updateReqVO.getId());
+        // 1.2 校验招聘职位是否存在
+        recruitPostService.validateRecruitPostExists(updateReqVO.getPostId());
+        // 1.3 校验招聘渠道是否存在
+        if (updateReqVO.getChannelId() != null) {
+            recruitChannelService.validateRecruitChannelExists(updateReqVO.getChannelId());
+        }
+
+        // 2. 更新候选人
+        recruitCandidateMapper.updateForEdit(BeanUtils.toBean(updateReqVO, HrmRecruitCandidateDO.class));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(recruitCandidate, HrmRecruitCandidateSaveReqVO.class));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_DELETE_SUB_TYPE,
+            bizNo = "{{#id}}", success = HRM_RECRUIT_CANDIDATE_DELETE_SUCCESS)
+    public void deleteRecruitCandidate(Long id) {
+        // 1. 校验候选人是否存在
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExistsForUpdate(id);
+        if (notEqualsAny(recruitCandidate.getStatus(), HrmRecruitCandidateStatusEnum.NEW.getStatus(),
+                HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus(),
+                HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus(),
+                HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus(),
+                HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus())) {
+            throw exception(RECRUIT_CANDIDATE_DELETE_STATUS_INVALID);
+        }
+        if (employeeService.getEmployeeByCandidateId(id) != null) {
+            throw exception(RECRUIT_CANDIDATE_HAS_EMPLOYEE);
+        }
+
+        // 2.1 删除候选人的面试记录
+        recruitInterviewService.deleteRecruitInterviewByCandidateId(id);
+        // 2.2 删除候选人
+        recruitCandidateMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+    }
+
+    @Override
+    public HrmRecruitCandidateDO getRecruitCandidate(Long id) {
+        return recruitCandidateMapper.selectById(id);
+    }
+
+    @Override
+    public HrmRecruitCandidateDO validateRecruitCandidateExistsForUpdate(Long id) {
+        HrmRecruitCandidateDO recruitCandidate = recruitCandidateMapper.selectByIdForUpdate(id);
+        if (recruitCandidate == null) {
+            throw exception(RECRUIT_CANDIDATE_NOT_EXISTS);
+        }
+        return recruitCandidate;
+    }
+
+    @Override
+    public List<HrmRecruitCandidateDO> getRecruitCandidateListByIds(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return recruitCandidateMapper.selectByIds(ids);
+    }
+
+    @Override
+    public PageResult<HrmRecruitCandidateDO> getRecruitCandidatePage(HrmRecruitCandidatePageReqVO pageReqVO) {
+        return recruitCandidateMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public void updateRecruitCandidateInterview(Long id, Integer stageNumber) {
+        // 1. 校验候选人是否存在
+        validateRecruitCandidateExists(id);
+
+        // 2. 更新候选人的面试状态和轮次
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO()
+                .setId(id).setStatus(HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus())
+                .setStageNumber(stageNumber).setStatusUpdateTime(LocalDateTime.now()));
+    }
+
+    @Override
+    public void updateRecruitCandidateStatusByInterviewResult(Long id, Integer status) {
+        // 1. 校验候选人是否存在
+        validateRecruitCandidateExists(id);
+
+        // 2. 更新候选人状态
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO()
+                .setId(id).setStatus(status).setStatusUpdateTime(LocalDateTime.now()));
+    }
+
+    @Override
+    public void updateRecruitCandidateInterviewState(Long id, Integer status, Integer stageNumber) {
+        validateRecruitCandidateExists(id);
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO().setId(id)
+                .setStatus(status).setStageNumber(stageNumber).setStatusUpdateTime(LocalDateTime.now()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_UPDATE_STATUS_SUB_TYPE,
+            bizNo = "{{#reqVO.id}}", success = HRM_RECRUIT_CANDIDATE_UPDATE_STATUS_SUCCESS)
+    public void updateRecruitCandidateStatus(HrmRecruitCandidateUpdateStatusReqVO reqVO) {
+        // 1. 校验候选人是否存在
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExistsForUpdate(reqVO.getId());
+        if (Objects.equals(recruitCandidate.getStatus(), reqVO.getStatus())) {
+            LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+            return;
+        }
+        if (!isStatusTransitionAllowed(recruitCandidate.getStatus(), reqVO.getStatus())) {
+            HrmRecruitCandidateStatusEnum targetStatus = HrmRecruitCandidateStatusEnum.valueOf(reqVO.getStatus());
+            throw exception(RECRUIT_CANDIDATE_STATUS_TRANSITION_INVALID,
+                    targetStatus == null ? reqVO.getStatus() : targetStatus.getName());
+        }
+
+        // 2. 更新候选人状态
+        LocalDateTime currentTime = LocalDateTime.now();
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO()
+                .setId(recruitCandidate.getId()).setStatus(reqVO.getStatus()).setStatusUpdateTime(currentTime));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+    }
+
+    /**
+     * 判断候选人是否允许从来源状态直接流转到目标状态
+     *
+     * 面试中、待入职和已入职等聚合动作必须走专用业务接口，不允许由通用状态接口跳转。
+     *
+     * @param sourceStatus 来源状态
+     * @param targetStatus 目标状态
+     * @return 是否允许流转
+     */
+    private boolean isStatusTransitionAllowed(Integer sourceStatus, Integer targetStatus) {
+        // 新候选人允许通过初选，或不安排面试直接标记为面试通过
+        if (Objects.equals(sourceStatus, HrmRecruitCandidateStatusEnum.NEW.getStatus())) {
+            return equalsAny(targetStatus, HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus(),
+                    HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus());
+        }
+        // 初选通过允许退回新候选人，或不安排面试直接标记为面试通过
+        if (Objects.equals(sourceStatus, HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())) {
+            return equalsAny(targetStatus, HrmRecruitCandidateStatusEnum.NEW.getStatus(),
+                    HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus());
+        }
+        // 面试通过允许发送 Offer，或退回到前置筛选状态
+        if (Objects.equals(sourceStatus, HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus())) {
+            return equalsAny(targetStatus, HrmRecruitCandidateStatusEnum.OFFER_SENT.getStatus(),
+                    HrmRecruitCandidateStatusEnum.NEW.getStatus(),
+                    HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus());
+        }
+        // 已淘汰候选人只允许恢复为新候选人
+        return Objects.equals(sourceStatus, HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus())
+                && Objects.equals(targetStatus, HrmRecruitCandidateStatusEnum.NEW.getStatus());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void confirmRecruitCandidateEntry(Long id, LocalDateTime entryTime) {
+        // 1. 校验候选人处于待入职状态
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExistsForUpdate(id);
+        if (ObjUtil.notEqual(recruitCandidate.getStatus(),
+                HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus())) {
+            throw exception(RECRUIT_CANDIDATE_STATUS_TRANSITION_INVALID,
+                    HrmRecruitCandidateStatusEnum.JOINED.getName());
+        }
+
+        // 2. 确认候选人已入职
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO().setId(id)
+                .setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus()).setEntryTime(entryTime)
+                .setStatusUpdateTime(LocalDateTime.now()));
+    }
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_UPDATE_POST_SUB_TYPE,
+            bizNo = "{{#reqVO.id}}", success = HRM_RECRUIT_CANDIDATE_UPDATE_POST_SUCCESS)
+    public void updateRecruitCandidatePost(HrmRecruitCandidateUpdatePostReqVO reqVO) {
+        // 1.1 校验候选人是否存在
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExists(reqVO.getId());
+        // 1.2 校验招聘职位是否存在
+        HrmRecruitPostDO recruitPost = recruitPostService.validateRecruitPostExists(reqVO.getPostId());
+
+        // 2. 更新候选人的招聘职位
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO()
+                .setId(reqVO.getId()).setPostId(reqVO.getPostId()));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+        LogRecordContext.putVariable("recruitPost", recruitPost);
+    }
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_UPDATE_CHANNEL_SUB_TYPE,
+            bizNo = "{{#reqVO.id}}", success = HRM_RECRUIT_CANDIDATE_UPDATE_CHANNEL_SUCCESS)
+    public void updateRecruitCandidateChannel(HrmRecruitCandidateUpdateChannelReqVO reqVO) {
+        // 1.1 校验候选人是否存在
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExists(reqVO.getId());
+        // 1.2 校验招聘渠道是否存在
+        HrmRecruitChannelDO recruitChannel = recruitChannelService.validateRecruitChannelExists(reqVO.getChannelId());
+
+        // 2. 更新候选人的招聘渠道
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO()
+                .setId(reqVO.getId()).setChannelId(reqVO.getChannelId()));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+        LogRecordContext.putVariable("recruitChannel", recruitChannel);
+    }
+
+    @Override
+    public void updateRecruitCandidateChannelByChannelId(Long channelId, Long newChannelId) {
+        recruitCandidateMapper.updateChannelIdByChannelId(channelId, newChannelId);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_ELIMINATE_SUB_TYPE,
+            bizNo = "{{#reqVO.id}}", success = HRM_RECRUIT_CANDIDATE_ELIMINATE_SUCCESS)
+    public void eliminateRecruitCandidate(HrmRecruitCandidateUpdateEliminateReqVO reqVO) {
+        // 1. 校验候选人是否存在
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExistsForUpdate(reqVO.getId());
+        if (!HrmRecruitCandidateStatusEnum.ELIMINATE_STATUSES.contains(recruitCandidate.getStatus())) {
+            throw exception(RECRUIT_CANDIDATE_ELIMINATE_STATUS_INVALID);
+        }
+
+        // 2. 正在面试时同步结束当前面试，避免候选人状态与面试结果矛盾
+        if (Objects.equals(recruitCandidate.getStatus(), HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus())) {
+            recruitInterviewService.finishCurrentRecruitInterviewForElimination(
+                    recruitCandidate.getId(), reqVO.getEliminate());
+        }
+
+        // 3.1 查询已生成的员工档案
+        HrmEmployeeDO employee = employeeService.getEmployeeByCandidateId(recruitCandidate.getId());
+        // 3.2 删除已生成的员工档案
+        if (employee != null) {
+            employeeService.deleteEmployee(employee.getId());
+        }
+        // 4. 淘汰候选人
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO()
+                .setId(recruitCandidate.getId()).setEliminate(reqVO.getEliminate()).setRemark(reqVO.getRemark())
+                .setStatus(HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus())
+                .setStatusUpdateTime(LocalDateTime.now()));
+
+        // 5. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_CONVERT_EMPLOYEE_SUB_TYPE,
+            bizNo = "{{#reqVO.candidateId}}", success = HRM_RECRUIT_CANDIDATE_CONVERT_EMPLOYEE_SUCCESS)
+    public Long convertRecruitCandidateToEmployee(HrmRecruitCandidateEntryReqVO reqVO) {
+        // 1.1 校验候选人是否存在
+        HrmRecruitCandidateDO recruitCandidate = validateRecruitCandidateExistsForUpdate(reqVO.getCandidateId());
+        if (!HrmRecruitCandidateStatusEnum.CONVERT_EMPLOYEE_STATUSES.contains(recruitCandidate.getStatus())) {
+            throw exception(RECRUIT_CANDIDATE_CONVERT_STATUS_INVALID);
+        }
+        // 1.2 校验候选人是否已转为员工
+        if (employeeService.getEmployeeByCandidateId(recruitCandidate.getId()) != null) {
+            throw exception(EMPLOYEE_CANDIDATE_CONVERTED);
+        }
+        // 1.3 校验招聘职位是否存在
+        recruitPostService.validateRecruitPostExists(recruitCandidate.getPostId());
+
+        // 2. 创建员工
+        HrmEmployeeSaveReqVO employeeReqVO = BeanUtils.toBean(reqVO, HrmEmployeeSaveReqVO.class)
+                .setId(null).setCandidateId(recruitCandidate.getId())
+                .setChannelId(recruitCandidate.getChannelId());
+        Long employeeId = employeeService.createEmployee(employeeReqVO);
+
+        // 3. 更新候选人的入职状态
+        recruitCandidateMapper.updateById(new HrmRecruitCandidateDO()
+                .setId(recruitCandidate.getId())
+                .setStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus().equals(employeeReqVO.getEntryStatus())
+                        ? HrmRecruitCandidateStatusEnum.JOINED.getStatus()
+                        : HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus())
+                .setEntryTime(reqVO.getEntryTime()).setStatusUpdateTime(LocalDateTime.now()));
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+        LogRecordContext.putVariable("employeeId", employeeId);
+        return employeeId;
+    }
+
+    @Override
+    public List<HrmRecruitCandidateDO> getRecruitCandidateList(Collection<Integer> statuses,
+                                                               LocalDateTime statusUpdateTime) {
+        if (CollUtil.isEmpty(statuses)) {
+            return Collections.emptyList();
+        }
+        return recruitCandidateMapper.selectListByStatusesAndStatusUpdateTimeBefore(statuses, statusUpdateTime);
+    }
+
+    @Override
+    public Long getRecruitCandidateCountByStatusAndStatusUpdateTimeBetween(
+            Integer status, LocalDateTime[] statusUpdateTimes) {
+        return recruitCandidateMapper.selectCountByStatusAndStatusUpdateTimeBetween(
+                status, statusUpdateTimes);
+    }
+
+    @Override
+    public Long getRecruitCandidateCountByStatusAndEntryTimeBetween(
+            Integer status, LocalDateTime[] entryTimes) {
+        return recruitCandidateMapper.selectCountByStatusAndEntryTimeBetween(
+                status, entryTimes);
+    }
+
+    @Override
+    public Map<Long, Long> getJoinedCandidateCountMap(Collection<Long> postIds) {
+        if (CollUtil.isEmpty(postIds)) {
+            return Collections.emptyMap();
+        }
+        return recruitCandidateMapper.selectCountMapByPostIdsAndStatus(postIds,
+                HrmRecruitCandidateStatusEnum.JOINED.getStatus());
+    }
+
+    @Override
+    public Map<Integer, Long> getRecruitCandidateStatusCount(HrmRecruitCandidatePageReqVO pageReqVO) {
+        return recruitCandidateMapper.selectCountMapByStatus(pageReqVO);
+    }
+
+    @Override
+    public HrmRecruitCandidateDO validateRecruitCandidateExists(Long id) {
+        HrmRecruitCandidateDO recruitCandidate = recruitCandidateMapper.selectById(id);
+        if (recruitCandidate == null) {
+            throw exception(RECRUIT_CANDIDATE_NOT_EXISTS);
+        }
+        return recruitCandidate;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewService.java
new file mode 100644
index 0000000..ea9e103
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewService.java
@@ -0,0 +1,108 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.candidate;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewResultReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * 招聘面试 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmRecruitInterviewService {
+
+    /**
+     * 创建招聘面试
+     *
+     * @param createReqVO 招聘面试信息
+     * @return 招聘面试编号
+     */
+    Long createRecruitInterview(HrmRecruitInterviewSaveReqVO createReqVO);
+
+    /**
+     * 更新招聘面试
+     *
+     * @param updateReqVO 招聘面试信息
+     */
+    void updateRecruitInterview(HrmRecruitInterviewSaveReqVO updateReqVO);
+
+    /**
+     * 删除招聘面试
+     *
+     * @param id 招聘面试编号
+     */
+    void deleteRecruitInterview(Long id);
+
+    /**
+     * 获得招聘面试
+     *
+     * @param id 招聘面试编号
+     * @return 招聘面试
+     */
+    HrmRecruitInterviewDO getRecruitInterview(Long id);
+
+    /**
+     * 获得候选人的招聘面试列表
+     *
+     * @param candidateId 候选人编号
+     * @return 招聘面试列表
+     */
+    List<HrmRecruitInterviewDO> getRecruitInterviewListByCandidateId(Long candidateId);
+
+    /**
+     * 获得候选人的最新面试 Map
+     *
+     * @param candidateIds 候选人编号集合
+     * @return 候选人编号与最新面试的映射
+     */
+    default Map<Long, HrmRecruitInterviewDO> getLatestRecruitInterviewMapByCandidateIds(Collection<Long> candidateIds) {
+        return convertMap(getRecruitInterviewListByCandidateIds(candidateIds), HrmRecruitInterviewDO::getCandidateId);
+    }
+
+    /**
+     * 获得候选人的招聘面试列表
+     *
+     * @param candidateIds 候选人编号集合
+     * @return 招聘面试列表
+     */
+    List<HrmRecruitInterviewDO> getRecruitInterviewListByCandidateIds(Collection<Long> candidateIds);
+
+    /**
+     * 获得指定面试时间范围内的招聘面试列表
+     *
+     * @param interviewTimes 面试时间双闭区间
+     * @return 招聘面试列表
+     */
+    List<HrmRecruitInterviewDO> getRecruitInterviewListByInterviewTimeBetween(
+            LocalDateTime[] interviewTimes);
+
+    /**
+     * 删除候选人的面试记录
+     *
+     * @param candidateId 候选人编号
+     */
+    void deleteRecruitInterviewByCandidateId(Long candidateId);
+
+    /**
+     * 淘汰候选人时结束当前面试
+     *
+     * @param candidateId 候选人编号
+     * @param eliminateReason 淘汰原因
+     */
+    void finishCurrentRecruitInterviewForElimination(Long candidateId, String eliminateReason);
+
+    /**
+     * 更新招聘面试结果
+     *
+     * @param reqVO 招聘面试结果信息
+     */
+    void updateRecruitInterviewResult(HrmRecruitInterviewResultReqVO reqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewServiceImpl.java
new file mode 100644
index 0000000..3112172
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewServiceImpl.java
@@ -0,0 +1,357 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.candidate;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewResultReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.candidate.HrmRecruitInterviewMapper;
+import cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDateTime;
+import java.time.format.DateTimeFormatter;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.notEqualsAny;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_CANCEL_REASON_REQUIRED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_FINISHED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_NOT_CURRENT;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_RESULT_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_STATE_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * 招聘面试 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmRecruitInterviewServiceImpl implements HrmRecruitInterviewService {
+
+    private static final DateTimeFormatter INTERVIEW_TIME_FORMATTER = DateTimeFormatter.ofPattern("MM-dd HH:mm");
+
+    @Resource
+    private HrmRecruitInterviewMapper recruitInterviewMapper;
+    @Resource
+    private HrmRecruitCandidateService recruitCandidateService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_ARRANGE_INTERVIEW_SUB_TYPE,
+            bizNo = "{{#createReqVO.candidateId}}", success = HRM_RECRUIT_CANDIDATE_ARRANGE_INTERVIEW_SUCCESS)
+    public Long createRecruitInterview(HrmRecruitInterviewSaveReqVO createReqVO) {
+        // 1. 校验候选人和面试官存在
+        HrmRecruitCandidateDO recruitCandidate = recruitCandidateService
+                .validateRecruitCandidateExistsForUpdate(createReqVO.getCandidateId());
+        validateCandidateCanArrangeInterview(recruitCandidate);
+        validateInterviewEmployees(createReqVO);
+
+        // 2. 创建面试记录。候选人仍在当前面试轮次时，复用最近一条记录
+        HrmRecruitInterviewDO recruitInterview = BeanUtils.toBean(createReqVO, HrmRecruitInterviewDO.class);
+        HrmRecruitInterviewDO latestInterview = recruitInterviewMapper
+                .selectLatestByCandidateId(createReqVO.getCandidateId());
+        if (latestInterview != null && HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus()
+                .equals(recruitCandidate.getStatus())) {
+            validateCurrentInterview(recruitCandidate, latestInterview);
+            if (notEqualsAny(latestInterview.getResult(), HrmRecruitInterviewResultEnum.UNFINISHED.getResult(),
+                    HrmRecruitInterviewResultEnum.CANCEL.getResult())) {
+                throw exception(RECRUIT_INTERVIEW_STATE_INVALID);
+            }
+            recruitInterview.setId(latestInterview.getId()).setCandidateId(latestInterview.getCandidateId())
+                    .setStageNumber(latestInterview.getStageNumber())
+                    .setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult());
+            recruitInterviewMapper.updateRecruitInterviewArrangement(recruitInterview);
+        } else {
+            recruitInterview.setStageNumber(latestInterview == null ? 1 : latestInterview.getStageNumber() + 1)
+                    .setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult());
+            recruitInterviewMapper.insert(recruitInterview);
+        }
+
+        // 3. 更新候选人的面试状态和轮次
+        recruitCandidateService.updateRecruitCandidateInterview(
+                recruitInterview.getCandidateId(), recruitInterview.getStageNumber());
+
+        // 4. 通知面试官
+        sendRecruitInterviewArrangedMessage(recruitCandidate, recruitInterview);
+
+        // 5. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+        LogRecordContext.putVariable("recruitInterview", recruitInterview);
+        return recruitInterview.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_UPDATE_INTERVIEW_SUB_TYPE,
+            bizNo = "{{#updateReqVO.candidateId}}", success = HRM_RECRUIT_CANDIDATE_UPDATE_INTERVIEW_SUCCESS)
+    public void updateRecruitInterview(HrmRecruitInterviewSaveReqVO updateReqVO) {
+        // 1.1 校验面试记录、候选人和面试官是否存在
+        HrmRecruitInterviewDO recruitInterview = validateRecruitInterviewExists(updateReqVO.getId());
+        HrmRecruitCandidateDO recruitCandidate = recruitCandidateService
+                .validateRecruitCandidateExistsForUpdate(recruitInterview.getCandidateId());
+        validateCurrentInterview(recruitCandidate, recruitInterview);
+        validateInterviewEmployees(updateReqVO);
+        // 1.2 已完成的历史面试不允许再修改安排
+        if (notEqualsAny(recruitInterview.getResult(), HrmRecruitInterviewResultEnum.UNFINISHED.getResult(),
+                HrmRecruitInterviewResultEnum.CANCEL.getResult())) {
+            throw exception(RECRUIT_INTERVIEW_FINISHED);
+        }
+
+        // 2.1 更新当前轮次面试安排；取消后重新安排时恢复为未完成
+        updateReqVO.setCandidateId(recruitInterview.getCandidateId()).setStageNumber(recruitInterview.getStageNumber());
+        HrmRecruitInterviewDO updateObj = BeanUtils.toBean(updateReqVO, HrmRecruitInterviewDO.class)
+                .setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult());
+        recruitInterviewMapper.updateRecruitInterviewArrangement(updateObj);
+        // 2.2 重新安排已取消的面试时，恢复候选人的面试状态和轮次
+        if (HrmRecruitInterviewResultEnum.CANCEL.getResult().equals(recruitInterview.getResult())) {
+            recruitCandidateService.updateRecruitCandidateInterview(
+                    recruitInterview.getCandidateId(), recruitInterview.getStageNumber());
+        }
+
+        // 3. 通知面试官
+        sendRecruitInterviewArrangedMessage(recruitCandidate, updateObj);
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(recruitInterview, HrmRecruitInterviewSaveReqVO.class));
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+        LogRecordContext.putVariable("recruitInterview", recruitInterview);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deleteRecruitInterview(Long id) {
+        // 1. 校验面试记录和候选人
+        HrmRecruitInterviewDO recruitInterview = validateRecruitInterviewExists(id);
+        HrmRecruitCandidateDO recruitCandidate = recruitCandidateService
+                .validateRecruitCandidateExistsForUpdate(recruitInterview.getCandidateId());
+        HrmRecruitInterviewDO latestInterview = recruitInterviewMapper
+                .selectLatestByCandidateId(recruitInterview.getCandidateId());
+        boolean currentInterview = latestInterview != null && Objects.equals(latestInterview.getId(), id);
+        if (currentInterview) {
+            validateCurrentInterview(recruitCandidate, recruitInterview);
+        }
+
+        // 2. 删除面试记录
+        recruitInterviewMapper.deleteById(id);
+
+        // 3. 删除当前面试时，根据剩余最近一轮修复候选人状态和轮次
+        if (currentInterview) {
+            repairCandidateInterviewState(recruitCandidate.getId(),
+                    recruitInterviewMapper.selectLatestByCandidateId(recruitCandidate.getId()));
+        }
+    }
+
+    @Override
+    public HrmRecruitInterviewDO getRecruitInterview(Long id) {
+        return recruitInterviewMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmRecruitInterviewDO> getRecruitInterviewListByCandidateId(Long candidateId) {
+        return recruitInterviewMapper.selectListByCandidateId(candidateId);
+    }
+
+    @Override
+    public List<HrmRecruitInterviewDO> getRecruitInterviewListByCandidateIds(Collection<Long> candidateIds) {
+        if (CollUtil.isEmpty(candidateIds)) {
+            return Collections.emptyList();
+        }
+        return recruitInterviewMapper.selectListByCandidateIds(candidateIds);
+    }
+
+    @Override
+    public List<HrmRecruitInterviewDO> getRecruitInterviewListByInterviewTimeBetween(
+            LocalDateTime[] interviewTimes) {
+        return recruitInterviewMapper.selectListByInterviewTimeBetween(interviewTimes);
+    }
+
+    @Override
+    public void deleteRecruitInterviewByCandidateId(Long candidateId) {
+        recruitInterviewMapper.deleteByCandidateId(candidateId);
+    }
+
+    @Override
+    public void finishCurrentRecruitInterviewForElimination(Long candidateId, String eliminateReason) {
+        HrmRecruitInterviewDO latestInterview = recruitInterviewMapper.selectLatestByCandidateId(candidateId);
+        if (latestInterview == null) {
+            throw exception(RECRUIT_INTERVIEW_STATE_INVALID);
+        }
+        if (Objects.equals(latestInterview.getResult(), HrmRecruitInterviewResultEnum.CANCEL.getResult())) {
+            return;
+        }
+        if (ObjUtil.notEqual(latestInterview.getResult(), HrmRecruitInterviewResultEnum.UNFINISHED.getResult())) {
+            throw exception(RECRUIT_INTERVIEW_STATE_INVALID);
+        }
+        recruitInterviewMapper.updateRecruitInterviewResult(new HrmRecruitInterviewDO()
+                .setId(latestInterview.getId()).setResult(HrmRecruitInterviewResultEnum.NOT_PASS.getResult())
+                .setEvaluate(eliminateReason));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CANDIDATE_TYPE, subType = HRM_RECRUIT_CANDIDATE_INTERVIEW_RESULT_SUB_TYPE,
+            bizNo = "{{#recruitInterview.candidateId}}", success = HRM_RECRUIT_CANDIDATE_INTERVIEW_RESULT_SUCCESS)
+    public void updateRecruitInterviewResult(HrmRecruitInterviewResultReqVO reqVO) {
+        // 1.1 校验面试记录、候选人是否存在
+        HrmRecruitInterviewDO recruitInterview = validateRecruitInterviewExists(reqVO.getId());
+        HrmRecruitCandidateDO recruitCandidate = recruitCandidateService
+                .validateRecruitCandidateExistsForUpdate(recruitInterview.getCandidateId());
+        // 1.2 只有当前未完成面试允许登记完成结果
+        validateCurrentInterview(recruitCandidate, recruitInterview);
+        if (ObjUtil.notEqual(recruitInterview.getResult(), HrmRecruitInterviewResultEnum.UNFINISHED.getResult())
+                || HrmRecruitInterviewResultEnum.UNFINISHED.getResult().equals(reqVO.getResult())) {
+            throw exception(RECRUIT_INTERVIEW_RESULT_INVALID);
+        }
+        // 1.3 校验取消原因
+        if (HrmRecruitInterviewResultEnum.CANCEL.getResult().equals(reqVO.getResult())
+                && StrUtil.isBlank(reqVO.getCancelReason())) {
+            throw exception(RECRUIT_INTERVIEW_CANCEL_REASON_REQUIRED);
+        }
+
+        // 2. 更新面试结果
+        boolean cancel = HrmRecruitInterviewResultEnum.CANCEL.getResult().equals(reqVO.getResult());
+        reqVO.setEvaluate(cancel ? null : reqVO.getEvaluate());
+        reqVO.setCancelReason(cancel ? reqVO.getCancelReason() : null);
+        recruitInterviewMapper.updateRecruitInterviewResult(BeanUtils.toBean(reqVO, HrmRecruitInterviewDO.class));
+
+        // 3. 根据面试结果更新候选人状态；取消时仅刷新最后处理时间
+        Integer candidateStatus = null;
+        if (HrmRecruitInterviewResultEnum.PASS.getResult().equals(reqVO.getResult())) {
+            candidateStatus = HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus();
+        } else if (HrmRecruitInterviewResultEnum.NOT_PASS.getResult().equals(reqVO.getResult())) {
+            candidateStatus = HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus();
+        }
+        if (candidateStatus != null) {
+            recruitCandidateService.updateRecruitCandidateStatusByInterviewResult(
+                    recruitInterview.getCandidateId(), candidateStatus);
+        } else {
+            recruitCandidateService.updateRecruitCandidateInterviewState(recruitCandidate.getId(),
+                    recruitCandidate.getStatus(), recruitCandidate.getStageNumber());
+        }
+
+        // 4. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitCandidate", recruitCandidate);
+        LogRecordContext.putVariable("recruitInterview", recruitInterview);
+    }
+
+    private void validateCandidateCanArrangeInterview(HrmRecruitCandidateDO recruitCandidate) {
+        if (!HrmRecruitCandidateStatusEnum.INTERVIEW_ARRANGE_STATUSES.contains(recruitCandidate.getStatus())) {
+            throw exception(RECRUIT_INTERVIEW_STATE_INVALID);
+        }
+    }
+
+    private void validateCurrentInterview(HrmRecruitCandidateDO recruitCandidate,
+                                          HrmRecruitInterviewDO recruitInterview) {
+        HrmRecruitInterviewDO latestInterview = recruitInterviewMapper
+                .selectLatestByCandidateId(recruitCandidate.getId());
+        if (latestInterview == null || ObjUtil.notEqual(latestInterview.getId(), recruitInterview.getId())
+                || ObjUtil.notEqual(recruitCandidate.getStatus(), HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus())
+                || ObjUtil.notEqual(recruitCandidate.getStageNumber(), recruitInterview.getStageNumber())) {
+            throw exception(RECRUIT_INTERVIEW_NOT_CURRENT);
+        }
+    }
+
+    private void repairCandidateInterviewState(Long candidateId, HrmRecruitInterviewDO latestInterview) {
+        if (latestInterview == null) {
+            recruitCandidateService.updateRecruitCandidateInterviewState(
+                    candidateId, HrmRecruitCandidateStatusEnum.NEW.getStatus(), 0);
+            return;
+        }
+        Integer status = HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus();
+        if (Objects.equals(latestInterview.getResult(), HrmRecruitInterviewResultEnum.PASS.getResult())) {
+            status = HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus();
+        } else if (Objects.equals(latestInterview.getResult(), HrmRecruitInterviewResultEnum.NOT_PASS.getResult())) {
+            status = HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus();
+        }
+        recruitCandidateService.updateRecruitCandidateInterviewState(
+                candidateId, status, latestInterview.getStageNumber());
+    }
+
+    private HrmRecruitInterviewDO validateRecruitInterviewExists(Long id) {
+        HrmRecruitInterviewDO interview = recruitInterviewMapper.selectById(id);
+        if (interview == null) {
+            throw exception(RECRUIT_INTERVIEW_NOT_EXISTS);
+        }
+        return interview;
+    }
+
+    private void validateInterviewEmployees(HrmRecruitInterviewSaveReqVO reqVO) {
+        // 1. 其他面试官按首次出现顺序去重，并排除主面试官
+        Set<Long> otherEmployeeIds = new LinkedHashSet<>(
+                CollUtil.emptyIfNull(reqVO.getOtherInterviewEmployeeIds()));
+        otherEmployeeIds.remove(reqVO.getInterviewEmployeeId());
+        reqVO.setOtherInterviewEmployeeIds(new ArrayList<>(otherEmployeeIds));
+
+        // 2. 一次性校验全部面试官员工档案存在
+        Set<Long> employeeIds = new HashSet<>(otherEmployeeIds);
+        employeeIds.add(reqVO.getInterviewEmployeeId());
+        employeeService.validateEmployeeListByEntryStatus(
+                employeeIds, HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+    }
+
+    private void sendRecruitInterviewArrangedMessage(HrmRecruitCandidateDO recruitCandidate,
+                                                       HrmRecruitInterviewDO recruitInterview) {
+        // 1. 获得已绑定后台账号的面试官用户编号
+        Set<Long> employeeIds = new LinkedHashSet<>();
+        if (recruitInterview.getInterviewEmployeeId() != null) {
+            employeeIds.add(recruitInterview.getInterviewEmployeeId());
+        }
+        if (CollUtil.isNotEmpty(recruitInterview.getOtherInterviewEmployeeIds())) {
+            employeeIds.addAll(recruitInterview.getOtherInterviewEmployeeIds());
+        }
+        if (CollUtil.isEmpty(employeeIds)) {
+            return;
+        }
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        if (CollUtil.isEmpty(employeeMap)) {
+            return;
+        }
+        Set<Long> userIds = convertSet(employeeMap.values(), HrmEmployeeDO::getUserId,
+                employee -> employee.getUserId() != null);
+
+        // 2. 发送面试安排站内信
+        Map<String, Object> templateParams = new HashMap<>(4);
+        templateParams.put("candidateName", recruitCandidate.getName());
+        templateParams.put("stageNumber", recruitInterview.getStageNumber());
+        templateParams.put("interviewTime", INTERVIEW_TIME_FORMATTER.format(recruitInterview.getInterviewTime()));
+        userIds.forEach(userId -> notifyMessageSendApi.sendSingleMessageToAdmin(new NotifySendSingleToUserReqDTO()
+                .setUserId(userId).setTemplateCode(MessageTemplateConstants.RECRUIT_INTERVIEW_ARRANGED)
+                .setTemplateParams(templateParams)));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelService.java
new file mode 100644
index 0000000..8db1fdf
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelService.java
@@ -0,0 +1,101 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelDeleteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * 招聘渠道 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmRecruitChannelService {
+
+    /**
+     * 创建招聘渠道
+     *
+     * @param createReqVO 招聘渠道信息
+     * @return 招聘渠道编号
+     */
+    Long createRecruitChannel(HrmRecruitChannelSaveReqVO createReqVO);
+
+    /**
+     * 更新招聘渠道
+     *
+     * @param updateReqVO 招聘渠道信息
+     */
+    void updateRecruitChannel(HrmRecruitChannelSaveReqVO updateReqVO);
+
+    /**
+     * 更新招聘渠道状态
+     *
+     * @param statusReqVO 招聘渠道状态信息
+     */
+    void updateRecruitChannelStatus(HrmRecruitChannelStatusReqVO statusReqVO);
+
+    /**
+     * 删除招聘渠道，并迁移关联的员工和候选人
+     *
+     * @param deleteReqVO 招聘渠道删除信息
+     */
+    void deleteRecruitChannel(HrmRecruitChannelDeleteReqVO deleteReqVO);
+
+    /**
+     * 获得招聘渠道
+     *
+     * @param id 招聘渠道编号
+     * @return 招聘渠道
+     */
+    HrmRecruitChannelDO getRecruitChannel(Long id);
+
+    /**
+     * 校验招聘渠道是否存在
+     *
+     * @param id 招聘渠道编号
+     * @return 招聘渠道
+     */
+    HrmRecruitChannelDO validateRecruitChannelExists(Long id);
+
+    /**
+     * 获得招聘渠道列表
+     *
+     * @param ids 招聘渠道编号集合
+     * @return 招聘渠道列表
+     */
+    List<HrmRecruitChannelDO> getRecruitChannelList(Collection<Long> ids);
+
+    /**
+     * 获得招聘渠道 Map
+     *
+     * @param ids 招聘渠道编号集合
+     * @return 招聘渠道 Map
+     */
+    default Map<Long, HrmRecruitChannelDO> getRecruitChannelMap(Collection<Long> ids) {
+        return convertMap(getRecruitChannelList(ids), HrmRecruitChannelDO::getId);
+    }
+
+    /**
+     * 获得招聘渠道分页列表
+     *
+     * @param pageReqVO 分页查询
+     * @return 招聘渠道分页列表
+     */
+    PageResult<HrmRecruitChannelDO> getRecruitChannelPage(HrmRecruitChannelPageReqVO pageReqVO);
+
+    /**
+     * 获得招聘渠道精简列表
+     *
+     * @return 招聘渠道精简列表
+     */
+    List<HrmRecruitChannelDO> getRecruitChannelSimpleList();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelServiceImpl.java
new file mode 100644
index 0000000..e8d436d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelServiceImpl.java
@@ -0,0 +1,164 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.config;
+
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelDeleteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.config.HrmRecruitChannelMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CHANNEL_SYSTEM_NAME_UPDATE_FORBIDDEN;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CHANNEL_SYSTEM_DELETE_FORBIDDEN;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CHANNEL_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CHANNEL_TRANSFER_DISABLED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CHANNEL_TRANSFER_SELF;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * 招聘渠道 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmRecruitChannelServiceImpl implements HrmRecruitChannelService {
+
+    @Resource
+    private HrmRecruitChannelMapper recruitChannelMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmRecruitCandidateService recruitCandidateService;
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_CHANNEL_TYPE, subType = HRM_RECRUIT_CHANNEL_CREATE_SUB_TYPE,
+            bizNo = "{{#recruitChannelId}}", success = HRM_RECRUIT_CHANNEL_CREATE_SUCCESS)
+    public Long createRecruitChannel(HrmRecruitChannelSaveReqVO createReqVO) {
+        // 1. 插入招聘渠道
+        HrmRecruitChannelDO recruitChannel = BeanUtils.toBean(createReqVO, HrmRecruitChannelDO.class)
+                .setSystemFlag(Boolean.FALSE).setStatus(CommonStatusEnum.ENABLE.getStatus());
+        recruitChannelMapper.insert(recruitChannel);
+
+        // 2. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitChannelId", recruitChannel.getId());
+        return recruitChannel.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_CHANNEL_TYPE, subType = HRM_RECRUIT_CHANNEL_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = HRM_RECRUIT_CHANNEL_UPDATE_SUCCESS)
+    public void updateRecruitChannel(HrmRecruitChannelSaveReqVO updateReqVO) {
+        // 1. 校验招聘渠道是否存在。系统内置渠道只允许调整排序和备注
+        HrmRecruitChannelDO recruitChannel = validateRecruitChannelExists(updateReqVO.getId());
+        if (Boolean.TRUE.equals(recruitChannel.getSystemFlag())
+                && ObjUtil.notEqual(recruitChannel.getName(), updateReqVO.getName())) {
+            throw exception(RECRUIT_CHANNEL_SYSTEM_NAME_UPDATE_FORBIDDEN);
+        }
+
+        // 2. 更新招聘渠道
+        recruitChannelMapper.updateById(BeanUtils.toBean(updateReqVO, HrmRecruitChannelDO.class));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(recruitChannel, HrmRecruitChannelSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_CHANNEL_TYPE, subType = HRM_RECRUIT_CHANNEL_UPDATE_STATUS_SUB_TYPE,
+            bizNo = "{{#statusReqVO.id}}", success = HRM_RECRUIT_CHANNEL_UPDATE_STATUS_SUCCESS)
+    public void updateRecruitChannelStatus(HrmRecruitChannelStatusReqVO statusReqVO) {
+        // 1. 校验招聘渠道是否存在
+        HrmRecruitChannelDO recruitChannel = validateRecruitChannelExists(statusReqVO.getId());
+
+        // 2. 更新招聘渠道状态
+        recruitChannelMapper.updateById(new HrmRecruitChannelDO()
+                .setId(statusReqVO.getId()).setStatus(statusReqVO.getStatus()));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitChannel", recruitChannel);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CHANNEL_TYPE, subType = HRM_RECRUIT_CHANNEL_DELETE_SUB_TYPE,
+            bizNo = "{{#deleteReqVO.id}}", success = HRM_RECRUIT_CHANNEL_DELETE_SUCCESS)
+    public void deleteRecruitChannel(HrmRecruitChannelDeleteReqVO deleteReqVO) {
+        // 1.1 校验待删除招聘渠道
+        HrmRecruitChannelDO recruitChannel = validateRecruitChannelExists(deleteReqVO.getId());
+        if (Boolean.TRUE.equals(recruitChannel.getSystemFlag())) {
+            throw exception(RECRUIT_CHANNEL_SYSTEM_DELETE_FORBIDDEN);
+        }
+        if (ObjUtil.equals(deleteReqVO.getId(), deleteReqVO.getTransferChannelId())) {
+            throw exception(RECRUIT_CHANNEL_TRANSFER_SELF);
+        }
+        // 1.2 校验承接招聘渠道
+        HrmRecruitChannelDO transferRecruitChannel = validateRecruitChannelExists(deleteReqVO.getTransferChannelId());
+        if (!CommonStatusEnum.isEnable(transferRecruitChannel.getStatus())) {
+            throw exception(RECRUIT_CHANNEL_TRANSFER_DISABLED);
+        }
+
+        // 2. 迁移员工、候选人的招聘渠道后，删除原渠道
+        employeeService.updateEmployeeChannelByChannelId(recruitChannel.getId(), transferRecruitChannel.getId());
+        recruitCandidateService.updateRecruitCandidateChannelByChannelId(
+                recruitChannel.getId(), transferRecruitChannel.getId());
+        recruitChannelMapper.deleteById(recruitChannel.getId());
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitChannel", recruitChannel);
+        LogRecordContext.putVariable("transferRecruitChannel", transferRecruitChannel);
+    }
+
+    @Override
+    public HrmRecruitChannelDO getRecruitChannel(Long id) {
+        return recruitChannelMapper.selectById(id);
+    }
+
+    @Override
+    public HrmRecruitChannelDO validateRecruitChannelExists(Long id) {
+        HrmRecruitChannelDO recruitChannel = recruitChannelMapper.selectById(id);
+        if (recruitChannel == null) {
+            throw exception(RECRUIT_CHANNEL_NOT_EXISTS);
+        }
+        return recruitChannel;
+    }
+
+    @Override
+    public List<HrmRecruitChannelDO> getRecruitChannelList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return recruitChannelMapper.selectByIds(ids);
+    }
+
+    @Override
+    public PageResult<HrmRecruitChannelDO> getRecruitChannelPage(HrmRecruitChannelPageReqVO pageReqVO) {
+        return recruitChannelMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmRecruitChannelDO> getRecruitChannelSimpleList() {
+        return recruitChannelMapper.selectListByStatus(CommonStatusEnum.ENABLE.getStatus());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigService.java
new file mode 100644
index 0000000..fc653d2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigService.java
@@ -0,0 +1,29 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.config.HrmRecruitEliminateReasonSaveReqVO;
+
+import jakarta.validation.Valid;
+import java.util.List;
+
+/**
+ * HRM 招聘设置 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmRecruitConfigService {
+
+    /**
+     * 保存招聘淘汰原因
+     *
+     * @param saveReqVO 淘汰原因列表
+     */
+    void saveRecruitEliminateReason(@Valid HrmRecruitEliminateReasonSaveReqVO saveReqVO);
+
+    /**
+     * 获得招聘淘汰原因列表
+     *
+     * @return 淘汰原因列表
+     */
+    List<String> getRecruitEliminateReasonList();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigServiceImpl.java
new file mode 100644
index 0000000..b7704de
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigServiceImpl.java
@@ -0,0 +1,60 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.config.HrmRecruitEliminateReasonSaveReqVO;
+import cn.iocoder.yudao.module.hrm.service.config.HrmConfigService;
+import cn.iocoder.yudao.module.hrm.enums.config.HrmConfigTypeEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.util.StringUtils;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertLinkedSet;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_RECRUIT_CONFIG_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_RECRUIT_ELIMINATE_REASON_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_RECRUIT_ELIMINATE_REASON_UPDATE_SUCCESS;
+
+/**
+ * HRM 招聘设置 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmRecruitConfigServiceImpl implements HrmRecruitConfigService {
+
+    @Resource
+    private HrmConfigService configService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_RECRUIT_CONFIG_TYPE, subType = HRM_RECRUIT_ELIMINATE_REASON_UPDATE_SUB_TYPE,
+            bizNo = "{{#configType}}", success = HRM_RECRUIT_ELIMINATE_REASON_UPDATE_SUCCESS)
+    public void saveRecruitEliminateReason(HrmRecruitEliminateReasonSaveReqVO saveReqVO) {
+        // 1. 过滤并去重淘汰原因
+        List<String> reasons = new ArrayList<>(convertLinkedSet(saveReqVO.getReasons(), String::trim,
+                StringUtils::hasText));
+        HrmRecruitEliminateReasonSaveReqVO oldConfig = new HrmRecruitEliminateReasonSaveReqVO()
+                .setReasons(getRecruitEliminateReasonList());
+        saveReqVO.setReasons(reasons);
+
+        // 2. 保存淘汰原因
+        configService.replaceConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType(), reasons);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("configType", HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType());
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT, oldConfig);
+    }
+
+    @Override
+    public List<String> getRecruitEliminateReasonList() {
+        return configService.getConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostService.java
new file mode 100644
index 0000000..d90d209
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostService.java
@@ -0,0 +1,101 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.post;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * 招聘职位 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmRecruitPostService {
+
+    /**
+     * 创建招聘职位
+     *
+     * @param createReqVO 招聘职位信息
+     * @return 招聘职位编号
+     */
+    Long createRecruitPost(HrmRecruitPostSaveReqVO createReqVO);
+
+    /**
+     * 更新招聘职位
+     *
+     * @param updateReqVO 招聘职位信息
+     */
+    void updateRecruitPost(HrmRecruitPostSaveReqVO updateReqVO);
+
+    /**
+     * 获得招聘职位
+     *
+     * @param id 招聘职位编号
+     * @return 招聘职位
+     */
+    HrmRecruitPostDO getRecruitPost(Long id);
+
+    /**
+     * 校验招聘职位是否存在
+     *
+     * @param id 招聘职位编号
+     * @return 招聘职位
+     */
+    HrmRecruitPostDO validateRecruitPostExists(Long id);
+
+    /**
+     * 获得招聘职位列表
+     *
+     * @param ids 招聘职位编号集合
+     * @return 招聘职位列表
+     */
+    List<HrmRecruitPostDO> getRecruitPostList(Collection<Long> ids);
+
+    /**
+     * 获得招聘职位 Map
+     *
+     * @param ids 招聘职位编号集合
+     * @return 招聘职位 Map
+     */
+    default Map<Long, HrmRecruitPostDO> getRecruitPostMap(Collection<Long> ids) {
+        return convertMap(getRecruitPostList(ids), HrmRecruitPostDO::getId);
+    }
+
+    /**
+     * 获得招聘职位分页列表
+     *
+     * @param pageReqVO 分页查询
+     * @return 招聘职位分页列表
+     */
+    PageResult<HrmRecruitPostDO> getRecruitPostPage(HrmRecruitPostPageReqVO pageReqVO);
+
+    /**
+     * 获得招聘职位精简列表
+     *
+     * @return 招聘职位精简列表
+     */
+    List<HrmRecruitPostDO> getRecruitPostSimpleList();
+
+    /**
+     * 更新招聘职位状态
+     *
+     * @param reqVO 招聘职位状态信息
+     */
+    void updateRecruitPostStatus(HrmRecruitPostStatusReqVO reqVO);
+
+    /**
+     * 获得招聘职位状态统计列表
+     *
+     * @param pageReqVO 分页查询
+     * @return 状态与数量的映射
+     */
+    Map<Integer, Long> getRecruitPostStatusCount(HrmRecruitPostPageReqVO pageReqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostServiceImpl.java
new file mode 100644
index 0000000..49723ae
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostServiceImpl.java
@@ -0,0 +1,159 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.post;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.post.HrmRecruitPostMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_POST_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * 招聘职位 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmRecruitPostServiceImpl implements HrmRecruitPostService {
+
+    @Resource
+    private HrmRecruitPostMapper recruitPostMapper;
+
+    @Resource
+    private HrmRecruitPostTypeService recruitPostTypeService;
+
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_POST_TYPE, subType = HRM_RECRUIT_POST_CREATE_SUB_TYPE,
+            bizNo = "{{#recruitPostId}}", success = HRM_RECRUIT_POST_CREATE_SUCCESS)
+    public Long createRecruitPost(HrmRecruitPostSaveReqVO createReqVO) {
+        // 1. 校验招聘职位关联
+        validateRecruitPost(createReqVO);
+
+        // 2. 插入招聘职位。新职位统一为招聘中状态，后续通过状态接口停止招聘
+        HrmRecruitPostDO recruitPost = BeanUtils.toBean(createReqVO, HrmRecruitPostDO.class)
+                .setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus());
+        recruitPostMapper.insert(recruitPost);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitPostId", recruitPost.getId());
+        return recruitPost.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_POST_TYPE, subType = HRM_RECRUIT_POST_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = HRM_RECRUIT_POST_UPDATE_SUCCESS)
+    public void updateRecruitPost(HrmRecruitPostSaveReqVO updateReqVO) {
+        // 1. 校验招聘职位及其关联
+        HrmRecruitPostDO recruitPost = validateRecruitPostExists(updateReqVO.getId());
+        validateRecruitPost(updateReqVO);
+
+        // 2. 更新招聘职位
+        recruitPostMapper.updateForEdit(BeanUtils.toBean(updateReqVO, HrmRecruitPostDO.class));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(recruitPost, HrmRecruitPostSaveReqVO.class));
+    }
+
+    @Override
+    public HrmRecruitPostDO getRecruitPost(Long id) {
+        return recruitPostMapper.selectById(id);
+    }
+
+    @Override
+    public HrmRecruitPostDO validateRecruitPostExists(Long id) {
+        HrmRecruitPostDO recruitPost = recruitPostMapper.selectById(id);
+        if (recruitPost == null) {
+            throw exception(RECRUIT_POST_NOT_EXISTS);
+        }
+        return recruitPost;
+    }
+
+    @Override
+    public List<HrmRecruitPostDO> getRecruitPostList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return recruitPostMapper.selectByIds(ids);
+    }
+
+    @Override
+    public PageResult<HrmRecruitPostDO> getRecruitPostPage(HrmRecruitPostPageReqVO pageReqVO) {
+        return recruitPostMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmRecruitPostDO> getRecruitPostSimpleList() {
+        return recruitPostMapper.selectListByStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus());
+    }
+
+    @Override
+    @LogRecord(type = HRM_RECRUIT_POST_TYPE, subType = HRM_RECRUIT_POST_UPDATE_STATUS_SUB_TYPE,
+            bizNo = "{{#reqVO.id}}", success = HRM_RECRUIT_POST_UPDATE_STATUS_SUCCESS)
+    public void updateRecruitPostStatus(HrmRecruitPostStatusReqVO reqVO) {
+        // 1. 校验招聘职位是否存在
+        HrmRecruitPostDO recruitPost = validateRecruitPostExists(reqVO.getId());
+
+        // 2. 更新招聘职位状态
+        HrmRecruitPostDO updateObj = BeanUtils.toBean(reqVO, HrmRecruitPostDO.class);
+        if (HrmRecruitPostStatusEnum.STOPPED.getStatus().equals(reqVO.getStatus())) {
+            updateObj.setStopReason(reqVO.getStopReason());
+        } else {
+            updateObj.setStopReason("");
+        }
+        recruitPostMapper.updateById(updateObj);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("recruitPost", recruitPost);
+    }
+
+    @Override
+    public Map<Integer, Long> getRecruitPostStatusCount(HrmRecruitPostPageReqVO pageReqVO) {
+        return recruitPostMapper.selectCountMapByStatus(pageReqVO);
+    }
+
+    private void validateRecruitPost(HrmRecruitPostSaveReqVO reqVO) {
+        // 1. 校验职位类型和用人部门存在
+        recruitPostTypeService.validateRecruitPostTypeExists(reqVO.getPostTypeId());
+        if (reqVO.getDeptId() != null) {
+            deptApi.validateDeptList(Collections.singleton(reqVO.getDeptId()));
+        }
+
+        // 2. 校验招聘负责人和面试官存在
+        Set<Long> employeeIds = new HashSet<>(CollUtil.emptyIfNull(reqVO.getInterviewEmployeeIds()));
+        CollectionUtils.addIfNotNull(employeeIds, reqVO.getOwnerEmployeeId());
+        employeeService.validateEmployeeListByEntryStatus(
+                employeeIds, HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeService.java
new file mode 100644
index 0000000..928fb83
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeService.java
@@ -0,0 +1,51 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.post;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostTypeDO;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * 招聘职位类型 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmRecruitPostTypeService {
+
+    /**
+     * 校验招聘职位类型是否存在
+     *
+     * @param id 招聘职位类型编号
+     */
+    void validateRecruitPostTypeExists(Long id);
+
+    /**
+     * 获得招聘职位类型列表
+     *
+     * @param status 状态
+     * @return 招聘职位类型列表
+     */
+    List<HrmRecruitPostTypeDO> getRecruitPostTypeList(Integer status);
+
+    /**
+     * 获得指定编号的招聘职位类型列表
+     *
+     * @param ids 招聘职位类型编号集合
+     * @return 招聘职位类型列表
+     */
+    List<HrmRecruitPostTypeDO> getRecruitPostTypeListByIds(Collection<Long> ids);
+
+    /**
+     * 获得指定编号的招聘职位类型 Map
+     *
+     * @param ids 招聘职位类型编号集合
+     * @return 招聘职位类型 Map
+     */
+    default Map<Long, HrmRecruitPostTypeDO> getRecruitPostTypeMap(Collection<Long> ids) {
+        return convertMap(getRecruitPostTypeListByIds(ids), HrmRecruitPostTypeDO::getId);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeServiceImpl.java
new file mode 100644
index 0000000..0b4e305
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeServiceImpl.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.post;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostTypeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.post.HrmRecruitPostTypeMapper;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_POST_TYPE_NOT_EXISTS;
+
+/**
+ * 招聘职位类型 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmRecruitPostTypeServiceImpl implements HrmRecruitPostTypeService {
+
+    @Resource
+    private HrmRecruitPostTypeMapper recruitPostTypeMapper;
+
+    @Override
+    public void validateRecruitPostTypeExists(Long id) {
+        if (id == null) {
+            return;
+        }
+        if (recruitPostTypeMapper.selectById(id) == null) {
+            throw exception(RECRUIT_POST_TYPE_NOT_EXISTS);
+        }
+    }
+
+    @Override
+    public List<HrmRecruitPostTypeDO> getRecruitPostTypeList(Integer status) {
+        return recruitPostTypeMapper.selectListByStatus(status);
+    }
+
+    @Override
+    public List<HrmRecruitPostTypeDO> getRecruitPostTypeListByIds(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return recruitPostTypeMapper.selectByIds(ids);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateService.java
new file mode 100644
index 0000000..1d8ce0a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateService.java
@@ -0,0 +1,54 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate.HrmSalaryChangeTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryChangeTemplateDO;
+
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 调薪模板 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryChangeTemplateService {
+
+    /**
+     * 创建调薪模板
+     *
+     * @param createReqVO 调薪模板信息
+     * @return 调薪模板编号
+     */
+    Long createSalaryChangeTemplate(@Valid HrmSalaryChangeTemplateSaveReqVO createReqVO);
+
+    /**
+     * 更新调薪模板
+     *
+     * @param updateReqVO 调薪模板信息
+     */
+    void updateSalaryChangeTemplate(@Valid HrmSalaryChangeTemplateSaveReqVO updateReqVO);
+
+    /**
+     * 删除调薪模板
+     *
+     * @param id 调薪模板编号
+     */
+    void deleteSalaryChangeTemplate(Long id);
+
+    /**
+     * 获得调薪模板
+     *
+     * @param id 调薪模板编号
+     * @return 调薪模板
+     */
+    HrmSalaryChangeTemplateDO getSalaryChangeTemplate(Long id);
+
+    /**
+     * 获得调薪模板列表
+     *
+     * @return 调薪模板列表
+     */
+    List<HrmSalaryChangeTemplateDO> getSalaryChangeTemplateList();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateServiceImpl.java
new file mode 100644
index 0000000..802cdb0
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateServiceImpl.java
@@ -0,0 +1,139 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate.HrmSalaryChangeOptionVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate.HrmSalaryChangeTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryChangeTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryChangeTemplateDO.Option;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryChangeTemplateMapper;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_TEMPLATE_DEFAULT_CANNOT_DELETE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_TEMPLATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_TEMPLATE_OPTION_INVALID;
+
+/**
+ * HRM 调薪模板 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryChangeTemplateServiceImpl implements HrmSalaryChangeTemplateService {
+
+    @Resource
+    private HrmSalaryChangeTemplateMapper salaryChangeTemplateMapper;
+    @Resource
+    private HrmSalaryOptionService salaryOptionService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Long createSalaryChangeTemplate(HrmSalaryChangeTemplateSaveReqVO createReqVO) {
+        // 1. 校验调薪项
+        List<Option> options = buildSalaryChangeOptions(createReqVO.getOptions());
+
+        // 2. 清理原默认模板
+        if (Boolean.TRUE.equals(createReqVO.getDefaultStatus())) {
+            clearSalaryChangeTemplateDefault(null);
+        }
+
+        // 3. 创建调薪模板
+        HrmSalaryChangeTemplateDO template = new HrmSalaryChangeTemplateDO()
+                .setName(createReqVO.getName()).setDefaultStatus(createReqVO.getDefaultStatus())
+                .setOptions(options);
+        salaryChangeTemplateMapper.insert(template);
+        return template.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updateSalaryChangeTemplate(HrmSalaryChangeTemplateSaveReqVO updateReqVO) {
+        // 1.1 校验调薪模板存在
+        validateSalaryChangeTemplateExists(updateReqVO.getId());
+        // 1.2 校验调薪项
+        List<Option> options = buildSalaryChangeOptions(updateReqVO.getOptions());
+
+        // 2.1 清理原默认模板
+        if (Boolean.TRUE.equals(updateReqVO.getDefaultStatus())) {
+            clearSalaryChangeTemplateDefault(updateReqVO.getId());
+        }
+        // 2.2 更新调薪模板
+        HrmSalaryChangeTemplateDO updateObj = new HrmSalaryChangeTemplateDO()
+                .setId(updateReqVO.getId()).setName(updateReqVO.getName())
+                .setDefaultStatus(updateReqVO.getDefaultStatus()).setOptions(options);
+        salaryChangeTemplateMapper.updateById(updateObj);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deleteSalaryChangeTemplate(Long id) {
+        // 1. 校验调薪模板存在且不是默认模板
+        HrmSalaryChangeTemplateDO template = validateSalaryChangeTemplateExists(id);
+        if (Boolean.TRUE.equals(template.getDefaultStatus())) {
+            throw exception(SALARY_CHANGE_TEMPLATE_DEFAULT_CANNOT_DELETE);
+        }
+
+        // 2. 删除调薪模板
+        salaryChangeTemplateMapper.deleteById(id);
+    }
+
+    @Override
+    public HrmSalaryChangeTemplateDO getSalaryChangeTemplate(Long id) {
+        return salaryChangeTemplateMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmSalaryChangeTemplateDO> getSalaryChangeTemplateList() {
+        return salaryChangeTemplateMapper.selectListByIdDesc();
+    }
+
+    private void clearSalaryChangeTemplateDefault(Long excludeId) {
+        for (HrmSalaryChangeTemplateDO template :
+                salaryChangeTemplateMapper.selectListByDefaultStatus(true)) {
+            if (ObjUtil.notEqual(template.getId(), excludeId)) {
+                salaryChangeTemplateMapper.updateById(new HrmSalaryChangeTemplateDO()
+                        .setId(template.getId()).setDefaultStatus(false));
+            }
+        }
+    }
+
+    private HrmSalaryChangeTemplateDO validateSalaryChangeTemplateExists(Long id) {
+        HrmSalaryChangeTemplateDO template = salaryChangeTemplateMapper.selectById(id);
+        if (template == null) {
+            throw exception(SALARY_CHANGE_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    private List<Option> buildSalaryChangeOptions(List<HrmSalaryChangeOptionVO> options) {
+        if (CollUtil.isEmpty(options)) {
+            throw exception(SALARY_CHANGE_TEMPLATE_OPTION_INVALID);
+        }
+        // 1. 获得可用调薪项
+        Map<Integer, HrmSalaryOptionDO> salaryOptionMap = convertMap(
+                salaryOptionService.getSalaryOptionList(true), HrmSalaryOptionDO::getCode);
+        // 2. 校验薪资项编码，并保存名称快照
+        Set<Integer> optionCodes = new HashSet<>();
+        return convertList(options, option -> {
+            HrmSalaryOptionDO salaryOption = option == null ? null : salaryOptionMap.get(option.getCode());
+            if (salaryOption == null || !optionCodes.add(option.getCode())) {
+                throw exception(SALARY_CHANGE_TEMPLATE_OPTION_INVALID);
+            }
+            return Option.builder().name(salaryOption.getName()).code(salaryOption.getCode()).build();
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigService.java
new file mode 100644
index 0000000..da3e902
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigService.java
@@ -0,0 +1,36 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryConfigDO;
+
+/**
+ * HRM 计薪配置 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryConfigService {
+
+    /**
+     * 创建计薪配置
+     *
+     * @param createReqVO 计薪配置信息
+     * @return 配置编号
+     */
+    Long createSalaryConfig(HrmSalaryConfigCreateReqVO createReqVO);
+
+    /**
+     * 更新计薪配置
+     *
+     * @param updateReqVO 计薪配置信息
+     */
+    void updateSalaryConfig(HrmSalaryConfigUpdateReqVO updateReqVO);
+
+    /**
+     * 获得计薪配置
+     *
+     * @return 计薪配置
+     */
+    HrmSalaryConfigDO getSalaryConfig();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigServiceImpl.java
new file mode 100644
index 0000000..4ef8c01
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigServiceImpl.java
@@ -0,0 +1,96 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryConfigDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryConfigMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CONFIG_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CONFIG_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_CONFIG_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_CONFIG_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_CONFIG_UPDATE_SUCCESS;
+
+/**
+ * HRM 计薪配置 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryConfigServiceImpl implements HrmSalaryConfigService {
+
+    @Resource
+    private HrmSalaryConfigMapper salaryConfigMapper;
+
+    @Resource
+    @Lazy // 延迟加载
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Long createSalaryConfig(HrmSalaryConfigCreateReqVO createReqVO) {
+        // 1. 校验计薪配置不存在
+        validateSalaryConfigNotExists();
+
+        // 2. 创建计薪配置，结束日由开始日推导
+        HrmSalaryConfigDO config = BeanUtils.toBean(createReqVO, HrmSalaryConfigDO.class);
+        config.setCycleEndDay(config.getCycleStartDay() == 1 ? 31 : config.getCycleStartDay() - 1);
+        salaryConfigMapper.insert(config);
+
+        // 3. 创建启用月份的工资表
+        HrmSalaryMonthRecordCreateReqVO monthRecordCreateReqVO = new HrmSalaryMonthRecordCreateReqVO()
+                .setYear(config.getStartYear()).setMonth(config.getStartMonth());
+        salaryMonthRecordService.createMonthRecord(monthRecordCreateReqVO);
+        return config.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_SALARY_CONFIG_TYPE, subType = HRM_SALARY_CONFIG_UPDATE_SUB_TYPE,
+            bizNo = "{{#salaryConfig.id}}", success = HRM_SALARY_CONFIG_UPDATE_SUCCESS)
+    public void updateSalaryConfig(HrmSalaryConfigUpdateReqVO updateReqVO) {
+        // 1. 校验计薪配置存在
+        HrmSalaryConfigDO config = validateSalaryConfigExists();
+
+        // 2. 更新计薪配置
+        salaryConfigMapper.updateById(new HrmSalaryConfigDO().setId(config.getId())
+                .setSocialSecurityMonthType(updateReqVO.getSocialSecurityMonthType()));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryConfig", config);
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(config, HrmSalaryConfigUpdateReqVO.class));
+    }
+
+    @Override
+    public HrmSalaryConfigDO getSalaryConfig() {
+        return salaryConfigMapper.selectFirst();
+    }
+
+    private void validateSalaryConfigNotExists() {
+        if (salaryConfigMapper.selectFirst() != null) {
+            throw exception(SALARY_CONFIG_EXISTS);
+        }
+    }
+
+    private HrmSalaryConfigDO validateSalaryConfigExists() {
+        HrmSalaryConfigDO config = salaryConfigMapper.selectFirst();
+        if (config == null) {
+            throw exception(SALARY_CONFIG_NOT_EXISTS);
+        }
+        return config;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupService.java
new file mode 100644
index 0000000..6a51e28
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupService.java
@@ -0,0 +1,96 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * HRM 薪资组 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryGroupService {
+
+    /**
+     * 创建薪资组
+     *
+     * @param createReqVO 创建信息
+     * @return 薪资组编号
+     */
+    Long createSalaryGroup(@Valid HrmSalaryGroupSaveReqVO createReqVO);
+
+    /**
+     * 更新薪资组
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateSalaryGroup(@Valid HrmSalaryGroupSaveReqVO updateReqVO);
+
+    /**
+     * 删除薪资组
+     *
+     * @param id 薪资组编号
+     */
+    void deleteSalaryGroup(Long id);
+
+    /**
+     * 获得薪资组
+     *
+     * @param id 薪资组编号
+     * @return 薪资组
+     */
+    HrmSalaryGroupDO getSalaryGroup(Long id);
+
+    /**
+     * 获得薪资组分页
+     *
+     * @param pageReqVO 分页查询
+     * @return 薪资组分页
+     */
+    PageResult<HrmSalaryGroupDO> getSalaryGroupPage(HrmSalaryGroupPageReqVO pageReqVO);
+
+    /**
+     * 获得薪资组列表
+     *
+     * @return 薪资组列表
+     */
+    List<HrmSalaryGroupDO> getSalaryGroupList();
+
+    /**
+     * 获得员工适用的薪资组 Map
+     *
+     * 员工单独配置优先于部门配置，部门配置向下覆盖子部门
+     *
+     * @param employees 员工列表
+     * @return 员工编号与薪资组的映射
+     */
+    Map<Long, HrmSalaryGroupDO> getEmployeeSalaryGroupMap(Collection<HrmEmployeeDO> employees);
+
+    /**
+     * 获得使用指定计税规则的薪资组数量
+     *
+     * @param taxRuleId 计税规则编号
+     * @return 薪资组数量
+     */
+    default long getSalaryGroupCountByTaxRuleId(Long taxRuleId) {
+        return getSalaryGroupCountMapByTaxRuleIds(Collections.singleton(taxRuleId))
+                .getOrDefault(taxRuleId, 0L);
+    }
+
+    /**
+     * 获得计税规则使用的薪资组数量 Map
+     *
+     * @param taxRuleIds 计税规则编号集合
+     * @return 计税规则编号与薪资组数量的映射
+     */
+    Map<Long, Long> getSalaryGroupCountMapByTaxRuleIds(Collection<Long> taxRuleIds);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupServiceImpl.java
new file mode 100644
index 0000000..5df0d61
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupServiceImpl.java
@@ -0,0 +1,261 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryGroupMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_GROUP_DEPT_CONFLICT;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_GROUP_EMPLOYEE_CONFLICT;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_GROUP_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_GROUP_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 薪资组 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryGroupServiceImpl implements HrmSalaryGroupService {
+
+    @Resource
+    private HrmSalaryGroupMapper salaryGroupMapper;
+
+    @Resource
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Resource
+    private DeptApi deptApi;
+
+    @Override
+    @LogRecord(type = HRM_SALARY_GROUP_TYPE, subType = HRM_SALARY_GROUP_CREATE_SUB_TYPE,
+            bizNo = "{{#salaryGroup.id}}", success = HRM_SALARY_GROUP_CREATE_SUCCESS)
+    public Long createSalaryGroup(HrmSalaryGroupSaveReqVO createReqVO) {
+        // 1. 校验薪资组
+        validateSalaryGroupForCreateOrUpdate(null, createReqVO);
+
+        // 2. 创建薪资组
+        HrmSalaryGroupDO salaryGroup = BeanUtils.toBean(createReqVO, HrmSalaryGroupDO.class);
+        fillSalaryGroupDefaultValue(salaryGroup);
+        salaryGroupMapper.insert(salaryGroup);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryGroup", salaryGroup);
+        return salaryGroup.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_SALARY_GROUP_TYPE, subType = HRM_SALARY_GROUP_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = HRM_SALARY_GROUP_UPDATE_SUCCESS)
+    public void updateSalaryGroup(HrmSalaryGroupSaveReqVO updateReqVO) {
+        // 1. 校验薪资组
+        HrmSalaryGroupDO oldSalaryGroup = validateSalaryGroupForCreateOrUpdate(
+                updateReqVO.getId(), updateReqVO);
+
+        // 2. 更新薪资组
+        HrmSalaryGroupDO updateObj = BeanUtils.toBean(updateReqVO, HrmSalaryGroupDO.class);
+        fillSalaryGroupDefaultValue(updateObj);
+        salaryGroupMapper.updateById(updateObj);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(oldSalaryGroup, HrmSalaryGroupSaveReqVO.class));
+    }
+
+    @Override
+    @LogRecord(type = HRM_SALARY_GROUP_TYPE, subType = HRM_SALARY_GROUP_DELETE_SUB_TYPE,
+            bizNo = "{{#salaryGroup.id}}", success = HRM_SALARY_GROUP_DELETE_SUCCESS)
+    public void deleteSalaryGroup(Long id) {
+        // 1. 校验薪资组存在
+        HrmSalaryGroupDO salaryGroup = validateSalaryGroupExists(id);
+
+        // 2. 删除薪资组
+        salaryGroupMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryGroup", salaryGroup);
+    }
+
+    @Override
+    public HrmSalaryGroupDO getSalaryGroup(Long id) {
+        return salaryGroupMapper.selectById(id);
+    }
+
+    @Override
+    public PageResult<HrmSalaryGroupDO> getSalaryGroupPage(HrmSalaryGroupPageReqVO pageReqVO) {
+        return salaryGroupMapper.selectPage(pageReqVO);
+    }
+
+    @Override
+    public List<HrmSalaryGroupDO> getSalaryGroupList() {
+        return salaryGroupMapper.selectListByIdDesc();
+    }
+
+    @Override
+    public Map<Long, HrmSalaryGroupDO> getEmployeeSalaryGroupMap(Collection<HrmEmployeeDO> employees) {
+        if (CollUtil.isEmpty(employees)) {
+            return Collections.emptyMap();
+        }
+        // 1. 查询薪资组
+        List<HrmSalaryGroupDO> salaryGroups = salaryGroupMapper.selectListByIdDesc();
+        if (CollUtil.isEmpty(salaryGroups)) {
+            return Collections.emptyMap();
+        }
+
+        // 2. 构建员工和部门对应的薪资组 Map
+        Map<Long, HrmSalaryGroupDO> employeeSalaryGroupMap = new HashMap<>();
+        Map<Long, HrmSalaryGroupDO> deptSalaryGroupMap = new HashMap<>();
+        for (HrmSalaryGroupDO salaryGroup : salaryGroups) {
+            CollUtil.emptyIfNull(salaryGroup.getEmployeeIds())
+                    .forEach(employeeId -> employeeSalaryGroupMap.put(employeeId, salaryGroup));
+            CollUtil.emptyIfNull(salaryGroup.getDeptIds())
+                    .forEach(deptId -> deptSalaryGroupMap.put(deptId, salaryGroup));
+        }
+
+        // 3. 员工单独配置优先，其次匹配最近的上级部门配置
+        Map<Long, List<Long>> parentDeptIdCache = new HashMap<>();
+        Map<Long, HrmSalaryGroupDO> result = new LinkedHashMap<>();
+        for (HrmEmployeeDO employee : employees) {
+            if (employee.getId() == null) {
+                continue;
+            }
+            HrmSalaryGroupDO salaryGroup = employeeSalaryGroupMap.get(employee.getId());
+            if (salaryGroup == null) {
+                salaryGroup = findDeptSalaryGroup(employee.getDeptId(), deptSalaryGroupMap, parentDeptIdCache);
+            }
+            if (salaryGroup != null) {
+                result.put(employee.getId(), salaryGroup);
+            }
+        }
+        return result;
+    }
+
+    @Override
+    public Map<Long, Long> getSalaryGroupCountMapByTaxRuleIds(Collection<Long> taxRuleIds) {
+        if (CollUtil.isEmpty(taxRuleIds)) {
+            return Collections.emptyMap();
+        }
+        return salaryGroupMapper.selectCountMapByTaxRuleIds(taxRuleIds);
+    }
+
+    private HrmSalaryGroupDO findDeptSalaryGroup(Long employeeDeptId,
+                                                 Map<Long, HrmSalaryGroupDO> deptSalaryGroupMap,
+                                                 Map<Long, List<Long>> parentDeptIdCache) {
+        if (employeeDeptId == null) {
+            return null;
+        }
+        HrmSalaryGroupDO salaryGroup = deptSalaryGroupMap.get(employeeDeptId);
+        if (salaryGroup != null) {
+            return salaryGroup;
+        }
+        List<Long> parentDeptIds = parentDeptIdCache.computeIfAbsent(employeeDeptId,
+                deptId -> convertList(deptApi.getParentDeptList(deptId), DeptRespDTO::getId));
+        for (Long parentDeptId : parentDeptIds) {
+            salaryGroup = deptSalaryGroupMap.get(parentDeptId);
+            if (salaryGroup != null) {
+                return salaryGroup;
+            }
+        }
+        return null;
+    }
+
+    private HrmSalaryGroupDO validateSalaryGroupForCreateOrUpdate(Long id, HrmSalaryGroupSaveReqVO reqVO) {
+        // 1. 校验薪资组是否存在
+        HrmSalaryGroupDO salaryGroup = id != null ? validateSalaryGroupExists(id) : null;
+        // 2. 校验薪资组名称唯一
+        validateSalaryGroupNameUnique(id, reqVO.getName());
+        // 3. 校验计税规则
+        salaryTaxRuleService.validateSalaryTaxRuleExists(reqVO.getTaxRuleId());
+        // 4. 校验适用范围
+        validateSalaryGroupScope(id, reqVO.getDeptIds(), reqVO.getEmployeeIds());
+        return salaryGroup;
+    }
+
+    private HrmSalaryGroupDO validateSalaryGroupExists(Long id) {
+        HrmSalaryGroupDO salaryGroup = salaryGroupMapper.selectById(id);
+        if (salaryGroup == null) {
+            throw exception(SALARY_GROUP_NOT_EXISTS);
+        }
+        return salaryGroup;
+    }
+
+    private void validateSalaryGroupNameUnique(Long id, String name) {
+        HrmSalaryGroupDO salaryGroup = salaryGroupMapper.selectByName(name);
+        if (salaryGroup != null && ObjUtil.notEqual(salaryGroup.getId(), id)) {
+            throw exception(SALARY_GROUP_NAME_DUPLICATE);
+        }
+    }
+
+    private void validateSalaryGroupScope(Long id, Collection<Long> deptIds, Collection<Long> employeeIds) {
+        // 1. 校验适用部门及其上下级部门未归属其他薪资组
+        Set<Long> selectedDeptIds = CollUtil.isEmpty(deptIds)
+                ? Collections.emptySet() : new HashSet<>(deptIds);
+        deptApi.validateDeptList(selectedDeptIds);
+        List<HrmSalaryGroupDO> otherSalaryGroups = convertList(salaryGroupMapper.selectListByIdDesc(),
+                salaryGroup -> salaryGroup, salaryGroup -> ObjUtil.notEqual(salaryGroup.getId(), id));
+        if (CollUtil.isNotEmpty(selectedDeptIds)) {
+            Set<Long> deptScope = getDeptScope(selectedDeptIds);
+            Set<Long> otherDeptIds = convertSetByFlatMap(
+                    otherSalaryGroups, HrmSalaryGroupDO::getDeptIds, Collection::stream);
+            if (!Collections.disjoint(deptScope, getDeptScope(otherDeptIds))) {
+                throw exception(SALARY_GROUP_DEPT_CONFLICT);
+            }
+        }
+
+        // 2. 校验适用员工存在且未归属其他薪资组
+        Set<Long> selectedEmployeeIds = CollUtil.isEmpty(employeeIds)
+                ? Collections.emptySet() : new HashSet<>(employeeIds);
+        employeeService.validateEmployeeListExists(selectedEmployeeIds);
+        Set<Long> otherEmployeeIds = convertSetByFlatMap(
+                otherSalaryGroups, HrmSalaryGroupDO::getEmployeeIds, Collection::stream);
+        if (!Collections.disjoint(selectedEmployeeIds, otherEmployeeIds)) {
+            throw exception(SALARY_GROUP_EMPLOYEE_CONFLICT);
+        }
+    }
+
+    private Set<Long> getDeptScope(Collection<Long> deptIds) {
+        if (CollUtil.isEmpty(deptIds)) {
+            return Collections.emptySet();
+        }
+        Set<Long> result = new HashSet<>(deptIds);
+        result.addAll(convertSet(deptApi.getChildDeptList(deptIds), DeptRespDTO::getId));
+        return result;
+    }
+
+    private void fillSalaryGroupDefaultValue(HrmSalaryGroupDO salaryGroup) {
+        salaryGroup.setSalaryStandard(HrmSalaryGroupDO.DEFAULT_SALARY_STANDARD);
+        salaryGroup.setChangeRule(HrmSalaryGroupDO.DEFAULT_CHANGE_RULE);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionService.java
new file mode 100644
index 0000000..b5bf0a3
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionService.java
@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+
+import java.util.List;
+
+/**
+ * HRM 工资表薪资项 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryOptionService {
+
+    /**
+     * 创建自定义薪资项
+     *
+     * @param createReqVO 创建信息
+     * @return 薪资项编号
+     */
+    Long createSalaryOption(HrmSalaryOptionSaveReqVO createReqVO);
+
+    /**
+     * 更新薪资项启用状态
+     *
+     * @param id      薪资项编号
+     * @param enabled 是否启用
+     */
+    void updateSalaryOptionEnabled(Long id, Boolean enabled);
+
+    /**
+     * 更新薪资项显示状态
+     *
+     * @param id      薪资项编号
+     * @param visible 是否显示
+     */
+    void updateSalaryOptionVisible(Long id, Boolean visible);
+
+    /**
+     * 删除自定义薪资项
+     *
+     * @param id 薪资项编号
+     */
+    void deleteSalaryOption(Long id);
+
+    /**
+     * 同步标准薪资项
+     */
+    void syncSalaryOption();
+
+    /**
+     * 获得已启用的薪资项列表
+     *
+     * @param adjustable 是否只查询可调薪项
+     * @return 薪资项列表
+     */
+    default List<HrmSalaryOptionDO> getSalaryOptionList(Boolean adjustable) {
+        return getSalaryOptionList(adjustable, null);
+    }
+
+    /**
+     * 获得已启用的薪资项列表
+     *
+     * @param adjustable 是否只查询可调薪项
+     * @param visible 是否只查询显示项
+     * @return 薪资项列表
+     */
+    List<HrmSalaryOptionDO> getSalaryOptionList(Boolean adjustable, Boolean visible);
+
+    /**
+     * 获得薪资项列表
+     *
+     * @return 薪资项列表
+     */
+    List<HrmSalaryOptionDO> getSalaryOptionList();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionServiceImpl.java
new file mode 100644
index 0000000..5d4bab1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionServiceImpl.java
@@ -0,0 +1,248 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryOptionMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryOptionTemplateMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ADJUSTABLE_CATEGORY_MAX_CODE;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ADJUSTABLE_CATEGORY_MIN_CODE;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.CUSTOM_OPTION_CODE_BASE;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ROOT_PARENT_CODE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_OPTION_CATEGORY_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_OPTION_CODE_OCCUPIED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_OPTION_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_OPTION_STANDARD_CANNOT_MODIFY;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 工资表薪资项 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryOptionServiceImpl implements HrmSalaryOptionService {
+
+    @Resource
+    private HrmSalaryOptionMapper salaryOptionMapper;
+    @Resource
+    private HrmSalaryOptionTemplateMapper salaryOptionTemplateMapper;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_OPTION_TYPE, subType = HRM_SALARY_OPTION_CREATE_SUB_TYPE,
+            bizNo = "{{#salaryOption.id}}", success = HRM_SALARY_OPTION_CREATE_SUCCESS)
+    public Long createSalaryOption(HrmSalaryOptionSaveReqVO createReqVO) {
+        // 1. 校验薪资项分类
+        HrmSalaryOptionDO category = validateSalaryOptionCategory(createReqVO.getParentCode());
+
+        // 2. 创建薪资项
+        HrmSalaryOptionDO option = new HrmSalaryOptionDO()
+                .setCode(generateCustomSalaryOptionCode(category.getCode())).setParentCode(category.getCode())
+                .setName(createReqVO.getName()).setRemark(createReqVO.getRemark())
+                .setSystemFlag(false).setType(category.getType()).setTaxEnabled(category.getTaxEnabled())
+                .setVisible(true).setCalculateEnabled(category.getCalculateEnabled()).setEnabled(true);
+        salaryOptionMapper.insert(option);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryOption", option);
+        return option.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_OPTION_TYPE, subType = HRM_SALARY_OPTION_UPDATE_ENABLED_SUB_TYPE,
+            bizNo = "{{#salaryOption.id}}", success = HRM_SALARY_OPTION_UPDATE_ENABLED_SUCCESS)
+    public void updateSalaryOptionEnabled(Long id, Boolean enabled) {
+        // 1. 校验薪资项
+        HrmSalaryOptionDO option = validateSalaryOptionExists(id);
+        if (Boolean.TRUE.equals(option.getSystemFlag())) {
+            throw exception(SALARY_OPTION_STANDARD_CANNOT_MODIFY);
+        }
+
+        // 2. 更新启用状态
+        salaryOptionMapper.updateById(new HrmSalaryOptionDO().setId(id).setEnabled(enabled));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryOption", option);
+        LogRecordContext.putVariable("enabled", enabled);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_OPTION_TYPE, subType = HRM_SALARY_OPTION_UPDATE_VISIBLE_SUB_TYPE,
+            bizNo = "{{#salaryOption.id}}", success = HRM_SALARY_OPTION_UPDATE_VISIBLE_SUCCESS)
+    public void updateSalaryOptionVisible(Long id, Boolean visible) {
+        // 1. 校验薪资项
+        HrmSalaryOptionDO option = validateSalaryOptionExists(id);
+        if (Boolean.FALSE.equals(option.getSystemFlag())) {
+            throw exception(SALARY_OPTION_STANDARD_CANNOT_MODIFY);
+        }
+
+        // 2. 更新显示状态
+        salaryOptionMapper.updateById(new HrmSalaryOptionDO().setId(id).setVisible(visible));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryOption", option);
+        LogRecordContext.putVariable("visible", visible);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_OPTION_TYPE, subType = HRM_SALARY_OPTION_DELETE_SUB_TYPE,
+            bizNo = "{{#salaryOption.id}}", success = HRM_SALARY_OPTION_DELETE_SUCCESS)
+    public void deleteSalaryOption(Long id) {
+        // 1. 校验薪资项允许删除
+        HrmSalaryOptionDO option = validateSalaryOptionExists(id);
+        validateCustomSalaryOption(option);
+
+        // 2. 删除薪资项
+        salaryOptionMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryOption", option);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public synchronized void syncSalaryOption() {
+        // 1. 查询标准薪资项目录
+        List<HrmSalaryOptionTemplateDO> templates = salaryOptionTemplateMapper.selectListOrderByCode();
+        if (CollUtil.isEmpty(templates)) {
+            return;
+        }
+
+        // 2. 计算待新增和待更新的标准薪资项
+        Map<Integer, HrmSalaryOptionDO> optionMap = convertMap(
+                salaryOptionMapper.selectListByEnabledAndVisible(null, null), HrmSalaryOptionDO::getCode);
+        List<HrmSalaryOptionDO> createOptions = new ArrayList<>();
+        List<HrmSalaryOptionDO> updateOptions = new ArrayList<>();
+        for (HrmSalaryOptionTemplateDO template : templates) {
+            HrmSalaryOptionDO option = optionMap.get(template.getCode());
+            if (option == null) {
+                HrmSalaryOptionDO occupiedOption = salaryOptionMapper.selectByCodeIncludeDeleted(template.getCode());
+                if (occupiedOption != null) {
+                    throw exception(SALARY_OPTION_CODE_OCCUPIED, template.getCode());
+                }
+                createOptions.add(buildSalaryOption(template).setEnabled(true).setVisible(template.getVisible()));
+                continue;
+            }
+            if (option.getTemplateId() == null && Boolean.FALSE.equals(option.getSystemFlag())) {
+                throw exception(SALARY_OPTION_CODE_OCCUPIED, template.getCode());
+            }
+            updateOptions.add(buildSalaryOption(template).setId(option.getId()));
+        }
+
+        // 3. 批量同步标准薪资项，保留租户自行维护的 enabled 和 visible
+        if (CollUtil.isNotEmpty(createOptions)) {
+            salaryOptionMapper.insertBatch(createOptions);
+        }
+        if (CollUtil.isNotEmpty(updateOptions)) {
+            salaryOptionMapper.updateBatch(updateOptions);
+        }
+    }
+
+    @Override
+    public List<HrmSalaryOptionDO> getSalaryOptionList(Boolean adjustable, Boolean visible) {
+        List<HrmSalaryOptionDO> options = salaryOptionMapper.selectListByEnabledAndVisible(true, visible);
+        // 过滤所属分类已停用的薪资项
+        Set<Integer> enabledCategoryCodes = convertSet(options, HrmSalaryOptionDO::getCode,
+                option -> ObjectUtil.equal(option.getParentCode(), ROOT_PARENT_CODE));
+        options.removeIf(option -> ObjectUtil.notEqual(option.getParentCode(), ROOT_PARENT_CODE)
+                && !enabledCategoryCodes.contains(option.getParentCode()));
+        // 调薪场景额外只保留可调薪分类下的薪资项
+        if (Boolean.TRUE.equals(adjustable)) {
+            options.removeIf(option -> option.getParentCode() == null
+                    || option.getParentCode() < ADJUSTABLE_CATEGORY_MIN_CODE
+                    || option.getParentCode() > ADJUSTABLE_CATEGORY_MAX_CODE);
+        }
+        return options;
+    }
+
+    @Override
+    public List<HrmSalaryOptionDO> getSalaryOptionList() {
+        return salaryOptionMapper.selectListByEnabledAndVisible(null, null);
+    }
+
+    private HrmSalaryOptionDO buildSalaryOption(HrmSalaryOptionTemplateDO template) {
+        return new HrmSalaryOptionDO().setCode(template.getCode()).setParentCode(template.getParentCode())
+                .setName(template.getName()).setRemark(template.getRemark())
+                .setSystemFlag(template.getSystemFlag()).setTemplateId(template.getId()).setType(template.getType())
+                .setTaxEnabled(Boolean.TRUE.equals(template.getTaxEnabled()))
+                .setCalculateEnabled(template.getCalculateEnabled());
+    }
+
+    /**
+     * 生成企业自定义薪资项编码
+     *
+     * <p>分类行通过悲观锁串行生成编码；编码使用企业自定义高位区间，并包含已逻辑删除记录，
+     * 避免与现在或未来同步的标准目录编码发生碰撞。</p>
+     *
+     * @param parentCode 父薪资项编码
+     * @return 自定义薪资项编码
+     */
+    private Integer generateCustomSalaryOptionCode(Integer parentCode) {
+        int firstCode = CUSTOM_OPTION_CODE_BASE + parentCode * 10_000 + 1;
+        Integer maxCode = salaryOptionMapper.selectMaxCodeByParentCodeAndCodeGreaterThanOrEqual(
+                parentCode, firstCode);
+        return maxCode == null ? firstCode : Math.max(firstCode, maxCode + 1);
+    }
+
+    private HrmSalaryOptionDO validateSalaryOptionExists(Long id) {
+        HrmSalaryOptionDO option = salaryOptionMapper.selectById(id);
+        if (option == null) {
+            throw exception(SALARY_OPTION_NOT_EXISTS);
+        }
+        return option;
+    }
+
+    private HrmSalaryOptionDO validateSalaryOptionCategory(Integer code) {
+        HrmSalaryOptionDO category = salaryOptionMapper.selectByCodeForUpdate(code);
+        // 1. 校验薪资项分类存在
+        if (category == null) {
+            throw exception(SALARY_OPTION_CATEGORY_INVALID);
+        }
+        // 2. 校验选择的是企业可选根分类
+        if (ObjectUtil.notEqual(category.getParentCode(), ROOT_PARENT_CODE)) {
+            throw exception(SALARY_OPTION_CATEGORY_INVALID);
+        }
+        if (category.getTemplateId() == null || Boolean.TRUE.equals(category.getSystemFlag())) {
+            throw exception(SALARY_OPTION_CATEGORY_INVALID);
+        }
+        // 3. 校验薪资项分类已启用
+        if (ObjectUtil.notEqual(category.getEnabled(), true)) {
+            throw exception(SALARY_OPTION_CATEGORY_INVALID);
+        }
+        return category;
+    }
+
+    private void validateCustomSalaryOption(HrmSalaryOptionDO option) {
+        // 1. 系统默认项不允许删除
+        if (Boolean.TRUE.equals(option.getSystemFlag())) {
+            throw exception(SALARY_OPTION_STANDARD_CANNOT_MODIFY);
+        }
+        // 2. 标准薪资项通过 enabled 管理，不允许物理删除
+        if (option.getTemplateId() != null) {
+            throw exception(SALARY_OPTION_STANDARD_CANNOT_MODIFY);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleService.java
new file mode 100644
index 0000000..ba68da6
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleService.java
@@ -0,0 +1,83 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.taxrule.HrmSalaryTaxRuleSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import jakarta.validation.Valid;
+
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 计税规则 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryTaxRuleService {
+
+    /**
+     * 创建计税规则
+     *
+     * @param createReqVO 创建信息
+     * @return 计税规则编号
+     */
+    Long createSalaryTaxRule(@Valid HrmSalaryTaxRuleSaveReqVO createReqVO);
+
+    /**
+     * 更新计税规则
+     *
+     * @param updateReqVO 更新信息
+     */
+    void updateSalaryTaxRule(@Valid HrmSalaryTaxRuleSaveReqVO updateReqVO);
+
+    /**
+     * 删除计税规则
+     *
+     * @param id 计税规则编号
+     */
+    void deleteSalaryTaxRule(Long id);
+
+    /**
+     * 获得计税规则
+     *
+     * @param id 计税规则编号
+     * @return 计税规则
+     */
+    HrmSalaryTaxRuleDO getSalaryTaxRule(Long id);
+
+    /**
+     * 获得计税规则列表
+     *
+     * @return 计税规则列表
+     */
+    List<HrmSalaryTaxRuleDO> getSalaryTaxRuleList();
+
+    /**
+     * 获得计税规则列表
+     *
+     * @param ids 计税规则编号集合
+     * @return 计税规则列表
+     */
+    List<HrmSalaryTaxRuleDO> getSalaryTaxRuleList(Collection<Long> ids);
+
+    /**
+     * 获得计税规则 Map
+     *
+     * @param ids 计税规则编号集合
+     * @return 计税规则 Map
+     */
+    default Map<Long, HrmSalaryTaxRuleDO> getSalaryTaxRuleMap(Collection<Long> ids) {
+        return convertMap(getSalaryTaxRuleList(ids), HrmSalaryTaxRuleDO::getId);
+    }
+
+    /**
+     * 校验计税规则存在
+     *
+     * @param id 计税规则编号
+     * @return 计税规则
+     */
+    HrmSalaryTaxRuleDO validateSalaryTaxRuleExists(Long id);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleServiceImpl.java
new file mode 100644
index 0000000..9b9bcbe
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleServiceImpl.java
@@ -0,0 +1,131 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.taxrule.HrmSalaryTaxRuleSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryTaxRuleMapper;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.service.impl.DiffParseFunction;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_TAX_RULE_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_TAX_RULE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_TAX_RULE_USED;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+
+/**
+ * HRM 计税规则 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryTaxRuleServiceImpl implements HrmSalaryTaxRuleService {
+
+    @Resource
+    private HrmSalaryTaxRuleMapper salaryTaxRuleMapper;
+
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmSalaryGroupService salaryGroupService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_TAX_RULE_TYPE, subType = HRM_SALARY_TAX_RULE_CREATE_SUB_TYPE,
+            bizNo = "{{#salaryTaxRule.id}}", success = HRM_SALARY_TAX_RULE_CREATE_SUCCESS)
+    public Long createSalaryTaxRule(HrmSalaryTaxRuleSaveReqVO createReqVO) {
+        // 1. 校验计税规则名称唯一
+        validateSalaryTaxRuleNameUnique(null, createReqVO.getName());
+
+        // 2. 创建计税规则
+        HrmSalaryTaxRuleDO salaryTaxRule = BeanUtils.toBean(createReqVO, HrmSalaryTaxRuleDO.class);
+        salaryTaxRuleMapper.insert(salaryTaxRule);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryTaxRule", salaryTaxRule);
+        return salaryTaxRule.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_TAX_RULE_TYPE, subType = HRM_SALARY_TAX_RULE_UPDATE_SUB_TYPE,
+            bizNo = "{{#updateReqVO.id}}", success = HRM_SALARY_TAX_RULE_UPDATE_SUCCESS)
+    public void updateSalaryTaxRule(HrmSalaryTaxRuleSaveReqVO updateReqVO) {
+        // 1. 校验计税规则
+        HrmSalaryTaxRuleDO oldSalaryTaxRule = validateSalaryTaxRuleExists(updateReqVO.getId());
+        validateSalaryTaxRuleNameUnique(updateReqVO.getId(), updateReqVO.getName());
+
+        // 2. 更新计税规则
+        salaryTaxRuleMapper.updateById(BeanUtils.toBean(updateReqVO, HrmSalaryTaxRuleDO.class));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryTaxRule", oldSalaryTaxRule);
+        LogRecordContext.putVariable(DiffParseFunction.OLD_OBJECT,
+                BeanUtils.toBean(oldSalaryTaxRule, HrmSalaryTaxRuleSaveReqVO.class));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_TAX_RULE_TYPE, subType = HRM_SALARY_TAX_RULE_DELETE_SUB_TYPE,
+            bizNo = "{{#salaryTaxRule.id}}", success = HRM_SALARY_TAX_RULE_DELETE_SUCCESS)
+    public void deleteSalaryTaxRule(Long id) {
+        // 1. 校验计税规则存在且未被薪资组使用
+        HrmSalaryTaxRuleDO salaryTaxRule = validateSalaryTaxRuleExists(id);
+        if (salaryGroupService.getSalaryGroupCountByTaxRuleId(id) > 0) {
+            throw exception(SALARY_TAX_RULE_USED);
+        }
+
+        // 2. 删除计税规则
+        salaryTaxRuleMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryTaxRule", salaryTaxRule);
+    }
+
+    @Override
+    public HrmSalaryTaxRuleDO getSalaryTaxRule(Long id) {
+        return salaryTaxRuleMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmSalaryTaxRuleDO> getSalaryTaxRuleList() {
+        return salaryTaxRuleMapper.selectList();
+    }
+
+    @Override
+    public List<HrmSalaryTaxRuleDO> getSalaryTaxRuleList(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyList();
+        }
+        return salaryTaxRuleMapper.selectByIds(ids);
+    }
+
+    @Override
+    public HrmSalaryTaxRuleDO validateSalaryTaxRuleExists(Long id) {
+        HrmSalaryTaxRuleDO taxRule = salaryTaxRuleMapper.selectById(id);
+        if (taxRule == null) {
+            throw exception(SALARY_TAX_RULE_NOT_EXISTS);
+        }
+        return taxRule;
+    }
+
+    private void validateSalaryTaxRuleNameUnique(Long id, String name) {
+        HrmSalaryTaxRuleDO salaryTaxRule = salaryTaxRuleMapper.selectByName(name);
+        if (salaryTaxRule != null && ObjUtil.notEqual(salaryTaxRule.getId(), id)) {
+            throw exception(SALARY_TAX_RULE_NAME_DUPLICATE);
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordService.java
new file mode 100644
index 0000000..137761f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordService.java
@@ -0,0 +1,121 @@
+package cn.iocoder.yudao.module.hrm.service.salary.employee;
+
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryChangeRecordDO;
+
+import java.time.LocalDate;
+import java.util.List;
+
+/**
+ * HRM 定薪/调薪记录 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryChangeRecordService {
+
+    /**
+     * 创建定薪/调薪记录
+     *
+     * @param changeRecord 定薪/调薪记录
+     * @return 记录编号
+     */
+    @SuppressWarnings("UnusedReturnValue")
+    Long createSalaryChangeRecord(HrmSalaryChangeRecordDO changeRecord);
+
+    /**
+     * 更新定薪/调薪记录
+     *
+     * @param changeRecord 定薪/调薪记录
+     */
+    void updateSalaryChangeRecord(HrmSalaryChangeRecordDO changeRecord);
+
+    /**
+     * 按原状态更新定薪/调薪记录状态
+     *
+     * @param id 记录编号
+     * @param oldStatus 原状态
+     * @param newStatus 新状态
+     * @return 是否更新成功
+     */
+    @SuppressWarnings("BooleanMethodIsAlwaysInverted")
+    boolean updateSalaryChangeRecordStatus(Long id, Integer oldStatus, Integer newStatus);
+
+    /**
+     * 校验定薪/调薪记录是否存在
+     *
+     * @param id 记录编号
+     * @return 定薪/调薪记录
+     */
+    HrmSalaryChangeRecordDO validateSalaryChangeRecordExists(Long id);
+
+    /**
+     * 判断员工是否存在待生效的定薪/调薪记录
+     *
+     * @param employeeId 员工编号
+     * @param excludeId 排除的记录编号
+     * @return 是否存在
+     */
+    boolean hasPendingSalaryChangeRecord(Long employeeId, Long excludeId);
+
+    /**
+     * 判断员工是否存在未取消的调薪记录
+     *
+     * @param employeeId 员工编号
+     * @return 是否存在
+     */
+    boolean hasUncancelledSalaryAdjustmentRecord(Long employeeId);
+
+    /**
+     * 获得员工定薪记录
+     *
+     * @param employeeId 员工编号
+     * @return 定薪记录
+     */
+    HrmSalaryChangeRecordDO getSalarySetRecordByEmployeeId(Long employeeId);
+
+    /**
+     * 获得定薪/调薪记录
+     *
+     * @param id 记录编号
+     * @return 定薪/调薪记录
+     */
+    HrmSalaryChangeRecordDO getSalaryChangeRecord(Long id);
+
+    /**
+     * 获得员工定薪、调薪记录列表
+     *
+     * @param employeeId 员工编号
+     * @return 定薪、调薪记录列表
+     */
+    List<HrmSalaryChangeRecordDO> getSalaryChangeRecordList(Long employeeId);
+
+    /**
+     * 取消待生效的定薪/调薪记录
+     *
+     * @param id 记录编号
+     */
+    void cancelSalaryChangeRecord(Long id);
+
+    /**
+     * 删除未生效的定薪/调薪记录
+     *
+     * @param id 记录编号
+     */
+    void deleteSalaryChangeRecord(Long id);
+
+    /**
+     * 获得指定日期前已到期的调薪记录数量
+     *
+     * @param targetDate 目标日期
+     * @return 到期记录数量
+     */
+    long getDueSalaryChangeCount(LocalDate targetDate);
+
+    /**
+     * 获得指定日期前已到期的调薪记录列表
+     *
+     * @param targetDate 目标日期
+     * @return 到期记录列表
+     */
+    List<HrmSalaryChangeRecordDO> getDueSalaryChangeRecordList(LocalDate targetDate);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordServiceImpl.java
new file mode 100644
index 0000000..4da62b8
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordServiceImpl.java
@@ -0,0 +1,131 @@
+package cn.iocoder.yudao.module.hrm.service.salary.employee;
+
+import cn.hutool.core.util.ObjUtil;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.employee.HrmSalaryChangeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordTypeEnum;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.validation.annotation.Validated;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_RECORD_STATUS_INVALID;
+
+/**
+ * HRM 定薪/调薪记录 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryChangeRecordServiceImpl implements HrmSalaryChangeRecordService {
+
+    @Resource
+    private HrmSalaryChangeRecordMapper salaryChangeRecordMapper;
+
+    @Override
+    public Long createSalaryChangeRecord(HrmSalaryChangeRecordDO changeRecord) {
+        salaryChangeRecordMapper.insert(changeRecord);
+        return changeRecord.getId();
+    }
+
+    @Override
+    public void updateSalaryChangeRecord(HrmSalaryChangeRecordDO changeRecord) {
+        salaryChangeRecordMapper.updateById(changeRecord);
+    }
+
+    @Override
+    public boolean updateSalaryChangeRecordStatus(Long id, Integer oldStatus, Integer newStatus) {
+        return salaryChangeRecordMapper.updateByIdAndStatus(
+                new HrmSalaryChangeRecordDO().setId(id).setStatus(newStatus), oldStatus) > 0;
+    }
+
+    @Override
+    public HrmSalaryChangeRecordDO validateSalaryChangeRecordExists(Long id) {
+        HrmSalaryChangeRecordDO changeRecord = salaryChangeRecordMapper.selectById(id);
+        if (changeRecord == null) {
+            throw exception(SALARY_CHANGE_RECORD_NOT_EXISTS);
+        }
+        return changeRecord;
+    }
+
+    @Override
+    public boolean hasPendingSalaryChangeRecord(Long employeeId, Long excludeId) {
+        return salaryChangeRecordMapper.selectCountByEmployeeIdAndStatus(
+                employeeId, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), excludeId) > 0;
+    }
+
+    @Override
+    public boolean hasUncancelledSalaryAdjustmentRecord(Long employeeId) {
+        return salaryChangeRecordMapper.selectCountByEmployeeIdAndTypeAndStatusNot(
+                employeeId, HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType(),
+                HrmSalaryChangeRecordStatusEnum.CANCELLED.getStatus()) > 0;
+    }
+
+    @Override
+    public HrmSalaryChangeRecordDO getSalarySetRecordByEmployeeId(Long employeeId) {
+        return salaryChangeRecordMapper.selectByEmployeeIdAndType(
+                employeeId, HrmSalaryChangeRecordTypeEnum.SALARY_SET.getType());
+    }
+
+    @Override
+    public HrmSalaryChangeRecordDO getSalaryChangeRecord(Long id) {
+        return salaryChangeRecordMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmSalaryChangeRecordDO> getSalaryChangeRecordList(Long employeeId) {
+        return salaryChangeRecordMapper.selectListByEmployeeId(employeeId);
+    }
+
+    @Override
+    public void cancelSalaryChangeRecord(Long id) {
+        // 1. 校验记录处于待生效状态
+        HrmSalaryChangeRecordDO changeRecord = validateSalaryChangeRecordExists(id);
+        if (ObjUtil.notEqual(changeRecord.getStatus(), HrmSalaryChangeRecordStatusEnum.PENDING.getStatus())) {
+            throw exception(SALARY_CHANGE_RECORD_STATUS_INVALID);
+        }
+
+        // 2. 取消定薪/调薪记录
+        if (!updateSalaryChangeRecordStatus(id, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                HrmSalaryChangeRecordStatusEnum.CANCELLED.getStatus())) {
+            throw exception(SALARY_CHANGE_RECORD_STATUS_INVALID);
+        }
+    }
+
+    @Override
+    public void deleteSalaryChangeRecord(Long id) {
+        // 1. 校验已生效记录不能删除
+        HrmSalaryChangeRecordDO changeRecord = validateSalaryChangeRecordExists(id);
+        if (ObjUtil.equal(changeRecord.getStatus(), HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus())) {
+            throw exception(SALARY_CHANGE_RECORD_STATUS_INVALID);
+        }
+
+        // 2. 删除定薪/调薪记录
+        salaryChangeRecordMapper.deleteById(id);
+    }
+
+    @Override
+    public long getDueSalaryChangeCount(LocalDate targetDate) {
+        LocalDate date = targetDate == null ? LocalDate.now() : targetDate;
+        LocalDateTime dayEndTime = LocalDateTimeUtils.getDayEndTime(date);
+        return salaryChangeRecordMapper.selectCountByStatusAndEffectTimeBeforeOrEqual(
+                HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), dayEndTime);
+    }
+
+    @Override
+    public List<HrmSalaryChangeRecordDO> getDueSalaryChangeRecordList(LocalDate targetDate) {
+        LocalDate date = targetDate == null ? LocalDate.now() : targetDate;
+        LocalDateTime dayEndTime = LocalDateTimeUtils.getDayEndTime(date);
+        return salaryChangeRecordMapper.selectListByStatusAndEffectTimeBeforeOrEqual(
+                HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), dayEndTime);
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoService.java
new file mode 100644
index 0000000..8c6817a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoService.java
@@ -0,0 +1,137 @@
+package cn.iocoder.yudao.module.hrm.service.salary.employee;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateListRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoImportRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import jakarta.validation.Valid;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+
+/**
+ * HRM 员工薪资信息 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryEmployeeInfoService {
+
+    /**
+     * 获得员工薪资信息分页
+     *
+     * @param reqVO 分页查询
+     * @return 员工分页
+     */
+    PageResult<HrmEmployeeDO> getSalaryEmployeeInfoPage(HrmSalaryEmployeeInfoPageReqVO reqVO);
+
+    /**
+     * 获得员工薪资信息状态数量
+     *
+     * @param reqVO 查询条件
+     * @return 状态与员工数量的映射
+     */
+    Map<Integer, Long> getSalaryEmployeeInfoStatusCount(HrmSalaryEmployeeInfoPageReqVO reqVO);
+
+    /**
+     * 修改员工薪资信息
+     *
+     * <p>首次定薪时创建当前薪资信息；立即调薪时更新当前薪资信息；延迟调薪时创建待生效记录。</p>
+     *
+     * @param reqVO 员工定薪或调薪信息
+     * @return 定薪或调薪记录编号
+     */
+    Long updateSalaryEmployeeInfo(@Valid HrmSalaryEmployeeInfoUpdateReqVO reqVO);
+
+    /**
+     * 批量更新员工薪资信息
+     *
+     * @param reqVO 批量调薪信息
+     * @return 批量调薪结果
+     */
+    HrmSalaryEmployeeInfoUpdateListRespVO updateSalaryEmployeeInfoList(
+            @Valid HrmSalaryEmployeeInfoUpdateListReqVO reqVO);
+
+    /**
+     * 获得员工薪资信息
+     *
+     * @param employeeId 员工编号
+     * @return 员工薪资信息
+     */
+    HrmSalaryEmployeeInfoDO getSalaryEmployeeInfoByEmployeeId(Long employeeId);
+
+    /**
+     * 获得员工薪资信息列表
+     *
+     * @param employeeIds 员工编号集合
+     * @return 员工薪资信息列表
+     */
+    List<HrmSalaryEmployeeInfoDO> getSalaryEmployeeInfoList(Collection<Long> employeeIds);
+
+    /**
+     * 获得员工薪资信息 Map
+     *
+     * @param employeeIds 员工编号集合
+     * @return 员工编号与薪资信息的映射
+     */
+    default Map<Long, HrmSalaryEmployeeInfoDO> getSalaryEmployeeInfoMap(Collection<Long> employeeIds) {
+        return convertMap(getSalaryEmployeeInfoList(employeeIds), HrmSalaryEmployeeInfoDO::getEmployeeId);
+    }
+
+    // ==================== 内部调用 ====================
+
+    /**
+     * 应用指定日期前已到期的调薪记录
+     *
+     * @param targetDate 目标日期
+     * @return 受影响的员工编号列表
+     */
+    List<Long> applyDueSalaryChanges(LocalDate targetDate);
+
+    /**
+     * 获得员工在工资周期内的生效工资项
+     *
+     * <p>试用期转正或调薪在周期内生效时，按生效前后的自然日比例混合计算。</p>
+     *
+     * @param employee 员工
+     * @param salaryTimes 工资周期双闭区间
+     * @return 生效工资项
+     */
+    List<HrmSalaryEmployeeInfoDO.SalaryOption> getEffectiveSalaryOptionList(
+            HrmEmployeeDO employee, LocalDateTime[] salaryTimes);
+
+    // ==================== 导入 ====================
+
+    /**
+     * 导入员工定薪信息
+     *
+     * @param rows Excel 数据行
+     * @return 导入结果
+     */
+    HrmSalaryEmployeeInfoImportRespVO importFixSalaryList(List<Map<Integer, String>> rows);
+
+    /**
+     * 导入员工调薪信息
+     *
+     * @param rows Excel 数据行
+     * @return 导入结果
+     */
+    HrmSalaryEmployeeInfoImportRespVO importChangeSalaryList(List<Map<Integer, String>> rows);
+
+    /**
+     * 获得员工薪资导入使用的薪资项列表
+     *
+     * @return 薪资项列表
+     */
+    List<HrmSalaryOptionDO> getSalaryImportOptionList();
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoServiceImpl.java
new file mode 100644
index 0000000..73e3c2d
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoServiceImpl.java
@@ -0,0 +1,826 @@
+package cn.iocoder.yudao.module.hrm.service.salary.employee;
+
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.hutool.extra.spring.SpringUtil;
+import cn.iocoder.yudao.framework.common.exception.ServiceException;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateListRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoImportRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.employee.HrmSalaryEmployeeInfoMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryBatchAdjustTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeReasonEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionCodeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeInfoChangeTypeEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.time.temporal.ChronoUnit;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.LinkedHashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDayBeginTime;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isBeforeOrEqual;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.defaultIfNull;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ROOT_PARENT_CODE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_RECORD_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_EFFECT_DATE_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_EMPLOYEE_INFO_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_IMPORT_LIST_IS_EMPTY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_PENDING_CHANGE_RECORD_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+import static cn.iocoder.yudao.module.hrm.util.HrmExcelUtils.getCell;
+import static cn.iocoder.yudao.module.hrm.util.HrmExcelUtils.parseAmount;
+import static cn.iocoder.yudao.module.hrm.util.HrmExcelUtils.parseDate;
+
+/**
+ * HRM 员工薪资信息 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryEmployeeInfoServiceImpl implements HrmSalaryEmployeeInfoService {
+
+    @Resource
+    private HrmSalaryOptionService salaryOptionService;
+    @Resource
+    private HrmSalaryEmployeeInfoMapper salaryEmployeeInfoMapper;
+    @Resource
+    private HrmSalaryChangeRecordService salaryChangeRecordService;
+    @Resource
+    @Lazy // 延迟加载
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    public PageResult<HrmEmployeeDO> getSalaryEmployeeInfoPage(HrmSalaryEmployeeInfoPageReqVO reqVO) {
+        // 1. 构建员工查询条件
+        HrmEmployeePageReqVO employeeReqVO = buildSalaryEmployeePageReqVO(reqVO, false);
+        if (reqVO.getChangeType() != null
+                && ObjectUtil.notEqual(reqVO.getChangeType(), HrmSalaryEmployeeInfoChangeTypeEnum.UNSET.getType())
+                && CollUtil.isEmpty(employeeReqVO.getIds())) {
+            return PageResult.empty();
+        }
+
+        // 2. 查询员工分页
+        return employeeService.getEmployeePage(employeeReqVO);
+    }
+
+    @Override
+    public Map<Integer, Long> getSalaryEmployeeInfoStatusCount(HrmSalaryEmployeeInfoPageReqVO reqVO) {
+        // 1. 转换员工查询条件，并忽略当前状态页签
+        HrmEmployeePageReqVO employeeReqVO = buildSalaryEmployeePageReqVO(reqVO, true);
+        if (reqVO.getChangeType() != null
+                && ObjectUtil.notEqual(reqVO.getChangeType(), HrmSalaryEmployeeInfoChangeTypeEnum.UNSET.getType())
+                && CollUtil.isEmpty(employeeReqVO.getIds())) {
+            return Collections.emptyMap();
+        }
+
+        // 2. 统计员工状态数量
+        return employeeService.getEmployeeStatusCount(employeeReqVO);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_EMPLOYEE_TYPE, subType = HRM_SALARY_EMPLOYEE_SET_SUB_TYPE,
+            bizNo = "{{#reqVO.employeeId}}", success = HRM_SALARY_EMPLOYEE_SET_SUCCESS)
+    public Long updateSalaryEmployeeInfo(HrmSalaryEmployeeInfoUpdateReqVO reqVO) {
+        // 1. 校验员工和定薪、调薪记录
+        HrmEmployeeDO employee = employeeService.validateEmployeeExists(reqVO.getEmployeeId());
+        HrmSalaryChangeRecordDO oldRecord = validateEditableChangeRecord(reqVO);
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                getSalaryEmployeeInfoByEmployeeId(reqVO.getEmployeeId());
+        boolean salarySet = Objects.equals(reqVO.getRecordType(), HrmSalaryChangeRecordTypeEnum.SALARY_SET.getType());
+        if (salarySet && oldRecord == null) {
+            oldRecord = salaryChangeRecordService.getSalarySetRecordByEmployeeId(reqVO.getEmployeeId());
+        }
+        if (!salarySet && salaryEmployeeInfo == null) {
+            throw exception(SALARY_EMPLOYEE_INFO_NOT_EXISTS);
+        }
+        if (salarySet && salaryChangeRecordService.hasUncancelledSalaryAdjustmentRecord(reqVO.getEmployeeId())) {
+            throw exception(SALARY_CHANGE_RECORD_STATUS_INVALID);
+        }
+        if (salaryChangeRecordService.hasPendingSalaryChangeRecord(
+                reqVO.getEmployeeId(), reqVO.getId())) {
+            throw exception(SALARY_PENDING_CHANGE_RECORD_EXISTS);
+        }
+        if (!salarySet) {
+            validateSalaryAdjustmentEffectTime(reqVO.getEffectTime());
+        }
+
+        // 2. 标准化并计算正式、试用期薪资
+        Map<Integer, HrmSalaryOptionDO> optionMap = getSalaryOptionMap();
+        List<HrmSalaryOptionValueVO> salaryOptions = normalizeOptionValues(reqVO.getSalaryOptions(), optionMap);
+        List<HrmSalaryOptionValueVO> probationSalaryOptions =
+                normalizeOptionValues(reqVO.getProbationSalaryOptions(), optionMap);
+        if (Objects.equals(reqVO.getRecordType(), HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType())) {
+            salaryOptions = mergeSalaryEmployeeInfoOptionValues(reqVO.getEmployeeId(), false, salaryOptions);
+            probationSalaryOptions =
+                    mergeSalaryEmployeeInfoOptionValues(reqVO.getEmployeeId(), true, probationSalaryOptions);
+        }
+        BigDecimal regularSalary = sumOptionValues(salaryOptions, optionMap);
+        BigDecimal probationSalary = sumOptionValues(probationSalaryOptions, optionMap);
+        LocalDate today = LocalDate.now();
+        Integer changeReason = salarySet
+                ? HrmSalaryChangeReasonEnum.ENTRY_SALARY.getReason() : reqVO.getChangeReason();
+        // 首次定薪是月度工资基线；编辑定薪保留原生效日期，首次未指定时从当月首日生效。
+        LocalDateTime effectTime = reqVO.getEffectTime();
+        if (salarySet && oldRecord != null && oldRecord.getEffectTime() != null) {
+            effectTime = oldRecord.getEffectTime();
+        } else if (salarySet && effectTime == null) {
+            effectTime = today.withDayOfMonth(1).atStartOfDay();
+        } else if (!salarySet) {
+            effectTime = getDayBeginTime(effectTime);
+        }
+        boolean pending = !salarySet && effectTime.toLocalDate().isAfter(today);
+        BigDecimal beforeTotal = salarySet ? BigDecimal.ZERO
+                : defaultIfNull(salaryEmployeeInfo.getRegularSalary(), BigDecimal.ZERO);
+        BigDecimal probationBeforeTotal = salarySet ? BigDecimal.ZERO
+                : defaultIfNull(salaryEmployeeInfo.getProbationSalary(), BigDecimal.ZERO);
+
+        // 3. 非待生效记录立即更新员工当前薪资
+        if (!pending) {
+            saveEffectiveSalaryEmployeeInfo(salaryEmployeeInfo, reqVO.getEmployeeId(), reqVO.getRecordType(),
+                    changeReason, effectTime, reqVO.getRemark(), salaryOptions,
+                    probationSalaryOptions, optionMap);
+        }
+
+        // 4. 创建或更新定薪、调薪记录
+        HrmSalaryChangeRecordDO changeRecord = HrmSalaryChangeRecordDO.builder()
+                .id(oldRecord == null ? null : oldRecord.getId()).employeeId(reqVO.getEmployeeId())
+                .type(reqVO.getRecordType()).reason(changeReason).effectTime(effectTime)
+                .beforeTotal(beforeTotal).afterTotal(regularSalary)
+                .probationBeforeTotal(probationBeforeTotal).probationAfterTotal(probationSalary)
+                .salaryOptions(buildSalaryChangeRecordOptionList(salaryOptions))
+                .probationSalaryOptions(buildSalaryChangeRecordOptionList(probationSalaryOptions))
+                .status(pending ? HrmSalaryChangeRecordStatusEnum.PENDING.getStatus() : HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus()).remark(reqVO.getRemark()).build();
+        if (oldRecord == null) {
+            salaryChangeRecordService.createSalaryChangeRecord(changeRecord);
+        } else {
+            salaryChangeRecordService.updateSalaryChangeRecord(changeRecord);
+        }
+
+        // 5. 记录操作日志上下文
+        LogRecordContext.putVariable("employee", employee);
+        return changeRecord.getId();
+    }
+
+    @Override
+    @LogRecord(type = HRM_SALARY_EMPLOYEE_TYPE, subType = HRM_SALARY_EMPLOYEE_BATCH_SET_SUB_TYPE,
+            bizNo = "{{#employeeIds.iterator().next()}}", success = HRM_SALARY_EMPLOYEE_BATCH_SET_SUCCESS)
+    public HrmSalaryEmployeeInfoUpdateListRespVO updateSalaryEmployeeInfoList(
+            HrmSalaryEmployeeInfoUpdateListReqVO reqVO) {
+        // 1. 合并部门和指定员工范围
+        Set<Long> employeeIds = new LinkedHashSet<>(CollUtil.emptyIfNull(reqVO.getEmployeeIds()));
+        List<HrmEmployeeDO> deptEmployees = employeeService.getEmployeeListByDeptIds(reqVO.getDeptIds());
+        employeeIds.addAll(convertList(deptEmployees, HrmEmployeeDO::getId));
+        if (CollUtil.isEmpty(employeeIds)) {
+            throw exception(SALARY_DATA_ILLEGAL);
+        }
+
+        // 2. 逐个调薪，单个员工失败不影响其他员工
+        HrmSalaryEmployeeInfoUpdateListRespVO result = new HrmSalaryEmployeeInfoUpdateListRespVO();
+        for (Long employeeId : employeeIds) {
+            try {
+                // 2.1 校验员工已定薪
+                HrmEmployeeDO employee = employeeService.validateEmployeeExists(employeeId);
+                if (getSalaryEmployeeInfoByEmployeeId(employeeId) == null) {
+                    throw exception(SALARY_EMPLOYEE_INFO_NOT_EXISTS);
+                }
+
+                // 2.2 根据员工当前工资计算调整后的薪资项
+                List<HrmSalaryOptionValueVO> salaryOptions = adjustSalaryOptions(
+                        employeeId, false, reqVO.getSalaryOptions(), reqVO.getType());
+                List<HrmSalaryOptionValueVO> probationSalaryOptions =
+                        Objects.equals(employee.getStatus(), HrmEmployeeStatusEnum.PROBATION.getStatus())
+                                ? adjustSalaryOptions(employeeId, true, reqVO.getSalaryOptions(), reqVO.getType())
+                                : Collections.emptyList();
+
+                // 2.3 创建调薪记录
+                HrmSalaryEmployeeInfoUpdateReqVO updateReqVO = new HrmSalaryEmployeeInfoUpdateReqVO()
+                        .setEmployeeId(employeeId).setRecordType(HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType())
+                        .setChangeReason(reqVO.getChangeReason()).setEffectTime(reqVO.getEffectTime())
+                        .setRemark(reqVO.getRemark()).setSalaryOptions(salaryOptions)
+                        .setProbationSalaryOptions(probationSalaryOptions);
+                getSelf().updateSalaryEmployeeInfo(updateReqVO);
+                result.getSuccessEmployeeIds().add(employeeId);
+            } catch (ServiceException ex) {
+                result.getFailureEmployeeReasons().put(employeeId, ex.getMessage());
+            }
+        }
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("employeeIds", employeeIds);
+        LogRecordContext.putVariable("batchResult", result);
+        return result;
+    }
+
+    // ==================== 导入 ====================
+
+    @Override
+    public List<HrmSalaryOptionDO> getSalaryImportOptionList() {
+        List<HrmSalaryOptionDO> options = salaryOptionService.getSalaryOptionList(false);
+        return filterList(options, option -> ObjectUtil.notEqual(option.getParentCode(), ROOT_PARENT_CODE)
+                && Boolean.TRUE.equals(option.getCalculateEnabled())
+                && !HrmSalaryOptionCodeEnum.EMPLOYEE_INFO_IMPORT_EXCLUDED_PARENT_CODES.contains(option.getParentCode()));
+    }
+
+    @Override
+    public HrmSalaryEmployeeInfoImportRespVO importFixSalaryList(List<Map<Integer, String>> rows) {
+        // 1. 校验导入数据并加载薪资项
+        validateImportRows(rows);
+        List<HrmSalaryOptionDO> options = getSalaryImportOptionList();
+
+        // 2. 逐行解析并保存定薪结果
+        HrmSalaryEmployeeInfoImportRespVO respVO = buildSalaryEmployeeInfoImportRespVO();
+        for (int i = 0; i < rows.size(); i++) {
+            Map<Integer, String> row = rows.get(i);
+            String jobNumber = getCell(row, 1);
+            String key = getSalaryImportKey(jobNumber, i + 1);
+            try {
+                HrmEmployeeDO employee = validateImportEmployee(jobNumber);
+                int probationStartIndex = 4;
+                int regularStartIndex = probationStartIndex + options.size();
+                HrmSalaryEmployeeInfoUpdateReqVO updateReqVO = new HrmSalaryEmployeeInfoUpdateReqVO()
+                        .setEmployeeId(employee.getId()).setRecordType(HrmSalaryChangeRecordTypeEnum.SALARY_SET.getType())
+                        .setChangeReason(HrmSalaryChangeReasonEnum.ENTRY_SALARY.getReason())
+                        .setSalaryOptions(readOptionValues(
+                                row, regularStartIndex, options, false, Collections.emptyMap()))
+                        .setProbationSalaryOptions(readOptionValues(
+                                row, probationStartIndex, options, false, Collections.emptyMap()))
+                        .setRemark(getCell(row, regularStartIndex + options.size()));
+                getSelf().updateSalaryEmployeeInfo(updateReqVO);
+                respVO.getSuccessJobNumbers().add(key);
+            } catch (Exception ex) {
+                respVO.getFailureJobNumbers().put(key, ex.getMessage());
+            }
+        }
+        return respVO;
+    }
+
+    @Override
+    public HrmSalaryEmployeeInfoImportRespVO importChangeSalaryList(List<Map<Integer, String>> rows) {
+        // 1. 校验导入数据并加载薪资项
+        validateImportRows(rows);
+        List<HrmSalaryOptionDO> options = getSalaryImportOptionList();
+
+        // 2. 逐行解析并保存调薪结果
+        HrmSalaryEmployeeInfoImportRespVO respVO = buildSalaryEmployeeInfoImportRespVO();
+        for (int i = 0; i < rows.size(); i++) {
+            Map<Integer, String> row = rows.get(i);
+            String jobNumber = getCell(row, 1);
+            String key = getSalaryImportKey(jobNumber, i + 1);
+            try {
+                HrmEmployeeDO employee = validateImportEmployee(jobNumber);
+                HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                        getSalaryEmployeeInfoByEmployeeId(employee.getId());
+                if (salaryEmployeeInfo == null) {
+                    throw exception(SALARY_EMPLOYEE_INFO_NOT_EXISTS);
+                }
+                int probationStartIndex = 6;
+                int regularStartIndex = probationStartIndex + options.size() * 2;
+                Map<Integer, BigDecimal> probationBeforeValueMap =
+                        getSalaryEmployeeInfoOptionValueMap(employee.getId(), true);
+                Map<Integer, BigDecimal> regularBeforeValueMap =
+                        getSalaryEmployeeInfoOptionValueMap(employee.getId(), false);
+                List<HrmSalaryOptionValueVO> probationSalaryOptions = readOptionValues(
+                        row, probationStartIndex, options, true, probationBeforeValueMap);
+                List<HrmSalaryOptionValueVO> salaryOptions = readOptionValues(
+                        row, regularStartIndex, options, true, regularBeforeValueMap);
+                HrmSalaryEmployeeInfoUpdateReqVO updateReqVO = new HrmSalaryEmployeeInfoUpdateReqVO()
+                        .setEmployeeId(employee.getId()).setRecordType(HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType())
+                        .setChangeReason(parseSalaryChangeReason(getCell(row, 5)))
+                        .setEffectTime(parseDate(getCell(row, 4), null, true, "生效日期").atStartOfDay())
+                        .setSalaryOptions(salaryOptions).setProbationSalaryOptions(probationSalaryOptions)
+                        .setRemark(getCell(row, regularStartIndex + options.size() * 2));
+                getSelf().updateSalaryEmployeeInfo(updateReqVO);
+                respVO.getSuccessJobNumbers().add(key);
+            } catch (Exception ex) {
+                respVO.getFailureJobNumbers().put(key, ex.getMessage());
+            }
+        }
+        return respVO;
+    }
+
+    // ==================== 查询 ====================
+
+    @Override
+    public HrmSalaryEmployeeInfoDO getSalaryEmployeeInfoByEmployeeId(Long employeeId) {
+        return salaryEmployeeInfoMapper.selectByEmployeeId(employeeId);
+    }
+
+    @Override
+    public List<HrmSalaryEmployeeInfoDO> getSalaryEmployeeInfoList(Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        return salaryEmployeeInfoMapper.selectListByEmployeeIds(new ArrayList<>(employeeIds));
+    }
+
+    // ==================== 内部调用 ====================
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<Long> applyDueSalaryChanges(LocalDate targetDate) {
+        // 1. 加载薪资项配置和待生效记录
+        List<Long> employeeIds = new ArrayList<>();
+        Map<Integer, HrmSalaryOptionDO> optionMap = getSalaryOptionMap();
+        List<HrmSalaryChangeRecordDO> changeRecords =
+                salaryChangeRecordService.getDueSalaryChangeRecordList(targetDate);
+
+        // 2. 逐条抢占待生效记录，并更新员工当前薪资
+        for (HrmSalaryChangeRecordDO changeRecord : changeRecords) {
+            if (!salaryChangeRecordService.updateSalaryChangeRecordStatus(changeRecord.getId(),
+                    HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                    HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus())) {
+                continue;
+            }
+            List<HrmSalaryOptionValueVO> salaryOptions = buildSalaryChangeRecordOptionValueVOList(
+                    changeRecord.getSalaryOptions());
+            List<HrmSalaryOptionValueVO> probationSalaryOptions =
+                    buildSalaryChangeRecordOptionValueVOList(changeRecord.getProbationSalaryOptions());
+            HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                    getSalaryEmployeeInfoByEmployeeId(changeRecord.getEmployeeId());
+            saveEffectiveSalaryEmployeeInfo(salaryEmployeeInfo, changeRecord.getEmployeeId(), changeRecord.getType(),
+                    changeRecord.getReason(), changeRecord.getEffectTime(), changeRecord.getRemark(),
+                    salaryOptions, probationSalaryOptions, optionMap);
+            employeeIds.add(changeRecord.getEmployeeId());
+        }
+        return employeeIds;
+    }
+
+    @Override
+    public List<HrmSalaryEmployeeInfoDO.SalaryOption> getEffectiveSalaryOptionList(
+            HrmEmployeeDO employee, LocalDateTime[] salaryTimes) {
+        // 1. 校验计算参数
+        LocalDateTime beginTime = ArrayUtils.get(salaryTimes, 0);
+        LocalDateTime endTime = ArrayUtils.get(salaryTimes, 1);
+        LocalDate beginDate = beginTime == null ? null : beginTime.toLocalDate();
+        LocalDate endDate = endTime == null ? null : endTime.toLocalDate();
+        if (employee == null || beginDate == null || endDate == null || endDate.isBefore(beginDate)) {
+            return Collections.emptyList();
+        }
+        // 2. 查询员工全部未取消的定薪、调薪记录
+        List<HrmSalaryChangeRecordDO> changeRecords = salaryChangeRecordService
+                .getSalaryChangeRecordList(employee.getId()).stream()
+                .filter(record -> ObjectUtil.notEqual(record.getStatus(), HrmSalaryChangeRecordStatusEnum.CANCELLED.getStatus()))
+                .sorted(Comparator.comparing(HrmSalaryChangeRecordDO::getEffectTime,
+                                Comparator.nullsLast(Comparator.naturalOrder()))
+                        .thenComparing(HrmSalaryChangeRecordDO::getId))
+                .collect(Collectors.toList());
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                getSalaryEmployeeInfoByEmployeeId(employee.getId());
+
+        // 3. 按周期内每天适用的试用期、正式工资及调薪记录进行加权
+        long periodDays = ChronoUnit.DAYS.between(beginDate, endDate) + 1;
+        Map<Integer, HrmSalaryEmployeeInfoDO.SalaryOption> optionMap = new LinkedHashMap<>();
+        Map<Integer, BigDecimal> amountMap = new LinkedHashMap<>();
+        for (LocalDate date = beginDate; isBeforeOrEqual(date, endDate); date = date.plusDays(1)) {
+            for (HrmSalaryEmployeeInfoDO.SalaryOption option :
+                    getEffectiveSalaryOptions(employee, date, changeRecords, salaryEmployeeInfo)) {
+                if (option.getCode() == null) {
+                    continue;
+                }
+                optionMap.putIfAbsent(option.getCode(), option);
+                amountMap.merge(option.getCode(), defaultIfNull(option.getValue(), BigDecimal.ZERO), BigDecimal::add);
+            }
+        }
+        return amountMap.entrySet().stream().map(entry -> {
+            HrmSalaryEmployeeInfoDO.SalaryOption source = optionMap.get(entry.getKey());
+            return HrmSalaryEmployeeInfoDO.SalaryOption.builder().code(entry.getKey())
+                    .name(source == null ? null : source.getName())
+                    .value(entry.getValue().divide(
+                            BigDecimal.valueOf(periodDays), 2, RoundingMode.HALF_UP))
+                    .build();
+        }).sorted(Comparator.comparing(HrmSalaryEmployeeInfoDO.SalaryOption::getCode)).collect(Collectors.toList());
+    }
+
+    private List<HrmSalaryEmployeeInfoDO.SalaryOption> getEffectiveSalaryOptions(
+            HrmEmployeeDO employee, LocalDate date, List<HrmSalaryChangeRecordDO> changeRecords,
+            HrmSalaryEmployeeInfoDO salaryEmployeeInfo) {
+        // 1. 查找指定日期前最后一条生效记录
+        HrmSalaryChangeRecordDO effectiveRecord = null;
+        for (HrmSalaryChangeRecordDO changeRecord : changeRecords) {
+            if (changeRecord.getEffectTime() == null || changeRecord.getEffectTime().toLocalDate().isAfter(date)) {
+                break;
+            }
+            effectiveRecord = changeRecord;
+        }
+        if (effectiveRecord != null) {
+            return convertSalaryChangeRecordOptionList(isProbation(employee, date)
+                    ? effectiveRecord.getProbationSalaryOptions() : effectiveRecord.getSalaryOptions());
+        }
+
+        // 2. 无历史记录时回退员工当前薪资
+        if (salaryEmployeeInfo == null || salaryEmployeeInfo.getEffectTime() == null
+                || salaryEmployeeInfo.getEffectTime().toLocalDate().isAfter(date)) {
+            return Collections.emptyList();
+        }
+        return CollUtil.emptyIfNull(isProbation(employee, date)
+                ? salaryEmployeeInfo.getProbationSalaryOptions() : salaryEmployeeInfo.getSalaryOptions());
+    }
+
+    private boolean isProbation(HrmEmployeeDO employee, LocalDate date) {
+        if (employee.getRegularTime() != null) {
+            return date.isBefore(employee.getRegularTime().toLocalDate());
+        }
+        return Objects.equals(employee.getStatus(), HrmEmployeeStatusEnum.PROBATION.getStatus());
+    }
+
+    /**
+     * 构建员工薪资分页使用的员工查询条件
+     *
+     * @param reqVO 员工薪资查询条件
+     * @param ignoreStatusCategory 是否忽略员工状态分类
+     * @return 员工查询条件
+     */
+    private HrmEmployeePageReqVO buildSalaryEmployeePageReqVO(
+            HrmSalaryEmployeeInfoPageReqVO reqVO, boolean ignoreStatusCategory) {
+        HrmEmployeePageReqVO employeeReqVO = BeanUtils.toBean(reqVO, HrmEmployeePageReqVO.class)
+                .setStatusCategory(ignoreStatusCategory ? null : reqVO.getStatusCategory());
+        Set<Long> requestedEmployeeIds = new LinkedHashSet<>(CollUtil.emptyIfNull(reqVO.getEmployeeIds()));
+        if (reqVO.getEmployeeId() != null) {
+            requestedEmployeeIds.add(reqVO.getEmployeeId());
+        }
+
+        // 1. 未指定薪资状态时，仅使用请求中的员工范围
+        if (reqVO.getChangeType() == null) {
+            employeeReqVO.setIds(new ArrayList<>(requestedEmployeeIds));
+            return employeeReqVO;
+        }
+
+        // 2. 未定薪员工使用排除条件
+        List<Long> salaryEmployeeIds = salaryEmployeeInfoMapper.selectEmployeeIdListByChangeType(
+                Objects.equals(reqVO.getChangeType(), HrmSalaryEmployeeInfoChangeTypeEnum.UNSET.getType()) ? null : reqVO.getChangeType());
+        if (Objects.equals(reqVO.getChangeType(), HrmSalaryEmployeeInfoChangeTypeEnum.UNSET.getType())) {
+            employeeReqVO.setIds(new ArrayList<>(requestedEmployeeIds));
+            employeeReqVO.setExcludeIds(salaryEmployeeIds);
+            return employeeReqVO;
+        }
+
+        // 3. 其他薪资状态使用已定薪员工与请求员工范围的交集
+        Set<Long> matchedEmployeeIds = new LinkedHashSet<>(salaryEmployeeIds);
+        if (CollUtil.isNotEmpty(requestedEmployeeIds)) {
+            matchedEmployeeIds.retainAll(requestedEmployeeIds);
+        }
+        employeeReqVO.setIds(new ArrayList<>(matchedEmployeeIds));
+        return employeeReqVO;
+    }
+
+    /**
+     * 校验待编辑的定薪、调薪记录
+     *
+     * @param reqVO 薪资信息修改参数
+     * @return 原定薪、调薪记录；新增时返回 {@code null}
+     */
+    private HrmSalaryChangeRecordDO validateEditableChangeRecord(HrmSalaryEmployeeInfoUpdateReqVO reqVO) {
+        if (reqVO.getId() == null) {
+            return null;
+        }
+        HrmSalaryChangeRecordDO changeRecord =
+                salaryChangeRecordService.validateSalaryChangeRecordExists(reqVO.getId());
+        if (ObjectUtil.notEqual(changeRecord.getEmployeeId(), reqVO.getEmployeeId())
+                || ObjectUtil.notEqual(changeRecord.getType(), reqVO.getRecordType())) {
+            throw exception(SALARY_CHANGE_RECORD_STATUS_INVALID);
+        }
+        if (ObjectUtil.equal(changeRecord.getType(), HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType())
+                && ObjectUtil.equal(changeRecord.getStatus(), HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus())) {
+            throw exception(SALARY_CHANGE_RECORD_STATUS_INVALID);
+        }
+        return changeRecord;
+    }
+
+    /**
+     * 校验调薪生效时间
+     *
+     * @param effectTime 生效时间
+     */
+    private void validateSalaryAdjustmentEffectTime(LocalDateTime effectTime) {
+        if (effectTime == null) {
+            throw exception(SALARY_CHANGE_EFFECT_DATE_INVALID);
+        }
+        HrmSalaryMonthRecordDO lastMonthRecord = salaryMonthRecordService.getLastMonthRecord();
+        if (lastMonthRecord == null || lastMonthRecord.getYear() == null || lastMonthRecord.getMonth() == null) {
+            return;
+        }
+        LocalDate latestSalaryMonthBeginDate = YearMonth.of(
+                lastMonthRecord.getYear(), lastMonthRecord.getMonth()).atDay(1);
+        if (effectTime.toLocalDate().isBefore(latestSalaryMonthBeginDate)) {
+            throw exception(SALARY_CHANGE_EFFECT_DATE_INVALID);
+        }
+    }
+
+    /**
+     * 保存已生效的员工当前薪资信息
+     *
+     * @param salaryEmployeeInfo 原员工薪资信息
+     * @param employeeId 员工编号
+     * @param recordType 记录类型
+     * @param changeReason 变更原因
+     * @param effectTime 生效时间
+     * @param remark 备注
+     * @param salaryOptions 正式薪资项
+     * @param probationSalaryOptions 试用期薪资项
+     * @param optionMap 薪资项配置 Map
+     */
+    private void saveEffectiveSalaryEmployeeInfo(
+            HrmSalaryEmployeeInfoDO salaryEmployeeInfo, Long employeeId, Integer recordType,
+            Integer changeReason, LocalDateTime effectTime, String remark,
+            List<HrmSalaryOptionValueVO> salaryOptions,
+            List<HrmSalaryOptionValueVO> probationSalaryOptions,
+            Map<Integer, HrmSalaryOptionDO> optionMap) {
+        if (salaryEmployeeInfo == null) {
+            salaryEmployeeInfo = HrmSalaryEmployeeInfoDO.builder().employeeId(employeeId).build();
+        }
+        salaryEmployeeInfo.setChangeReason(changeReason).setEffectTime(effectTime)
+                .setChangeType(Objects.equals(recordType, HrmSalaryChangeRecordTypeEnum.SALARY_SET.getType()) ? HrmSalaryEmployeeInfoChangeTypeEnum.SET.getType() : HrmSalaryEmployeeInfoChangeTypeEnum.ADJUSTED.getType())
+                .setRegularSalary(sumOptionValues(salaryOptions, optionMap))
+                .setProbationSalary(sumOptionValues(probationSalaryOptions, optionMap))
+                .setRemark(remark).setSalaryOptions(buildSalaryOptionList(salaryOptions))
+                .setProbationSalaryOptions(buildSalaryOptionList(probationSalaryOptions));
+        salaryEmployeeInfoMapper.insertOrUpdate(salaryEmployeeInfo);
+    }
+
+    /**
+     * 合并员工原薪资项和本次变更薪资项
+     *
+     * @param employeeId 员工编号
+     * @param probation 是否为试用期薪资
+     * @param changedOptions 本次变更薪资项
+     * @return 合并后的薪资项
+     */
+    private List<HrmSalaryOptionValueVO> mergeSalaryEmployeeInfoOptionValues(
+            Long employeeId, boolean probation, List<HrmSalaryOptionValueVO> changedOptions) {
+        Map<Integer, HrmSalaryOptionValueVO> optionMap = new LinkedHashMap<>();
+        getSalaryEmployeeInfoOptionList(employeeId, probation).stream()
+                .map(this::buildSalaryOptionValueVO)
+                .forEach(option -> optionMap.put(option.getCode(), option));
+        changedOptions.forEach(option -> optionMap.put(option.getCode(), option));
+        return optionMap.values().stream()
+                .sorted(Comparator.comparing(HrmSalaryOptionValueVO::getCode))
+                .collect(Collectors.toList());
+    }
+
+    /**
+     * 根据批量调薪规则计算员工调整后的薪资项
+     *
+     * @param employeeId 员工编号
+     * @param probation 是否为试用期薪资
+     * @param adjustmentOptions 调整薪资项
+     * @param adjustmentType 调整类型
+     * @return 调整后的薪资项
+     */
+    @SuppressWarnings("DataFlowIssue")
+    private List<HrmSalaryOptionValueVO> adjustSalaryOptions(
+            Long employeeId, boolean probation, List<HrmSalaryOptionValueVO> adjustmentOptions,
+            Integer adjustmentType) {
+        Map<Integer, HrmSalaryOptionValueVO> optionMap = new LinkedHashMap<>();
+        getSalaryEmployeeInfoOptionList(employeeId, probation).stream()
+                .map(this::buildSalaryOptionValueVO)
+                .forEach(option -> optionMap.put(option.getCode(), option));
+        for (HrmSalaryOptionValueVO adjustmentOption : adjustmentOptions) {
+            if (adjustmentOption.getCode() == null) {
+                continue;
+            }
+            HrmSalaryOptionValueVO oldOption = optionMap.get(adjustmentOption.getCode());
+            BigDecimal oldValue = oldOption == null ? BigDecimal.ZERO
+                    : defaultIfNull(oldOption.getValue(), BigDecimal.ZERO);
+            BigDecimal adjustmentValue = defaultIfNull(adjustmentOption.getValue(), BigDecimal.ZERO);
+            BigDecimal changeValue = Objects.equals(adjustmentType,
+                    HrmSalaryBatchAdjustTypeEnum.PERCENT.getType())
+                    ? oldValue.multiply(adjustmentValue)
+                            .divide(BigDecimal.valueOf(100), 2, RoundingMode.HALF_UP)
+                    : adjustmentValue;
+            BigDecimal newValue = oldValue.add(changeValue).setScale(2, RoundingMode.HALF_UP);
+            validateSalaryOptionValue(newValue);
+            HrmSalaryOptionValueVO newOption = new HrmSalaryOptionValueVO()
+                    .setCode(adjustmentOption.getCode())
+                    .setName(adjustmentOption.getName() != null ? adjustmentOption.getName()
+                            : oldOption == null ? null : oldOption.getName())
+                    .setValue(newValue);
+            optionMap.put(newOption.getCode(), newOption);
+        }
+        return new ArrayList<>(optionMap.values());
+    }
+
+    private HrmSalaryEmployeeInfoImportRespVO buildSalaryEmployeeInfoImportRespVO() {
+        return HrmSalaryEmployeeInfoImportRespVO.builder()
+                .successJobNumbers(new ArrayList<>())
+                .failureJobNumbers(new LinkedHashMap<>())
+                .build();
+    }
+
+    private void validateImportRows(List<Map<Integer, String>> rows) {
+        if (CollUtil.isEmpty(rows)) {
+            throw exception(SALARY_IMPORT_LIST_IS_EMPTY);
+        }
+    }
+
+    private HrmEmployeeDO validateImportEmployee(String jobNumber) {
+        if (StrUtil.isBlank(jobNumber)) {
+            throw new IllegalArgumentException("请填写工号");
+        }
+        HrmEmployeeDO employee = employeeService.getEmployeeByJobNumber(jobNumber);
+        if (employee == null) {
+            throw new IllegalArgumentException("工号对应的员工不存在");
+        }
+        return employee;
+    }
+
+    private String getSalaryImportKey(String jobNumber, int rowIndex) {
+        return StrUtil.isBlank(jobNumber) ? "第 " + rowIndex + " 行" : jobNumber;
+    }
+
+    private Integer parseSalaryChangeReason(String value) {
+        if (StrUtil.isBlank(value)) {
+            throw new IllegalArgumentException("请填写调薪原因");
+        }
+        String text = value.trim();
+        if (text.matches("\\d+")) {
+            HrmSalaryChangeReasonEnum reason = HrmSalaryChangeReasonEnum.valueOf(Integer.parseInt(text));
+            if (reason != null) {
+                return reason.getReason();
+            }
+        }
+        HrmSalaryChangeReasonEnum reason = HrmSalaryChangeReasonEnum.valueOfName(text);
+        if (reason == null) {
+            throw new IllegalArgumentException("调薪原因填写不正确");
+        }
+        return reason.getReason();
+    }
+
+    private List<HrmSalaryOptionValueVO> readOptionValues(Map<Integer, String> row, int startIndex,
+                                                          List<HrmSalaryOptionDO> options,
+                                                          boolean changeImport,
+                                                          Map<Integer, BigDecimal> defaultValueMap) {
+        List<HrmSalaryOptionValueVO> values = new ArrayList<>();
+        for (int i = 0; i < options.size(); i++) {
+            HrmSalaryOptionDO option = options.get(i);
+            int index = changeImport ? startIndex + i * 2 + 1 : startIndex + i;
+            BigDecimal defaultValue = defaultValueMap.getOrDefault(option.getCode(), BigDecimal.ZERO);
+            values.add(optionValue(option, parseAmount(getCell(row, index), defaultValue)));
+        }
+        return values;
+    }
+
+    private HrmSalaryOptionValueVO optionValue(HrmSalaryOptionDO option, BigDecimal value) {
+        return new HrmSalaryOptionValueVO().setCode(option.getCode())
+                .setName(option.getName()).setValue(value);
+    }
+
+    private Map<Integer, BigDecimal> getSalaryEmployeeInfoOptionValueMap(
+            Long employeeId, boolean probation) {
+        return convertMap(getSalaryEmployeeInfoOptionList(employeeId, probation),
+                HrmSalaryEmployeeInfoDO.SalaryOption::getCode,
+                option -> defaultIfNull(option.getValue(), BigDecimal.ZERO));
+    }
+
+    private List<HrmSalaryOptionValueVO> normalizeOptionValues(
+            List<HrmSalaryOptionValueVO> options, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        if (options == null) {
+            return Collections.emptyList();
+        }
+        return convertList(options, option -> {
+                    HrmSalaryOptionDO optionDO = optionMap.get(option.getCode());
+                    if (optionDO == null) {
+                        throw exception(SALARY_DATA_ILLEGAL);
+                    }
+                    BigDecimal value = defaultIfNull(option.getValue(), BigDecimal.ZERO);
+                    validateSalaryOptionValue(value);
+                    return new HrmSalaryOptionValueVO().setCode(option.getCode())
+                            .setName(option.getName() == null ? optionDO.getName() : option.getName())
+                            .setValue(value.setScale(2, RoundingMode.HALF_UP));
+                }, option -> option.getCode() != null);
+    }
+
+    private void validateSalaryOptionValue(BigDecimal value) {
+        if (value.signum() < 0 || Math.max(value.stripTrailingZeros().scale(), 0) > 2) {
+            throw exception(SALARY_DATA_ILLEGAL);
+        }
+    }
+
+    @SuppressWarnings("DataFlowIssue")
+    private BigDecimal sumOptionValues(
+            List<HrmSalaryOptionValueVO> options, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        return options.stream()
+                .filter(option -> {
+                    HrmSalaryOptionDO optionDO = optionMap.get(option.getCode());
+                    return optionDO != null && Boolean.TRUE.equals(optionDO.getCalculateEnabled());
+                })
+                .map(option -> {
+                    HrmSalaryOptionDO optionDO = optionMap.get(option.getCode());
+                    BigDecimal amount = defaultIfNull(option.getValue(), BigDecimal.ZERO);
+                    return Objects.equals(optionDO.getType(), HrmSalaryOptionTypeEnum.MINUS.getType()) ? amount.negate() : amount;
+                })
+                .reduce(BigDecimal.ZERO, BigDecimal::add);
+    }
+
+    private Map<Integer, HrmSalaryOptionDO> getSalaryOptionMap() {
+        return convertMap(salaryOptionService.getSalaryOptionList(false), HrmSalaryOptionDO::getCode);
+    }
+
+    private HrmSalaryOptionValueVO buildSalaryOptionValueVO(HrmSalaryEmployeeInfoDO.SalaryOption optionDO) {
+        return new HrmSalaryOptionValueVO().setCode(optionDO.getCode())
+                .setName(optionDO.getName()).setValue(optionDO.getValue());
+    }
+
+    private List<HrmSalaryEmployeeInfoDO.SalaryOption> buildSalaryOptionList(
+            List<HrmSalaryOptionValueVO> options) {
+        return convertList(options, option -> HrmSalaryEmployeeInfoDO.SalaryOption.builder()
+                .code(option.getCode()).name(option.getName())
+                .value(defaultIfNull(option.getValue(), BigDecimal.ZERO)).build());
+    }
+
+    private List<HrmSalaryChangeRecordDO.SalaryOption> buildSalaryChangeRecordOptionList(
+            List<HrmSalaryOptionValueVO> options) {
+        return convertList(options, option -> HrmSalaryChangeRecordDO.SalaryOption.builder()
+                .code(option.getCode()).name(option.getName())
+                .value(defaultIfNull(option.getValue(), BigDecimal.ZERO)).build());
+    }
+
+    private List<HrmSalaryOptionValueVO> buildSalaryChangeRecordOptionValueVOList(
+            List<HrmSalaryChangeRecordDO.SalaryOption> options) {
+        return convertList(options, option -> new HrmSalaryOptionValueVO().setCode(option.getCode())
+                .setName(option.getName()).setValue(option.getValue()));
+    }
+
+    private List<HrmSalaryEmployeeInfoDO.SalaryOption> convertSalaryChangeRecordOptionList(
+            List<HrmSalaryChangeRecordDO.SalaryOption> options) {
+        return convertList(options, option -> HrmSalaryEmployeeInfoDO.SalaryOption.builder()
+                .code(option.getCode()).name(option.getName()).value(option.getValue()).build());
+    }
+
+    /**
+     * 获得员工当前薪资项列表
+     *
+     * @param employeeId 员工编号
+     * @param probation 是否为试用期薪资
+     * @return 薪资项列表
+     */
+    private List<HrmSalaryEmployeeInfoDO.SalaryOption> getSalaryEmployeeInfoOptionList(
+            Long employeeId, boolean probation) {
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                getSalaryEmployeeInfoByEmployeeId(employeeId);
+        if (salaryEmployeeInfo == null) {
+            return Collections.emptyList();
+        }
+        return CollUtil.emptyIfNull(probation
+                ? salaryEmployeeInfo.getProbationSalaryOptions() : salaryEmployeeInfo.getSalaryOptions());
+    }
+
+    /**
+     * 获得自身的代理对象，解决 AOP 生效问题
+     *
+     * @return 自己
+     */
+    private HrmSalaryEmployeeInfoServiceImpl getSelf() {
+        return SpringUtil.getBean(getClass());
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordService.java
new file mode 100644
index 0000000..8cbcad7
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordService.java
@@ -0,0 +1,142 @@
+package cn.iocoder.yudao.module.hrm.service.salary.monthrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryEmployeeMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryPerformanceCoefficientReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+
+import java.math.BigDecimal;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * HRM 员工月度工资 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryMonthEmployeeRecordService {
+
+    /**
+     * 保存月度工资表的员工记录，并保持同一员工记录编号稳定
+     *
+     * @param monthRecordId 月度工资表编号
+     * @param employeeRecords 员工月度工资记录集合
+     */
+    void saveMonthEmployeeRecordList(
+            Long monthRecordId, Collection<HrmSalaryMonthEmployeeRecordDO> employeeRecords);
+
+    /**
+     * 批量计算员工月度工资
+     *
+     * @param employeeRecords 员工月度工资记录集合
+     * @param employeeOptionValueMap 员工薪资项 Map
+     * @param employeeTaxRuleMap 员工计税规则 Map
+     * @return 员工月度工资记录列表
+     */
+    List<HrmSalaryMonthEmployeeRecordDO> calculateMonthEmployeeRecordList(
+            List<HrmSalaryMonthEmployeeRecordDO> employeeRecords,
+            Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap,
+            Map<Long, HrmSalaryTaxRuleDO> employeeTaxRuleMap);
+
+    /**
+     * 重新计算员工月度工资
+     *
+     * @param employeeRecord 员工月度工资记录
+     * @param optionValues 薪资项值
+     * @return 员工月度工资记录
+     */
+    HrmSalaryMonthEmployeeRecordDO calculateMonthEmployeeRecord(
+            HrmSalaryMonthEmployeeRecordDO employeeRecord, List<HrmSalaryOptionValueVO> optionValues);
+
+    /**
+     * 批量修改员工月度工资
+     *
+     * @param reqVOs 修改信息列表
+     */
+    void updateMonthEmployeeRecordList(List<HrmSalaryMonthEmployeeRecordUpdateReqVO> reqVOs);
+
+    /**
+     * 删除指定月度工资表的员工记录
+     *
+     * @param monthRecordId 月度工资表编号
+     */
+    void deleteMonthEmployeeRecordListByMonthRecordId(Long monthRecordId);
+
+    /**
+     * 获得员工月度工资分页
+     *
+     * @param reqVO 分页查询
+     * @return 员工月度工资分页
+     */
+    PageResult<HrmSalaryMonthEmployeeRecordDO> getMonthEmployeeRecordPage(
+            HrmSalaryMonthEmployeeRecordPageReqVO reqVO);
+
+    /**
+     * 获得员工月度工资列表
+     *
+     * @param reqVO 列表查询
+     * @return 员工月度工资列表
+     */
+    List<HrmSalaryMonthEmployeeRecordDO> getMonthEmployeeRecordList(
+            HrmSalaryMonthEmployeeRecordListReqVO reqVO);
+
+    /**
+     * 获得指定月度工资表的员工记录
+     *
+     * @param monthRecordId 月度工资表编号
+     * @return 员工月度工资记录列表
+     */
+    List<HrmSalaryMonthEmployeeRecordDO> getMonthEmployeeRecordListByMonthRecordId(Long monthRecordId);
+
+    /**
+     * 获得指定员工年月的工资记录
+     *
+     * @param employeeId 员工编号
+     * @param year 年份
+     * @param month 月份
+     * @return 员工月度工资记录
+     */
+    HrmSalaryMonthEmployeeRecordDO getMonthEmployeeRecordByEmployeeIdAndYearMonth(
+            Long employeeId, Integer year, Integer month);
+
+    /**
+     * 获得月度工资项汇总
+     *
+     * @param employeeRecords 员工月度工资记录列表
+     * @return 工资项汇总
+     */
+    List<HrmSalaryMonthEmployeeRecordDO.OptionValue> getMonthOptionSummary(
+            List<HrmSalaryMonthEmployeeRecordDO> employeeRecords);
+
+    /**
+     * 获得员工异动分类数量
+     *
+     * @param reqVO 查询条件
+     * @return 异动类型与员工数量的映射
+     */
+    Map<Integer, Long> getMonthEmployeeChangeCount(HrmSalaryMonthEmployeeRecordPageReqVO reqVO);
+
+    /**
+     * 获得员工绩效系数 Map
+     *
+     * @param reqVO 查询条件
+     * @return 员工编号与绩效系数的映射
+     */
+    Map<Long, BigDecimal> getPerformanceCoefficientMap(HrmSalaryPerformanceCoefficientReqVO reqVO);
+
+    /**
+     * 获得指定员工的月度工资分页
+     *
+     * @param reqVO 分页查询
+     * @return 员工月度工资分页
+     */
+    PageResult<HrmSalaryMonthEmployeeRecordDO> getEmployeeMonthRecordPage(
+            HrmSalaryEmployeeMonthRecordPageReqVO reqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordServiceImpl.java
new file mode 100644
index 0000000..8addba2
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordServiceImpl.java
@@ -0,0 +1,887 @@
+package cn.iocoder.yudao.module.hrm.service.salary.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryGroupService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryTaxRuleService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.common.util.object.ObjectUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryEmployeeMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryPerformanceCoefficientReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.monthrecord.HrmSalaryMonthEmployeeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentService;
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionCodeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxRateEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxTypeEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.context.annotation.Lazy;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.math.RoundingMode;
+import java.time.LocalDate;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashSet;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isBetween;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceScale;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_EMP_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_MONTH_EMPLOYEE_UPDATE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_MONTH_EMPLOYEE_UPDATE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_MONTH_TYPE;
+
+/**
+ * HRM 员工月度工资 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryMonthEmployeeRecordServiceImpl implements HrmSalaryMonthEmployeeRecordService {
+
+    private static final Set<Integer> EXPECTED_PAY_PARENT_CODES = new HashSet<>(Arrays.asList(
+            10, 20, 30, 40, 50, 60, 70, 80, 90, 130, 140, 180, 200));
+    private static final Integer WITHHOLDING_PARENT_CODE = 100;
+    private static final Integer AFTER_TAX_ADD_PARENT_CODE = 150;
+    private static final Integer AFTER_TAX_DEDUCT_PARENT_CODE = 160;
+    private static final Integer SPECIAL_TAX_PARENT_CODE = 170;
+
+    @Resource
+    private HrmSalaryMonthEmployeeRecordMapper monthEmployeeRecordMapper;
+
+    @Resource
+    @Lazy // 延迟加载，避免循环依赖
+    private HrmSalaryMonthRecordService monthRecordService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @Resource
+    private HrmPerformanceAssessmentService performanceAssessmentService;
+    @Resource
+    private HrmPerformancePlanService performancePlanService;
+    @Resource
+    private HrmSalaryOptionService salaryOptionService;
+    @Resource
+    private HrmSalaryGroupService salaryGroupService;
+    @Resource
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void saveMonthEmployeeRecordList(
+            Long monthRecordId, Collection<HrmSalaryMonthEmployeeRecordDO> employeeRecords) {
+        // 1. 锁定月度工资表，避免并发核算生成重复的员工记录
+        monthRecordService.validateMonthRecordEditableForUpdate(monthRecordId);
+        // 2. 加载已有员工记录
+        List<HrmSalaryMonthEmployeeRecordDO> oldRecords =
+                monthEmployeeRecordMapper.selectListByMonthRecordId(monthRecordId);
+        Map<Long, HrmSalaryMonthEmployeeRecordDO> oldRecordMap = convertMap(oldRecords,
+                HrmSalaryMonthEmployeeRecordDO::getEmployeeId, record -> record,
+                (firstRecord, lastRecord) -> lastRecord);
+
+        // 3. 新增或更新员工记录
+        Set<Long> retainedIds = new HashSet<>();
+        for (HrmSalaryMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            HrmSalaryMonthEmployeeRecordDO oldRecord = oldRecordMap.get(employeeRecord.getEmployeeId());
+            if (oldRecord == null) {
+                monthEmployeeRecordMapper.insert(employeeRecord);
+                retainedIds.add(employeeRecord.getId());
+                continue;
+            }
+            employeeRecord.setId(oldRecord.getId());
+            monthEmployeeRecordMapper.updateById(employeeRecord);
+            retainedIds.add(oldRecord.getId());
+        }
+
+        // 4. 删除不在工资表范围的员工记录
+        Set<Long> removedIds = convertSet(oldRecords, HrmSalaryMonthEmployeeRecordDO::getId);
+        removedIds.removeAll(retainedIds);
+        if (CollUtil.isNotEmpty(removedIds)) {
+            monthEmployeeRecordMapper.deleteByIds(removedIds);
+        }
+    }
+
+    @Override
+    public List<HrmSalaryMonthEmployeeRecordDO> calculateMonthEmployeeRecordList(
+            List<HrmSalaryMonthEmployeeRecordDO> employeeRecords,
+            Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap,
+            Map<Long, HrmSalaryTaxRuleDO> employeeTaxRuleMap) {
+        if (CollUtil.isEmpty(employeeRecords)) {
+            return Collections.emptyList();
+        }
+        Map<Integer, HrmSalaryOptionDO> optionMap = getSalaryOptionMap();
+        for (HrmSalaryMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            calculateMonthEmployeeRecord(employeeRecord,
+                    employeeOptionValueMap.getOrDefault(employeeRecord.getEmployeeId(), Collections.emptyList()),
+                    employeeTaxRuleMap.get(employeeRecord.getEmployeeId()), optionMap);
+        }
+        return employeeRecords;
+    }
+
+    @Override
+    public HrmSalaryMonthEmployeeRecordDO calculateMonthEmployeeRecord(
+            HrmSalaryMonthEmployeeRecordDO employeeRecord, List<HrmSalaryOptionValueVO> optionValues) {
+        Map<Integer, HrmSalaryOptionDO> optionMap = getSalaryOptionMap();
+        HrmSalaryTaxRuleDO taxRule = getEmployeeTaxRuleMap(
+                Collections.singleton(employeeRecord.getEmployeeId())).get(employeeRecord.getEmployeeId());
+        return calculateMonthEmployeeRecord(employeeRecord,
+                mergeEditableOptionValues(employeeRecord.getOptionValues(), optionValues, optionMap),
+                taxRule, optionMap);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_MONTH_TYPE, subType = HRM_SALARY_MONTH_EMPLOYEE_UPDATE_SUB_TYPE,
+            bizNo = "{{#salaryMonthRecord.id}}", success = HRM_SALARY_MONTH_EMPLOYEE_UPDATE_SUCCESS,
+            condition = "{{#reqVOs != null && !#reqVOs.isEmpty()}}")
+    public void updateMonthEmployeeRecordList(List<HrmSalaryMonthEmployeeRecordUpdateReqVO> reqVOs) {
+        // 1. 校验员工月度工资记录属于同一张可编辑工资表
+        if (CollUtil.isEmpty(reqVOs)) {
+            return;
+        }
+        Set<Long> employeeRecordIds = convertSet(reqVOs, HrmSalaryMonthEmployeeRecordUpdateReqVO::getId);
+        if (employeeRecordIds.size() != reqVOs.size()) {
+            throw exception(SALARY_DATA_ILLEGAL);
+        }
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords =
+                monthEmployeeRecordMapper.selectByIds(employeeRecordIds);
+        if (employeeRecords.size() != employeeRecordIds.size()) {
+            throw exception(SALARY_MONTH_EMP_RECORD_NOT_EXISTS);
+        }
+        Set<Long> monthRecordIds = convertSet(
+                employeeRecords, HrmSalaryMonthEmployeeRecordDO::getMonthRecordId);
+        if (monthRecordIds.size() != 1) {
+            throw exception(SALARY_DATA_ILLEGAL);
+        }
+        Long monthRecordId = CollUtil.getFirst(monthRecordIds);
+        HrmSalaryMonthRecordDO salaryMonthRecord =
+                monthRecordService.validateMonthRecordEditableForUpdate(monthRecordId);
+
+        // 2.1 批量加载工资项和员工计税规则
+        Map<Integer, HrmSalaryOptionDO> optionMap = getSalaryOptionMap();
+        Map<Long, HrmSalaryTaxRuleDO> employeeTaxRuleMap = getEmployeeTaxRuleMap(
+                convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId));
+        // 2.2 重新计算并批量更新员工月度工资
+        Map<Long, HrmSalaryMonthEmployeeRecordDO> employeeRecordMap = employeeRecords.stream()
+                .collect(Collectors.toMap(HrmSalaryMonthEmployeeRecordDO::getId, Function.identity()));
+        for (HrmSalaryMonthEmployeeRecordUpdateReqVO reqVO : reqVOs) {
+            HrmSalaryMonthEmployeeRecordDO employeeRecord = employeeRecordMap.get(reqVO.getId());
+            monthEmployeeRecordMapper.updateById(calculateMonthEmployeeRecord(employeeRecord,
+                    mergeEditableOptionValues(employeeRecord.getOptionValues(), reqVO.getOptionValues(), optionMap),
+                    employeeTaxRuleMap.get(employeeRecord.getEmployeeId()), optionMap));
+        }
+
+        // 3. 统一更新月度工资表汇总
+        monthRecordService.updateMonthRecordSummary(monthRecordId);
+
+        // 4.1 构建操作日志上下文。只记录影响范围和薪资项名称，不记录任何薪资金额
+        List<Long> affectedEmployeeIds = employeeRecords.stream()
+                .map(HrmSalaryMonthEmployeeRecordDO::getEmployeeId).filter(Objects::nonNull)
+                .distinct().sorted().collect(Collectors.toList());
+        List<Long> displayedEmployeeIds = affectedEmployeeIds.size() > 20
+                ? affectedEmployeeIds.subList(0, 20) : affectedEmployeeIds;
+        String employeeScope = StrUtil.join("、", displayedEmployeeIds);
+        if (affectedEmployeeIds.size() > displayedEmployeeIds.size()) {
+            employeeScope += " 等 " + affectedEmployeeIds.size() + " 人";
+        }
+        List<String> changedOptionNames = reqVOs.stream()
+                .flatMap(reqVO -> CollUtil.emptyIfNull(reqVO.getOptionValues()).stream())
+                .map(HrmSalaryOptionValueVO::getCode).filter(Objects::nonNull)
+                .distinct().sorted().map(optionMap::get).filter(Objects::nonNull)
+                .map(HrmSalaryOptionDO::getName).filter(StrUtil::isNotBlank)
+                .collect(Collectors.toList());
+        List<String> displayedOptionNames = changedOptionNames.size() > 20
+                ? changedOptionNames.subList(0, 20) : changedOptionNames;
+        String changedOptionSummary = CollUtil.isEmpty(displayedOptionNames)
+                ? "未指定可编辑薪资项" : StrUtil.join("、", displayedOptionNames);
+        if (changedOptionNames.size() > displayedOptionNames.size()) {
+            changedOptionSummary += " 等 " + changedOptionNames.size() + " 项";
+        }
+
+        // 4.2 记录操作日志上下文
+        LogRecordContext.putVariable("salaryMonthRecord", salaryMonthRecord);
+        LogRecordContext.putVariable("employeeCount", affectedEmployeeIds.size());
+        LogRecordContext.putVariable("employeeScope", employeeScope);
+        LogRecordContext.putVariable("changedOptionSummary", changedOptionSummary);
+    }
+
+    @Override
+    public void deleteMonthEmployeeRecordListByMonthRecordId(Long monthRecordId) {
+        monthEmployeeRecordMapper.deleteByMonthRecordId(monthRecordId);
+    }
+
+    @Override
+    public PageResult<HrmSalaryMonthEmployeeRecordDO> getMonthEmployeeRecordPage(
+            HrmSalaryMonthEmployeeRecordPageReqVO reqVO) {
+        // 1.1 获得月度工资表
+        HrmSalaryMonthRecordDO monthRecord = monthRecordService.getMonthRecord(reqVO.getMonthRecordId());
+        if (monthRecord == null) {
+            return PageResult.empty();
+        }
+        // 1.2 获得符合员工信息和异动条件的员工编号
+        Set<Long> employeeIds = reqVO.getEmployeeIds() == null
+                ? resolveMonthEmployeeRecordEmployeeIds(reqVO, monthRecord, true)
+                : new HashSet<>(reqVO.getEmployeeIds());
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return PageResult.empty();
+        }
+        HrmSalaryMonthEmployeeRecordPageReqVO queryReqVO = BeanUtils.toBean(
+                reqVO, HrmSalaryMonthEmployeeRecordPageReqVO.class);
+        if (employeeIds != null) {
+            queryReqVO.setEmployeeIds(new ArrayList<>(employeeIds));
+        }
+
+        // 2. 查询员工月度工资分页
+        return monthEmployeeRecordMapper.selectPage(queryReqVO);
+    }
+
+    @Override
+    public List<HrmSalaryMonthEmployeeRecordDO> getMonthEmployeeRecordList(
+            HrmSalaryMonthEmployeeRecordListReqVO reqVO) {
+        // 1.1 获得月度工资表
+        HrmSalaryMonthRecordDO monthRecord = monthRecordService.getMonthRecord(reqVO.getMonthRecordId());
+        if (monthRecord == null) {
+            return Collections.emptyList();
+        }
+        // 1.2 获得符合员工信息和异动条件的员工编号
+        Set<Long> employeeIds = reqVO.getEmployeeIds() == null
+                ? resolveMonthEmployeeRecordEmployeeIds(reqVO, monthRecord)
+                : new HashSet<>(reqVO.getEmployeeIds());
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+        HrmSalaryMonthEmployeeRecordListReqVO queryReqVO = BeanUtils.toBean(
+                reqVO, HrmSalaryMonthEmployeeRecordListReqVO.class);
+        if (employeeIds != null) {
+            queryReqVO.setEmployeeIds(new ArrayList<>(employeeIds));
+        }
+
+        // 2. 查询员工月度工资列表
+        return monthEmployeeRecordMapper.selectList(queryReqVO);
+    }
+
+    @Override
+    public List<HrmSalaryMonthEmployeeRecordDO> getMonthEmployeeRecordListByMonthRecordId(Long monthRecordId) {
+        return monthEmployeeRecordMapper.selectListByMonthRecordId(monthRecordId);
+    }
+
+    @Override
+    public HrmSalaryMonthEmployeeRecordDO getMonthEmployeeRecordByEmployeeIdAndYearMonth(
+            Long employeeId, Integer year, Integer month) {
+        return monthEmployeeRecordMapper.selectByEmployeeIdAndYearMonth(employeeId, year, month);
+    }
+
+    @Override
+    public List<HrmSalaryMonthEmployeeRecordDO.OptionValue> getMonthOptionSummary(
+            List<HrmSalaryMonthEmployeeRecordDO> employeeRecords) {
+        Map<Integer, HrmSalaryMonthEmployeeRecordDO.OptionValue> summaryMap = new LinkedHashMap<>();
+        for (HrmSalaryMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            for (HrmSalaryMonthEmployeeRecordDO.OptionValue optionValue :
+                    CollUtil.emptyIfNull(employeeRecord.getOptionValues())) {
+                HrmSalaryMonthEmployeeRecordDO.OptionValue summary = summaryMap.computeIfAbsent(
+                        optionValue.getCode(), code -> HrmSalaryMonthEmployeeRecordDO.OptionValue.builder()
+                                .code(code).name(optionValue.getName()).value(BigDecimal.ZERO).build());
+                summary.setValue(summary.getValue().add(nvl(optionValue.getValue())));
+            }
+        }
+        return summaryMap.values().stream()
+                .sorted(Comparator.comparing(HrmSalaryMonthEmployeeRecordDO.OptionValue::getCode))
+                .collect(Collectors.toList());
+    }
+
+    @Override
+    public Map<Integer, Long> getMonthEmployeeChangeCount(HrmSalaryMonthEmployeeRecordPageReqVO reqVO) {
+        // 1.1 获得月度工资表
+        HrmSalaryMonthRecordDO monthRecord = monthRecordService.getMonthRecord(reqVO.getMonthRecordId());
+        if (monthRecord == null) {
+            return Collections.emptyMap();
+        }
+        // 1.2 按其他查询条件筛选员工
+        Set<Long> employeeIds = resolveMonthEmployeeRecordEmployeeIds(reqVO, monthRecord, false);
+        if (employeeIds == null) {
+            employeeIds = convertSet(monthEmployeeRecordMapper.selectListByMonthRecordId(reqVO.getMonthRecordId()),
+                    HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+        }
+        Set<Long> filteredEmployeeIds = employeeIds;
+
+        // 2. 统计各异动分类数量
+        return convertMap(Arrays.asList(HrmSalaryEmployeeChangeTypeEnum.values()),
+                HrmSalaryEmployeeChangeTypeEnum::getType,
+                type -> (long) filterEmployeeIdsByChangeType(filteredEmployeeIds, monthRecord, type).size(),
+                (first, second) -> first, LinkedHashMap::new);
+    }
+
+    @Override
+    public Map<Long, BigDecimal> getPerformanceCoefficientMap(HrmSalaryPerformanceCoefficientReqVO reqVO) {
+        return getPerformanceCoefficientMap(reqVO.getYear(), reqVO.getMonth(), reqVO.getEmployeeIds());
+    }
+
+    @Override
+    public PageResult<HrmSalaryMonthEmployeeRecordDO> getEmployeeMonthRecordPage(
+            HrmSalaryEmployeeMonthRecordPageReqVO reqVO) {
+        // 1. 获得符合状态条件的月度工资表编号
+        List<HrmSalaryMonthRecordDO> monthRecords =
+                monthRecordService.getMonthRecordListByStatus(reqVO.getMonthRecordStatus());
+        if (CollUtil.isEmpty(monthRecords)) {
+            return PageResult.empty();
+        }
+        List<Long> monthRecordIds = convertList(monthRecords, HrmSalaryMonthRecordDO::getId);
+
+        // 2. 查询指定员工的月度工资分页
+        return monthEmployeeRecordMapper.selectPageByEmployeeId(reqVO, monthRecordIds);
+    }
+
+    private HrmSalaryMonthEmployeeRecordDO calculateMonthEmployeeRecord(
+            HrmSalaryMonthEmployeeRecordDO employeeRecord, List<HrmSalaryOptionValueVO> optionValues,
+            HrmSalaryTaxRuleDO taxRule, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        List<HrmSalaryOptionValueVO> values = fillLastMonthCumulativeValues(
+                new ArrayList<>(optionValues), employeeRecord.getEmployeeId(),
+                employeeRecord.getYear(), employeeRecord.getMonth(), taxRule, optionMap);
+        SalaryComputeResult result = computeSalary(values, optionMap, taxRule);
+        return employeeRecord.setExpectedPaySalary(result.getExpectedPaySalary())
+                .setTaxableSalary(result.getTaxableSalary()).setPersonalTax(result.getPersonalTax())
+                .setRealPaySalary(result.getRealPaySalary())
+                .setOptionValues(buildMonthOptionValues(result.getOptionValues()));
+    }
+
+    private List<HrmSalaryMonthEmployeeRecordDO.OptionValue> buildMonthOptionValues(
+            List<HrmSalaryOptionValueVO> optionValues) {
+        return convertList(optionValues, optionValue -> HrmSalaryMonthEmployeeRecordDO.OptionValue.builder()
+                .code(optionValue.getCode()).name(optionValue.getName()).value(nvl(optionValue.getValue()))
+                .build());
+    }
+
+    private SalaryComputeResult computeSalary(List<HrmSalaryOptionValueVO> sourceValues,
+                                              Map<Integer, HrmSalaryOptionDO> optionMap,
+                                              HrmSalaryTaxRuleDO taxRule) {
+        List<HrmSalaryOptionValueVO> values = normalizeComputeSourceValues(sourceValues);
+        SalaryBaseAmounts baseAmounts = calculateSalaryBaseAmounts(values, optionMap);
+        BigDecimal expected = baseAmounts.getExpectedPaySalary();
+        BigDecimal taxable;
+        BigDecimal personalTax;
+        if (taxRule == null || Boolean.FALSE.equals(taxRule.getTaxEnabled())
+                || Objects.equals(taxRule.getType(), HrmSalaryTaxTypeEnum.NONE.getType())) {
+            taxable = BigDecimal.ZERO;
+            personalTax = BigDecimal.ZERO;
+        } else if (Objects.equals(taxRule.getType(), HrmSalaryTaxTypeEnum.REMUNERATION.getType())) {
+            taxable = calculateRemunerationTaxable(
+                    baseAmounts.getTaxableIncome(), nvl(taxRule.getThreshold()), taxRule.getDecimalScale());
+            personalTax = calculateRemunerationTax(taxable, taxRule.getDecimalScale());
+        } else {
+            BigDecimal threshold = nvl(taxRule.getThreshold());
+            taxable = baseAmounts.getTaxableBeforeThreshold().subtract(threshold).max(BigDecimal.ZERO);
+            personalTax = appendCumulativeSalaryTaxValues(values, optionMap, baseAmounts, threshold,
+                    taxRule.getDecimalScale());
+        }
+        BigDecimal realPay;
+        if (taxRule == null || Boolean.FALSE.equals(taxRule.getTaxEnabled())
+                || Objects.equals(taxRule.getType(), HrmSalaryTaxTypeEnum.NONE.getType())) {
+            realPay = expected.subtract(baseAmounts.getCurrentSpecialDeduction())
+                    .add(baseAmounts.getAfterTaxAdjustment());
+        } else if (Objects.equals(taxRule.getType(), HrmSalaryTaxTypeEnum.REMUNERATION.getType())) {
+            realPay = expected.subtract(personalTax).add(baseAmounts.getAfterTaxAdjustment());
+        } else {
+            realPay = expected.subtract(baseAmounts.getCurrentSpecialDeduction()).subtract(personalTax)
+                    .add(baseAmounts.getAfterTaxAdjustment());
+        }
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.EXPECTED_PAY.getCode(), "应发工资", expected);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.TAXABLE.getCode(), "应税工资", taxable);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.PERSONAL_TAX.getCode(), "个人所得税", personalTax);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.REAL_PAY.getCode(), "实发工资", realPay);
+        return new SalaryComputeResult(expected, taxable, personalTax, realPay, values);
+    }
+
+    private SalaryBaseAmounts calculateSalaryBaseAmounts(List<HrmSalaryOptionValueVO> values,
+                                                         Map<Integer, HrmSalaryOptionDO> optionMap) {
+        BigDecimal expected = BigDecimal.ZERO;
+        BigDecimal taxableExpected = BigDecimal.ZERO;
+        BigDecimal currentSpecialDeduction = BigDecimal.ZERO;
+        BigDecimal specialTaxSalary = BigDecimal.ZERO;
+        BigDecimal afterTaxAdjustment = BigDecimal.ZERO;
+        for (HrmSalaryOptionValueVO value : values) {
+            HrmSalaryOptionDO option = optionMap.get(value.getCode());
+            if (option == null) {
+                continue;
+            }
+            BigDecimal amount = nvl(value.getValue());
+            if (Objects.equals(option.getParentCode(), WITHHOLDING_PARENT_CODE)) {
+                currentSpecialDeduction = currentSpecialDeduction.add(amount);
+            }
+            if (Objects.equals(option.getParentCode(), SPECIAL_TAX_PARENT_CODE)
+                    && Boolean.TRUE.equals(option.getTaxEnabled())) {
+                specialTaxSalary = specialTaxSalary.add(amount);
+            }
+            if (Objects.equals(option.getParentCode(), AFTER_TAX_ADD_PARENT_CODE)) {
+                afterTaxAdjustment = afterTaxAdjustment.add(amount);
+            }
+            if (Objects.equals(option.getParentCode(), AFTER_TAX_DEDUCT_PARENT_CODE)) {
+                afterTaxAdjustment = afterTaxAdjustment.subtract(amount);
+            }
+            if (EXPECTED_PAY_PARENT_CODES.contains(option.getParentCode())) {
+                boolean minus = Objects.equals(option.getType(), HrmSalaryOptionTypeEnum.MINUS.getType());
+                expected = minus ? expected.subtract(amount) : expected.add(amount);
+                if (Boolean.TRUE.equals(option.getTaxEnabled())) {
+                    taxableExpected = minus ? taxableExpected.subtract(amount) : taxableExpected.add(amount);
+                }
+            }
+        }
+        BigDecimal taxableIncome = taxableExpected.add(specialTaxSalary);
+        BigDecimal taxableBeforeThreshold = taxableIncome
+                .subtract(currentSpecialDeduction);
+        return new SalaryBaseAmounts(expected, taxableIncome, taxableBeforeThreshold,
+                currentSpecialDeduction, afterTaxAdjustment);
+    }
+
+    private List<HrmSalaryOptionValueVO> normalizeComputeSourceValues(
+            List<HrmSalaryOptionValueVO> sourceValues) {
+        Map<Integer, HrmSalaryOptionValueVO> valueMap = new LinkedHashMap<>();
+        for (HrmSalaryOptionValueVO sourceValue : sourceValues) {
+            if (sourceValue.getCode() == null || HrmSalaryOptionCodeEnum.COMPUTED_CODES.contains(sourceValue.getCode())) {
+                continue;
+            }
+            valueMap.put(sourceValue.getCode(), sourceValue);
+        }
+        return new ArrayList<>(valueMap.values());
+    }
+
+    private BigDecimal appendCumulativeSalaryTaxValues(List<HrmSalaryOptionValueVO> values,
+                                                       Map<Integer, HrmSalaryOptionDO> optionMap,
+                                                       SalaryBaseAmounts baseAmounts, BigDecimal threshold,
+                                                       Integer decimalScale) {
+        BigDecimal cumulativeIncome = getOptionValue(values, HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_INCOME.getCode())
+                .add(baseAmounts.getTaxableIncome());
+        BigDecimal cumulativeDeductExpense = getOptionValue(values, HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_DEDUCT_EXPENSE.getCode())
+                .add(threshold);
+        BigDecimal cumulativeSpecialDeduction = getOptionValue(values, HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_SPECIAL_DEDUCTION.getCode())
+                .add(baseAmounts.getCurrentSpecialDeduction());
+        BigDecimal cumulativeAdditionalDeduction = calculateCumulativeAdditionalDeduction(values, optionMap);
+        BigDecimal cumulativeTaxable = cumulativeIncome.subtract(cumulativeDeductExpense)
+                .subtract(cumulativeSpecialDeduction).subtract(cumulativeAdditionalDeduction);
+        BigDecimal cumulativeTax = calculateCumulativeSalaryTax(cumulativeTaxable, decimalScale);
+        BigDecimal personalTax = cumulativeTax.subtract(
+                getOptionValue(values, HrmSalaryOptionCodeEnum.LAST_MONTH_PREPAID_TAX.getCode()));
+
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_INCOME.getCode(), "累计收入额", cumulativeIncome);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_DEDUCT_EXPENSE.getCode(), "累计减除费用", cumulativeDeductExpense);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_SPECIAL_DEDUCTION.getCode(), "累计专项扣除",
+                cumulativeSpecialDeduction);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_ADDITIONAL_DEDUCTION.getCode(),
+                "累计专项附加扣除", cumulativeAdditionalDeduction);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_TAXABLE.getCode(), "累计应纳税所得额", cumulativeTaxable);
+        appendComputedValue(values, HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_TAX.getCode(), "累计应纳税额", cumulativeTax);
+        return personalTax.setScale(decimalScale == null ? 2 : decimalScale, RoundingMode.HALF_UP);
+    }
+
+    private BigDecimal calculateCumulativeAdditionalDeduction(List<HrmSalaryOptionValueVO> values,
+                                                               Map<Integer, HrmSalaryOptionDO> optionMap) {
+        return values.stream()
+                .filter(value -> {
+                    HrmSalaryOptionDO option = optionMap.get(value.getCode());
+                    return option != null && Objects.equals(option.getParentCode(), 260);
+                })
+                .map(value -> nvl(value.getValue()).max(BigDecimal.ZERO))
+                .reduce(BigDecimal.ZERO, BigDecimal::add);
+    }
+
+    private BigDecimal getOptionValue(List<HrmSalaryOptionValueVO> values, Integer code) {
+        return values.stream().filter(value -> Objects.equals(value.getCode(), code)).findFirst()
+                .map(HrmSalaryOptionValueVO::getValue).map(HrmSalaryMonthEmployeeRecordServiceImpl::nvl)
+                .orElse(BigDecimal.ZERO).max(BigDecimal.ZERO);
+    }
+
+    private void appendComputedValue(List<HrmSalaryOptionValueVO> values, Integer code,
+                                     String name, BigDecimal value) {
+        values.removeIf(item -> Objects.equals(item.getCode(), code));
+        values.add(new HrmSalaryOptionValueVO().setCode(code).setName(name).setValue(priceScale(value)));
+    }
+
+    private BigDecimal calculateCumulativeSalaryTax(BigDecimal taxable, Integer decimalScale) {
+        if (taxable.signum() < 0) {
+            return BigDecimal.ZERO.setScale(getTaxDecimalScale(decimalScale), RoundingMode.HALF_UP);
+        }
+        HrmSalaryTaxRateEnum taxRate = HrmSalaryTaxRateEnum.valueOf(
+                HrmSalaryTaxTypeEnum.SALARY.getType(), taxable);
+        return calculateTax(taxable, taxRate, decimalScale);
+    }
+
+    private BigDecimal calculateRemunerationTaxable(
+            BigDecimal expected, BigDecimal threshold, Integer decimalScale) {
+        int scale = getTaxDecimalScale(decimalScale);
+        if (expected.compareTo(BigDecimal.valueOf(4000)) <= 0) {
+            return expected.subtract(threshold).max(BigDecimal.ZERO)
+                    .setScale(scale, RoundingMode.HALF_UP);
+        }
+        return expected.multiply(BigDecimal.valueOf(0.8)).max(BigDecimal.ZERO)
+                .setScale(scale, RoundingMode.HALF_UP);
+    }
+
+    private BigDecimal calculateRemunerationTax(BigDecimal taxable, Integer decimalScale) {
+        HrmSalaryTaxRateEnum taxRate = HrmSalaryTaxRateEnum.valueOf(
+                HrmSalaryTaxTypeEnum.REMUNERATION.getType(), taxable);
+        return calculateTax(taxable, taxRate, decimalScale);
+    }
+
+    private BigDecimal calculateTax(BigDecimal taxable, HrmSalaryTaxRateEnum taxRate,
+                                    Integer decimalScale) {
+        int scale = getTaxDecimalScale(decimalScale);
+        return taxable.multiply(BigDecimal.valueOf(taxRate.getRate()))
+                .divide(BigDecimal.valueOf(100), scale, RoundingMode.UP)
+                .subtract(taxRate.getQuickDeduction()).setScale(scale, RoundingMode.HALF_UP);
+    }
+
+    private int getTaxDecimalScale(Integer decimalScale) {
+        return decimalScale == null ? 2 : decimalScale;
+    }
+
+    private List<HrmSalaryOptionValueVO> fillLastMonthCumulativeValues(
+            List<HrmSalaryOptionValueVO> sourceValues, Long employeeId, Integer year, Integer month,
+            HrmSalaryTaxRuleDO taxRule, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        if (!isSalaryTaxRule(taxRule)) {
+            return sourceValues;
+        }
+        Set<Integer> existingCodes = convertSet(sourceValues, HrmSalaryOptionValueVO::getCode);
+        Map<Integer, BigDecimal> lastMonthValues = getLastMonthCumulativeValues(
+                employeeId, year, month, taxRule, optionMap);
+        List<HrmSalaryOptionValueVO> missingValues = HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_CODES.stream()
+                .filter(code -> !existingCodes.contains(code))
+                .map(code -> buildOptionValue(code, lastMonthValues.getOrDefault(code, BigDecimal.ZERO), optionMap))
+                .collect(Collectors.toList());
+        return mergeOptionValues(sourceValues, missingValues);
+    }
+
+    private boolean isSalaryTaxRule(HrmSalaryTaxRuleDO taxRule) {
+        return taxRule != null && ObjectUtil.notEqual(Boolean.FALSE, taxRule.getTaxEnabled())
+                && (taxRule.getType() == null || Objects.equals(taxRule.getType(), HrmSalaryTaxTypeEnum.SALARY.getType()));
+    }
+
+    private Map<Integer, BigDecimal> getLastMonthCumulativeValues(
+            Long employeeId, Integer year, Integer month, HrmSalaryTaxRuleDO taxRule,
+            Map<Integer, HrmSalaryOptionDO> optionMap) {
+        Map<Integer, BigDecimal> result = HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_CODES.stream()
+                .collect(Collectors.toMap(Function.identity(), ignored -> BigDecimal.ZERO,
+                        (first, second) -> first, LinkedHashMap::new));
+        if (employeeId == null || year == null || month == null) {
+            return result;
+        }
+        int cycleStartMonth = Objects.equals(taxRule.getCycleType(), HrmSalaryTaxCycleTypeEnum.DECEMBER_TO_NOVEMBER.getType()) ? 12 : 1;
+        if (month == cycleStartMonth) {
+            return result;
+        }
+        YearMonth lastYearMonth = YearMonth.of(year, month).minusMonths(1);
+        HrmSalaryMonthEmployeeRecordDO lastRecord = monthEmployeeRecordMapper
+                .selectByEmployeeIdAndYearMonth(employeeId, lastYearMonth.getYear(), lastYearMonth.getMonthValue());
+        if (lastRecord == null) {
+            return result;
+        }
+        List<HrmSalaryOptionValueVO> lastOptionValues = BeanUtils.toBean(
+                CollUtil.emptyIfNull(lastRecord.getOptionValues()), HrmSalaryOptionValueVO.class);
+        Map<Integer, BigDecimal> lastOptionMap = lastOptionValues.stream()
+                .filter(value -> value.getCode() != null)
+                .collect(Collectors.toMap(HrmSalaryOptionValueVO::getCode,
+                        value -> nvl(value.getValue()), (first, second) -> second));
+
+        SalaryBaseAmounts lastBaseAmounts = calculateSalaryBaseAmounts(lastOptionValues, optionMap);
+        BigDecimal legacyIncome = lastOptionMap
+                .getOrDefault(HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_INCOME.getCode(), BigDecimal.ZERO)
+                .add(lastBaseAmounts.getExpectedPaySalary());
+        BigDecimal legacyDeductExpense = lastOptionMap
+                .getOrDefault(HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_DEDUCT_EXPENSE.getCode(), BigDecimal.ZERO)
+                .add(nvl(taxRule.getThreshold()));
+        BigDecimal legacySpecialDeduction = lastOptionMap
+                .getOrDefault(HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_SPECIAL_DEDUCTION.getCode(), BigDecimal.ZERO)
+                .add(lastBaseAmounts.getCurrentSpecialDeduction());
+        BigDecimal legacyPrepaidTax = lastOptionMap
+                .getOrDefault(HrmSalaryOptionCodeEnum.LAST_MONTH_PREPAID_TAX.getCode(), BigDecimal.ZERO)
+                .add(nvl(lastRecord.getPersonalTax()));
+
+        result.put(HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_INCOME.getCode(),
+                lastOptionMap.getOrDefault(HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_INCOME.getCode(), legacyIncome));
+        result.put(HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_DEDUCT_EXPENSE.getCode(),
+                lastOptionMap.getOrDefault(HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_DEDUCT_EXPENSE.getCode(), legacyDeductExpense));
+        result.put(HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_SPECIAL_DEDUCTION.getCode(),
+                lastOptionMap.getOrDefault(HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_SPECIAL_DEDUCTION.getCode(), legacySpecialDeduction));
+        result.put(HrmSalaryOptionCodeEnum.LAST_MONTH_PREPAID_TAX.getCode(),
+                lastOptionMap.getOrDefault(HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_TAX.getCode(), legacyPrepaidTax));
+        return result;
+    }
+
+    private List<HrmSalaryOptionValueVO> mergeEditableOptionValues(
+            List<HrmSalaryMonthEmployeeRecordDO.OptionValue> currentValues,
+            List<HrmSalaryOptionValueVO> updateValues, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        Map<Integer, HrmSalaryOptionValueVO> valueMap = new LinkedHashMap<>();
+        for (HrmSalaryMonthEmployeeRecordDO.OptionValue currentValue : CollUtil.emptyIfNull(currentValues)) {
+            HrmSalaryOptionValueVO value = new HrmSalaryOptionValueVO();
+            value.setCode(currentValue.getCode()).setName(currentValue.getName()).setValue(currentValue.getValue());
+            valueMap.put(value.getCode(), value);
+        }
+        for (HrmSalaryOptionValueVO updateValue : CollUtil.emptyIfNull(updateValues)) {
+            HrmSalaryOptionDO option = optionMap.get(updateValue.getCode());
+            if (option == null || HrmSalaryOptionCodeEnum.COMPUTED_CODES.contains(option.getCode())) {
+                continue;
+            }
+            HrmSalaryOptionValueVO value = new HrmSalaryOptionValueVO();
+            value.setCode(option.getCode()).setName(option.getName()).setValue(nvl(updateValue.getValue()));
+            valueMap.put(value.getCode(), value);
+        }
+        return valueMap.values().stream()
+                .sorted(Comparator.comparing(HrmSalaryOptionValueVO::getCode))
+                .collect(Collectors.toList());
+    }
+
+    private List<HrmSalaryOptionValueVO> mergeOptionValues(
+            List<HrmSalaryOptionValueVO> baseValues, List<HrmSalaryOptionValueVO> addedValues) {
+        if (CollUtil.isEmpty(addedValues)) {
+            return baseValues;
+        }
+        Map<Integer, HrmSalaryOptionValueVO> valueMap = convertMap(
+                baseValues, HrmSalaryOptionValueVO::getCode, Function.identity(), (first, second) -> second,
+                LinkedHashMap::new);
+        valueMap.putAll(convertMap(addedValues, HrmSalaryOptionValueVO::getCode, Function.identity()));
+        return new ArrayList<>(valueMap.values());
+    }
+
+    private HrmSalaryOptionValueVO buildOptionValue(
+            Integer code, BigDecimal value, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        HrmSalaryOptionDO option = optionMap.get(code);
+        return new HrmSalaryOptionValueVO().setCode(code)
+                .setName(option == null ? "薪资项" + code : option.getName()).setValue(value);
+    }
+
+    private Map<Integer, HrmSalaryOptionDO> getSalaryOptionMap() {
+        return convertMap(salaryOptionService.getSalaryOptionList(false),
+                HrmSalaryOptionDO::getCode, Function.identity());
+    }
+
+    private Map<Long, HrmSalaryTaxRuleDO> getEmployeeTaxRuleMap(Collection<Long> employeeIds) {
+        if (CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyMap();
+        }
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+        Collection<HrmEmployeeDO> employees = employeeMap == null
+                ? Collections.emptyList() : employeeMap.values();
+        Map<Long, HrmSalaryGroupDO> salaryGroupMap = salaryGroupService.getEmployeeSalaryGroupMap(employees);
+        salaryGroupMap = salaryGroupMap == null ? Collections.emptyMap() : salaryGroupMap;
+        Map<Long, HrmSalaryTaxRuleDO> taxRuleMap = salaryTaxRuleService.getSalaryTaxRuleMap(
+                convertSet(salaryGroupMap.values(), HrmSalaryGroupDO::getTaxRuleId));
+        HrmSalaryTaxRuleDO defaultTaxRule = CollUtil.getFirst(salaryTaxRuleService.getSalaryTaxRuleList());
+        Map<Long, HrmSalaryTaxRuleDO> employeeTaxRuleMap = new LinkedHashMap<>();
+        for (Long employeeId : employeeIds) {
+            HrmSalaryGroupDO salaryGroup = salaryGroupMap.get(employeeId);
+            HrmSalaryTaxRuleDO taxRule = salaryGroup == null || salaryGroup.getTaxRuleId() == null
+                    ? defaultTaxRule : taxRuleMap.getOrDefault(salaryGroup.getTaxRuleId(), defaultTaxRule);
+            employeeTaxRuleMap.put(employeeId, taxRule);
+        }
+        return employeeTaxRuleMap;
+    }
+
+    private Set<Long> resolveMonthEmployeeRecordEmployeeIds(
+            HrmSalaryMonthEmployeeRecordPageReqVO reqVO, HrmSalaryMonthRecordDO monthRecord,
+            boolean filterChangeType) {
+        return resolveMonthEmployeeRecordEmployeeIds(reqVO.getMonthRecordId(), reqVO.getEmployeeId(),
+                reqVO.getEmployeeName(), reqVO.getJobNumber(), reqVO.getDeptId(), reqVO.getEmployeeChangeType(),
+                monthRecord, filterChangeType);
+    }
+
+    private Set<Long> resolveMonthEmployeeRecordEmployeeIds(
+            HrmSalaryMonthEmployeeRecordListReqVO reqVO, HrmSalaryMonthRecordDO monthRecord) {
+        return resolveMonthEmployeeRecordEmployeeIds(reqVO.getMonthRecordId(), reqVO.getEmployeeId(),
+                reqVO.getEmployeeName(), reqVO.getJobNumber(), reqVO.getDeptId(), reqVO.getEmployeeChangeType(),
+                monthRecord, true);
+    }
+
+    /**
+     * 获得符合工资表、员工信息和异动类型条件的员工编号
+     *
+     * @param monthRecordId 月度工资表编号
+     * @param employeeId 员工编号
+     * @param employeeName 员工姓名
+     * @param jobNumber 工号
+     * @param deptId 部门编号
+     * @param employeeChangeType 员工异动类型
+     * @param monthRecord 月度工资表
+     * @param filterChangeType 是否筛选员工异动类型
+     * @return 员工编号集合
+     */
+    private Set<Long> resolveMonthEmployeeRecordEmployeeIds(
+            Long monthRecordId, Long employeeId, String employeeName, String jobNumber, Long deptId,
+            Integer employeeChangeType, HrmSalaryMonthRecordDO monthRecord, boolean filterChangeType) {
+        // 1. 判断是否需要按员工或异动类型筛选
+        HrmSalaryEmployeeChangeTypeEnum changeType = HrmSalaryEmployeeChangeTypeEnum.valueOf(employeeChangeType);
+        boolean hasEmployeeFilter = employeeId != null || StrUtil.isNotBlank(employeeName)
+                || StrUtil.isNotBlank(jobNumber) || deptId != null;
+        boolean hasChangeTypeFilter = filterChangeType && changeType != null
+                && changeType != HrmSalaryEmployeeChangeTypeEnum.ALL;
+        if (!hasEmployeeFilter && !hasChangeTypeFilter) {
+            return null;
+        }
+        if (employeeId != null && StrUtil.isBlank(employeeName) && StrUtil.isBlank(jobNumber)
+                && deptId == null && !hasChangeTypeFilter) {
+            return Collections.singleton(employeeId);
+        }
+
+        // 2.1 获得工资表员工编号
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords =
+                monthEmployeeRecordMapper.selectListByMonthRecordId(monthRecordId);
+        if (CollUtil.isEmpty(employeeRecords)) {
+            return Collections.emptySet();
+        }
+        Set<Long> employeeIds = convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+        // 2.2 按指定员工编号筛选
+        if (employeeId != null) {
+            employeeIds.removeIf(id -> ObjectUtil.notEqual(id, employeeId));
+        }
+
+        // 3. 按员工档案信息筛选
+        if (StrUtil.isNotBlank(employeeName) || StrUtil.isNotBlank(jobNumber) || deptId != null) {
+            Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+            employeeIds.removeIf(candidateEmployeeId -> {
+                HrmEmployeeDO employee = employeeMap.get(candidateEmployeeId);
+                return employee == null
+                        || (StrUtil.isNotBlank(employeeName)
+                            && !StrUtil.contains(employee.getName(), employeeName.trim()))
+                        || (StrUtil.isNotBlank(jobNumber)
+                            && !StrUtil.contains(employee.getJobNumber(), jobNumber.trim()))
+                        || (deptId != null && ObjectUtil.notEqual(deptId, employee.getDeptId()));
+            });
+        }
+
+        // 4. 按员工异动类型筛选
+        if (!filterChangeType) {
+            return employeeIds;
+        }
+        return filterEmployeeIdsByChangeType(employeeIds, monthRecord, changeType);
+    }
+
+    /**
+     * 按工资周期内的员工异动类型筛选员工编号
+     *
+     * @param employeeIds 员工编号集合
+     * @param monthRecord 月度工资表
+     * @param changeType 员工异动类型
+     * @return 员工编号集合
+     */
+    private Set<Long> filterEmployeeIdsByChangeType(
+            Set<Long> employeeIds, HrmSalaryMonthRecordDO monthRecord,
+            HrmSalaryEmployeeChangeTypeEnum changeType) {
+        // 1. 未指定异动类型时返回全部员工
+        if (CollUtil.isEmpty(employeeIds) || changeType == null
+                || changeType == HrmSalaryEmployeeChangeTypeEnum.ALL) {
+            return new HashSet<>(employeeIds);
+        }
+
+        // 2. 按员工入职、离职时间筛选
+        LocalDate beginDate = monthRecord.getStartTime().toLocalDate();
+        LocalDate endDate = monthRecord.getEndTime().toLocalDate();
+        if (ObjectUtils.equalsAny(changeType, HrmSalaryEmployeeChangeTypeEnum.ENTRY,
+                HrmSalaryEmployeeChangeTypeEnum.LEAVE)) {
+            Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(employeeIds);
+            return convertSet(employeeIds, employeeId -> employeeId, employeeId -> {
+                HrmEmployeeDO employee = employeeMap.get(employeeId);
+                if (employee == null) {
+                    return false;
+                }
+                LocalDate effectDate = changeType == HrmSalaryEmployeeChangeTypeEnum.ENTRY
+                        ? employee.getEntryTime() == null ? null : employee.getEntryTime().toLocalDate()
+                        : employee.getLeaveTime() == null ? null : employee.getLeaveTime().toLocalDate();
+                return isBetween(beginDate, endDate, effectDate);
+            });
+        }
+
+        // 3. 按员工转正、调岗记录筛选
+        Integer employeeChangeType = changeType == HrmSalaryEmployeeChangeTypeEnum.REGULAR
+                ? HrmEmployeeChangeTypeEnum.REGULAR.getType() : HrmEmployeeChangeTypeEnum.TRANSFER.getType();
+        List<HrmEmployeeChangeRecordDO> changeRecords = employeeChangeRecordService
+                .getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(employeeIds,
+                        LocalDateTimeUtils.getDateTimeRange(beginDate, endDate));
+        return convertSet(changeRecords, HrmEmployeeChangeRecordDO::getEmployeeId,
+                record -> ObjectUtil.equal(record.getType(), employeeChangeType));
+    }
+
+    private Map<Long, BigDecimal> getPerformanceCoefficientMap(
+            Integer year, Integer month, Collection<Long> employeeIds) {
+        if (year == null || month == null || CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyMap();
+        }
+        List<HrmPerformancePlanDO> performancePlans = performancePlanService.getPerformancePlanListByPaidForMonth(
+                String.format("%d-%02d", year, month));
+        return performanceAssessmentService.getPerformanceArchiveEmployeeCoefficientMap(
+                convertSet(performancePlans, HrmPerformancePlanDO::getId,
+                        plan -> Boolean.TRUE.equals(plan.getSyncToSalary())), employeeIds);
+    }
+
+    private static BigDecimal nvl(BigDecimal value) {
+        return value == null ? BigDecimal.ZERO : value;
+    }
+
+    @Getter
+    @AllArgsConstructor
+    private static class SalaryBaseAmounts {
+
+        private final BigDecimal expectedPaySalary;
+        private final BigDecimal taxableIncome;
+        private final BigDecimal taxableBeforeThreshold;
+        private final BigDecimal currentSpecialDeduction;
+        private final BigDecimal afterTaxAdjustment;
+
+    }
+
+    @Getter
+    @AllArgsConstructor
+    private static class SalaryComputeResult {
+
+        private final BigDecimal expectedPaySalary;
+        private final BigDecimal taxableSalary;
+        private final BigDecimal personalTax;
+        private final BigDecimal realPaySalary;
+        private final List<HrmSalaryOptionValueVO> optionValues;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordService.java
new file mode 100644
index 0000000..92d29bc
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordService.java
@@ -0,0 +1,171 @@
+package cn.iocoder.yudao.module.hrm.service.salary.monthrecord;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryPayrollReadinessRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * HRM 月度工资 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalaryMonthRecordService {
+
+    /**
+     * 创建月度工资表
+     *
+     * @param reqVO 创建信息
+     * @return 月度工资表编号
+     */
+    Long createMonthRecord(HrmSalaryMonthRecordCreateReqVO reqVO);
+
+    /**
+     * 创建下月工资表
+     *
+     * @return 月度工资表编号
+     */
+    Long createNextMonthRecord();
+
+    /**
+     * 核算月度工资表
+     *
+     * @param id 月度工资表编号
+     */
+    void computeMonthRecord(Long id);
+
+    /**
+     * 使用导入数据核算月度工资表
+     *
+     * @param id 月度工资表编号
+     * @param attendanceRows 考勤导入数据
+     * @param additionalDeductionRows 专项附加扣除导入数据
+     * @param cumulativeTaxRows 累计个税导入数据
+     */
+    void computeMonthRecord(Long id, List<Map<Integer, String>> attendanceRows,
+                            List<Map<Integer, String>> additionalDeductionRows,
+                            List<Map<Integer, String>> cumulativeTaxRows);
+
+    /**
+     * 核算月度工资表
+     *
+     * @param id 月度工资表编号
+     * @param syncInsuranceData 是否同步社保数据
+     * @param syncAttendanceData 是否同步考勤数据
+     * @param attendanceRows 考勤导入数据
+     * @param additionalDeductionRows 专项附加扣除导入数据
+     * @param cumulativeTaxRows 累计个税导入数据
+     */
+    void computeMonthRecord(Long id, boolean syncInsuranceData, boolean syncAttendanceData,
+                            List<Map<Integer, String>> attendanceRows,
+                            List<Map<Integer, String>> additionalDeductionRows,
+                            List<Map<Integer, String>> cumulativeTaxRows);
+
+    /**
+     * 删除月度工资表
+     *
+     * @param id 月度工资表编号
+     */
+    void deleteMonthRecord(Long id);
+
+    /**
+     * 获得月度工资表
+     *
+     * @param id 月度工资表编号
+     * @return 月度工资表
+     */
+    HrmSalaryMonthRecordDO getMonthRecord(Long id);
+
+    /**
+     * 获得指定年月的月度工资表
+     *
+     * @param year 年份
+     * @param month 月份
+     * @return 月度工资表
+     */
+    HrmSalaryMonthRecordDO getMonthRecordByYearMonth(Integer year, Integer month);
+
+    /**
+     * 获得最近月度工资表
+     *
+     * @return 最近月度工资表
+     */
+    HrmSalaryMonthRecordDO getLastMonthRecord();
+
+    /**
+     * 获得工资核算准备情况
+     *
+     * @param monthRecordId 月度工资表编号
+     * @return 工资核算准备情况
+     */
+    HrmSalaryPayrollReadinessRespVO getPayrollReadiness(Long monthRecordId);
+
+    /**
+     * 获得计薪员工列表
+     *
+     * @param monthRecord 月度工资表
+     * @return 员工列表
+     */
+    List<HrmEmployeeDO> getPayrollEmployeeList(HrmSalaryMonthRecordDO monthRecord);
+
+    /**
+     * 获得月度工资表分页
+     *
+     * @param reqVO 分页查询
+     * @return 月度工资表分页
+     */
+    PageResult<HrmSalaryMonthRecordDO> getMonthRecordPage(HrmSalaryMonthRecordPageReqVO reqVO);
+
+    /**
+     * 获得指定状态的月度工资表列表
+     *
+     * @param status 状态
+     * @return 月度工资表列表
+     */
+    List<HrmSalaryMonthRecordDO> getMonthRecordListByStatus(Integer status);
+
+    /**
+     * 校验月度工资表是否存在
+     *
+     * @param id 月度工资表编号
+     * @return 月度工资表
+     */
+    HrmSalaryMonthRecordDO validateMonthRecordExists(Long id);
+
+    /**
+     * 校验月度工资表是否存在，并锁定当前记录
+     *
+     * @param id 月度工资表编号
+     * @return 月度工资表
+     */
+    HrmSalaryMonthRecordDO validateMonthRecordExistsForUpdate(Long id);
+
+    /**
+     * 校验月度工资表是否可编辑
+     *
+     * @param id 月度工资表编号
+     * @return 月度工资表
+     */
+    HrmSalaryMonthRecordDO validateMonthRecordEditable(Long id);
+
+    /**
+     * 校验月度工资表是否可编辑，并锁定当前记录
+     *
+     * @param id 月度工资表编号
+     * @return 月度工资表
+     */
+    HrmSalaryMonthRecordDO validateMonthRecordEditableForUpdate(Long id);
+
+    /**
+     * 更新月度工资表汇总
+     *
+     * @param id 月度工资表编号
+     */
+    void updateMonthRecordSummary(Long id);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordServiceImpl.java
new file mode 100644
index 0000000..f79b18f
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordServiceImpl.java
@@ -0,0 +1,763 @@
+package cn.iocoder.yudao.module.hrm.service.salary.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryConfigService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryGroupService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryTaxRuleService;
+import cn.iocoder.yudao.module.hrm.service.salary.employee.HrmSalaryEmployeeInfoService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryPayrollReadinessRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryConfigDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.monthrecord.HrmSalaryMonthRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionCodeEnum;
+import cn.iocoder.yudao.module.hrm.service.attendance.statistics.HrmAttendanceStatisticsService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthRecordService;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalarySocialSecurityMonthTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.hutool.core.util.ObjectUtil.defaultIfNull;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMultiMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isAfterOrEqual;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.isBeforeOrEqual;
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceAdd;
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CONFIG_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_CANNOT_DELETE_ONLY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_NOT_LATEST;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.*;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ROOT_PARENT_CODE;
+import static cn.iocoder.yudao.module.hrm.util.HrmExcelUtils.getCell;
+import static cn.iocoder.yudao.module.hrm.util.HrmExcelUtils.parseAmount;
+
+/**
+ * HRM 月度工资 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalaryMonthRecordServiceImpl implements HrmSalaryMonthRecordService {
+
+    private static final String MONTH_RECORD_TITLE_TEMPLATE = "%d年%d月工资表";
+
+    @Resource
+    private HrmSalaryMonthRecordMapper monthRecordMapper;
+
+    @Resource
+    private HrmSalaryOptionService salaryOptionService;
+    @Resource
+    private HrmSalaryConfigService salaryConfigService;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @Resource
+    private HrmAttendanceStatisticsService attendanceStatisticsService;
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordService insuranceMonthEmployeeRecordService;
+    @Resource
+    private HrmInsuranceMonthRecordService insuranceMonthRecordService;
+    @Resource
+    private HrmSalaryMonthEmployeeRecordService monthEmployeeRecordService;
+    @Resource
+    private HrmSalaryEmployeeInfoService salaryEmployeeInfoService;
+    @Resource
+    private HrmSalaryGroupService salaryGroupService;
+    @Resource
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_MONTH_TYPE, subType = HRM_SALARY_MONTH_CREATE_SUB_TYPE,
+            bizNo = "{{#salaryMonthRecord.id}}", success = HRM_SALARY_MONTH_CREATE_SUCCESS)
+    public Long createMonthRecord(HrmSalaryMonthRecordCreateReqVO reqVO) {
+        // 1. 校验年月唯一性
+        if (monthRecordMapper.selectByYearMonth(reqVO.getYear(), reqVO.getMonth()) != null) {
+            throw exception(SALARY_MONTH_RECORD_EXISTS);
+        }
+
+        // 2.1 根据工资配置计算计薪周期
+        YearMonth yearMonth = YearMonth.of(reqVO.getYear(), reqVO.getMonth());
+        HrmSalaryConfigDO salaryConfig = salaryConfigService.getSalaryConfig();
+        LocalDate defaultStartDate = resolveMonthDay(yearMonth,
+                salaryConfig == null ? null : salaryConfig.getCycleStartDay(), 1);
+        YearMonth endYearMonth = salaryConfig != null && salaryConfig.getCycleStartDay() != null
+                && salaryConfig.getCycleStartDay() > 1 ? yearMonth.plusMonths(1) : yearMonth;
+        LocalDate defaultEndDate = resolveMonthDay(endYearMonth,
+                salaryConfig == null ? null : salaryConfig.getCycleEndDay(), endYearMonth.lengthOfMonth());
+        // 2.2 创建月度工资表
+        HrmSalaryMonthRecordDO monthRecord = BeanUtils.toBean(reqVO, HrmSalaryMonthRecordDO.class)
+                .setTitle(reqVO.getTitle() != null ? reqVO.getTitle()
+                        : String.format(MONTH_RECORD_TITLE_TEMPLATE, reqVO.getYear(), reqVO.getMonth()))
+                .setStartTime(reqVO.getStartTime() == null ? defaultStartDate.atStartOfDay() : reqVO.getStartTime())
+                .setEndTime(reqVO.getEndTime() == null ? defaultEndDate.atStartOfDay() : reqVO.getEndTime())
+                .setEmployeeCount(0).setStatus(HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus())
+                .setExpectedPaySalary(BigDecimal.ZERO).setPersonalTax(BigDecimal.ZERO).setRealPaySalary(BigDecimal.ZERO)
+                .setOptionHeaders(buildOptionHeaderList(salaryOptionService.getSalaryOptionList(false, true)));
+        monthRecordMapper.insert(monthRecord);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryMonthRecord", monthRecord);
+        return monthRecord.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_MONTH_TYPE, subType = HRM_SALARY_MONTH_CREATE_SUB_TYPE,
+            bizNo = "{{#salaryMonthRecord.id}}", success = HRM_SALARY_MONTH_CREATE_SUCCESS)
+    public Long createNextMonthRecord() {
+        // 1. 获得最近月度工资表
+        HrmSalaryMonthRecordDO lastRecord = monthRecordMapper.selectLast();
+
+        // 2.1 首次创建时，使用工资配置的开始年月
+        YearMonth nextMonth;
+        if (lastRecord == null) {
+            HrmSalaryConfigDO salaryConfig = salaryConfigService.getSalaryConfig();
+            if (salaryConfig == null || salaryConfig.getStartYear() == null || salaryConfig.getStartMonth() == null) {
+                throw exception(SALARY_CONFIG_NOT_EXISTS);
+            }
+            nextMonth = YearMonth.of(salaryConfig.getStartYear(), salaryConfig.getStartMonth());
+        } else {
+            // 2.2 非首次创建时，归档最近月度工资表
+            if (ObjectUtil.notEqual(lastRecord.getStatus(), HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus())) {
+                monthRecordMapper.updateById(new HrmSalaryMonthRecordDO()
+                        .setId(lastRecord.getId()).setStatus(HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus()));
+            }
+            nextMonth = YearMonth.of(lastRecord.getYear(), lastRecord.getMonth()).plusMonths(1);
+        }
+
+        // 3. 创建下月工资表
+        return createMonthRecord(new HrmSalaryMonthRecordCreateReqVO()
+                .setYear(nextMonth.getYear()).setMonth(nextMonth.getMonthValue()));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_MONTH_TYPE, subType = HRM_SALARY_MONTH_COMPUTE_SUB_TYPE,
+            bizNo = "{{#salaryMonthRecord.id}}", success = HRM_SALARY_MONTH_COMPUTE_SUCCESS)
+    public void computeMonthRecord(Long id) {
+        computeMonthRecord(id, false, false,
+                Collections.emptyList(), Collections.emptyList(), Collections.emptyList());
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void computeMonthRecord(Long id, List<Map<Integer, String>> attendanceRows,
+                                   List<Map<Integer, String>> additionalDeductionRows,
+                                   List<Map<Integer, String>> cumulativeTaxRows) {
+        computeMonthRecord(id, false, false,
+                attendanceRows, additionalDeductionRows, cumulativeTaxRows);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_MONTH_TYPE, subType = HRM_SALARY_MONTH_COMPUTE_SUB_TYPE,
+            bizNo = "{{#salaryMonthRecord.id}}", success = HRM_SALARY_MONTH_COMPUTE_SUCCESS)
+    public void computeMonthRecord(Long id, boolean syncInsuranceData, boolean syncAttendanceData,
+                                   List<Map<Integer, String>> attendanceRows,
+                                   List<Map<Integer, String>> additionalDeductionRows,
+                                   List<Map<Integer, String>> cumulativeTaxRows) {
+        // 1.1 校验工资表并构造计薪周期
+        HrmSalaryMonthRecordDO monthRecord = validateMonthRecordEditableForUpdate(id);
+        LocalDateTime[] salaryTimes = LocalDateTimeUtils.getDateTimeRange(
+                monthRecord.getStartTime().toLocalDate(), monthRecord.getEndTime().toLocalDate());
+        // 1.2 获得计薪周期内、且已分配薪资组的员工
+        List<HrmEmployeeDO> payrollEmployees = getPayrollEmployeeList(monthRecord);
+        Map<Long, HrmSalaryGroupDO> salaryGroupMap = salaryGroupService.getEmployeeSalaryGroupMap(payrollEmployees);
+        payrollEmployees = filterList(payrollEmployees, employee -> salaryGroupMap.containsKey(employee.getId()));
+
+        // 2. 加载工资项、考勤、社保和导入数据
+        List<HrmSalaryOptionDO> optionList = salaryOptionService.getSalaryOptionList(false);
+        Map<Integer, HrmSalaryOptionDO> optionMap = convertMap(optionList, HrmSalaryOptionDO::getCode);
+        Map<String, AttendanceImportData> attendanceImportMap = syncAttendanceData
+                ? Collections.emptyMap() : parseAttendanceImportData(attendanceRows, optionMap);
+        Map<Long, HrmAttendanceMonthRecordRespVO> attendanceMap = syncAttendanceData
+                ? attendanceStatisticsService.getAttendanceMonthRecordMap(
+                        monthRecord.getYear(), monthRecord.getMonth(),
+                        convertList(payrollEmployees, HrmEmployeeDO::getId))
+                : Collections.emptyMap();
+        HrmSalaryConfigDO salaryConfig = salaryConfigService.getSalaryConfig();
+        YearMonth socialSecurityYearMonth = resolveSocialSecurityYearMonth(
+                YearMonth.of(monthRecord.getYear(), monthRecord.getMonth()), salaryConfig);
+        if (syncInsuranceData) {
+            insuranceMonthRecordService.validateMonthRecordExists(
+                    socialSecurityYearMonth.getYear(), socialSecurityYearMonth.getMonthValue());
+        }
+        Map<Long, HrmInsuranceMonthEmployeeRecordDO> insuranceMap = syncInsuranceData
+                ? insuranceMonthEmployeeRecordService.getNormalMonthEmployeeRecordMap(
+                        socialSecurityYearMonth.getYear(), socialSecurityYearMonth.getMonthValue())
+                : Collections.emptyMap();
+        Map<String, List<HrmSalaryOptionValueVO>> additionalDeductionImportMap =
+                parseOptionImportData(additionalDeductionRows, getAdditionalDeductionImportColumns(), optionMap);
+        Map<String, List<HrmSalaryOptionValueVO>> cumulativeTaxImportMap =
+                parseOptionImportData(cumulativeTaxRows, getCumulativeTaxImportColumns(), optionMap);
+        Map<Long, HrmSalaryTaxRuleDO> taxRuleMap = salaryTaxRuleService.getSalaryTaxRuleMap(
+                convertSet(salaryGroupMap.values(), HrmSalaryGroupDO::getTaxRuleId));
+        HrmSalaryTaxRuleDO defaultTaxRule = CollUtil.getFirst(salaryTaxRuleService.getSalaryTaxRuleList());
+
+        // 3. 逐个员工核算工资
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords = new ArrayList<>();
+        Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap = new LinkedHashMap<>();
+        Map<Long, HrmSalaryTaxRuleDO> employeeTaxRuleMap = new LinkedHashMap<>();
+        for (HrmEmployeeDO employee : payrollEmployees) {
+            // 3.1 获得本周期生效薪资；没有薪资档案时继承上月可维护薪资项
+            String jobNumber = employee.getJobNumber();
+            List<HrmSalaryOptionValueVO> values = BeanUtils.toBean(
+                    salaryEmployeeInfoService.getEffectiveSalaryOptionList(employee, salaryTimes),
+                    HrmSalaryOptionValueVO.class);
+            if (CollUtil.isEmpty(values)) {
+                YearMonth previousMonth = YearMonth.of(monthRecord.getYear(), monthRecord.getMonth()).minusMonths(1);
+                HrmSalaryMonthEmployeeRecordDO previousEmployeeRecord = monthEmployeeRecordService
+                        .getMonthEmployeeRecordByEmployeeIdAndYearMonth(employee.getId(), previousMonth.getYear(), previousMonth.getMonthValue());
+                if (previousEmployeeRecord != null) {
+                    values = convertList(previousEmployeeRecord.getOptionValues(),
+                            optionValue -> new HrmSalaryOptionValueVO().setCode(optionValue.getCode()).setName(optionValue.getName()).setValue(optionValue.getValue()),
+                            optionValue -> {
+                                HrmSalaryOptionDO option = optionMap.get(optionValue.getCode());
+                                return option != null && option.getParentCode() != null
+                                        && option.getParentCode() >= HrmSalaryOptionDO.ADJUSTABLE_CATEGORY_MIN_CODE
+                                        && option.getParentCode() <= HrmSalaryOptionDO.ADJUSTABLE_CATEGORY_MAX_CODE;
+                            });
+                }
+            }
+
+            // 3.2 合并考勤、社保、专项附加扣除和累计个税数据
+            AttendanceImportData attendanceData = syncAttendanceData
+                    ? buildAttendanceData(attendanceMap.get(employee.getId()), optionMap)
+                    : jobNumber == null ? null : attendanceImportMap.get(jobNumber);
+            if (attendanceData != null) {
+                values = mergeOptionValues(values, attendanceData.getOptionValues());
+            }
+            if (syncInsuranceData) {
+                values = mergeOptionValues(values, buildInsuranceOptionValues(insuranceMap.get(employee.getId()), optionMap));
+            }
+            if (jobNumber != null) {
+                values = mergeOptionValues(values, additionalDeductionImportMap.getOrDefault(jobNumber, Collections.emptyList()));
+                values = mergeOptionValues(values, cumulativeTaxImportMap.getOrDefault(jobNumber, Collections.emptyList()));
+            }
+
+            // 3.3 构建员工月工资记录，并准备批量核算所需数据
+            HrmSalaryGroupDO salaryGroup = salaryGroupMap.get(employee.getId());
+            HrmSalaryTaxRuleDO taxRule = taxRuleMap.getOrDefault(salaryGroup.getTaxRuleId(), defaultTaxRule);
+            BigDecimal salaryStandard = defaultIfNull(salaryGroup.getSalaryStandard(), HrmSalaryGroupDO.DEFAULT_SALARY_STANDARD);
+            employeeRecords.add(HrmSalaryMonthEmployeeRecordDO.builder()
+                    .monthRecordId(id).employeeId(employee.getId())
+                    .actualWorkDay(attendanceData == null ? salaryStandard : attendanceData.getActualWorkDay())
+                    .needWorkDay(salaryStandard).year(monthRecord.getYear()).month(monthRecord.getMonth()).build());
+            employeeOptionValueMap.put(employee.getId(), values);
+            employeeTaxRuleMap.put(employee.getId(), taxRule);
+        }
+        employeeRecords = monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                employeeRecords, employeeOptionValueMap, employeeTaxRuleMap);
+        monthEmployeeRecordService.saveMonthEmployeeRecordList(id, employeeRecords);
+
+        // 4. 更新工资表状态、表头和汇总
+        monthRecordMapper.updateById(new HrmSalaryMonthRecordDO().setId(id).setStatus(HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus())
+                .setOptionHeaders(buildOptionHeaderList(salaryOptionService.getSalaryOptionList(false, true))));
+        updateMonthRecordSummary(id);
+
+        // 5. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryMonthRecord", monthRecord);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_MONTH_TYPE, subType = HRM_SALARY_MONTH_DELETE_SUB_TYPE,
+            bizNo = "{{#salaryMonthRecord.id}}", success = HRM_SALARY_MONTH_DELETE_SUCCESS)
+    public void deleteMonthRecord(Long id) {
+        // 1. 校验仅删除最新工资表，并至少保留一张工资表
+        HrmSalaryMonthRecordDO salaryMonthRecord = validateMonthRecordEditableForUpdate(id);
+        HrmSalaryMonthRecordDO lastMonthRecord = monthRecordMapper.selectLast();
+        if (lastMonthRecord == null || ObjectUtil.notEqual(lastMonthRecord.getId(), salaryMonthRecord.getId())) {
+            throw exception(SALARY_MONTH_RECORD_NOT_LATEST);
+        }
+        if (monthRecordMapper.selectCount() <= 1) {
+            throw exception(SALARY_MONTH_RECORD_CANNOT_DELETE_ONLY);
+        }
+
+        // 2.1 删除当前月员工工资记录和工资表
+        monthEmployeeRecordService.deleteMonthEmployeeRecordListByMonthRecordId(id);
+        monthRecordMapper.deleteById(id);
+        // 2.2 恢复上一月工资表为已核算状态
+        HrmSalaryMonthRecordDO previousMonthRecord = monthRecordMapper.selectLast();
+        monthRecordMapper.updateById(new HrmSalaryMonthRecordDO()
+                .setId(previousMonthRecord.getId()).setStatus(HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus()));
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salaryMonthRecord", salaryMonthRecord);
+    }
+
+    @Override
+    public HrmSalaryMonthRecordDO getMonthRecord(Long id) {
+        return monthRecordMapper.selectById(id);
+    }
+
+    @Override
+    public HrmSalaryMonthRecordDO getMonthRecordByYearMonth(Integer year, Integer month) {
+        return monthRecordMapper.selectByYearMonth(year, month);
+    }
+
+    @Override
+    public HrmSalaryMonthRecordDO getLastMonthRecord() {
+        return monthRecordMapper.selectLast();
+    }
+
+    @Override
+    public HrmSalaryPayrollReadinessRespVO getPayrollReadiness(Long monthRecordId) {
+        // 1. 获得月度工资表和计薪周期内的员工
+        HrmSalaryMonthRecordDO monthRecord = monthRecordId == null ? monthRecordMapper.selectLast()
+                : monthRecordMapper.selectById(monthRecordId);
+        if (monthRecord == null) {
+            return null;
+        }
+        List<HrmEmployeeDO> validEmployees = getPayrollEmployeeList(monthRecord);
+
+        // 2. 筛选已配置薪资组和已定薪的员工
+        Map<Long, HrmSalaryGroupDO> salaryGroupMap =
+                salaryGroupService.getEmployeeSalaryGroupMap(validEmployees);
+        List<HrmEmployeeDO> payrollCandidates =
+                filterList(validEmployees, employee -> salaryGroupMap.containsKey(employee.getId()));
+        List<HrmEmployeeDO> noSalaryGroupEmployees =
+                filterList(validEmployees, employee -> !salaryGroupMap.containsKey(employee.getId()));
+        Set<Long> candidateIds = convertSet(payrollCandidates, HrmEmployeeDO::getId);
+        Set<Long> salaryEmployeeIds = salaryEmployeeInfoService.getSalaryEmployeeInfoMap(candidateIds).keySet();
+
+        // 3. 获得实际计薪员工和工资周期内的员工异动
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords = monthEmployeeRecordService
+                .getMonthEmployeeRecordListByMonthRecordId(monthRecord.getId());
+        Set<Long> payrollEmployeeIds = CollUtil.isEmpty(employeeRecords) ? candidateIds
+                : convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+        List<HrmEmployeeDO> noSalaryEmployees = filterList(payrollCandidates,
+                employee -> employee.getId() != null && !salaryEmployeeIds.contains(employee.getId()));
+        List<HrmEmployeeChangeRecordDO> changeRecords = employeeChangeRecordService
+                .getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(payrollEmployeeIds,
+                        LocalDateTimeUtils.getDateTimeRange(monthRecord.getStartTime().toLocalDate(),
+                                monthRecord.getEndTime().toLocalDate()));
+
+        // 4. 构建核算准备情况
+        HrmSalaryConfigDO salaryConfig = salaryConfigService.getSalaryConfig();
+        YearMonth salaryYearMonth = YearMonth.of(monthRecord.getYear(), monthRecord.getMonth());
+        List<HrmSalaryPayrollReadinessRespVO.Employee> noSalaryEmployeeVOs =
+                buildPayrollReadinessEmployeeList(noSalaryEmployees);
+        List<HrmSalaryPayrollReadinessRespVO.Employee> noSalaryGroupEmployeeVOs =
+                buildPayrollReadinessEmployeeList(noSalaryGroupEmployees);
+        return new HrmSalaryPayrollReadinessRespVO()
+                .setMonthRecordId(monthRecord.getId()).setTitle(monthRecord.getTitle())
+                .setYear(monthRecord.getYear()).setMonth(monthRecord.getMonth())
+                .setStartTime(monthRecord.getStartTime()).setEndTime(monthRecord.getEndTime())
+                .setSocialSecurityYearMonth(resolveSocialSecurityYearMonth(salaryYearMonth, salaryConfig).toString())
+                .setPayrollEmployeeCount((long) payrollEmployeeIds.size())
+                .setSalaryEmployeeCount((long) salaryEmployeeIds.size())
+                .setNoSalaryEmployeeCount((long) noSalaryEmployeeVOs.size())
+                .setNoSalaryGroupEmployeeCount((long) noSalaryGroupEmployeeVOs.size())
+                .setChangeEmployeeCount((long) changeRecords.size())
+                .setChangeTypeCountMap(buildPayrollReadinessChangeTypeCountMap(changeRecords))
+                .setNoSalaryEmployees(noSalaryEmployeeVOs)
+                .setNoSalaryGroupEmployees(noSalaryGroupEmployeeVOs);
+    }
+
+    private List<HrmSalaryPayrollReadinessRespVO.Employee> buildPayrollReadinessEmployeeList(
+            List<HrmEmployeeDO> employees) {
+        return convertList(employees, employee ->
+                BeanUtils.toBean(employee, HrmSalaryPayrollReadinessRespVO.Employee.class)
+                        .setEmployeeId(employee.getId()).setEmployeeName(employee.getName()));
+    }
+
+    @Override
+    public List<HrmEmployeeDO> getPayrollEmployeeList(HrmSalaryMonthRecordDO monthRecord) {
+        HrmEmployeeListReqVO employeeReqVO = new HrmEmployeeListReqVO();
+        List<HrmEmployeeDO> employees = employeeService.getEmployeeList(employeeReqVO);
+        employees = filterList(employees, employee -> (employee.getEntryTime() == null
+                        || isBeforeOrEqual(employee.getEntryTime().toLocalDate(), monthRecord.getEndTime().toLocalDate()))
+                        && (HrmEmployeeEntryStatusEnum.ACTIVE_STATUSES.contains(employee.getEntryStatus())
+                        || Objects.equals(employee.getEntryStatus(), HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                        && employee.getLeaveTime() != null
+                        && isAfterOrEqual(employee.getLeaveTime().toLocalDate(), monthRecord.getStartTime().toLocalDate())));
+        employees.sort(Comparator.comparing(HrmEmployeeDO::getId));
+        return employees;
+    }
+
+    @Override
+    public PageResult<HrmSalaryMonthRecordDO> getMonthRecordPage(HrmSalaryMonthRecordPageReqVO reqVO) {
+        return monthRecordMapper.selectPage(reqVO);
+    }
+
+    @Override
+    public List<HrmSalaryMonthRecordDO> getMonthRecordListByStatus(Integer status) {
+        return monthRecordMapper.selectListByStatus(status);
+    }
+
+    @Override
+    public HrmSalaryMonthRecordDO validateMonthRecordExists(Long id) {
+        HrmSalaryMonthRecordDO monthRecord = monthRecordMapper.selectById(id);
+        if (monthRecord == null) {
+            throw exception(SALARY_MONTH_RECORD_NOT_EXISTS);
+        }
+        return monthRecord;
+    }
+
+    @Override
+    public HrmSalaryMonthRecordDO validateMonthRecordExistsForUpdate(Long id) {
+        HrmSalaryMonthRecordDO monthRecord = monthRecordMapper.selectByIdForUpdate(id);
+        if (monthRecord == null) {
+            throw exception(SALARY_MONTH_RECORD_NOT_EXISTS);
+        }
+        return monthRecord;
+    }
+
+    @Override
+    public HrmSalaryMonthRecordDO validateMonthRecordEditable(Long id) {
+        HrmSalaryMonthRecordDO monthRecord = validateMonthRecordExists(id);
+        if (Objects.equals(monthRecord.getStatus(), HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus())) {
+            throw exception(SALARY_MONTH_RECORD_STATUS_INVALID);
+        }
+        return monthRecord;
+    }
+
+    @Override
+    public HrmSalaryMonthRecordDO validateMonthRecordEditableForUpdate(Long id) {
+        HrmSalaryMonthRecordDO monthRecord = validateMonthRecordExistsForUpdate(id);
+        if (Objects.equals(monthRecord.getStatus(), HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus())) {
+            throw exception(SALARY_MONTH_RECORD_STATUS_INVALID);
+        }
+        return monthRecord;
+    }
+
+    @Override
+    public void updateMonthRecordSummary(Long id) {
+        // 1.1 校验工资表可编辑
+        HrmSalaryMonthRecordDO monthRecord = validateMonthRecordEditable(id);
+        // 1.2 计算员工工资汇总
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords = monthEmployeeRecordService
+                .getMonthEmployeeRecordListByMonthRecordId(monthRecord.getId());
+        Map<Integer, BigDecimal> optionSummary = convertMap(
+                monthEmployeeRecordService.getMonthOptionSummary(employeeRecords),
+                HrmSalaryMonthEmployeeRecordDO.OptionValue::getCode,
+                option -> defaultIfNull(option.getValue(), BigDecimal.ZERO));
+
+        // 2. 更新工资表汇总数据
+        HrmSalaryMonthRecordDO updateObj = new HrmSalaryMonthRecordDO()
+                .setId(id).setEmployeeCount(employeeRecords.size());
+        updateObj.setExpectedPaySalary(priceAdd(convertList(employeeRecords,
+                HrmSalaryMonthEmployeeRecordDO::getExpectedPaySalary).toArray(new BigDecimal[0])));
+        updateObj.setPersonalTax(priceAdd(convertList(employeeRecords,
+                HrmSalaryMonthEmployeeRecordDO::getPersonalTax).toArray(new BigDecimal[0])));
+        updateObj.setRealPaySalary(priceAdd(convertList(employeeRecords,
+                HrmSalaryMonthEmployeeRecordDO::getRealPaySalary).toArray(new BigDecimal[0])));
+        updateObj.setPersonalInsuranceAmount(
+                optionSummary.getOrDefault(HrmSalaryOptionCodeEnum.PERSONAL_INSURANCE.getCode(), BigDecimal.ZERO));
+        updateObj.setPersonalProvidentFundAmount(
+                optionSummary.getOrDefault(HrmSalaryOptionCodeEnum.PERSONAL_PROVIDENT_FUND.getCode(), BigDecimal.ZERO));
+        updateObj.setCorporateInsuranceAmount(
+                optionSummary.getOrDefault(HrmSalaryOptionCodeEnum.CORPORATE_INSURANCE.getCode(), BigDecimal.ZERO));
+        updateObj.setCorporateProvidentFundAmount(
+                optionSummary.getOrDefault(HrmSalaryOptionCodeEnum.CORPORATE_PROVIDENT_FUND.getCode(), BigDecimal.ZERO));
+        monthRecordMapper.updateById(updateObj);
+    }
+
+    private AttendanceImportData buildAttendanceData(
+            HrmAttendanceMonthRecordRespVO attendance, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        if (attendance == null) {
+            return null;
+        }
+        List<HrmSalaryOptionValueVO> optionValues = Arrays.asList(
+                importOptionValue(HrmSalaryOptionCodeEnum.OVERTIME_PAY.getCode(), optionMap, BigDecimal.ZERO),
+                importOptionValue(HrmSalaryOptionCodeEnum.LATE_DEDUCTION.getCode(), optionMap,
+                        defaultIfNull(attendance.getLateDeductAmount(), BigDecimal.ZERO)),
+                importOptionValue(HrmSalaryOptionCodeEnum.EARLY_DEDUCTION.getCode(), optionMap,
+                        defaultIfNull(attendance.getEarlyDeductAmount(), BigDecimal.ZERO)),
+                importOptionValue(HrmSalaryOptionCodeEnum.ABSENTEEISM_DEDUCTION.getCode(), optionMap,
+                        defaultIfNull(attendance.getAbsenteeismDeductAmount(), BigDecimal.ZERO)),
+                importOptionValue(HrmSalaryOptionCodeEnum.LEAVE_DEDUCTION.getCode(), optionMap, BigDecimal.ZERO),
+                importOptionValue(HrmSalaryOptionCodeEnum.MISSING_CARD_DEDUCTION.getCode(), optionMap,
+                        defaultIfNull(attendance.getMisscardDeductAmount(), BigDecimal.ZERO)),
+                importOptionValue(HrmSalaryOptionCodeEnum.COMPREHENSIVE_DEDUCTION.getCode(), optionMap, BigDecimal.ZERO),
+                importOptionValue(HrmSalaryOptionCodeEnum.ATTENDANCE_DEDUCTION_TOTAL.getCode(), optionMap,
+                        defaultIfNull(attendance.getAttendanceDeductAmount(), BigDecimal.ZERO)));
+        return new AttendanceImportData(
+                defaultIfNull(attendance.getActualDays(), BigDecimal.ZERO), optionValues);
+    }
+
+    private List<HrmSalaryOptionValueVO> buildInsuranceOptionValues(
+            HrmInsuranceMonthEmployeeRecordDO insurance, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        if (insurance == null) {
+            return Arrays.asList(
+                    importOptionValue(HrmSalaryOptionCodeEnum.PERSONAL_INSURANCE.getCode(), optionMap, BigDecimal.ZERO),
+                    importOptionValue(HrmSalaryOptionCodeEnum.PERSONAL_PROVIDENT_FUND.getCode(), optionMap, BigDecimal.ZERO),
+                    importOptionValue(HrmSalaryOptionCodeEnum.CORPORATE_INSURANCE.getCode(), optionMap, BigDecimal.ZERO),
+                    importOptionValue(HrmSalaryOptionCodeEnum.CORPORATE_PROVIDENT_FUND.getCode(), optionMap, BigDecimal.ZERO));
+        }
+        return Arrays.asList(
+                importOptionValue(HrmSalaryOptionCodeEnum.PERSONAL_INSURANCE.getCode(), optionMap,
+                        defaultIfNull(insurance.getPersonalInsuranceAmount(), BigDecimal.ZERO)),
+                importOptionValue(HrmSalaryOptionCodeEnum.PERSONAL_PROVIDENT_FUND.getCode(), optionMap,
+                        defaultIfNull(insurance.getPersonalProvidentFundAmount(), BigDecimal.ZERO)),
+                importOptionValue(HrmSalaryOptionCodeEnum.CORPORATE_INSURANCE.getCode(), optionMap,
+                        defaultIfNull(insurance.getCorporateInsuranceAmount(), BigDecimal.ZERO)),
+                importOptionValue(HrmSalaryOptionCodeEnum.CORPORATE_PROVIDENT_FUND.getCode(), optionMap,
+                        defaultIfNull(insurance.getCorporateProvidentFundAmount(), BigDecimal.ZERO)));
+    }
+
+    private Map<String, AttendanceImportData> parseAttendanceImportData(List<Map<Integer, String>> rows,
+                                                                        Map<Integer, HrmSalaryOptionDO> optionMap) {
+        // 1. 无导入数据时直接返回
+        if (CollUtil.isEmpty(rows)) {
+            return Collections.emptyMap();
+        }
+
+        // 2. 按工号解析考勤金额和实际出勤天数
+        List<ImportColumn> columns = getAttendanceImportColumns();
+        Map<String, AttendanceImportData> dataMap = new HashMap<>();
+        for (Map<Integer, String> row : rows) {
+            String jobNumber = getCell(row, 2);
+            if (StrUtil.isBlank(jobNumber)) {
+                continue;
+            }
+            List<HrmSalaryOptionValueVO> values = new ArrayList<>();
+            BigDecimal attendanceDeductionTotal = BigDecimal.ZERO;
+            for (ImportColumn column : columns) {
+                BigDecimal amount = parseAmount(getCell(row, column.getIndex()), BigDecimal.ZERO);
+                values.add(importOptionValue(column.getCode(), optionMap, amount));
+                if (ObjectUtil.notEqual(column.getCode(), HrmSalaryOptionCodeEnum.OVERTIME_PAY.getCode())) {
+                    attendanceDeductionTotal = attendanceDeductionTotal.add(amount);
+                }
+            }
+            values.add(importOptionValue(HrmSalaryOptionCodeEnum.ATTENDANCE_DEDUCTION_TOTAL.getCode(), optionMap, attendanceDeductionTotal));
+            dataMap.put(jobNumber, new AttendanceImportData(parseAmount(getCell(row, 11), BigDecimal.ZERO), values));
+        }
+        return dataMap;
+    }
+
+    /**
+     * 按员工工号解析导入的薪资项金额
+     *
+     * @param rows 导入行数据
+     * @param columns 导入列定义
+     * @param optionMap 薪资项 Map
+     * @return 工号与薪资项金额列表的映射
+     */
+    private Map<String, List<HrmSalaryOptionValueVO>> parseOptionImportData(
+            List<Map<Integer, String>> rows, List<ImportColumn> columns, Map<Integer, HrmSalaryOptionDO> optionMap) {
+        // 1. 无导入数据时直接返回
+        if (CollUtil.isEmpty(rows)) {
+            return Collections.emptyMap();
+        }
+
+        // 2. 按工号解析各导入列对应的薪资项金额
+        Map<String, List<HrmSalaryOptionValueVO>> dataMap = new HashMap<>();
+        for (Map<Integer, String> row : rows) {
+            String jobNumber = getCell(row, 2);
+            if (StrUtil.isBlank(jobNumber)) {
+                continue;
+            }
+            List<HrmSalaryOptionValueVO> values = new ArrayList<>();
+            for (ImportColumn column : columns) {
+                values.add(importOptionValue(column.getCode(), optionMap,
+                        parseAmount(getCell(row, column.getIndex()), BigDecimal.ZERO)));
+            }
+            dataMap.put(jobNumber, values);
+        }
+        return dataMap;
+    }
+
+    private List<ImportColumn> getAttendanceImportColumns() {
+        return Arrays.asList(
+                new ImportColumn(4, HrmSalaryOptionCodeEnum.OVERTIME_PAY.getCode()),
+                new ImportColumn(5, HrmSalaryOptionCodeEnum.LATE_DEDUCTION.getCode()),
+                new ImportColumn(6, HrmSalaryOptionCodeEnum.EARLY_DEDUCTION.getCode()),
+                new ImportColumn(7, HrmSalaryOptionCodeEnum.ABSENTEEISM_DEDUCTION.getCode()),
+                new ImportColumn(8, HrmSalaryOptionCodeEnum.LEAVE_DEDUCTION.getCode()),
+                new ImportColumn(9, HrmSalaryOptionCodeEnum.MISSING_CARD_DEDUCTION.getCode()),
+                new ImportColumn(10, HrmSalaryOptionCodeEnum.COMPREHENSIVE_DEDUCTION.getCode())
+        );
+    }
+
+    private List<ImportColumn> getCumulativeTaxImportColumns() {
+        return Arrays.asList(
+                new ImportColumn(4, HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_INCOME.getCode()),
+                new ImportColumn(5, HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_DEDUCT_EXPENSE.getCode()),
+                new ImportColumn(6, HrmSalaryOptionCodeEnum.LAST_MONTH_CUMULATIVE_SPECIAL_DEDUCTION.getCode()),
+                new ImportColumn(7, HrmSalaryOptionCodeEnum.LAST_MONTH_PREPAID_TAX.getCode())
+        );
+    }
+
+    private List<ImportColumn> getAdditionalDeductionImportColumns() {
+        return Arrays.asList(
+                new ImportColumn(4, HrmSalaryOptionCodeEnum.CHILD_EDUCATION_DEDUCTION.getCode()),
+                new ImportColumn(5, HrmSalaryOptionCodeEnum.HOUSE_RENT_DEDUCTION.getCode()),
+                new ImportColumn(6, HrmSalaryOptionCodeEnum.HOUSE_LOAN_DEDUCTION.getCode()),
+                new ImportColumn(7, HrmSalaryOptionCodeEnum.ELDERLY_SUPPORT_DEDUCTION.getCode()),
+                new ImportColumn(8, HrmSalaryOptionCodeEnum.CONTINUING_EDUCATION_DEDUCTION.getCode())
+        );
+    }
+
+    private HrmSalaryOptionValueVO importOptionValue(Integer code, Map<Integer, HrmSalaryOptionDO> optionMap,
+                                                      BigDecimal amount) {
+        HrmSalaryOptionDO option = optionMap.get(code);
+        HrmSalaryOptionCodeEnum optionCode = HrmSalaryOptionCodeEnum.valueOf(code);
+        String name = option != null ? option.getName() : optionCode != null ? optionCode.getName() : "薪资项" + code;
+        return new HrmSalaryOptionValueVO().setCode(code).setName(name).setValue(amount);
+    }
+
+    private List<HrmSalaryOptionValueVO> mergeOptionValues(
+            List<HrmSalaryOptionValueVO> baseValues,
+            List<HrmSalaryOptionValueVO> importValues) {
+        if (CollUtil.isEmpty(importValues)) {
+            return baseValues;
+        }
+        Map<Integer, HrmSalaryOptionValueVO> valueMap = new LinkedHashMap<>();
+        for (HrmSalaryOptionValueVO value : baseValues) {
+            if (value.getCode() != null) {
+                valueMap.put(value.getCode(), value);
+            }
+        }
+        for (HrmSalaryOptionValueVO value : importValues) {
+            if (value.getCode() != null) {
+                valueMap.put(value.getCode(), value);
+            }
+        }
+        return new ArrayList<>(valueMap.values());
+    }
+
+    private Map<Integer, Long> buildPayrollReadinessChangeTypeCountMap(List<HrmEmployeeChangeRecordDO> changeRecords) {
+        Map<Integer, Long> changeTypeCountMap = new LinkedHashMap<>();
+        changeTypeCountMap.put(HrmEmployeeChangeTypeEnum.REGULAR.getType(), 0L);
+        changeTypeCountMap.put(HrmEmployeeChangeTypeEnum.TRANSFER.getType(), 0L);
+        changeTypeCountMap.put(HrmEmployeeChangeTypeEnum.PROMOTION.getType(), 0L);
+        changeTypeCountMap.put(HrmEmployeeChangeTypeEnum.DEMOTION.getType(), 0L);
+        changeTypeCountMap.put(HrmEmployeeChangeTypeEnum.FULL_TIME.getType(), 0L);
+        for (HrmEmployeeChangeRecordDO changeRecord : changeRecords) {
+            if (changeRecord.getType() == null) {
+                continue;
+            }
+            changeTypeCountMap.merge(changeRecord.getType(), 1L, Long::sum);
+        }
+        return changeTypeCountMap;
+    }
+
+    private LocalDate resolveMonthDay(YearMonth yearMonth, Integer configuredDay, int defaultDay) {
+        int day = configuredDay == null ? defaultDay : configuredDay;
+        return yearMonth.atDay(Math.max(1, Math.min(day, yearMonth.lengthOfMonth())));
+    }
+
+    private YearMonth resolveSocialSecurityYearMonth(YearMonth salaryYearMonth, HrmSalaryConfigDO salaryConfig) {
+        if (salaryConfig == null || salaryConfig.getSocialSecurityMonthType() == null) {
+            return salaryYearMonth;
+        }
+        if (HrmSalarySocialSecurityMonthTypeEnum.PREVIOUS_MONTH.getType().equals(salaryConfig.getSocialSecurityMonthType())) {
+            return salaryYearMonth.minusMonths(1);
+        }
+        if (HrmSalarySocialSecurityMonthTypeEnum.NEXT_MONTH.getType().equals(salaryConfig.getSocialSecurityMonthType())) {
+            return salaryYearMonth.plusMonths(1);
+        }
+        return salaryYearMonth;
+    }
+
+    private List<HrmSalaryMonthRecordDO.OptionHeader> buildOptionHeaderList(List<HrmSalaryOptionDO> options) {
+        Map<Integer, List<HrmSalaryOptionDO>> childrenMap =
+                convertMultiMap(options, HrmSalaryOptionDO::getParentCode);
+        List<HrmSalaryOptionDO> categories =
+                childrenMap.getOrDefault(ROOT_PARENT_CODE, Collections.emptyList());
+        return convertList(categories, category -> {
+            List<HrmSalaryMonthRecordDO.OptionHeader> children = convertList(
+                    childrenMap.getOrDefault(category.getCode(), Collections.emptyList()),
+                    option -> HrmSalaryMonthRecordDO.OptionHeader.builder()
+                            .code(option.getCode()).name(option.getName())
+                            .children(Collections.emptyList()).build());
+            return HrmSalaryMonthRecordDO.OptionHeader.builder()
+                    .code(category.getCode()).name(category.getName()).children(children).build();
+        });
+    }
+
+    /**
+     * 薪资导入列定义
+     */
+    @Getter
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class ImportColumn {
+
+        /**
+         * Excel 列索引
+         */
+        private final int index;
+        /**
+         * 薪资项编码
+         */
+        private final int code;
+
+    }
+
+    /**
+     * 员工考勤导入数据
+     */
+    @Getter
+    @AllArgsConstructor
+    @SuppressWarnings("ClassCanBeRecord")
+    private static class AttendanceImportData {
+
+        /**
+         * 实际出勤天数
+         */
+        private final BigDecimal actualWorkDay;
+        /**
+         * 薪资项金额列表
+         */
+        private final List<HrmSalaryOptionValueVO> optionValues;
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordService.java
new file mode 100644
index 0000000..8695246
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordService.java
@@ -0,0 +1,59 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendEmployeeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipSendRecordDO;
+import jakarta.validation.Valid;
+
+/**
+ * HRM 工资条发放记录 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalarySlipSendRecordService {
+
+    /**
+     * 发放工资条
+     *
+     * @param reqVO 工资条发放信息
+     * @return 工资条发放记录编号
+     */
+    Long sendSalarySlip(@Valid HrmSalarySlipSendReqVO reqVO);
+
+    /**
+     * 获得工资条待发员工分页
+     *
+     * @param reqVO 分页查询
+     * @return 员工月度工资分页
+     */
+    PageResult<HrmSalaryMonthEmployeeRecordDO> getSalarySlipSendEmployeePage(
+            HrmSalarySlipSendEmployeeReqVO reqVO);
+
+    /**
+     * 删除工资条发放记录
+     *
+     * @param id 工资条发放记录编号
+     */
+    void deleteSalarySlipSendRecord(Long id);
+
+    /**
+     * 获得工资条发放记录分页
+     *
+     * @param reqVO 分页查询
+     * @return 工资条发放记录分页
+     */
+    PageResult<HrmSalarySlipSendRecordDO> getSalarySlipSendRecordPage(
+            HrmSalarySlipSendRecordPageReqVO reqVO);
+
+    /**
+     * 获得工资条发放记录
+     *
+     * @param id 发放记录编号
+     * @return 工资条发放记录
+     */
+    HrmSalarySlipSendRecordDO getSalarySlipSendRecord(Long id);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordServiceImpl.java
new file mode 100644
index 0000000..5176982
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordServiceImpl.java
@@ -0,0 +1,210 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.StrUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendEmployeeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipSendRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip.HrmSalarySlipSendRecordMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import com.mzt.logapi.context.LogRecordContext;
+import com.mzt.logapi.starter.annotation.LogRecord;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_EMP_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_EMPLOYEE_ACCOUNT_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_SLIP_DELETE_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_SLIP_DELETE_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_SLIP_SEND_SUB_TYPE;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_SLIP_SEND_SUCCESS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_SALARY_SLIP_TYPE;
+
+/**
+ * HRM 工资条发放记录 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalarySlipSendRecordServiceImpl implements HrmSalarySlipSendRecordService {
+
+    @Resource
+    private HrmSalarySlipSendRecordMapper salarySlipSendRecordMapper;
+
+    @Resource
+    private HrmSalaryMonthRecordService monthRecordService;
+    @Resource
+    private HrmSalaryMonthEmployeeRecordService monthEmployeeRecordService;
+    @Resource
+    private HrmSalarySlipTemplateService salarySlipTemplateService;
+    @Resource
+    private HrmSalarySlipService salarySlipService;
+    @Resource
+    private HrmEmployeeService employeeService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_SLIP_TYPE, subType = HRM_SALARY_SLIP_SEND_SUB_TYPE,
+            bizNo = "{{#salarySlipSendRecord.id}}", success = HRM_SALARY_SLIP_SEND_SUCCESS)
+    public Long sendSalarySlip(HrmSalarySlipSendReqVO reqVO) {
+        // 1.1 校验月度工资表，并构建本次发放的工资条模板快照
+        HrmSalaryMonthRecordDO monthRecord = monthRecordService.validateMonthRecordExistsForUpdate(
+                reqVO.getMonthRecordId());
+        if (Objects.equals(monthRecord.getStatus(), HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus())) {
+            throw exception(SALARY_MONTH_RECORD_STATUS_INVALID);
+        }
+        HrmSalarySlipTemplateDO template = salarySlipTemplateService.buildSalarySlipTemplateSnapshot(
+                reqVO.getHideEmpty(), reqVO.getOptions());
+        // 1.2  筛选本次发放的员工月度工资记录
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords;
+        if (Boolean.TRUE.equals(reqVO.getAll())) {
+            employeeRecords = getSalarySlipSendEmployeeRecordList(reqVO);
+        } else {
+            Set<Long> employeeIds = convertSet(reqVO.getEmployeeIds());
+            employeeRecords = monthEmployeeRecordService.getMonthEmployeeRecordList(new HrmSalaryMonthEmployeeRecordListReqVO()
+                            .setMonthRecordId(reqVO.getMonthRecordId()).setEmployeeIds(employeeIds));
+            Set<Long> monthEmployeeIds = convertSet(
+                    employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+            if (!monthEmployeeIds.containsAll(employeeIds) || monthEmployeeIds.size() != employeeIds.size()) {
+                throw exception(SALARY_MONTH_EMP_RECORD_NOT_EXISTS);
+            }
+        }
+        if (CollUtil.isEmpty(employeeRecords)) {
+            throw exception(SALARY_MONTH_EMP_RECORD_NOT_EXISTS);
+        }
+        // 1.3 仅向已绑定后台账号的员工发放工资条
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId));
+        List<HrmSalaryMonthEmployeeRecordDO> sendableEmployeeRecords = filterList(
+                employeeRecords, employeeRecord -> {
+                    HrmEmployeeDO employee = employeeMap.get(employeeRecord.getEmployeeId());
+                    return employee != null && employee.getUserId() != null;
+                });
+        if (Boolean.FALSE.equals(reqVO.getAll()) && sendableEmployeeRecords.size() != employeeRecords.size()) {
+            throw exception(SALARY_SLIP_EMPLOYEE_ACCOUNT_NOT_EXISTS);
+        }
+        if (CollUtil.isEmpty(sendableEmployeeRecords)) {
+            throw exception(SALARY_SLIP_EMPLOYEE_ACCOUNT_NOT_EXISTS);
+        }
+
+        // 2.1 创建工资条发放记录
+        HrmSalarySlipSendRecordDO salarySlipSendRecord = HrmSalarySlipSendRecordDO.builder()
+                .monthRecordId(reqVO.getMonthRecordId()).employeeCount(monthRecord.getEmployeeCount())
+                .sendEmployeeCount(sendableEmployeeRecords.size()).year(monthRecord.getYear())
+                .month(monthRecord.getMonth()).build();
+        salarySlipSendRecordMapper.insert(salarySlipSendRecord);
+        // 2.2 创建员工工资条
+        salarySlipService.createSalarySlipList(
+                salarySlipSendRecord.getId(), sendableEmployeeRecords, template);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salarySlipSendRecord", salarySlipSendRecord);
+        return salarySlipSendRecord.getId();
+    }
+
+    @Override
+    public PageResult<HrmSalaryMonthEmployeeRecordDO> getSalarySlipSendEmployeePage(
+            HrmSalarySlipSendEmployeeReqVO reqVO) {
+        // 1. 获得月度工资表
+        if (monthRecordService.getMonthRecord(reqVO.getMonthRecordId()) == null) {
+            return PageResult.empty();
+        }
+
+        // 2. 根据员工条件筛选员工编号
+        List<Long> employeeIds = getSalarySlipSendEmployeeIdList(reqVO.getSearch(), reqVO.getDeptId());
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return PageResult.empty();
+        }
+
+        // 3. 查询员工月度工资记录分页
+        HrmSalaryMonthEmployeeRecordPageReqVO pageReqVO = BeanUtils.toBean(reqVO, HrmSalaryMonthEmployeeRecordPageReqVO.class)
+                .setEmployeeIds(employeeIds).setSalarySlipSent(reqVO.getSent());
+        return monthEmployeeRecordService.getMonthEmployeeRecordPage(pageReqVO);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    @LogRecord(type = HRM_SALARY_SLIP_TYPE, subType = HRM_SALARY_SLIP_DELETE_SUB_TYPE,
+            bizNo = "{{#salarySlipSendRecord.id}}", success = HRM_SALARY_SLIP_DELETE_SUCCESS)
+    public void deleteSalarySlipSendRecord(Long id) {
+        // 1. 校验工资条发放记录存在
+        HrmSalarySlipSendRecordDO salarySlipSendRecord = validateSalarySlipSendRecordExists(id);
+
+        // 2. 删除工资条和发放记录
+        salarySlipService.deleteSalarySlipListBySendRecordId(id);
+        salarySlipSendRecordMapper.deleteById(id);
+
+        // 3. 记录操作日志上下文
+        LogRecordContext.putVariable("salarySlipSendRecord", salarySlipSendRecord);
+    }
+
+    @Override
+    public PageResult<HrmSalarySlipSendRecordDO> getSalarySlipSendRecordPage(HrmSalarySlipSendRecordPageReqVO reqVO) {
+        return salarySlipSendRecordMapper.selectPage(reqVO);
+    }
+
+    @Override
+    public HrmSalarySlipSendRecordDO getSalarySlipSendRecord(Long id) {
+        return salarySlipSendRecordMapper.selectById(id);
+    }
+
+    private List<HrmSalaryMonthEmployeeRecordDO> getSalarySlipSendEmployeeRecordList(
+            HrmSalarySlipSendReqVO reqVO) {
+        // 1. 根据员工条件筛选员工编号
+        List<Long> employeeIds = getSalarySlipSendEmployeeIdList(reqVO.getSearch(), reqVO.getDeptId());
+        if (employeeIds != null && CollUtil.isEmpty(employeeIds)) {
+            return Collections.emptyList();
+        }
+
+        // 2. 查询符合发放条件的员工月度工资记录
+        HrmSalaryMonthEmployeeRecordListReqVO listReqVO = new HrmSalaryMonthEmployeeRecordListReqVO()
+                .setMonthRecordId(reqVO.getMonthRecordId()).setEmployeeIds(employeeIds).setSalarySlipSent(reqVO.getSent());
+        return monthEmployeeRecordService.getMonthEmployeeRecordList(listReqVO);
+    }
+
+    private List<Long> getSalarySlipSendEmployeeIdList(String search, Long deptId) {
+        if (StrUtil.isBlank(search) && deptId == null) {
+            return null;
+        }
+        HrmEmployeeListReqVO employeeReqVO = new HrmEmployeeListReqVO().setSearch(search).setDeptId(deptId);
+        List<HrmEmployeeDO> employees = employeeService.getEmployeeList(employeeReqVO);
+        return convertList(employees, HrmEmployeeDO::getId);
+    }
+
+    private HrmSalarySlipSendRecordDO validateSalarySlipSendRecordExists(Long id) {
+        HrmSalarySlipSendRecordDO salarySlipSendRecord = salarySlipSendRecordMapper.selectById(id);
+        if (salarySlipSendRecord == null) {
+            throw exception(SALARY_SLIP_RECORD_NOT_EXISTS);
+        }
+        return salarySlipSendRecord;
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipService.java
new file mode 100644
index 0000000..a3bb24a
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipService.java
@@ -0,0 +1,111 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipRemarkReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import jakarta.validation.Valid;
+
+import java.time.YearMonth;
+import java.util.Collection;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+/**
+ * HRM 工资条 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalarySlipService {
+
+    /**
+     * 创建员工工资条
+     *
+     * @param sendRecordId 发放记录编号
+     * @param employeeRecords 员工月度工资记录列表
+     * @param template 工资条模板快照
+     */
+    void createSalarySlipList(Long sendRecordId, List<HrmSalaryMonthEmployeeRecordDO> employeeRecords,
+                              HrmSalarySlipTemplateDO template);
+
+    /**
+     * 删除发放记录对应的工资条
+     *
+     * @param sendRecordId 发放记录编号
+     */
+    void deleteSalarySlipListBySendRecordId(Long sendRecordId);
+
+    /**
+     * 获得工资条发放记录的已读人数 Map
+     *
+     * @param sendRecordIds 发放记录编号集合
+     * @return 发放记录编号与已读人数的映射
+     */
+    Map<Long, Long> getSalarySlipReadCountMap(Collection<Long> sendRecordIds);
+
+    /**
+     * 获得工资条分页
+     *
+     * @param reqVO 分页查询
+     * @return 工资条分页
+     */
+    PageResult<HrmSalarySlipDO> getSalarySlipPage(HrmSalarySlipPageReqVO reqVO);
+
+    /**
+     * 获得工资条详情
+     *
+     * @param id 工资条编号
+     * @return 工资条详情
+     */
+    HrmSalarySlipDO getSalarySlip(Long id);
+
+    /**
+     * 获得指定员工的工资条列表
+     *
+     * @param employeeId 员工编号
+     * @param startMonth 开始月份
+     * @param endMonth 结束月份
+     * @param orderType 排序字段类型
+     * @param order 排序方式
+     * @return 工资条列表
+     */
+    List<HrmSalarySlipDO> getSalarySlipListByEmployeeId(
+            Long employeeId, YearMonth startMonth, YearMonth endMonth,
+            Integer orderType, Integer order);
+
+    /**
+     * 获得指定员工的工资条详情
+     *
+     * @param id 工资条编号
+     * @param employeeId 员工编号
+     * @return 工资条详情
+     */
+    HrmSalarySlipDO getSalarySlipByIdAndEmployeeId(Long id, Long employeeId);
+
+    /**
+     * 获得已发放工资条的员工月度工资记录编号集合
+     *
+     * @param monthEmployeeRecordIds 员工月度工资记录编号集合
+     * @return 已发放的员工月度工资记录编号集合
+     */
+    Set<Long> getSentMonthEmployeeRecordIdSet(Collection<Long> monthEmployeeRecordIds);
+
+    /**
+     * 标记指定员工的工资条为已读
+     *
+     * @param employeeId 员工编号
+     * @param ids 工资条编号列表
+     */
+    void markSalarySlipListRead(Long employeeId, List<Long> ids);
+
+    /**
+     * 修改工资条备注
+     *
+     * @param reqVO 工资条备注信息
+     */
+    void updateSalarySlipRemark(@Valid HrmSalarySlipRemarkReqVO reqVO);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipServiceImpl.java
new file mode 100644
index 0000000..3b4bcef
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipServiceImpl.java
@@ -0,0 +1,262 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipRemarkReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip.HrmSalarySlipMapper;
+import cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipReadStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipTemplateOptionTypeEnum;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.LinkedHashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.anyMatch;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_ALREADY_SENT;
+
+/**
+ * HRM 工资条 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalarySlipServiceImpl implements HrmSalarySlipService {
+
+    @Resource
+    private HrmSalarySlipMapper salarySlipMapper;
+    @Resource
+    private HrmEmployeeService employeeService;
+    @Resource
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void createSalarySlipList(Long sendRecordId,
+                                     List<HrmSalaryMonthEmployeeRecordDO> employeeRecords,
+                                     HrmSalarySlipTemplateDO template) {
+        // 1. 获得员工和模板快照
+        Map<Long, HrmEmployeeDO> employeeMap = employeeService.getEmployeeMap(
+                convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId));
+        List<HrmSalarySlipTemplateDO.Option> templateOptions = template.getOptions();
+
+        // 2. 构建员工工资条，并保证同一员工月记录只存在一张有效工资条
+        List<HrmSalarySlipDO> salarySlips = convertList(employeeRecords, employeeRecord ->
+                HrmSalarySlipDO.builder()
+                    .sendRecordId(sendRecordId).monthEmployeeRecordId(employeeRecord.getId())
+                    .employeeId(employeeRecord.getEmployeeId()).year(employeeRecord.getYear())
+                    .month(employeeRecord.getMonth()).readStatus(HrmSalarySlipReadStatusEnum.UNREAD.getStatus())
+                    .realPaySalary(employeeRecord.getRealPaySalary()).remark("")
+                    .options(buildSalarySlipOptions(employeeRecord, template, templateOptions)).build());
+        HrmSalaryMonthEmployeeRecordDO firstEmployeeRecord = CollUtil.getFirst(employeeRecords);
+        Set<Long> employeeIds = convertSet(employeeRecords, HrmSalaryMonthEmployeeRecordDO::getEmployeeId);
+        List<HrmSalarySlipDO> sentEmployeeSlips = salarySlipMapper.selectListByEmployeeIdsAndYearMonth(
+                employeeIds,
+                firstEmployeeRecord.getYear(), firstEmployeeRecord.getMonth());
+        if (employeeIds.size() != employeeRecords.size() || CollUtil.isNotEmpty(sentEmployeeSlips)) {
+            throw exception(SALARY_SLIP_ALREADY_SENT);
+        }
+        for (HrmSalarySlipDO salarySlip : salarySlips) {
+            salarySlipMapper.insert(salarySlip);
+        }
+
+        // 3. 逐个发送工资条通知
+        for (HrmSalaryMonthEmployeeRecordDO employeeRecord : employeeRecords) {
+            sendSalarySlipMessage(employeeMap.get(employeeRecord.getEmployeeId()), employeeRecord);
+        }
+    }
+
+    @Override
+    public void deleteSalarySlipListBySendRecordId(Long sendRecordId) {
+        salarySlipMapper.deleteBySendRecordId(sendRecordId);
+    }
+
+    @Override
+    public Map<Long, Long> getSalarySlipReadCountMap(Collection<Long> sendRecordIds) {
+        if (CollUtil.isEmpty(sendRecordIds)) {
+            return Collections.emptyMap();
+        }
+        return salarySlipMapper.selectCountMapBySendRecordIdsAndReadStatus(sendRecordIds, HrmSalarySlipReadStatusEnum.READ.getStatus());
+    }
+
+    @Override
+    public PageResult<HrmSalarySlipDO> getSalarySlipPage(HrmSalarySlipPageReqVO reqVO) {
+        return salarySlipMapper.selectPage(reqVO);
+    }
+
+    @Override
+    public HrmSalarySlipDO getSalarySlip(Long id) {
+        return salarySlipMapper.selectById(id);
+    }
+
+    @Override
+    public List<HrmSalarySlipDO> getSalarySlipListByEmployeeId(
+            Long employeeId, YearMonth startMonth, YearMonth endMonth,
+            Integer orderType, Integer order) {
+        return salarySlipMapper.selectListByEmployeeId(
+                employeeId, startMonth, endMonth, orderType, order);
+    }
+
+    @Override
+    public HrmSalarySlipDO getSalarySlipByIdAndEmployeeId(Long id, Long employeeId) {
+        return validateSalarySlipByEmployeeId(id, employeeId);
+    }
+
+    @Override
+    public Set<Long> getSentMonthEmployeeRecordIdSet(Collection<Long> monthEmployeeRecordIds) {
+        if (CollUtil.isEmpty(monthEmployeeRecordIds)) {
+            return Collections.emptySet();
+        }
+        List<HrmSalarySlipDO> salarySlips =
+                salarySlipMapper.selectListByMonthEmployeeRecordIds(monthEmployeeRecordIds);
+        return convertSet(salarySlips, HrmSalarySlipDO::getMonthEmployeeRecordId);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void markSalarySlipListRead(Long employeeId, List<Long> ids) {
+        // 1. 校验工资条均属于指定员工
+        List<Long> distinctIds = new ArrayList<>(new LinkedHashSet<>(ids));
+        List<HrmSalarySlipDO> salarySlips = salarySlipMapper.selectByIds(distinctIds);
+        if (salarySlips.size() != distinctIds.size()
+                || anyMatch(salarySlips, slip -> ObjectUtil.notEqual(slip.getEmployeeId(), employeeId))) {
+            throw exception(SALARY_SLIP_NOT_EXISTS);
+        }
+
+        // 2. 更新阅读状态
+        salarySlipMapper.updateByIds(distinctIds,
+                new HrmSalarySlipDO().setReadStatus(HrmSalarySlipReadStatusEnum.READ.getStatus()));
+    }
+
+    @Override
+    public void updateSalarySlipRemark(HrmSalarySlipRemarkReqVO reqVO) {
+        // 1. 校验工资条存在
+        validateSalarySlipExists(reqVO.getId());
+
+        // 2. 更新工资条备注
+        salarySlipMapper.updateById(new HrmSalarySlipDO().setId(reqVO.getId()).setRemark(reqVO.getRemark()));
+    }
+
+    private void validateSalarySlipExists(Long id) {
+        if (salarySlipMapper.selectById(id) == null) {
+            throw exception(SALARY_SLIP_NOT_EXISTS);
+        }
+    }
+
+    private HrmSalarySlipDO validateSalarySlipByEmployeeId(Long id, Long employeeId) {
+        HrmSalarySlipDO salarySlip = salarySlipMapper.selectById(id);
+        if (salarySlip == null || ObjectUtil.notEqual(salarySlip.getEmployeeId(), employeeId)) {
+            throw exception(SALARY_SLIP_NOT_EXISTS);
+        }
+        return salarySlip;
+    }
+
+    private List<HrmSalarySlipDO.Option> buildSalarySlipOptions(
+            HrmSalaryMonthEmployeeRecordDO employeeRecord, HrmSalarySlipTemplateDO template,
+            List<HrmSalarySlipTemplateDO.Option> templateOptions) {
+        // 1. 构建薪资项值 Map
+        Map<Integer, HrmSalaryMonthEmployeeRecordDO.OptionValue> valueMap = convertMap(
+                employeeRecord.getOptionValues(), HrmSalaryMonthEmployeeRecordDO.OptionValue::getCode);
+
+        // 2. 获得并排序模板项；空模板按本月薪资项生成默认明细
+        List<HrmSalarySlipTemplateDO.Option> options = convertList(templateOptions, option -> option);
+        if (CollUtil.isEmpty(options)) {
+            options = convertList(valueMap.values(), value -> HrmSalarySlipTemplateDO.Option.builder()
+                            .name(value.getName()).type(HrmSalarySlipTemplateOptionTypeEnum.ITEM.getType()).code(value.getCode())
+                            .hidden(false).sort(value.getCode()).children(Collections.emptyList()).build());
+        }
+        options.sort(Comparator.comparing(item -> item.getSort() == null
+                ? Integer.MAX_VALUE : item.getSort()));
+
+        // 3. 按模板结构生成工资条项
+        boolean hideEmpty = Boolean.TRUE.equals(template.getHideEmpty());
+        List<HrmSalarySlipDO.Option> salarySlipOptions = new ArrayList<>();
+        for (HrmSalarySlipTemplateDO.Option option : options) {
+            if (Boolean.TRUE.equals(option.getHidden())) {
+                continue;
+            }
+            if (ObjectUtil.notEqual(option.getType(), HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType())) {
+                addSalarySlipOptionIfVisible(salarySlipOptions, option, valueMap, hideEmpty);
+                continue;
+            }
+            List<HrmSalarySlipDO.Option> children = new ArrayList<>();
+            List<HrmSalarySlipTemplateDO.Option> templateChildren =
+                    convertList(option.getChildren(), child -> child);
+            templateChildren.sort(Comparator.comparing(item -> item.getSort() == null
+                    ? Integer.MAX_VALUE : item.getSort()));
+            for (HrmSalarySlipTemplateDO.Option child : templateChildren) {
+                addSalarySlipOptionIfVisible(children, child, valueMap, hideEmpty);
+            }
+            if (CollUtil.isNotEmpty(children)) {
+                salarySlipOptions.add(buildSalarySlipOption(option, BigDecimal.ZERO, children));
+            }
+        }
+        return salarySlipOptions;
+    }
+
+    private void addSalarySlipOptionIfVisible(List<HrmSalarySlipDO.Option> options,
+                                              HrmSalarySlipTemplateDO.Option templateOption,
+                                              Map<Integer, HrmSalaryMonthEmployeeRecordDO.OptionValue> valueMap,
+                                              boolean hideEmpty) {
+        if (Boolean.TRUE.equals(templateOption.getHidden())) {
+            return;
+        }
+        HrmSalaryMonthEmployeeRecordDO.OptionValue value = valueMap.get(templateOption.getCode());
+        if (hideEmpty && (value == null || value.getValue().signum() == 0)) {
+            return;
+        }
+        options.add(buildSalarySlipOption(templateOption,
+                value == null ? BigDecimal.ZERO : value.getValue(), Collections.emptyList()));
+    }
+
+    private HrmSalarySlipDO.Option buildSalarySlipOption(HrmSalarySlipTemplateDO.Option option,
+                                                         BigDecimal value,
+                                                         List<HrmSalarySlipDO.Option> children) {
+        return HrmSalarySlipDO.Option.builder()
+                .name(option.getName()).type(option.getType()).code(option.getCode()).value(value)
+                .remark(option.getRemark()).sort(option.getSort()).children(children).build();
+    }
+
+    private void sendSalarySlipMessage(HrmEmployeeDO employee,
+                                       HrmSalaryMonthEmployeeRecordDO employeeRecord) {
+        if (employee == null || employee.getUserId() == null) {
+            return;
+        }
+        Map<String, Object> templateParams = new HashMap<>(4);
+        templateParams.put("employeeName", employee.getName());
+        templateParams.put("year", employeeRecord.getYear());
+        templateParams.put("month", employeeRecord.getMonth());
+        templateParams.put("realSalary", employeeRecord.getRealPaySalary().toPlainString());
+        notifyMessageSendApi.sendSingleMessageToAdmin(new NotifySendSingleToUserReqDTO()
+                .setUserId(employee.getUserId()).setTemplateCode(MessageTemplateConstants.SALARY_SLIP_SENT)
+                .setTemplateParams(templateParams));
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateService.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateService.java
new file mode 100644
index 0000000..7c5fb58
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateService.java
@@ -0,0 +1,64 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateOptionVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import jakarta.validation.Valid;
+
+import java.util.List;
+
+/**
+ * HRM 工资条模板 Service 接口
+ *
+ * @author 芋道源码
+ */
+public interface HrmSalarySlipTemplateService {
+
+    /**
+     * 创建工资条模板
+     *
+     * @param createReqVO 工资条模板信息
+     * @return 工资条模板编号
+     */
+    Long createSalarySlipTemplate(@Valid HrmSalarySlipTemplateSaveReqVO createReqVO);
+
+    /**
+     * 更新工资条模板
+     *
+     * @param updateReqVO 工资条模板信息
+     */
+    void updateSalarySlipTemplate(@Valid HrmSalarySlipTemplateSaveReqVO updateReqVO);
+
+    /**
+     * 删除工资条模板
+     *
+     * @param id 工资条模板编号
+     */
+    void deleteSalarySlipTemplate(Long id);
+
+    /**
+     * 获得工资条模板详情
+     *
+     * @param id 工资条模板编号
+     * @return 工资条模板详情
+     */
+    HrmSalarySlipTemplateDO getSalarySlipTemplate(Long id);
+
+    /**
+     * 获得工资条模板列表
+     *
+     * @return 工资条模板列表
+     */
+    List<HrmSalarySlipTemplateDO> getSalarySlipTemplateList();
+
+    /**
+     * 构建工资条模板快照
+     *
+     * @param hideEmpty 是否隐藏空值
+     * @param options 工资条模板项
+     * @return 工资条模板快照
+     */
+    HrmSalarySlipTemplateDO buildSalarySlipTemplateSnapshot(
+            Boolean hideEmpty, List<HrmSalarySlipTemplateOptionVO> options);
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateServiceImpl.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateServiceImpl.java
new file mode 100644
index 0000000..605b7f1
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateServiceImpl.java
@@ -0,0 +1,371 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.hutool.core.collection.CollUtil;
+import cn.hutool.core.util.ObjectUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.tenant.core.util.TenantUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateOptionVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip.HrmSalarySlipTemplateMapper;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionCodeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipTemplateCategoryEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipTemplateOptionTypeEnum;
+import jakarta.annotation.Resource;
+import org.springframework.stereotype.Service;
+import org.springframework.transaction.annotation.Transactional;
+import org.springframework.validation.annotation.Validated;
+
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Comparator;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSetByFlatMap;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.filterList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getMaxValue;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ADJUSTABLE_CATEGORY_MAX_CODE;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ADJUSTABLE_CATEGORY_MIN_CODE;
+import static cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO.ROOT_PARENT_CODE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_TEMPLATE_NOT_EXISTS;
+
+/**
+ * HRM 工资条模板 Service 实现类
+ *
+ * @author 芋道源码
+ */
+@Service
+@Validated
+public class HrmSalarySlipTemplateServiceImpl implements HrmSalarySlipTemplateService {
+
+    @Resource
+    private HrmSalarySlipTemplateMapper salarySlipTemplateMapper;
+    @Resource
+    private HrmSalaryOptionService salaryOptionService;
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public Long createSalarySlipTemplate(HrmSalarySlipTemplateSaveReqVO createReqVO) {
+        // 1. 构建工资条模板项
+        List<HrmSalarySlipTemplateDO.Option> options =
+                buildSalarySlipTemplateOptions(createReqVO.getOptions());
+
+        // 2. 创建自定义工资条模板
+        HrmSalarySlipTemplateDO template = new HrmSalarySlipTemplateDO()
+                .setName(createReqVO.getName()).setHideEmpty(Boolean.TRUE.equals(createReqVO.getHideEmpty()))
+                .setDefaultStatus(false).setOptions(options);
+        salarySlipTemplateMapper.insert(template);
+        return template.getId();
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void updateSalarySlipTemplate(HrmSalarySlipTemplateSaveReqVO updateReqVO) {
+        // 1.1 校验工资条模板存在且不是默认模板
+        HrmSalarySlipTemplateDO template = validateSalarySlipTemplateExists(updateReqVO.getId());
+        if (Boolean.TRUE.equals(template.getDefaultStatus())) {
+            throw exception(SALARY_DATA_ILLEGAL);
+        }
+        // 1.2 构建工资条模板项
+        List<HrmSalarySlipTemplateDO.Option> options =
+                buildSalarySlipTemplateOptions(updateReqVO.getOptions());
+
+        // 2. 更新自定义工资条模板
+        HrmSalarySlipTemplateDO updateObj = new HrmSalarySlipTemplateDO().setId(updateReqVO.getId())
+                .setName(updateReqVO.getName()).setHideEmpty(Boolean.TRUE.equals(updateReqVO.getHideEmpty()))
+                .setDefaultStatus(false).setOptions(options);
+        salarySlipTemplateMapper.updateById(updateObj);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public void deleteSalarySlipTemplate(Long id) {
+        // 1. 校验工资条模板存在且不是默认模板
+        HrmSalarySlipTemplateDO template = validateSalarySlipTemplateExists(id);
+        if (Boolean.TRUE.equals(template.getDefaultStatus())) {
+            throw exception(SALARY_DATA_ILLEGAL);
+        }
+
+        // 2. 删除工资条模板
+        salarySlipTemplateMapper.deleteById(id);
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public HrmSalarySlipTemplateDO getSalarySlipTemplate(Long id) {
+        HrmSalarySlipTemplateDO template = getSalarySlipTemplateByIdIncludingGlobalDefault(id);
+        return buildDynamicSalarySlipTemplate(
+                template, salaryOptionService.getSalaryOptionList(false));
+    }
+
+    @Override
+    @Transactional(rollbackFor = Exception.class)
+    public List<HrmSalarySlipTemplateDO> getSalarySlipTemplateList() {
+        List<HrmSalarySlipTemplateDO> templates = salarySlipTemplateMapper.selectListByDefaultStatusDesc();
+        if (CollUtil.findOne(templates, template -> Boolean.TRUE.equals(template.getDefaultStatus())) == null) {
+            HrmSalarySlipTemplateDO globalDefaultTemplate = getGlobalDefaultSalarySlipTemplate();
+            if (globalDefaultTemplate != null) {
+                templates.add(0, globalDefaultTemplate);
+            }
+        }
+        List<HrmSalaryOptionDO> salaryOptions = salaryOptionService.getSalaryOptionList(false);
+        return convertList(templates,
+                template -> buildDynamicSalarySlipTemplate(template, salaryOptions));
+    }
+
+    @Override
+    public HrmSalarySlipTemplateDO buildSalarySlipTemplateSnapshot(
+            Boolean hideEmpty, List<HrmSalarySlipTemplateOptionVO> options) {
+        return new HrmSalarySlipTemplateDO()
+                .setHideEmpty(Boolean.TRUE.equals(hideEmpty))
+                .setOptions(buildSalarySlipTemplateOptions(options));
+    }
+
+    // ==================== 动态补全 ====================
+
+    /**
+     * 动态补全工资条模板薪资项
+     *
+     * <p>系统默认模板始终展示当前有效的基本项和明细项；自定义模板保留用户布局，并把模板创建后新增的薪资项放入“未分类科目”。</p>
+     *
+     * @param template 工资条模板
+     * @param salaryOptions 有效薪资项
+     * @return 补全后的工资条模板
+     */
+    private HrmSalarySlipTemplateDO buildDynamicSalarySlipTemplate(
+            HrmSalarySlipTemplateDO template, List<HrmSalaryOptionDO> salaryOptions) {
+        // TODO DONE @AI：按空模板、默认模板、自定义模板三个分支补充方法内业务注释。
+        // 1. 空模板无需补全
+        if (template == null) {
+            return null;
+        }
+
+        // 2. 默认模板始终按当前有效薪资项重建
+        if (Boolean.TRUE.equals(template.getDefaultStatus())) {
+            template.setOptions(buildDefaultSalarySlipTemplateOptions(salaryOptions));
+            return template;
+        }
+
+        // 3. 自定义模板保留原布局，并将新增薪资项归入“未分类科目”
+        List<HrmSalarySlipTemplateDO.Option> templateOptions =
+                copySalarySlipTemplateOptions(template.getOptions());
+        Set<Integer> selectedCodes = convertSetByFlatMap(templateOptions,
+                option -> CollUtil.emptyIfNull(option.getChildren()).stream()
+                        .map(HrmSalarySlipTemplateDO.Option::getCode));
+        selectedCodes.addAll(convertSet(templateOptions, HrmSalarySlipTemplateDO.Option::getCode,
+                option -> ObjectUtil.equal(option.getType(), HrmSalarySlipTemplateOptionTypeEnum.ITEM.getType())));
+        List<HrmSalaryOptionDO> detailOptions = getSalarySlipDetailOptions(salaryOptions);
+        List<HrmSalaryOptionDO> missingOptions = filterList(detailOptions,
+                option -> !selectedCodes.contains(option.getCode()));
+        if (CollUtil.isNotEmpty(missingOptions)) {
+            Set<Integer> usedCodes = convertSet(templateOptions, HrmSalarySlipTemplateDO.Option::getCode);
+            int categoryCode = HrmSalarySlipTemplateCategoryEnum.BASIC.getCode();
+            for (int i = 0; i <= usedCodes.size(); i++) {
+                if (!usedCodes.contains(categoryCode)) {
+                    break;
+                }
+                categoryCode--;
+            }
+            Integer maxSort = getMaxValue(
+                    filterList(templateOptions, option -> option.getSort() != null),
+                    HrmSalarySlipTemplateDO.Option::getSort);
+            int categorySort = (maxSort == null ? 0 : maxSort) + 1;
+            templateOptions.add(HrmSalarySlipTemplateDO.Option.builder()
+                    .name("未分类科目").type(HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType()).code(categoryCode)
+                    .hidden(false).sort(categorySort)
+                    .children(buildSalarySlipTemplateItems(missingOptions)).build());
+        }
+        template.setOptions(templateOptions);
+        return template;
+    }
+
+    /**
+     * 构建系统默认工资条模板项
+     *
+     * @param salaryOptions 有效薪资项
+     * @return 默认工资条模板项
+     */
+    private List<HrmSalarySlipTemplateDO.Option> buildDefaultSalarySlipTemplateOptions(
+            List<HrmSalaryOptionDO> salaryOptions) {
+        // 1. 构建基本项分类
+        List<HrmSalaryOptionDO> basicOptions = filterList(salaryOptions,
+                option -> HrmSalaryOptionCodeEnum.SALARY_SLIP_BASIC_CODES.contains(option.getCode()));
+        basicOptions.sort(Comparator.comparing(HrmSalaryOptionDO::getCode));
+        HrmSalarySlipTemplateDO.Option basicCategory = HrmSalarySlipTemplateDO.Option.builder()
+                .name(HrmSalarySlipTemplateCategoryEnum.BASIC.getName()).type(HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType()).code(HrmSalarySlipTemplateCategoryEnum.BASIC.getCode())
+                .hidden(false).sort(HrmSalarySlipTemplateCategoryEnum.BASIC.getSort()).children(buildSalarySlipTemplateItems(basicOptions)).build();
+
+        // 2. 构建明细项分类
+        HrmSalarySlipTemplateDO.Option detailCategory = HrmSalarySlipTemplateDO.Option.builder()
+                .name(HrmSalarySlipTemplateCategoryEnum.DETAIL.getName()).type(HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType()).code(HrmSalarySlipTemplateCategoryEnum.DETAIL.getCode())
+                .hidden(false).sort(HrmSalarySlipTemplateCategoryEnum.DETAIL.getSort())
+                .children(buildSalarySlipTemplateItems(getSalarySlipDetailOptions(salaryOptions))).build();
+        return Arrays.asList(basicCategory, detailCategory);
+    }
+
+    /**
+     * 获得工资条明细薪资项
+     *
+     * @param salaryOptions 有效薪资项
+     * @return 明细薪资项
+     */
+    private List<HrmSalaryOptionDO> getSalarySlipDetailOptions(List<HrmSalaryOptionDO> salaryOptions) {
+        List<HrmSalaryOptionDO> detailOptions = filterList(salaryOptions,
+                option -> option.getParentCode() != null
+                        && option.getParentCode() >= ADJUSTABLE_CATEGORY_MIN_CODE
+                        && option.getParentCode() <= ADJUSTABLE_CATEGORY_MAX_CODE);
+        detailOptions.sort(Comparator.comparing(HrmSalaryOptionDO::getCode));
+        return detailOptions;
+    }
+
+    /**
+     * 转换工资条模板明细项
+     *
+     * @param salaryOptions 薪资项
+     * @return 工资条模板明细项
+     */
+    private List<HrmSalarySlipTemplateDO.Option> buildSalarySlipTemplateItems(
+            List<HrmSalaryOptionDO> salaryOptions) {
+        List<HrmSalarySlipTemplateDO.Option> options = new ArrayList<>();
+        for (int i = 0; i < salaryOptions.size(); i++) {
+            HrmSalaryOptionDO salaryOption = salaryOptions.get(i);
+            options.add(HrmSalarySlipTemplateDO.Option.builder()
+                    .name(salaryOption.getName()).type(HrmSalarySlipTemplateOptionTypeEnum.ITEM.getType()).code(salaryOption.getCode())
+                    .remark(salaryOption.getRemark()).hidden(false).sort(i + 1)
+                    .children(Collections.emptyList()).build());
+        }
+        return options;
+    }
+
+    /**
+     * 复制工资条模板项，避免动态补全修改持久化对象
+     *
+     * @param options 工资条模板项
+     * @return 复制后的工资条模板项
+     */
+    private List<HrmSalarySlipTemplateDO.Option> copySalarySlipTemplateOptions(
+            List<HrmSalarySlipTemplateDO.Option> options) {
+        return convertList(options, option -> BeanUtils.toBean(option, HrmSalarySlipTemplateDO.Option.class,
+                copy -> copy.setChildren(copySalarySlipTemplateOptions(option.getChildren()))));
+    }
+
+    // ==================== 校验 ====================
+
+    private HrmSalarySlipTemplateDO validateSalarySlipTemplateExists(Long id) {
+        HrmSalarySlipTemplateDO template = getSalarySlipTemplateByIdIncludingGlobalDefault(id);
+        if (template == null) {
+            throw exception(SALARY_SLIP_TEMPLATE_NOT_EXISTS);
+        }
+        return template;
+    }
+
+    /**
+     * 获得租户工资条模板，必要时回退平台级默认模板
+     *
+     * @param id 工资条模板编号
+     * @return 工资条模板
+     */
+    private HrmSalarySlipTemplateDO getSalarySlipTemplateByIdIncludingGlobalDefault(Long id) {
+        HrmSalarySlipTemplateDO template = salarySlipTemplateMapper.selectById(id);
+        if (template != null) {
+            return template;
+        }
+        HrmSalarySlipTemplateDO globalDefaultTemplate = getGlobalDefaultSalarySlipTemplate();
+        return globalDefaultTemplate != null && ObjectUtil.equal(globalDefaultTemplate.getId(), id)
+                ? globalDefaultTemplate : null;
+    }
+
+    /**
+     * 获得平台级默认工资条模板
+     *
+     * @return 平台级默认工资条模板
+     */
+    private HrmSalarySlipTemplateDO getGlobalDefaultSalarySlipTemplate() {
+        return TenantUtils.executeIgnore(salarySlipTemplateMapper::selectGlobalDefaultTemplate);
+    }
+
+    // ==================== 保存模板项 ====================
+
+    /**
+     * 将前端提交的扁平模板节点重建为持久化的两层结构。
+     *
+     * <p>方法会校验节点类型、编码唯一性和父分类引用，并在缺少时补全不可缺少的“实发工资”项，
+     * 最后按排序值输出稳定结果。</p>
+     *
+     * @param optionVOs 前端提交的扁平模板节点
+     * @return 持久化的工资条模板项
+     */
+    private List<HrmSalarySlipTemplateDO.Option> buildSalarySlipTemplateOptions(
+            List<HrmSalarySlipTemplateOptionVO> optionVOs) {
+        List<HrmSalarySlipTemplateOptionVO> sortedOptions = convertList(optionVOs, option -> option);
+        sortedOptions.sort(Comparator.comparing(option -> option.getSort() == null
+                ? Integer.MAX_VALUE : option.getSort()));
+
+        // 1. 校验节点并构建分类
+        List<HrmSalarySlipTemplateDO.Option> options = new ArrayList<>();
+        Map<Integer, HrmSalarySlipTemplateDO.Option> categoryMap = new HashMap<>();
+        Set<Integer> optionCodes = new HashSet<>();
+        for (HrmSalarySlipTemplateOptionVO option : sortedOptions) {
+            if ((ObjectUtil.notEqual(option.getType(), HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType())
+                    && ObjectUtil.notEqual(option.getType(), HrmSalarySlipTemplateOptionTypeEnum.ITEM.getType()))
+                    || option.getCode() == null || !optionCodes.add(option.getCode())) {
+                throw exception(SALARY_DATA_ILLEGAL);
+            }
+            if (ObjectUtil.notEqual(option.getType(), HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType())) {
+                continue;
+            }
+            if (option.getParentCode() != null && ObjectUtil.notEqual(option.getParentCode(), ROOT_PARENT_CODE)) {
+                throw exception(SALARY_DATA_ILLEGAL);
+            }
+            HrmSalarySlipTemplateDO.Option category = buildSalarySlipTemplateOption(option);
+            categoryMap.put(category.getCode(), category);
+            options.add(category);
+        }
+
+        // 2. 将薪资项放入根节点或对应分类
+        for (HrmSalarySlipTemplateOptionVO option : sortedOptions) {
+            if (ObjectUtil.equal(option.getType(), HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType())) {
+                continue;
+            }
+            HrmSalarySlipTemplateDO.Option item = buildSalarySlipTemplateOption(option);
+            HrmSalarySlipTemplateDO.Option category = categoryMap.get(option.getParentCode());
+            if (option.getParentCode() == null || ObjectUtil.equal(option.getParentCode(), ROOT_PARENT_CODE)) {
+                options.add(item);
+            } else if (category == null) {
+                throw exception(SALARY_DATA_ILLEGAL);
+            } else {
+                category.getChildren().add(item);
+            }
+        }
+        if (!optionCodes.contains(HrmSalaryOptionCodeEnum.REAL_PAY.getCode())) {
+            options.add(HrmSalarySlipTemplateDO.Option.builder()
+                    .name(HrmSalaryOptionCodeEnum.REAL_PAY.getName()).type(HrmSalarySlipTemplateOptionTypeEnum.ITEM.getType()).code(HrmSalaryOptionCodeEnum.REAL_PAY.getCode())
+                    .hidden(false).sort(HrmSalaryOptionCodeEnum.REAL_PAY.getCode()).children(Collections.emptyList()).build());
+        }
+        options.sort(Comparator.comparing(option -> option.getSort() == null
+                ? Integer.MAX_VALUE : option.getSort()));
+        return options;
+    }
+
+    private HrmSalarySlipTemplateDO.Option buildSalarySlipTemplateOption(
+            HrmSalarySlipTemplateOptionVO option) {
+        return HrmSalarySlipTemplateDO.Option.builder()
+                .name(option.getName()).type(option.getType()).code(option.getCode()).remark(option.getRemark())
+                .hidden(ObjectUtil.notEqual(option.getCode(), HrmSalaryOptionCodeEnum.REAL_PAY.getCode())
+                        && Boolean.TRUE.equals(option.getHidden()))
+                .sort(option.getSort() == null ? option.getCode() : option.getSort())
+                .children(new ArrayList<>()).build();
+    }
+
+}
diff --git a/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/util/HrmExcelUtils.java b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/util/HrmExcelUtils.java
new file mode 100644
index 0000000..1fa7f3e
--- /dev/null
+++ b/yudao-module-hrm/src/main/java/cn/iocoder/yudao/module/hrm/util/HrmExcelUtils.java
@@ -0,0 +1,96 @@
+package cn.iocoder.yudao.module.hrm.util;
+
+import cn.hutool.core.map.MapUtil;
+import cn.hutool.core.util.NumberUtil;
+import cn.hutool.core.util.StrUtil;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+import java.time.format.DateTimeParseException;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.number.MoneyUtils.priceScale;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.defaultIfNull;
+
+/**
+ * HRM Excel 工具类
+ *
+ * @author 芋道源码
+ */
+public class HrmExcelUtils {
+
+    private static final BigDecimal MAX_AMOUNT = new BigDecimal("9999999.99");
+
+    private static final List<DateTimeFormatter> DATE_FORMATTERS = Arrays.asList(
+            DateTimeFormatter.ISO_LOCAL_DATE,
+            DateTimeFormatter.ofPattern("yyyy/M/d"),
+            DateTimeFormatter.ofPattern("yyyy.M.d"),
+            DateTimeFormatter.BASIC_ISO_DATE);
+
+    /**
+     * 获得并清理单元格文本
+     *
+     * @param row Excel 行
+     * @param index 列下标
+     * @return 单元格文本
+     */
+    public static String getCell(Map<Integer, String> row, int index) {
+        return StrUtil.trim(MapUtil.getStr(row, index, StrUtil.EMPTY));
+    }
+
+    /**
+     * 解析日期
+     *
+     * @param value 导入值
+     * @param defaultValue 空值时的默认日期
+     * @param required 是否必填
+     * @param fieldName 字段名称
+     * @return 日期
+     */
+    public static LocalDate parseDate(
+            String value, LocalDate defaultValue, boolean required, String fieldName) {
+        if (StrUtil.isBlank(value)) {
+            if (required) {
+                throw new IllegalArgumentException("请填写" + fieldName);
+            }
+            return defaultValue;
+        }
+        for (DateTimeFormatter formatter : DATE_FORMATTERS) {
+            try {
+                return LocalDate.parse(value.trim(), formatter);
+            } catch (DateTimeParseException ignored) {
+                // 尝试下一个支持的日期格式
+            }
+        }
+        throw new IllegalArgumentException(fieldName + "格式不正确，请使用 2026-07-01");
+    }
+
+    /**
+     * 解析金额
+     *
+     * @param value 导入值
+     * @param defaultValue 空值时的默认金额
+     * @return 标准化后的金额
+     */
+    public static BigDecimal parseAmount(String value, BigDecimal defaultValue) {
+        if (StrUtil.isBlank(value)) {
+            return defaultIfNull(defaultValue, BigDecimal.ZERO);
+        }
+        String normalizedValue = StrUtil.removeAll(value, ",");
+        if (!NumberUtil.isNumber(normalizedValue)) {
+            throw new IllegalArgumentException("工资数据格式不正确");
+        }
+        BigDecimal amount = NumberUtil.toBigDecimal(normalizedValue);
+        if (amount.abs().compareTo(MAX_AMOUNT) > 0) {
+            throw new IllegalArgumentException("工资数据格式不正确");
+        }
+        return priceScale(amount);
+    }
+
+    private HrmExcelUtils() {
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupServiceImplTest.java
new file mode 100644
index 0000000..4f0fe45
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceGroupServiceImplTest.java
@@ -0,0 +1,266 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseMockitoUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.group.HrmAttendanceGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.config.HrmAttendanceGroupMapper;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceAbsenteeismDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceHolidayTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceLateEarlyDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceMisscardDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmAttendanceGroupServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+public class HrmAttendanceGroupServiceImplTest extends BaseMockitoUnitTest {
+
+    @InjectMocks
+    private HrmAttendanceGroupServiceImpl attendanceGroupService;
+
+    @Mock
+    private HrmAttendanceGroupMapper attendanceGroupMapper;
+
+    @Mock
+    private HrmEmployeeService employeeService;
+
+    @Mock
+    private DeptApi deptApi;
+
+    @Test
+    public void testGetAttendanceGroupMap_employeeAndDeptAndDefaultGroup() {
+        // mock 数据
+        HrmEmployeeDO directEmployee = new HrmEmployeeDO().setId(1L).setDeptId(10L);
+        HrmEmployeeDO deptEmployee = new HrmEmployeeDO().setId(2L).setDeptId(20L);
+        HrmEmployeeDO defaultEmployee = new HrmEmployeeDO().setId(3L).setDeptId(30L);
+        HrmAttendanceGroupDO defaultGroup = new HrmAttendanceGroupDO().setId(100L).setDefaultStatus(true);
+        HrmAttendanceGroupDO directGroup = new HrmAttendanceGroupDO().setId(102L)
+                .setEmployeeIds(Collections.singletonList(directEmployee.getId()));
+        HrmAttendanceGroupDO deptGroup = new HrmAttendanceGroupDO().setId(101L)
+                .setDeptIds(Collections.singletonList(10L));
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(directEmployee.getId(), directEmployee);
+        employeeMap.put(deptEmployee.getId(), deptEmployee);
+        employeeMap.put(defaultEmployee.getId(), defaultEmployee);
+        when(employeeService.getEmployeeMap(Arrays.asList(1L, 2L, 3L))).thenReturn(employeeMap);
+        when(attendanceGroupMapper.selectListOrderByDefaultStatusAndId())
+                .thenReturn(Arrays.asList(defaultGroup, directGroup, deptGroup));
+        when(deptApi.getParentDeptList(10L)).thenReturn(Collections.emptyList());
+        when(deptApi.getParentDeptList(20L)).thenReturn(Collections.singletonList(
+                new DeptRespDTO().setId(10L)));
+        when(deptApi.getParentDeptList(30L)).thenReturn(Collections.emptyList());
+
+        // 调用
+        Map<Long, HrmAttendanceGroupDO> result =
+                attendanceGroupService.getAttendanceGroupMap(Arrays.asList(1L, 2L, 3L));
+
+        // 断言
+        assertEquals(directGroup, result.get(directEmployee.getId()));
+        assertEquals(deptGroup, result.get(deptEmployee.getId()));
+        assertEquals(defaultGroup, result.get(defaultEmployee.getId()));
+        verify(deptApi, times(3)).getParentDeptList(any());
+        verify(deptApi, never()).getDeptList(anyCollection());
+    }
+
+    @Test
+    public void testGetAttendanceGroupShiftMap_specialWorkDateBeforeRestHoliday() {
+        // mock 数据
+        LocalDate attendanceDate = LocalDate.of(2026, 10, 1);
+        HrmAttendanceGroupDO.Shift workShift = HrmAttendanceGroupDO.Shift.builder()
+                .weeks(Collections.singletonList(1))
+                .startTime(LocalTime.of(9, 0)).endTime(LocalTime.of(18, 0)).build();
+        HrmAttendanceGroupDO attendanceGroup = HrmAttendanceGroupDO.builder().rest(true)
+                .shifts(Collections.singletonList(workShift))
+                .specialDates(Collections.singletonList(HrmAttendanceGroupDO.SpecialDate.builder()
+                        .date(attendanceDate.atStartOfDay())
+                        .type(HrmAttendanceHolidayTypeEnum.WORK.getType()).build()))
+                .build();
+        HrmAttendanceHolidayDO holiday = HrmAttendanceHolidayDO.builder()
+                .date(attendanceDate.atStartOfDay())
+                .type(HrmAttendanceHolidayTypeEnum.REST.getType()).build();
+
+        // 调用
+        Map<LocalDate, HrmAttendanceGroupDO.Shift> result =
+                attendanceGroupService.getAttendanceGroupShiftMap(attendanceGroup,
+                        Collections.singletonList(attendanceDate),
+                        Collections.singletonMap(attendanceDate, holiday));
+
+        // 断言
+        assertEquals(workShift, result.get(attendanceDate));
+    }
+
+    @Test
+    public void testGetAttendanceGroupShiftMap_specialRestDateBeforeWorkHoliday() {
+        // mock 数据
+        LocalDate attendanceDate = LocalDate.of(2026, 10, 1);
+        HrmAttendanceGroupDO attendanceGroup = HrmAttendanceGroupDO.builder().rest(true)
+                .shifts(Collections.singletonList(HrmAttendanceGroupDO.Shift.builder()
+                        .weeks(Collections.singletonList(attendanceDate.getDayOfWeek().getValue()))
+                        .startTime(LocalTime.of(9, 0)).endTime(LocalTime.of(18, 0)).build()))
+                .specialDates(Collections.singletonList(HrmAttendanceGroupDO.SpecialDate.builder()
+                        .date(attendanceDate.atStartOfDay())
+                        .type(HrmAttendanceHolidayTypeEnum.REST.getType()).build()))
+                .build();
+        HrmAttendanceHolidayDO holiday = HrmAttendanceHolidayDO.builder()
+                .date(attendanceDate.atStartOfDay())
+                .type(HrmAttendanceHolidayTypeEnum.WORK.getType()).build();
+
+        // 调用
+        Map<LocalDate, HrmAttendanceGroupDO.Shift> result =
+                attendanceGroupService.getAttendanceGroupShiftMap(attendanceGroup,
+                        Collections.singletonList(attendanceDate),
+                        Collections.singletonMap(attendanceDate, holiday));
+
+        // 断言
+        assertNull(result.get(attendanceDate));
+    }
+
+    @Test
+    public void testCreateAttendanceGroup_convertEmbeddedSettings() {
+        // mock 数据
+        when(attendanceGroupMapper.insert(any(HrmAttendanceGroupDO.class))).thenAnswer(invocation -> {
+            HrmAttendanceGroupDO group = invocation.getArgument(0);
+            group.setId(1L);
+            return 1;
+        });
+        when(deptApi.getChildDeptList(anyCollection())).thenReturn(Collections.emptyList());
+        when(attendanceGroupMapper.selectListOrderByDefaultStatusAndId()).thenReturn(Collections.emptyList());
+
+        // 准备参数
+        LocalDateTime specialDate = LocalDate.of(2026, 10, 1).atTime(15, 30);
+        HrmAttendanceGroupSaveReqVO reqVO = new HrmAttendanceGroupSaveReqVO()
+                .setName("考勤组 A")
+                .setOpenWifiCard(true).setOpenPointCard(true).setRest(true)
+                .setDeptIds(Collections.emptyList()).setEmployeeIds(Collections.singletonList(10L))
+                .setSpecialDates(Collections.singletonList(new HrmAttendanceGroupSaveReqVO.SpecialDate()
+                        .setDate(specialDate).setType(HrmAttendanceHolidayTypeEnum.WORK.getType())))
+                .setShifts(Collections.singletonList(new HrmAttendanceGroupSaveReqVO.Shift()
+                        .setWeeks(Arrays.asList(1, 2, 3, 4, 5))
+                        .setStartTime(LocalTime.of(9, 0)).setEndTime(LocalTime.of(18, 0))
+                        .setClockInStartTime(LocalTime.of(8, 0)).setClockInEndTime(LocalTime.of(10, 0))
+                        .setClockOutStartTime(LocalTime.of(17, 0)).setClockOutEndTime(LocalTime.of(20, 0))
+                        .setRestStartTime(LocalTime.of(12, 0)).setRestEndTime(LocalTime.of(13, 0))
+                        .setExcludeRestTime(true)))
+                .setPoints(Collections.singletonList(new HrmAttendanceGroupSaveReqVO.Point()
+                        .setName("总部").setAddress("总部办公区")
+                        .setLatitude(new BigDecimal("39.983424"))
+                        .setLongitude(new BigDecimal("116.322987")).setRadius(300)))
+                .setWifis(Collections.singletonList(new HrmAttendanceGroupSaveReqVO.Wifi()
+                        .setSsid("Office-WiFi").setMac("00:11:22:33:44:55")))
+                .setDeductRule(new HrmAttendanceGroupSaveReqVO.DeductRule()
+                        .setLateMethod(HrmAttendanceLateEarlyDeductMethodEnum.BY_MINUTE.getMethod())
+                        .setLateDeductMoney(BigDecimal.TEN)
+                        .setEarlyMethod(HrmAttendanceLateEarlyDeductMethodEnum.BY_MINUTE.getMethod())
+                        .setEarlyDeductMoney(BigDecimal.TEN)
+                        .setAbsenteeismMethod(HrmAttendanceAbsenteeismDeductMethodEnum.BY_DAY.getMethod())
+                        .setAbsenteeismDeductMoney(BigDecimal.valueOf(100))
+                        .setMisscardMethod(HrmAttendanceMisscardDeductMethodEnum.BY_COUNT.getMethod())
+                        .setMisscardDeductMoney(BigDecimal.valueOf(20)));
+
+        // 调用
+        Long groupId = attendanceGroupService.createAttendanceGroup(reqVO);
+
+        // 断言
+        ArgumentCaptor<HrmAttendanceGroupDO> insertCaptor = ArgumentCaptor.forClass(HrmAttendanceGroupDO.class);
+        verify(attendanceGroupMapper).insert(insertCaptor.capture());
+        HrmAttendanceGroupDO group = insertCaptor.getValue();
+        assertEquals(1L, groupId);
+        assertFalse(group.getDefaultStatus());
+        assertEquals(HrmAttendanceGroupDO.SpecialDate.class, group.getSpecialDates().get(0).getClass());
+        assertEquals(specialDate.toLocalDate().atStartOfDay(), group.getSpecialDates().get(0).getDate());
+        assertEquals(HrmAttendanceGroupDO.Shift.class, group.getShifts().get(0).getClass());
+        assertEquals(reqVO.getShifts().get(0).getStartTime(), group.getShifts().get(0).getStartTime());
+        assertEquals(HrmAttendanceGroupDO.Point.class, group.getPoints().get(0).getClass());
+        assertEquals(reqVO.getPoints().get(0).getLatitude(), group.getPoints().get(0).getLatitude());
+        assertEquals(HrmAttendanceGroupDO.Wifi.class, group.getWifis().get(0).getClass());
+        assertEquals(reqVO.getWifis().get(0).getMac(), group.getWifis().get(0).getMac());
+        assertEquals(HrmAttendanceGroupDO.DeductRule.class, group.getDeductRule().getClass());
+        assertEquals(reqVO.getDeductRule().getLateDeductMoney(), group.getDeductRule().getLateDeductMoney());
+        assertEquals(specialDate, reqVO.getSpecialDates().get(0).getDate());
+    }
+
+    @Test
+    public void testUpdateAttendanceGroup_transferRepeatedScope() {
+        // mock 数据
+        HrmAttendanceGroupDO currentGroup = new HrmAttendanceGroupDO().setId(1L)
+                .setName("考勤组 A").setDeptIds(Collections.emptyList())
+                .setEmployeeIds(Collections.singletonList(10L)).setDefaultStatus(false);
+        HrmAttendanceGroupDO otherGroup = new HrmAttendanceGroupDO().setId(2L)
+                .setName("考勤组 B").setDeptIds(Collections.emptyList())
+                .setEmployeeIds(Arrays.asList(10L, 11L)).setDefaultStatus(false);
+        when(attendanceGroupMapper.selectById(currentGroup.getId())).thenReturn(currentGroup);
+        when(deptApi.getChildDeptList(anyCollection())).thenReturn(Collections.emptyList());
+        when(attendanceGroupMapper.selectListOrderByDefaultStatusAndId())
+                .thenReturn(Arrays.asList(currentGroup, otherGroup));
+        HrmAttendanceGroupSaveReqVO reqVO = new HrmAttendanceGroupSaveReqVO();
+        reqVO.setId(currentGroup.getId());
+        reqVO.setName("修改后的考勤组 A");
+        reqVO.setDeptIds(Collections.emptyList());
+        reqVO.setEmployeeIds(Collections.singletonList(10L));
+        LocalDateTime specialDate = LocalDate.of(2026, 10, 1).atTime(15, 30);
+        reqVO.setSpecialDates(Collections.singletonList(new HrmAttendanceGroupSaveReqVO.SpecialDate()
+                .setDate(specialDate).setType(HrmAttendanceHolidayTypeEnum.WORK.getType())));
+
+        // 调用
+        attendanceGroupService.updateAttendanceGroup(reqVO);
+
+        // 断言
+        ArgumentCaptor<HrmAttendanceGroupDO> updateCaptor =
+                ArgumentCaptor.forClass(HrmAttendanceGroupDO.class);
+        verify(attendanceGroupMapper, times(2)).updateById(updateCaptor.capture());
+        List<HrmAttendanceGroupDO> updateList = updateCaptor.getAllValues();
+        assertEquals(currentGroup.getId(), updateList.get(0).getId());
+        assertEquals(reqVO.getName(), updateList.get(0).getName());
+        assertEquals(specialDate.toLocalDate().atStartOfDay(),
+                updateList.get(0).getSpecialDates().get(0).getDate());
+        assertEquals(specialDate, reqVO.getSpecialDates().get(0).getDate());
+        assertEquals(otherGroup.getId(), updateList.get(1).getId());
+        assertEquals(Collections.singletonList(11L), updateList.get(1).getEmployeeIds());
+        verify(attendanceGroupMapper, never()).insert(any(HrmAttendanceGroupDO.class));
+    }
+
+    @Test
+    public void testDeleteAttendanceGroup_success() {
+        // mock 数据
+        HrmAttendanceGroupDO group =
+                new HrmAttendanceGroupDO().setId(1L).setDefaultStatus(false);
+        when(attendanceGroupMapper.selectById(group.getId())).thenReturn(group);
+
+        // 调用
+        attendanceGroupService.deleteAttendanceGroup(group.getId());
+
+        // 断言
+        verify(attendanceGroupMapper).deleteById(group.getId());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayServiceImplTest.java
new file mode 100644
index 0000000..09ff32e
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/config/HrmAttendanceHolidayServiceImplTest.java
@@ -0,0 +1,242 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidayPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.holiday.HrmAttendanceHolidaySaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceHolidayDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.config.HrmAttendanceHolidayMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_HOLIDAY_DATE_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_HOLIDAY_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+/**
+ * {@link HrmAttendanceHolidayServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmAttendanceHolidayServiceImpl.class)
+public class HrmAttendanceHolidayServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmAttendanceHolidayServiceImpl attendanceHolidayService;
+
+    @Resource
+    private HrmAttendanceHolidayMapper attendanceHolidayMapper;
+
+    @Test
+    public void testCreateAttendanceHoliday_success() {
+        // 准备参数
+        HrmAttendanceHolidaySaveReqVO reqVO = new HrmAttendanceHolidaySaveReqVO();
+        reqVO.setDate(LocalDateTime.of(2026, 10, 1, 9, 0));
+        reqVO.setType(2);
+
+        // 调用
+        Long id = attendanceHolidayService.createAttendanceHoliday(reqVO);
+
+        // 断言
+        HrmAttendanceHolidayDO dbHoliday = attendanceHolidayMapper.selectById(id);
+        assertPojoEquals(reqVO, dbHoliday, "id", "date");
+        assertEquals(reqVO.getDate().toLocalDate().atStartOfDay(), dbHoliday.getDate());
+    }
+
+    @Test
+    public void testCreateAttendanceHoliday_dateDuplicate() {
+        // mock 数据
+        HrmAttendanceHolidayDO dbHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 1, 9, 0), 2);
+        attendanceHolidayMapper.insert(dbHoliday);
+        // 准备参数
+        HrmAttendanceHolidaySaveReqVO reqVO = new HrmAttendanceHolidaySaveReqVO();
+        reqVO.setDate(LocalDateTime.of(2026, 10, 1, 18, 0));
+        reqVO.setType(1);
+
+        // 调用，并断言异常
+        assertServiceException(() -> attendanceHolidayService.createAttendanceHoliday(reqVO),
+                ATTENDANCE_HOLIDAY_DATE_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateAttendanceHoliday_success() {
+        // mock 数据
+        HrmAttendanceHolidayDO dbHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 1, 9, 0), 2);
+        attendanceHolidayMapper.insert(dbHoliday);
+        // 准备参数
+        HrmAttendanceHolidaySaveReqVO reqVO = new HrmAttendanceHolidaySaveReqVO();
+        reqVO.setId(dbHoliday.getId());
+        reqVO.setDate(LocalDateTime.of(2026, 10, 2, 9, 0));
+        reqVO.setType(1);
+
+        // 调用
+        attendanceHolidayService.updateAttendanceHoliday(reqVO);
+
+        // 断言
+        HrmAttendanceHolidayDO updatedHoliday = attendanceHolidayMapper.selectById(dbHoliday.getId());
+        assertPojoEquals(reqVO, updatedHoliday, "date");
+        assertEquals(reqVO.getDate().toLocalDate().atStartOfDay(), updatedHoliday.getDate());
+    }
+
+    @Test
+    public void testUpdateAttendanceHoliday_notExists() {
+        // 准备参数
+        HrmAttendanceHolidaySaveReqVO reqVO = new HrmAttendanceHolidaySaveReqVO();
+        reqVO.setId(randomLongId());
+        reqVO.setDate(LocalDateTime.of(2026, 10, 1, 9, 0));
+        reqVO.setType(2);
+
+        // 调用，并断言异常
+        assertServiceException(() -> attendanceHolidayService.updateAttendanceHoliday(reqVO),
+                ATTENDANCE_HOLIDAY_NOT_EXISTS);
+    }
+
+    @Test
+    public void testUpdateAttendanceHoliday_dateDuplicate() {
+        // mock 数据
+        HrmAttendanceHolidayDO firstHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 1, 9, 0), 2);
+        attendanceHolidayMapper.insert(firstHoliday);
+        HrmAttendanceHolidayDO secondHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 2, 9, 0), 1);
+        attendanceHolidayMapper.insert(secondHoliday);
+        // 准备参数
+        HrmAttendanceHolidaySaveReqVO reqVO = new HrmAttendanceHolidaySaveReqVO();
+        reqVO.setId(firstHoliday.getId());
+        reqVO.setDate(LocalDateTime.of(2026, 10, 2, 18, 0));
+        reqVO.setType(2);
+
+        // 调用，并断言异常
+        assertServiceException(() -> attendanceHolidayService.updateAttendanceHoliday(reqVO),
+                ATTENDANCE_HOLIDAY_DATE_DUPLICATE);
+    }
+
+    @Test
+    public void testDeleteAttendanceHoliday_success() {
+        // mock 数据
+        HrmAttendanceHolidayDO dbHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 1, 9, 0), 2);
+        attendanceHolidayMapper.insert(dbHoliday);
+
+        // 调用
+        attendanceHolidayService.deleteAttendanceHoliday(dbHoliday.getId());
+
+        // 断言
+        assertNull(attendanceHolidayMapper.selectById(dbHoliday.getId()));
+    }
+
+    @Test
+    public void testDeleteAttendanceHoliday_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> attendanceHolidayService.deleteAttendanceHoliday(id),
+                ATTENDANCE_HOLIDAY_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetAttendanceHolidayPage() {
+        // mock 数据
+        HrmAttendanceHolidayDO selectedHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 2, 9, 0), 2);
+        attendanceHolidayMapper.insert(selectedHoliday);
+        attendanceHolidayMapper.insert(randomAttendanceHoliday(
+                LocalDateTime.of(2026, 9, 30, 9, 0), 2));
+        attendanceHolidayMapper.insert(randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 3, 9, 0), 1));
+        HrmAttendanceHolidayDO endBoundaryHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 8, 0, 0), 2);
+        attendanceHolidayMapper.insert(endBoundaryHoliday);
+        attendanceHolidayMapper.insert(randomPojo(HrmAttendanceHolidayDO.class,
+                holiday -> holiday.setId(null).setDate(LocalDateTime.of(2026, 10, 8, 0, 0, 1))
+                        .setType(2).setDeleted(false)));
+        // 准备参数
+        HrmAttendanceHolidayPageReqVO reqVO = new HrmAttendanceHolidayPageReqVO();
+        reqVO.setDate(new LocalDateTime[]{LocalDateTime.of(2026, 10, 1, 0, 0),
+                LocalDateTime.of(2026, 10, 8, 0, 0)});
+        reqVO.setType(2);
+
+        // 调用
+        PageResult<HrmAttendanceHolidayDO> pageResult = attendanceHolidayService.getAttendanceHolidayPage(reqVO);
+
+        // 断言
+        assertEquals(2, pageResult.getTotal());
+        assertEquals(endBoundaryHoliday.getId(), pageResult.getList().get(0).getId());
+        assertPojoEquals(selectedHoliday, pageResult.getList().get(1));
+    }
+
+    @Test
+    public void testGetAttendanceHolidayListByDateRange() {
+        // mock 数据
+        HrmAttendanceHolidayDO firstHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 1, 9, 0), 2);
+        attendanceHolidayMapper.insert(firstHoliday);
+        HrmAttendanceHolidayDO secondHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 2, 18, 0), 1);
+        attendanceHolidayMapper.insert(secondHoliday);
+        HrmAttendanceHolidayDO endBoundaryHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 8, 9, 0), 2);
+        attendanceHolidayMapper.insert(endBoundaryHoliday);
+        attendanceHolidayMapper.insert(randomPojo(HrmAttendanceHolidayDO.class,
+                holiday -> holiday.setId(null).setDate(LocalDateTime.of(2026, 10, 8, 0, 0, 1))
+                        .setType(2).setDeleted(false)));
+
+        // 调用
+        List<HrmAttendanceHolidayDO> result = attendanceHolidayService.getAttendanceHolidayListByDateRange(
+                new LocalDateTime[]{LocalDateTime.of(2026, 10, 1, 0, 0),
+                        LocalDateTime.of(2026, 10, 8, 0, 0)});
+
+        // 断言
+        assertEquals(3, result.size());
+        assertEquals(firstHoliday.getId(), result.get(0).getId());
+        assertEquals(secondHoliday.getId(), result.get(1).getId());
+        assertEquals(endBoundaryHoliday.getId(), result.get(2).getId());
+    }
+
+    @Test
+    public void testGetAttendanceHolidayMap() {
+        // mock 数据
+        HrmAttendanceHolidayDO selectedHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 2, 9, 0), 2);
+        attendanceHolidayMapper.insert(selectedHoliday);
+        HrmAttendanceHolidayDO latestHoliday = randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 2, 18, 0), 1);
+        attendanceHolidayMapper.insert(latestHoliday);
+        attendanceHolidayMapper.insert(randomAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 8, 9, 0), 1));
+
+        // 调用
+        Map<LocalDate, HrmAttendanceHolidayDO> result = attendanceHolidayService.getAttendanceHolidayMap(
+                new LocalDateTime[]{LocalDate.of(2026, 10, 1).atStartOfDay(),
+                        LocalDate.of(2026, 10, 8).atStartOfDay()});
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(latestHoliday.getId(), result.get(LocalDate.of(2026, 10, 2)).getId());
+        assertEquals(LocalDate.of(2026, 10, 8), result.get(LocalDate.of(2026, 10, 8)).getDate().toLocalDate());
+        assertEquals(latestHoliday.getId(), attendanceHolidayService.checkAttendanceHoliday(
+                LocalDateTime.of(2026, 10, 2, 23, 59)).getId());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmAttendanceHolidayDO randomAttendanceHoliday(LocalDateTime date, Integer type) {
+        return randomPojo(HrmAttendanceHolidayDO.class,
+                o -> o.setId(null).setDate(date.toLocalDate().atStartOfDay()).setType(type).setDeleted(false));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockServiceImplTest.java
new file mode 100644
index 0000000..8cbbd61
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceClockServiceImplTest.java
@@ -0,0 +1,407 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.record;
+
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceGroupService;
+import cn.iocoder.yudao.framework.common.exception.ServiceException;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.clock.HrmAttendanceClockSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.attendance.vo.clock.HrmPortalAttendanceClockDetailRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.record.HrmAttendanceClockMapper;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockButtonStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockSourceEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.record.HrmAttendanceClockStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_POINT_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_CLOCK_WIFI_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmAttendanceClockServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmAttendanceClockServiceImpl.class)
+public class HrmAttendanceClockServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmAttendanceClockServiceImpl attendanceClockService;
+
+    @Resource
+    private HrmAttendanceClockMapper attendanceClockMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private HrmAttendanceGroupService attendanceGroupService;
+
+    @Test
+    public void testCreate_sourceAndModifyBoundary() {
+        // 准备参数
+        HrmEmployeeDO employee = createEmployee(10L, "手工打卡员工", 210L);
+        when(employeeService.validateEmployeeExists(employee.getId())).thenReturn(employee);
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(createShift());
+        HrmAttendanceClockSaveReqVO createReqVO = createClockReqVO(employee.getId(),
+                LocalDateTime.of(2026, 7, 18, 9, 10), LocalDateTime.of(2026, 7, 18, 9, 0), 1);
+
+        // 调用
+        Long manualId = attendanceClockService.createAttendanceClock(createReqVO);
+
+        // 断言：管理端新增不能伪造来源和状态
+        HrmAttendanceClockDO manualClock = attendanceClockMapper.selectById(manualId);
+        assertEquals(HrmAttendanceClockSourceEnum.MANUAL.getSource(), manualClock.getSourceType());
+        assertEquals(HrmAttendanceClockStatusEnum.LATE.getStatus(), manualClock.getStatus());
+
+        // ========== 非手工打卡记录 ==========
+        HrmAttendanceClockDO mobileClock = HrmAttendanceClockDO.builder()
+                .employeeId(employee.getId()).type(1)
+                .attendanceTime(LocalDateTime.of(2026, 7, 18, 9, 0))
+                .clockTime(LocalDateTime.of(2026, 7, 18, 9, 0))
+                .sourceType(HrmAttendanceClockSourceEnum.MOBILE.getSource())
+                .status(HrmAttendanceClockStatusEnum.NORMAL.getStatus()).stage(1).build();
+        attendanceClockMapper.insert(mobileClock);
+        HrmAttendanceClockSaveReqVO updateReqVO = createClockReqVO(employee.getId(),
+                LocalDateTime.of(2026, 7, 18, 9, 1), LocalDateTime.of(2026, 7, 18, 9, 0), 1);
+        updateReqVO.setId(mobileClock.getId());
+
+        // 调用，并断言异常：非手工记录不能修改、删除，批量删除不会部分成功
+        assertThrows(ServiceException.class, () -> attendanceClockService.updateAttendanceClock(updateReqVO));
+        assertThrows(ServiceException.class, () -> attendanceClockService.deleteAttendanceClock(mobileClock.getId()));
+        assertThrows(ServiceException.class, () -> attendanceClockService.deleteAttendanceClockList(
+                Arrays.asList(manualId, mobileClock.getId())));
+        assertNotNull(attendanceClockMapper.selectById(manualId));
+        assertNotNull(attendanceClockMapper.selectById(mobileClock.getId()));
+    }
+
+    @Test
+    public void testGetPageList() {
+        // mock 数据
+        HrmEmployeeDO employee = createEmployee(20L, "分页员工", 300L);
+        HrmAttendanceClockDO lateClock = createClock(employee.getId(),
+                LocalDateTime.of(2026, 7, 8, 9, 15), LocalDateTime.of(2026, 7, 8, 9, 0),
+                1, HrmAttendanceClockStatusEnum.LATE.getStatus());
+        HrmAttendanceClockDO earlyClock = createClock(employee.getId(),
+                LocalDateTime.of(2026, 7, 8, 17, 45), LocalDateTime.of(2026, 7, 8, 18, 0),
+                2, HrmAttendanceClockStatusEnum.EARLY.getStatus());
+        attendanceClockMapper.insert(lateClock);
+        attendanceClockMapper.insert(earlyClock);
+        when(employeeService.getEmployeeList(any())).thenReturn(Collections.singletonList(employee));
+
+        // 准备参数
+        HrmAttendanceClockPageReqVO pageReqVO = new HrmAttendanceClockPageReqVO();
+        pageReqVO.setSearch(employee.getJobNumber());
+        pageReqVO.setDeptIds(Collections.singletonList(employee.getDeptId()));
+        pageReqVO.setAddress("总部");
+
+        // 调用，并断言异常
+        assertEquals(2, attendanceClockService.getAttendanceClockPage(pageReqVO).getTotal());
+        List<HrmAttendanceClockDO> clockList = attendanceClockService.getAttendanceClockList(pageReqVO);
+        assertEquals(2, clockList.size());
+        assertEquals(employee.getId(), clockList.get(0).getEmployeeId());
+    }
+
+    @Test
+    public void testGetAttendanceClockListByEmployeeIdAndClockTime() {
+        // mock 数据
+        Long employeeId = 30L;
+        LocalDateTime beginTime = LocalDateTime.of(2026, 8, 1, 0, 0);
+        LocalDateTime endTime = beginTime.plusMonths(1);
+        HrmAttendanceClockDO beginBoundaryClock = createClock(employeeId, beginTime, beginTime,
+                1, HrmAttendanceClockStatusEnum.NORMAL.getStatus());
+        attendanceClockMapper.insert(beginBoundaryClock);
+        HrmAttendanceClockDO innerClock = createClock(employeeId, endTime.minusSeconds(1), endTime.minusSeconds(1),
+                2, HrmAttendanceClockStatusEnum.NORMAL.getStatus());
+        attendanceClockMapper.insert(innerClock);
+        HrmAttendanceClockDO endBoundaryClock = createClock(employeeId, endTime, endTime,
+                1, HrmAttendanceClockStatusEnum.NORMAL.getStatus());
+        attendanceClockMapper.insert(endBoundaryClock);
+
+        // 调用
+        List<HrmAttendanceClockDO> result = attendanceClockService
+                .getAttendanceClockListByEmployeeIdAndClockTime(
+                        employeeId, new LocalDateTime[]{beginTime, endTime});
+
+        // 断言：开始、结束边界都包含
+        assertEquals(3, result.size());
+        assertEquals(beginBoundaryClock.getId(), result.get(0).getId());
+        assertEquals(innerClock.getId(), result.get(1).getId());
+        assertEquals(endBoundaryClock.getId(), result.get(2).getId());
+    }
+
+    @Test
+    public void testDeleteList_deduplicatesAndPrevalidates() {
+        // mock 数据
+        HrmEmployeeDO employee = createEmployee(40L, "批量删除员工", 410L);
+        when(employeeService.validateEmployeeExists(employee.getId())).thenReturn(employee);
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(createShift());
+        LocalDateTime attendanceTime = LocalDateTime.of(2026, 7, 11, 9, 0);
+        Long firstId = attendanceClockService.createAttendanceClock(createClockReqVO(employee.getId(),
+                attendanceTime, attendanceTime, 1));
+        Long secondId = attendanceClockService.createAttendanceClock(createClockReqVO(employee.getId(),
+                attendanceTime.plusHours(9), attendanceTime.plusHours(9), 2));
+        Long retainedId = attendanceClockService.createAttendanceClock(createClockReqVO(employee.getId(),
+                attendanceTime.plusDays(1), attendanceTime.plusDays(1), 1));
+
+        // 调用
+        attendanceClockService.deleteAttendanceClockList(Arrays.asList(firstId, firstId, secondId));
+
+        // 断言
+        assertNull(attendanceClockMapper.selectById(firstId));
+        assertNull(attendanceClockMapper.selectById(secondId));
+        assertNotNull(attendanceClockMapper.selectById(retainedId));
+        assertThrows(ServiceException.class, () -> attendanceClockService.deleteAttendanceClockList(
+                Arrays.asList(retainedId, Long.MAX_VALUE)));
+        assertNotNull(attendanceClockMapper.selectById(retainedId));
+    }
+
+    @Test
+    public void testCreate_validatesShiftClockWindow() {
+        // mock 数据
+        HrmEmployeeDO employee = createEmployee(50L, "班次窗口员工", 510L);
+        when(employeeService.validateEmployeeExists(employee.getId())).thenReturn(employee);
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(createShift());
+
+        // 准备参数：伪造应打卡时间
+        HrmAttendanceClockSaveReqVO invalidScheduledTimeReqVO = createClockReqVO(employee.getId(),
+                LocalDateTime.of(2026, 7, 18, 9, 30), LocalDateTime.of(2026, 7, 18, 9, 30), 1);
+        // 准备参数：实际打卡时间早于允许窗口
+        HrmAttendanceClockSaveReqVO invalidClockTimeReqVO = createClockReqVO(employee.getId(),
+                LocalDateTime.of(2026, 7, 18, 7, 59), LocalDateTime.of(2026, 7, 18, 9, 0), 1);
+
+        // 调用、断言
+        assertThrows(ServiceException.class,
+                () -> attendanceClockService.createAttendanceClock(invalidScheduledTimeReqVO));
+        assertThrows(ServiceException.class,
+                () -> attendanceClockService.createAttendanceClock(invalidClockTimeReqVO));
+        Long boundaryClockId = attendanceClockService.createAttendanceClock(createClockReqVO(employee.getId(),
+                LocalDateTime.of(2026, 7, 18, 8, 0), LocalDateTime.of(2026, 7, 18, 9, 0), 1));
+        assertNotNull(attendanceClockMapper.selectById(boundaryClockId));
+    }
+
+    @Test
+    public void testCreate_supportsCrossDayShiftClockWindow() {
+        // mock 数据
+        HrmEmployeeDO employee = createEmployee(60L, "跨日班次员工", 610L);
+        when(employeeService.validateEmployeeExists(employee.getId())).thenReturn(employee);
+        HrmAttendanceGroupDO.Shift shift = createShift()
+                .setStartTime(LocalTime.of(22, 0)).setEndTime(LocalTime.of(6, 0))
+                .setClockInStartTime(LocalTime.of(20, 0)).setClockInEndTime(LocalTime.of(23, 0))
+                .setClockOutStartTime(LocalTime.of(5, 0)).setClockOutEndTime(LocalTime.of(8, 0));
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(shift);
+
+        // 调用：7 月 18 日夜班的下班卡发生在次日
+        Long clockId = attendanceClockService.createAttendanceClock(createClockReqVO(employee.getId(),
+                LocalDateTime.of(2026, 7, 19, 6, 30), LocalDateTime.of(2026, 7, 19, 6, 0), 2));
+
+        // 断言
+        HrmAttendanceClockDO clock = attendanceClockMapper.selectById(clockId);
+        assertNotNull(clock);
+        assertEquals(HrmAttendanceClockStatusEnum.NORMAL.getStatus(), clock.getStatus());
+    }
+
+    @Test
+    public void testCreateMyAttendanceClock_mobileSourceAndOwner() {
+        // mock 数据：本人 + 全天可打上班卡的班次
+        Long userId = 9001L;
+        HrmEmployeeDO employee = createEmployee(30L, "手机打卡员工", 400L);
+        when(employeeService.validateEmployeeBySelf(userId)).thenReturn(employee);
+        when(attendanceGroupService.getMyAttendanceGroup(employee.getId()))
+                .thenReturn(createGroup(false, false, null, null));
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(createAllDayShift());
+
+        // 调用
+        Long clockId = attendanceClockService.createMyAttendanceClock(userId,
+                new HrmPortalAttendanceClockCreateReqVO());
+
+        // 断言：归属本人，来源固定手机端
+        HrmAttendanceClockDO clock = attendanceClockMapper.selectById(clockId);
+        assertNotNull(clock);
+        assertEquals(employee.getId(), clock.getEmployeeId());
+        assertEquals(HrmAttendanceClockSourceEnum.MOBILE.getSource(), clock.getSourceType());
+        assertEquals(1, clock.getType());
+    }
+
+    @Test
+    public void testCreateMyAttendanceClock_pointValidate() {
+        // mock 数据：仅开启定位打卡
+        Long userId = 9002L;
+        HrmEmployeeDO employee = createEmployee(31L, "定位打卡员工", 401L);
+        HrmAttendanceGroupDO.Point point = HrmAttendanceGroupDO.Point.builder()
+                .name("总部").address("文三路")
+                .latitude(new BigDecimal("30.270000")).longitude(new BigDecimal("120.150000"))
+                .radius(200).build();
+        when(employeeService.validateEmployeeBySelf(userId)).thenReturn(employee);
+        when(attendanceGroupService.getMyAttendanceGroup(employee.getId()))
+                .thenReturn(createGroup(true, false, Collections.singletonList(point), null));
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(createAllDayShift());
+
+        // 准备参数：超出半径
+        HrmPortalAttendanceClockCreateReqVO invalidReqVO = new HrmPortalAttendanceClockCreateReqVO();
+        invalidReqVO.setLatitude(new BigDecimal("30.280000"));
+        invalidReqVO.setLongitude(new BigDecimal("120.160000"));
+        assertServiceException(() -> attendanceClockService.createMyAttendanceClock(userId, invalidReqVO),
+                ATTENDANCE_CLOCK_POINT_INVALID);
+
+        // 准备参数：命中地点
+        HrmPortalAttendanceClockCreateReqVO validReqVO = new HrmPortalAttendanceClockCreateReqVO();
+        validReqVO.setLatitude(new BigDecimal("30.270050"));
+        validReqVO.setLongitude(new BigDecimal("120.150050"));
+        validReqVO.setAddress("总部门口");
+        Long clockId = attendanceClockService.createMyAttendanceClock(userId, validReqVO);
+
+        // 断言
+        HrmAttendanceClockDO clock = attendanceClockMapper.selectById(clockId);
+        assertNotNull(clock);
+        assertEquals(HrmAttendanceClockSourceEnum.MOBILE.getSource(), clock.getSourceType());
+        assertEquals("总部门口", clock.getAddress());
+    }
+
+    @Test
+    public void testCreateMyAttendanceClock_wifiValidate() {
+        // mock 数据：仅开启 WiFi 打卡
+        Long userId = 9003L;
+        HrmEmployeeDO employee = createEmployee(32L, "WiFi打卡员工", 402L);
+        HrmAttendanceGroupDO.Wifi wifi = HrmAttendanceGroupDO.Wifi.builder()
+                .ssid("office_wifi").mac("00:11:22:33:44:55").build();
+        when(employeeService.validateEmployeeBySelf(userId)).thenReturn(employee);
+        when(attendanceGroupService.getMyAttendanceGroup(employee.getId()))
+                .thenReturn(createGroup(false, true, null, Collections.singletonList(wifi)));
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(createAllDayShift());
+
+        // 准备参数：未命中 WiFi
+        HrmPortalAttendanceClockCreateReqVO invalidReqVO = new HrmPortalAttendanceClockCreateReqVO();
+        invalidReqVO.setSsid("guest_wifi");
+        invalidReqVO.setMac("AA:BB:CC:DD:EE:FF");
+        assertServiceException(() -> attendanceClockService.createMyAttendanceClock(userId, invalidReqVO),
+                ATTENDANCE_CLOCK_WIFI_INVALID);
+
+        // 准备参数：MAC 精确命中
+        HrmPortalAttendanceClockCreateReqVO validReqVO = new HrmPortalAttendanceClockCreateReqVO();
+        validReqVO.setMac("00:11:22:33:44:55");
+        Long clockId = attendanceClockService.createMyAttendanceClock(userId, validReqVO);
+
+        // 断言
+        HrmAttendanceClockDO clock = attendanceClockMapper.selectById(clockId);
+        assertNotNull(clock);
+        assertEquals(HrmAttendanceClockSourceEnum.MOBILE.getSource(), clock.getSourceType());
+        assertEquals("00:11:22:33:44:55", clock.getMac());
+    }
+
+    @Test
+    public void testGetMyAttendanceClockDetail_crossDayShift() {
+        // mock 数据：跨日班次的上班卡在昨日，下班卡在今日
+        Long userId = 9004L;
+        HrmEmployeeDO employee = createEmployee(33L, "跨日打卡员工", 403L);
+        HrmAttendanceGroupDO group = createGroup(false, false, null, null);
+        HrmAttendanceGroupDO.Shift shift = createCrossDayShift();
+        when(employeeService.validateEmployeeBySelf(userId)).thenReturn(employee);
+        when(attendanceGroupService.getMyAttendanceGroup(employee.getId())).thenReturn(group);
+        when(attendanceGroupService.getEmployeeAttendanceShift(any(), any())).thenReturn(shift);
+        LocalDateTime now = LocalDateTime.now().withSecond(0).withNano(0);
+        LocalDateTime onDutyAttendanceTime = now.toLocalDate().minusDays(1).atTime(shift.getStartTime());
+        LocalDateTime offDutyAttendanceTime = now.toLocalDate().atTime(shift.getEndTime());
+        attendanceClockMapper.insert(createClock(employee.getId(), onDutyAttendanceTime,
+                onDutyAttendanceTime, 1, HrmAttendanceClockStatusEnum.NORMAL.getStatus()));
+        HrmAttendanceClockDO offDutyClock = createClock(employee.getId(), now,
+                offDutyAttendanceTime, 2, HrmAttendanceClockStatusEnum.NORMAL.getStatus());
+        attendanceClockMapper.insert(offDutyClock);
+
+        // 调用
+        HrmPortalAttendanceClockDetailRespVO detail =
+                attendanceClockService.getMyAttendanceClockDetail(userId);
+
+        // 断言：次日下班卡归属昨日班次，并进入更新打卡状态
+        assertEquals(now.toLocalDate().minusDays(1), detail.getAttendanceDate());
+        assertEquals(HrmAttendanceClockButtonStatusEnum.UPDATE.getStatus(),
+                detail.getNextClock().getButtonStatus());
+        assertEquals(offDutyClock.getClockTime(), detail.getTimeline().get(1).getClockTime());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmEmployeeDO createEmployee(Long id, String name, Long deptId) {
+        return new HrmEmployeeDO().setId(id).setName(name).setJobNumber("NO-" + name)
+                .setDeptId(deptId).setPostName("工程师");
+    }
+
+    private HrmAttendanceClockDO createClock(Long employeeId, LocalDateTime clockTime,
+                                             LocalDateTime attendanceTime, Integer clockType,
+                                             Integer status) {
+        return HrmAttendanceClockDO.builder().employeeId(employeeId).clockTime(clockTime)
+                .attendanceTime(attendanceTime).type(clockType).sourceType(
+                        HrmAttendanceClockSourceEnum.MANUAL.getSource())
+                .status(status).stage(1).address("总部").build();
+    }
+
+    private HrmAttendanceClockSaveReqVO createClockReqVO(Long employeeId, LocalDateTime clockTime,
+                                                          LocalDateTime attendanceTime, Integer clockType) {
+        HrmAttendanceClockSaveReqVO reqVO = new HrmAttendanceClockSaveReqVO();
+        reqVO.setEmployeeId(employeeId);
+        reqVO.setClockTime(clockTime);
+        reqVO.setAttendanceTime(attendanceTime);
+        reqVO.setType(clockType);
+        reqVO.setAddress("总部");
+        return reqVO;
+    }
+
+    private HrmAttendanceGroupDO.Shift createShift() {
+        return HrmAttendanceGroupDO.Shift.builder()
+                .weeks(Arrays.asList(1, 2, 3, 4, 5))
+                .startTime(LocalTime.of(9, 0)).endTime(LocalTime.of(18, 0))
+                .clockInStartTime(LocalTime.of(8, 0)).clockInEndTime(LocalTime.of(10, 0))
+                .clockOutStartTime(LocalTime.of(17, 0)).clockOutEndTime(LocalTime.of(19, 0))
+                .restStartTime(LocalTime.of(12, 0)).restEndTime(LocalTime.of(13, 0))
+                .excludeRestTime(true).build();
+    }
+
+    /** 全天可打卡班次，避免单测依赖当前时刻落在固定窗口内 */
+    private HrmAttendanceGroupDO.Shift createAllDayShift() {
+        return HrmAttendanceGroupDO.Shift.builder()
+                .weeks(Arrays.asList(1, 2, 3, 4, 5, 6, 7))
+                .startTime(LocalTime.of(9, 0)).endTime(LocalTime.of(18, 0))
+                .clockInStartTime(LocalTime.of(0, 0)).clockInEndTime(LocalTime.of(23, 59))
+                .clockOutStartTime(LocalTime.of(0, 0)).clockOutEndTime(LocalTime.of(23, 59))
+                .restStartTime(LocalTime.of(12, 0)).restEndTime(LocalTime.of(13, 0))
+                .excludeRestTime(true).build();
+    }
+
+    private HrmAttendanceGroupDO.Shift createCrossDayShift() {
+        return HrmAttendanceGroupDO.Shift.builder()
+                .weeks(Arrays.asList(1, 2, 3, 4, 5, 6, 7))
+                .startTime(LocalTime.of(23, 0)).endTime(LocalTime.of(22, 0))
+                .clockInStartTime(LocalTime.MIN).clockInEndTime(LocalTime.of(23, 59))
+                .clockOutStartTime(LocalTime.MIN).clockOutEndTime(LocalTime.of(23, 59))
+                .restStartTime(LocalTime.of(12, 0)).restEndTime(LocalTime.of(13, 0))
+                .excludeRestTime(true).build();
+    }
+
+    private HrmAttendanceGroupDO createGroup(boolean openPointCard, boolean openWifiCard,
+                                             List<HrmAttendanceGroupDO.Point> points,
+                                             List<HrmAttendanceGroupDO.Wifi> wifis) {
+        return HrmAttendanceGroupDO.builder()
+                .id(1L).name("默认考勤组").openPointCard(openPointCard).openWifiCard(openWifiCard)
+                .points(points).wifis(wifis).defaultStatus(true).build();
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveServiceImplTest.java
new file mode 100644
index 0000000..9cf0a9a
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/record/HrmAttendanceLeaveServiceImplTest.java
@@ -0,0 +1,310 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.record;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.bpm.api.task.BpmProcessInstanceApi;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCancelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeaveCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.leave.HrmAttendanceLeavePageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.attendance.record.HrmAttendanceLeaveMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.bpm.enums.task.BpmProcessInstanceStatusEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.ATTENDANCE_LEAVE_TIME_CONFLICT;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmAttendanceLeaveServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmAttendanceLeaveServiceImpl.class)
+public class HrmAttendanceLeaveServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmAttendanceLeaveServiceImpl attendanceLeaveService;
+    @Resource
+    private HrmAttendanceLeaveMapper attendanceLeaveMapper;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private BpmProcessInstanceApi processInstanceApi;
+
+    @Test
+    public void testCreateLeave_success() {
+        // mock 数据
+        Long userId = randomLongId();
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(randomLongId())
+                .setDeptId(randomLongId()).setName("张三");
+        when(employeeService.validateEmployeeBySelf(userId)).thenReturn(employee);
+        when(processInstanceApi.createProcessInstance(eq(userId), any())).thenReturn("leave-process");
+
+        // 准备参数
+        HrmAttendanceLeaveCreateReqVO reqVO = new HrmAttendanceLeaveCreateReqVO();
+        reqVO.setType("年假");
+        reqVO.setStartTime(LocalDateTime.of(2026, 8, 1, 9, 0));
+        reqVO.setEndTime(LocalDateTime.of(2026, 8, 1, 18, 0));
+        reqVO.setDay(new BigDecimal("1.00"));
+        reqVO.setReason("个人事务");
+
+        // 调用
+        Long id = attendanceLeaveService.createLeave(userId, reqVO);
+
+        // 断言
+        HrmAttendanceLeaveDO attendanceLeave = attendanceLeaveMapper.selectById(id);
+        assertNotNull(attendanceLeave);
+        assertEquals(employee.getId(), attendanceLeave.getEmployeeId());
+        assertEquals(0, reqVO.getDay().compareTo(attendanceLeave.getDay()));
+        assertEquals(BpmProcessInstanceStatusEnum.RUNNING.getStatus(), attendanceLeave.getApprovalStatus());
+        assertEquals("leave-process", attendanceLeave.getProcessInstanceId());
+        verify(employeeService).validateEmployeeExistsForUpdate(employee.getId());
+    }
+
+    @Test
+    public void testCreateLeave_timeConflict() {
+        // mock 数据
+        Long userId = randomLongId();
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(randomLongId())
+                .setDeptId(randomLongId()).setName("张三");
+        when(employeeService.validateEmployeeBySelf(userId)).thenReturn(employee);
+        when(processInstanceApi.createProcessInstance(eq(userId), any())).thenReturn("leave-process");
+
+        // 准备参数
+        HrmAttendanceLeaveCreateReqVO reqVO = new HrmAttendanceLeaveCreateReqVO();
+        reqVO.setType("年假");
+        reqVO.setStartTime(LocalDateTime.of(2026, 8, 1, 9, 0));
+        reqVO.setEndTime(LocalDateTime.of(2026, 8, 1, 18, 0));
+        reqVO.setDay(new BigDecimal("1.00"));
+        reqVO.setReason("个人事务");
+        attendanceLeaveService.createLeave(userId, reqVO);
+
+        // 调用，并断言异常
+        assertServiceException(() -> attendanceLeaveService.createLeave(userId, reqVO),
+                ATTENDANCE_LEAVE_TIME_CONFLICT);
+    }
+
+    @Test
+    public void testCancelLeave_success() {
+        // mock 数据
+        Long userId = randomLongId();
+        Long employeeId = randomLongId();
+        when(employeeService.validateEmployeeBySelf(userId)).thenReturn(
+                new HrmEmployeeDO().setId(employeeId));
+        HrmAttendanceLeaveDO attendanceLeave = randomAttendanceLeaveDO(employeeId, "年假",
+                LocalDateTime.of(2026, 8, 1, 9, 0), BpmProcessInstanceStatusEnum.RUNNING.getStatus());
+        attendanceLeaveMapper.insert(attendanceLeave);
+
+        // 准备参数
+        HrmAttendanceLeaveCancelReqVO reqVO = new HrmAttendanceLeaveCancelReqVO();
+        reqVO.setId(attendanceLeave.getId());
+        reqVO.setReason("行程取消");
+
+        // 调用
+        attendanceLeaveService.cancelLeave(userId, reqVO);
+
+        // 断言
+        verify(processInstanceApi).cancelProcessInstanceByStartUser(
+                userId, attendanceLeave.getProcessInstanceId(), "行程取消");
+        HrmAttendanceLeaveDO result = attendanceLeaveMapper.selectById(attendanceLeave.getId());
+        assertEquals(BpmProcessInstanceStatusEnum.CANCEL.getStatus(), result.getApprovalStatus());
+        assertEquals("行程取消", result.getApprovalReason());
+        assertNotNull(result.getApprovalTime());
+    }
+
+    @Test
+    public void testUpdateLeaveApprovalStatus_success() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmAttendanceLeaveDO attendanceLeave = randomAttendanceLeaveDO(employeeId, "年假",
+                LocalDateTime.of(2026, 8, 1, 9, 0), BpmProcessInstanceStatusEnum.RUNNING.getStatus());
+        attendanceLeave.setProcessInstanceId("leave-process");
+        attendanceLeaveMapper.insert(attendanceLeave);
+
+        // 调用
+        attendanceLeaveService.updateLeaveApprovalStatus(
+                attendanceLeave.getId(), "leave-process", BpmProcessInstanceStatusEnum.APPROVE.getStatus(), "同意");
+
+        // 断言
+        HrmAttendanceLeaveDO result = attendanceLeaveMapper.selectById(attendanceLeave.getId());
+        assertEquals(BpmProcessInstanceStatusEnum.APPROVE.getStatus(), result.getApprovalStatus());
+        assertEquals("同意", result.getApprovalReason());
+        assertNotNull(result.getApprovalTime());
+
+        // 重复终态回调不能覆盖首次审批结果
+        attendanceLeaveService.updateLeaveApprovalStatus(
+                attendanceLeave.getId(), "leave-process",
+                BpmProcessInstanceStatusEnum.REJECT.getStatus(), "驳回");
+        result = attendanceLeaveMapper.selectById(attendanceLeave.getId());
+        assertEquals(BpmProcessInstanceStatusEnum.APPROVE.getStatus(), result.getApprovalStatus());
+        assertEquals("同意", result.getApprovalReason());
+    }
+
+    @Test
+    public void testUpdateLeaveApprovalStatus_processInstanceNotMatch() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmAttendanceLeaveDO attendanceLeave = randomAttendanceLeaveDO(employeeId, "年假",
+                LocalDateTime.of(2026, 8, 1, 9, 0), BpmProcessInstanceStatusEnum.RUNNING.getStatus());
+        attendanceLeave.setProcessInstanceId("current-process");
+        attendanceLeaveMapper.insert(attendanceLeave);
+
+        // 调用
+        attendanceLeaveService.updateLeaveApprovalStatus(
+                attendanceLeave.getId(), "expired-process", BpmProcessInstanceStatusEnum.APPROVE.getStatus(), "同意");
+
+        // 断言
+        HrmAttendanceLeaveDO result = attendanceLeaveMapper.selectById(attendanceLeave.getId());
+        assertEquals(BpmProcessInstanceStatusEnum.RUNNING.getStatus(), result.getApprovalStatus());
+        assertEquals("current-process", result.getProcessInstanceId());
+    }
+
+    @Test
+    public void testGetAttendanceLeavePage() {
+        // mock 数据
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(randomLongId()).setName("张三");
+        HrmAttendanceLeaveDO leave = randomAttendanceLeaveDO(employee.getId(), "年假",
+                LocalDateTime.of(2026, 8, 1, 9, 0), BpmProcessInstanceStatusEnum.RUNNING.getStatus());
+        attendanceLeaveMapper.insert(leave);
+        when(employeeService.getEmployeeList(any())).thenReturn(Collections.singletonList(employee));
+
+        // 准备参数
+        HrmAttendanceLeavePageReqVO reqVO = new HrmAttendanceLeavePageReqVO();
+        reqVO.setEmployeeId(employee.getId());
+
+        // 调用
+        HrmAttendanceLeaveDO result = attendanceLeaveService.getAttendanceLeavePage(reqVO).getList().get(0);
+
+        // 断言
+        assertEquals(leave.getId(), result.getId());
+    }
+
+    @Test
+    public void testGetAttendanceLeaveListByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        LocalDateTime beginTime = LocalDateTime.of(2026, 8, 1, 0, 0);
+        HrmAttendanceLeaveDO approvedLeave = randomAttendanceLeaveDO(employeeId, "年假",
+                beginTime.plusHours(9), BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+        attendanceLeaveMapper.insert(approvedLeave);
+        HrmAttendanceLeaveDO secondApprovedLeave = randomAttendanceLeaveDO(employeeId, "病假",
+                beginTime.plusDays(1).plusHours(9), BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+        attendanceLeaveMapper.insert(secondApprovedLeave);
+        attendanceLeaveMapper.insert(randomAttendanceLeaveDO(employeeId, "事假",
+                beginTime.plusDays(2).plusHours(9), BpmProcessInstanceStatusEnum.RUNNING.getStatus()));
+        attendanceLeaveMapper.insert(randomAttendanceLeaveDO(randomLongId(), "年假",
+                beginTime.plusHours(9), BpmProcessInstanceStatusEnum.APPROVE.getStatus()));
+
+        // 调用
+        List<HrmAttendanceLeaveDO> leaves =
+                attendanceLeaveService.getAttendanceLeaveListByEmployeeId(employeeId);
+        List<HrmAttendanceLeaveDO> effectiveLeaves =
+                attendanceLeaveService.getEffectiveAttendanceLeaveListByEmployeeId(employeeId);
+
+        // 断言
+        assertEquals(3, leaves.size());
+        assertEquals(2, effectiveLeaves.size());
+        assertEquals(secondApprovedLeave.getId(), effectiveLeaves.get(0).getId());
+        assertEquals(approvedLeave.getId(), effectiveLeaves.get(1).getId());
+    }
+
+    @Test
+    public void testGetEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange() {
+        // mock 数据
+        Long firstEmployeeId = randomLongId();
+        Long secondEmployeeId = randomLongId();
+        LocalDateTime beginTime = LocalDateTime.of(2026, 8, 1, 0, 0);
+        LocalDateTime endTime = beginTime.plusMonths(1);
+        HrmAttendanceLeaveDO firstLeave = randomAttendanceLeaveDO(firstEmployeeId, "年假",
+                beginTime.plusHours(9), BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+        attendanceLeaveMapper.insert(firstLeave);
+        HrmAttendanceLeaveDO secondLeave = randomAttendanceLeaveDO(secondEmployeeId, "病假",
+                endTime.minusDays(1).plusHours(9), BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+        attendanceLeaveMapper.insert(secondLeave);
+        // 请假开始时间早于查询左边界，但结束时间落在范围内，仍属于双闭区间重叠
+        HrmAttendanceLeaveDO boundaryOverlapLeave = randomAttendanceLeaveDO(firstEmployeeId, "调休",
+                beginTime.minusHours(4), BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+        attendanceLeaveMapper.insert(boundaryOverlapLeave);
+        // 双闭区间首尾相接也属于重叠
+        HrmAttendanceLeaveDO leftBoundaryLeave = randomAttendanceLeaveDO(firstEmployeeId, "事假",
+                beginTime.minusHours(8), BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+        attendanceLeaveMapper.insert(leftBoundaryLeave);
+        HrmAttendanceLeaveDO rightBoundaryLeave = randomAttendanceLeaveDO(firstEmployeeId, "事假",
+                endTime, BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+        attendanceLeaveMapper.insert(rightBoundaryLeave);
+        attendanceLeaveMapper.insert(randomAttendanceLeaveDO(firstEmployeeId, "事假",
+                beginTime.minusDays(2), BpmProcessInstanceStatusEnum.APPROVE.getStatus()));
+        attendanceLeaveMapper.insert(randomAttendanceLeaveDO(firstEmployeeId, "事假",
+                beginTime.plusDays(1), BpmProcessInstanceStatusEnum.RUNNING.getStatus()));
+
+        // 调用
+        List<HrmAttendanceLeaveDO> result =
+                attendanceLeaveService.getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(
+                        Arrays.asList(firstEmployeeId, secondEmployeeId),
+                        new LocalDateTime[]{beginTime, endTime});
+
+        // 断言
+        assertEquals(5, result.size());
+        assertEquals(rightBoundaryLeave.getId(), result.get(0).getId());
+        assertEquals(secondLeave.getId(), result.get(1).getId());
+        assertEquals(firstLeave.getId(), result.get(2).getId());
+        assertEquals(boundaryOverlapLeave.getId(), result.get(3).getId());
+        assertEquals(leftBoundaryLeave.getId(), result.get(4).getId());
+    }
+
+    @Test
+    public void testGetAttendanceLeaveList() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        LocalDateTime startTime = LocalDateTime.of(2026, 8, 1, 9, 0);
+        attendanceLeaveMapper.insert(randomAttendanceLeaveDO(
+                employeeId, "年假", startTime, BpmProcessInstanceStatusEnum.APPROVE.getStatus()));
+        attendanceLeaveMapper.insert(randomAttendanceLeaveDO(
+                employeeId, "年假", startTime.plusDays(1), BpmProcessInstanceStatusEnum.RUNNING.getStatus()));
+        attendanceLeaveMapper.insert(randomAttendanceLeaveDO(
+                employeeId, "病假", startTime.plusDays(2), BpmProcessInstanceStatusEnum.APPROVE.getStatus()));
+        when(employeeService.getEmployeeList(any())).thenReturn(
+                Collections.singletonList(new HrmEmployeeDO().setId(employeeId)));
+
+        // 准备参数
+        HrmAttendanceLeavePageReqVO reqVO = new HrmAttendanceLeavePageReqVO();
+        reqVO.setEmployeeId(employeeId);
+        reqVO.setTypes(Collections.singletonList("年假"));
+        reqVO.setApprovalStatus(BpmProcessInstanceStatusEnum.APPROVE.getStatus());
+
+        // 调用
+        List<HrmAttendanceLeaveDO> leaves = attendanceLeaveService.getAttendanceLeaveList(reqVO);
+
+        // 断言
+        assertEquals(1, leaves.size());
+    }
+
+    // ========== 随机对象 ==========
+
+    private static HrmAttendanceLeaveDO randomAttendanceLeaveDO(
+            Long employeeId, String type, LocalDateTime startTime, Integer approvalStatus) {
+        return randomPojo(HrmAttendanceLeaveDO.class, leave -> leave.setId(null).setEmployeeId(employeeId)
+                .setType(type).setStartTime(startTime).setEndTime(startTime.plusHours(8))
+                .setDay(new BigDecimal("1.00")).setApprovalStatus(approvalStatus)
+                .setProcessInstanceId(employeeId + "-" + startTime).setDeleted(false));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsServiceImplTest.java
new file mode 100644
index 0000000..7bbe261
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/attendance/statistics/HrmAttendanceStatisticsServiceImplTest.java
@@ -0,0 +1,480 @@
+package cn.iocoder.yudao.module.hrm.service.attendance.statistics;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseMockitoUnitTest;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceDailyDetailRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.config.HrmAttendanceGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceLeaveDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.enums.attendance.config.HrmAttendanceLateEarlyDeductMethodEnum;
+import cn.iocoder.yudao.module.hrm.enums.attendance.statistics.HrmAttendanceResultEnum;
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceGroupService;
+import cn.iocoder.yudao.module.hrm.service.attendance.config.HrmAttendanceHolidayService;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceClockService;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceLeaveService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.LocalTime;
+import java.util.ArrayList;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmAttendanceStatisticsServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+public class HrmAttendanceStatisticsServiceImplTest extends BaseMockitoUnitTest {
+
+    @InjectMocks
+    private HrmAttendanceStatisticsServiceImpl attendanceStatisticsService;
+
+    @Mock
+    private HrmAttendanceClockService attendanceClockService;
+    @Mock
+    private HrmEmployeeService employeeService;
+    @Mock
+    private HrmAttendanceLeaveService attendanceLeaveService;
+    @Mock
+    private HrmAttendanceGroupService attendanceGroupService;
+    @Mock
+    private HrmAttendanceHolidayService attendanceHolidayService;
+
+    @Test
+    public void testGetAttendanceMonthRecordPage_fullAttendanceFilterUsesMemoryPage() {
+        // mock 数据
+        List<HrmEmployeeDO> employees = new ArrayList<>();
+        for (long id = 1L; id <= 201L; id++) {
+            employees.add(new HrmEmployeeDO().setId(id).setName("员工" + id)
+                    .setEntryTime(LocalDateTime.of(2026, 1, 1, 9, 0)));
+        }
+        when(employeeService.getEmployeeList(any(HrmEmployeeListReqVO.class))).thenReturn(employees);
+        when(attendanceGroupService.getAttendanceGroupMap(any())).thenReturn(Collections.emptyMap());
+        when(attendanceHolidayService.getAttendanceHolidayMap(any())).thenReturn(Collections.emptyMap());
+        when(attendanceLeaveService.getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(any(), any()))
+                .thenReturn(Collections.emptyList());
+        HrmAttendanceMonthRecordPageReqVO reqVO = new HrmAttendanceMonthRecordPageReqVO();
+        reqVO.setYear(2026).setMonth(7).setFullAttendance(false);
+        reqVO.setPageNo(2).setPageSize(10);
+
+        // 调用
+        PageResult<HrmAttendanceMonthRecordRespVO> result =
+                attendanceStatisticsService.getAttendanceMonthRecordPage(reqVO);
+
+        // 断言
+        assertEquals(201L, result.getTotal());
+        assertEquals(10, result.getList().size());
+        assertEquals(11L, result.getList().get(0).getEmployeeId());
+        assertEquals(20L, result.getList().get(9).getEmployeeId());
+        verify(employeeService).getEmployeeList(any(HrmEmployeeListReqVO.class));
+    }
+
+    @Test
+    public void testGetAttendanceMonthRecordList_actualDaysUsesNetWorkDays() {
+        // mock 数据
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(1L).setName("张三")
+                .setEntryTime(LocalDate.of(2026, 1, 1).atStartOfDay());
+        HrmAttendanceGroupDO attendanceGroup = new HrmAttendanceGroupDO().setId(10L);
+        when(employeeService.getEmployeeMap(any()))
+                .thenReturn(Collections.singletonMap(employee.getId(), employee));
+        when(attendanceGroupService.getAttendanceGroupMap(Collections.singletonList(employee.getId())))
+                .thenReturn(Collections.singletonMap(employee.getId(), attendanceGroup));
+        when(attendanceGroupService.getAttendanceGroupShiftMap(any(), any(), any()))
+                .thenReturn(Collections.singletonMap(attendanceDate, standardShift()));
+        when(attendanceHolidayService.getAttendanceHolidayMap(any())).thenReturn(Collections.emptyMap());
+        when(attendanceClockService.getAttendanceClockListByEmployeeIdsAndClockTime(any(), any()))
+                .thenReturn(Collections.singletonList(
+                        clock(attendanceDate.atTime(18, 0), 2).setEmployeeId(employee.getId())));
+        when(attendanceLeaveService.getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(any(), any()))
+                .thenReturn(Collections.singletonList(
+                        leave(attendanceDate.atTime(9, 0), attendanceDate.atTime(13, 0))
+                                .setEmployeeId(employee.getId())));
+
+        // 调用
+        List<HrmAttendanceMonthRecordRespVO> result = attendanceStatisticsService
+                .getAttendanceMonthRecordList(2026, 7, Collections.singletonList(employee.getId()));
+
+        // 断言
+        assertEquals(1, result.size());
+        assertEquals(1, result.get(0).getAttendDays());
+        assertDecimal("0.38", result.get(0).getLeaveDays());
+        assertDecimal("0.62", result.get(0).getActualDays());
+    }
+
+    @Test
+    public void testGetAttendanceDailyDetail_distinguishesRestAndNotScheduled() {
+        // mock 数据
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 12);
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(1L).setName("张三");
+        HrmAttendanceGroupDO attendanceGroup = new HrmAttendanceGroupDO().setId(10L);
+        when(employeeService.getEmployee(employee.getId())).thenReturn(employee);
+        when(attendanceClockService.getAttendanceClockListByEmployeeIdAndClockTime(any(), any()))
+                .thenReturn(Collections.emptyList());
+        when(attendanceLeaveService.getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(any(), any()))
+                .thenReturn(Collections.emptyList());
+        when(attendanceHolidayService.getAttendanceHolidayMap(any())).thenReturn(Collections.emptyMap());
+        when(attendanceGroupService.getMyAttendanceGroup(employee.getId()))
+                .thenReturn(attendanceGroup)
+                .thenReturn(null);
+        when(attendanceGroupService.getAttendanceGroupShiftMap(any(), any(), any()))
+                .thenReturn(Collections.singletonMap(attendanceDate, null));
+        HrmAttendanceDailyDetailReqVO reqVO = new HrmAttendanceDailyDetailReqVO()
+                .setEmployeeId(employee.getId()).setAttendanceTime(attendanceDate.atStartOfDay());
+
+        // 调用
+        HrmAttendanceDailyDetailRespVO restResult = attendanceStatisticsService.getAttendanceDailyDetail(reqVO);
+        HrmAttendanceDailyDetailRespVO notScheduledResult =
+                attendanceStatisticsService.getAttendanceDailyDetail(reqVO);
+
+        // 断言
+        assertEquals(HrmAttendanceResultEnum.REST.getFormat(), restResult.getAttendanceResult());
+        assertEquals(HrmAttendanceResultEnum.NOT_SCHEDULED.getFormat(), notScheduledResult.getAttendanceResult());
+    }
+
+    @Test
+    public void testGetAttendanceDailyDetail_includesCrossDayClockAndLeave() {
+        // mock 数据
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 31);
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(1L).setName("张三");
+        HrmAttendanceGroupDO attendanceGroup = new HrmAttendanceGroupDO().setId(10L);
+        HrmAttendanceGroupDO.Shift shift = HrmAttendanceGroupDO.Shift.builder()
+                .startTime(LocalTime.of(22, 0)).endTime(LocalTime.of(6, 0)).build();
+        HrmAttendanceClockDO offDutyClock = clock(attendanceDate.plusDays(1).atTime(6, 0), 2)
+                .setAttendanceTime(attendanceDate.plusDays(1).atTime(6, 0));
+        HrmAttendanceLeaveDO leave = leave(
+                attendanceDate.atTime(22, 0), attendanceDate.plusDays(1).atTime(3, 0));
+        when(employeeService.getEmployee(employee.getId())).thenReturn(employee);
+        when(attendanceGroupService.getMyAttendanceGroup(employee.getId())).thenReturn(attendanceGroup);
+        when(attendanceHolidayService.getAttendanceHolidayMap(any())).thenReturn(Collections.emptyMap());
+        when(attendanceGroupService.getAttendanceGroupShiftMap(any(), any(), any()))
+                .thenReturn(Collections.singletonMap(attendanceDate, shift));
+        when(attendanceClockService.getAttendanceClockListByEmployeeIdAndClockTime(any(), any()))
+                .thenReturn(Collections.singletonList(offDutyClock));
+        when(attendanceLeaveService.getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(any(), any()))
+                .thenReturn(Collections.singletonList(leave));
+        HrmAttendanceDailyDetailReqVO reqVO = new HrmAttendanceDailyDetailReqVO()
+                .setEmployeeId(employee.getId()).setAttendanceTime(attendanceDate.atStartOfDay());
+
+        // 调用
+        HrmAttendanceDailyDetailRespVO result = attendanceStatisticsService.getAttendanceDailyDetail(reqVO);
+
+        // 断言
+        assertEquals(1, result.getClockCount());
+        assertEquals(300, result.getLeaveMinutes());
+        assertDecimal("0.63", result.getLeaveDays());
+        ArgumentCaptor<LocalDateTime[]> leaveTimesCaptor = ArgumentCaptor.forClass(LocalDateTime[].class);
+        verify(attendanceLeaveService).getEffectiveAttendanceLeaveListByEmployeeIdsAndTimeRange(
+                any(), leaveTimesCaptor.capture());
+        assertEquals(attendanceDate.atTime(22, 0), leaveTimesCaptor.getValue()[0]);
+        assertEquals(attendanceDate.plusDays(1).atTime(6, 0), leaveTimesCaptor.getValue()[1]);
+    }
+
+    @Test
+    public void testGetAttendanceDate_crossDayOffDutyBelongsToShiftBeginDate() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 31);
+        HrmAttendanceGroupDO.Shift shift = HrmAttendanceGroupDO.Shift.builder()
+                .startTime(LocalTime.of(22, 0)).endTime(LocalTime.of(6, 0)).build();
+        HrmAttendanceClockDO clock = clock(attendanceDate.plusDays(1).atTime(6, 0), 2)
+                .setAttendanceTime(attendanceDate.plusDays(1).atTime(6, 0));
+
+        // 调用
+        LocalDate result = attendanceStatisticsService.getAttendanceDate(
+                clock, Collections.singletonMap(attendanceDate, shift));
+
+        // 断言
+        assertEquals(attendanceDate, result);
+    }
+
+    @Test
+    public void testGetAttendanceDetail_employeeNotExists() {
+        // 准备参数
+        HrmAttendanceDailyDetailReqVO dailyReqVO = new HrmAttendanceDailyDetailReqVO()
+                .setEmployeeId(1L).setAttendanceTime(LocalDateTime.of(2026, 8, 1, 0, 0));
+
+        // 调用，并断言
+        assertNull(attendanceStatisticsService.getAttendanceDailyDetail(dailyReqVO));
+        assertNull(attendanceStatisticsService.getAttendanceMonthDetail(1L, 2026, 8));
+    }
+
+    @Test
+    public void testGetAttendanceDate_normalOffDutyKeepsNaturalDate() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 31);
+        HrmAttendanceClockDO clock = clock(attendanceDate.atTime(18, 0), 2)
+                .setAttendanceTime(attendanceDate.atTime(18, 0));
+
+        // 调用
+        LocalDate result = attendanceStatisticsService.getAttendanceDate(
+                clock, Collections.singletonMap(attendanceDate, standardShift()));
+
+        // 断言
+        assertEquals(attendanceDate, result);
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_ignoresLegacyMultipleStages() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 12);
+        HrmAttendanceClockDO firstStageClock = clock(attendanceDate.atTime(9, 0), 1);
+        HrmAttendanceClockDO legacySecondStageClock = clock(attendanceDate.atTime(12, 0), 1).setStage(2);
+
+        // 调用
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(attendanceDate, null,
+                        Arrays.asList(firstStageClock, legacySecondStageClock), Collections.emptyList(), null);
+
+        // 断言
+        assertEquals(1, result.getActualClockCount());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_doesNotMissCardBeforeClosedClockDeadline() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+
+        // 调用：打卡窗口结束边界仍允许打卡
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(attendanceDate, standardShift(),
+                        Collections.emptyList(), Collections.emptyList(), attendanceDate.atTime(9, 30));
+
+        // 断言
+        assertEquals(0, result.getMisscardCount());
+        assertEquals(HrmAttendanceResultEnum.PENDING_CLOCK.getFormat(), result.getAttendanceResult());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_marksMissCardAfterClockDeadline() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+
+        // 调用
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(attendanceDate, standardShift(),
+                        Collections.emptyList(), Collections.emptyList(),
+                        attendanceDate.atTime(9, 30, 0, 1));
+
+        // 断言
+        assertEquals(1, result.getMisscardCount());
+        assertEquals("缺卡 1 次", result.getAttendanceResult());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_doesNotSettleBeforeClosedOffDutyDeadline() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+
+        // 调用：已有上班卡，但下班打卡窗口尚未结束
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(attendanceDate, standardShift(),
+                        Collections.singletonList(clock(attendanceDate.atTime(9, 0), 1)),
+                        Collections.emptyList(), attendanceDate.atTime(18, 30));
+
+        // 断言
+        assertEquals(0, result.getMisscardCount());
+        assertEquals(HrmAttendanceResultEnum.PENDING_CLOCK.getFormat(), result.getAttendanceResult());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_partialMorningLeave() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+
+        // 调用
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(attendanceDate, standardShift(),
+                        Collections.singletonList(clock(attendanceDate.atTime(18, 0), 2)),
+                        Collections.singletonList(leave(
+                                attendanceDate.atTime(9, 0), attendanceDate.atTime(13, 0))),
+                        attendanceDate.plusDays(1).atStartOfDay());
+
+        // 断言
+        assertEquals(480, result.getScheduledMinutes());
+        assertEquals(180, result.getLeaveMinutes());
+        assertDecimal("0.38", result.getLeaveDays());
+        assertEquals(0, result.getMisscardCount());
+        assertEquals(0, result.getAbsenteeismMinutes());
+        assertEquals("请假 0.38 天", result.getAttendanceResult());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_lateAndEarlySubtractLeave() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+
+        // 调用
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(attendanceDate, standardShift(),
+                        Arrays.asList(clock(attendanceDate.atTime(10, 0), 1),
+                                clock(attendanceDate.atTime(17, 0), 2)),
+                        Arrays.asList(leave(attendanceDate.atTime(9, 0), attendanceDate.atTime(9, 30)),
+                                leave(attendanceDate.atTime(17, 30), attendanceDate.atTime(18, 0))),
+                        attendanceDate.plusDays(1).atStartOfDay());
+
+        // 断言
+        assertEquals(30, result.getLateMinutes());
+        assertEquals(1, result.getLateCount());
+        assertEquals(30, result.getEarlyMinutes());
+        assertEquals(1, result.getEarlyCount());
+        assertEquals(60, result.getLeaveMinutes());
+        assertEquals(0, result.getMisscardCount());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_partialLeaveWithoutClocks() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+
+        // 调用
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(
+                        attendanceDate, standardShift(), Collections.emptyList(),
+                        Collections.singletonList(leave(
+                                attendanceDate.atTime(9, 0), attendanceDate.atTime(11, 0))),
+                        attendanceDate.plusDays(1).atStartOfDay());
+
+        // 断言
+        assertEquals(120, result.getLeaveMinutes());
+        assertDecimal("0.25", result.getLeaveDays());
+        assertEquals(360, result.getAbsenteeismMinutes());
+        assertDecimal("0.75", result.getAbsenteeismDays());
+        assertEquals(0, result.getMisscardCount());
+        assertEquals("请假 0.25 天 / 旷工 0.75 天", result.getAttendanceResult());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_overlappingLeaveIntervals() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+
+        // 调用
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(
+                        attendanceDate, standardShift(), Collections.emptyList(),
+                        Arrays.asList(leave(attendanceDate.atTime(9, 0), attendanceDate.atTime(11, 0)),
+                                leave(attendanceDate.atTime(10, 0), attendanceDate.atTime(12, 0))),
+                        attendanceDate.plusDays(1).atStartOfDay());
+
+        // 断言
+        assertEquals(180, result.getLeaveMinutes());
+        assertDecimal("0.38", result.getLeaveDays());
+        assertEquals(300, result.getAbsenteeismMinutes());
+    }
+
+    @Test
+    public void testCalculateAttendanceDay_crossDayShift() {
+        // 准备参数
+        LocalDate attendanceDate = LocalDate.of(2026, 7, 8);
+        HrmAttendanceGroupDO.Shift shift = HrmAttendanceGroupDO.Shift.builder()
+                .startTime(LocalTime.of(22, 0)).endTime(LocalTime.of(6, 0))
+                .excludeRestTime(true).restStartTime(LocalTime.of(2, 0)).restEndTime(LocalTime.of(3, 0)).build();
+
+        // 调用
+        HrmAttendanceStatisticsServiceImpl.AttendanceDayCalculation result =
+                attendanceStatisticsService.calculateAttendanceDay(attendanceDate, shift,
+                        Collections.singletonList(clock(attendanceDate.plusDays(1).atTime(6, 0), 2)),
+                        Collections.singletonList(leave(
+                                attendanceDate.atTime(22, 0), attendanceDate.plusDays(1).atTime(3, 0))),
+                        attendanceDate.plusDays(2).atStartOfDay());
+
+        // 断言
+        assertEquals(420, result.getScheduledMinutes());
+        assertEquals(240, result.getLeaveMinutes());
+        assertDecimal("0.57", result.getLeaveDays());
+        assertEquals(0, result.getMisscardCount());
+        assertEquals(0, result.getAbsenteeismMinutes());
+    }
+
+    @Test
+    public void testSetAttendanceDeductAmounts_configuredRule() {
+        // 准备参数
+        HrmAttendanceMonthRecordRespVO respVO = new HrmAttendanceMonthRecordRespVO()
+                .setLateCount(3).setLateMinute(20)
+                .setEarlyCount(2).setEarlyMinute(10)
+                .setAbsenteeismDays(new BigDecimal("0.50")).setMisscardCount(2);
+        HrmAttendanceGroupDO.DeductRule deductRule = HrmAttendanceGroupDO.DeductRule.builder()
+                .lateMethod(HrmAttendanceLateEarlyDeductMethodEnum.BY_COUNT.getMethod())
+                .lateDeductMoney(new BigDecimal("5.00"))
+                .earlyMethod(HrmAttendanceLateEarlyDeductMethodEnum.BY_MINUTE.getMethod())
+                .earlyDeductMoney(new BigDecimal("2.00"))
+                .absenteeismMethod(1).absenteeismDeductMoney(new BigDecimal("100.00"))
+                .misscardMethod(1).misscardDeductMoney(new BigDecimal("8.00"))
+                .build();
+
+        // 调用
+        attendanceStatisticsService.setAttendanceDeductAmounts(respVO, deductRule);
+
+        // 断言
+        assertDecimal("15.00", respVO.getLateDeductAmount());
+        assertDecimal("20.00", respVO.getEarlyDeductAmount());
+        assertDecimal("50.00", respVO.getAbsenteeismDeductAmount());
+        assertDecimal("16.00", respVO.getMisscardDeductAmount());
+        assertDecimal("101.00", respVO.getAttendanceDeductAmount());
+    }
+
+    @Test
+    public void testSetAttendanceDeductAmounts_fixedMonthWithoutEarlyEvent() {
+        // 准备参数
+        HrmAttendanceMonthRecordRespVO respVO = new HrmAttendanceMonthRecordRespVO()
+                .setLateCount(1).setLateMinute(5)
+                .setEarlyCount(0).setEarlyMinute(0)
+                .setAbsenteeismDays(BigDecimal.ZERO).setMisscardCount(0);
+        HrmAttendanceGroupDO.DeductRule deductRule = HrmAttendanceGroupDO.DeductRule.builder()
+                .lateMethod(HrmAttendanceLateEarlyDeductMethodEnum.FIXED_MONTH.getMethod())
+                .lateDeductMoney(new BigDecimal("30.00"))
+                .earlyMethod(HrmAttendanceLateEarlyDeductMethodEnum.FIXED_MONTH.getMethod())
+                .earlyDeductMoney(new BigDecimal("20.00"))
+                .absenteeismMethod(1).absenteeismDeductMoney(BigDecimal.ZERO)
+                .misscardMethod(1).misscardDeductMoney(BigDecimal.ZERO)
+                .build();
+
+        // 调用
+        attendanceStatisticsService.setAttendanceDeductAmounts(respVO, deductRule);
+
+        // 断言
+        assertDecimal("30.00", respVO.getLateDeductAmount());
+        assertDecimal("20.00", respVO.getEarlyDeductAmount());
+        assertDecimal("50.00", respVO.getAttendanceDeductAmount());
+    }
+
+    private static HrmAttendanceGroupDO.Shift standardShift() {
+        return HrmAttendanceGroupDO.Shift.builder()
+                .startTime(LocalTime.of(9, 0)).endTime(LocalTime.of(18, 0))
+                .clockInStartTime(LocalTime.of(8, 0)).clockInEndTime(LocalTime.of(9, 30))
+                .clockOutStartTime(LocalTime.of(17, 30)).clockOutEndTime(LocalTime.of(18, 30))
+                .excludeRestTime(true).restStartTime(LocalTime.of(12, 0)).restEndTime(LocalTime.of(13, 0)).build();
+    }
+
+    private static HrmAttendanceClockDO clock(LocalDateTime clockTime, int type) {
+        return HrmAttendanceClockDO.builder().clockTime(clockTime).type(type).stage(1).build();
+    }
+
+    private static HrmAttendanceLeaveDO leave(LocalDateTime startTime, LocalDateTime endTime) {
+        return HrmAttendanceLeaveDO.builder().startTime(startTime).endTime(endTime).build();
+    }
+
+    private static void assertDecimal(String expected, BigDecimal actual) {
+        assertEquals(0, new BigDecimal(expected).compareTo(actual));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigServiceImplTest.java
new file mode 100644
index 0000000..5ad3db2
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/config/HrmConfigServiceImplTest.java
@@ -0,0 +1,63 @@
+package cn.iocoder.yudao.module.hrm.service.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.config.HrmConfigDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.config.HrmConfigMapper;
+import cn.iocoder.yudao.module.hrm.enums.config.HrmConfigTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * {@link HrmConfigServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmConfigServiceImpl.class)
+public class HrmConfigServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmConfigServiceImpl configService;
+    @Resource
+    private HrmConfigMapper hrmConfigMapper;
+
+    @Test
+    public void testReplaceConfigValueList_success() {
+        // mock 数据
+        hrmConfigMapper.insert(randomPojo(HrmConfigDO.class, config -> config.setId(null)
+                .setType(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType()).setValue("旧配置").setSort(1)));
+
+        // 准备参数
+        List<String> newValues = Arrays.asList("第二项", "第一项");
+
+        // 调用
+        configService.replaceConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType(), newValues);
+
+        // 断言
+        assertEquals(newValues, configService.getConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType()));
+        assertEquals(1, hrmConfigMapper.selectListByType(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType()).get(0).getSort());
+        assertEquals(2, hrmConfigMapper.selectListByType(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType()).get(1).getSort());
+    }
+
+    @Test
+    public void testReplaceConfigValueList_empty() {
+        // mock 数据
+        hrmConfigMapper.insert(randomPojo(HrmConfigDO.class, config -> config.setId(null)
+                .setType(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType()).setValue("旧配置").setSort(1)));
+
+        // 调用
+        configService.replaceConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType(), Collections.emptyList());
+
+        // 断言
+        assertTrue(configService.getConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType()).isEmpty());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigServiceImplTest.java
new file mode 100644
index 0000000..91ecfdb
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/config/HrmEmployeeFieldConfigServiceImplTest.java
@@ -0,0 +1,184 @@
+package cn.iocoder.yudao.module.hrm.service.employee.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeArchiveFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeCreateFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.config.HrmEmployeeFieldConfigSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeArchiveFieldEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeCreateFieldEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.config.HrmConfigService;
+import cn.iocoder.yudao.module.hrm.enums.config.HrmConfigTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_FIELD_CONFIG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_FIELD_NOT_VISIBLE;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmEmployeeFieldConfigServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeFieldConfigServiceImpl.class)
+public class HrmEmployeeFieldConfigServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeFieldConfigServiceImpl employeeFieldConfigService;
+
+    @MockitoBean
+    private HrmConfigService configService;
+
+    @Test
+    public void testGetCreateFieldConfigList_default() {
+        // mock 方法
+        when(configService.getConfigValueList(HrmConfigTypeEnum.EMPLOYEE_CREATE_ACTIVE_FIELD.getType()))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        List<HrmEmployeeFieldConfigRespVO> fields = employeeFieldConfigService.getEmployeeCreateFieldConfigList(
+                HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+
+        // 断言
+        assertEquals(HrmEmployeeCreateFieldEnum.values().length, fields.size());
+        HrmEmployeeFieldConfigRespVO nameField = getField(fields, "name");
+        assertTrue(nameField.getVisible());
+        assertTrue(nameField.getVisibleLocked());
+        assertTrue(getField(fields, "jobNumber").getVisible());
+        assertTrue(getField(fields, "jobNumber").getVisibleLocked());
+        assertFalse(getField(fields, "country").getVisible());
+        assertFalse(getField(fields, "age").getVisible());
+    }
+
+    @Test
+    public void testGetCreateFieldConfigList_pendingEntryDefault() {
+        // mock 方法
+        when(configService.getConfigValueList(HrmConfigTypeEnum.EMPLOYEE_CREATE_PENDING_FIELD.getType()))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        List<HrmEmployeeFieldConfigRespVO> fields = employeeFieldConfigService.getEmployeeCreateFieldConfigList(
+                HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus());
+
+        // 断言
+        assertFalse(getField(fields, "jobNumber").getVisible());
+        assertFalse(getField(fields, "jobNumber").getVisibleLocked());
+        assertTrue(getField(fields, "entryTime").getVisible());
+        assertTrue(getField(fields, "entryTime").getVisibleLocked());
+    }
+
+    @Test
+    public void testValidateEmployeeCreateFields_hiddenField() {
+        // mock 方法
+        when(configService.getConfigValueList(HrmConfigTypeEnum.EMPLOYEE_CREATE_ACTIVE_FIELD.getType()))
+                .thenReturn(Collections.emptyList());
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = new HrmEmployeeSaveReqVO().setCountry("中国");
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeFieldConfigService.validateEmployeeCreateFields(
+                reqVO, HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()),
+                EMPLOYEE_FIELD_NOT_VISIBLE, "国家或地区");
+    }
+
+    @Test
+    public void testSaveCreateFieldConfig_success() {
+        // 准备参数
+        HrmEmployeeCreateFieldConfigSaveReqVO reqVO = new HrmEmployeeCreateFieldConfigSaveReqVO();
+        reqVO.setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        reqVO.setFields(Arrays.asList(createField("name", false, null),
+                createField("country", false, null), createField("age", true, null)));
+
+        // 调用
+        employeeFieldConfigService.saveEmployeeCreateFieldConfig(reqVO);
+
+        // mock 方法
+        @SuppressWarnings("unchecked")
+        ArgumentCaptor<List<String>> configValuesCaptor = ArgumentCaptor.forClass(List.class);
+        verify(configService).replaceConfigValueList(eq(HrmConfigTypeEnum.EMPLOYEE_CREATE_ACTIVE_FIELD.getType()),
+                configValuesCaptor.capture());
+        when(configService.getConfigValueList(HrmConfigTypeEnum.EMPLOYEE_CREATE_ACTIVE_FIELD.getType()))
+                .thenReturn(configValuesCaptor.getValue());
+
+        // 断言
+        List<HrmEmployeeFieldConfigRespVO> fields = employeeFieldConfigService.getEmployeeCreateFieldConfigList(
+                HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        assertTrue(getField(fields, "name").getVisible());
+        assertFalse(getField(fields, "country").getVisible());
+        assertTrue(getField(fields, "age").getVisible());
+        assertEquals(HrmEmployeeCreateFieldEnum.values().length, configValuesCaptor.getValue().size());
+    }
+
+    @Test
+    public void testSaveCreateFieldConfig_fieldInvalid() {
+        // 准备参数
+        HrmEmployeeCreateFieldConfigSaveReqVO reqVO = new HrmEmployeeCreateFieldConfigSaveReqVO();
+        reqVO.setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        reqVO.setFields(Arrays.asList(createField("unknown", true, null)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeFieldConfigService.saveEmployeeCreateFieldConfig(reqVO),
+                EMPLOYEE_FIELD_CONFIG_INVALID, "unknown");
+    }
+
+    @Test
+    public void testSaveArchiveFieldConfig_success() {
+        // 准备参数
+        HrmEmployeeArchiveFieldConfigSaveReqVO reqVO = new HrmEmployeeArchiveFieldConfigSaveReqVO();
+        reqVO.setFields(Arrays.asList(createField("mobile", false, true),
+                createField("email", true, true), createField("age", true, true)));
+
+        // 调用
+        employeeFieldConfigService.saveEmployeeArchiveFieldConfig(reqVO);
+
+        // mock 方法
+        @SuppressWarnings("unchecked")
+        ArgumentCaptor<List<String>> configValuesCaptor = ArgumentCaptor.forClass(List.class);
+        verify(configService).replaceConfigValueList(eq(HrmConfigTypeEnum.EMPLOYEE_ARCHIVE_FIELD.getType()),
+                configValuesCaptor.capture());
+        when(configService.getConfigValueList(HrmConfigTypeEnum.EMPLOYEE_ARCHIVE_FIELD.getType()))
+                .thenReturn(configValuesCaptor.getValue());
+
+        // 断言
+        List<HrmEmployeeFieldConfigRespVO> fields = employeeFieldConfigService.getEmployeeArchiveFieldConfigList();
+        assertFalse(getField(fields, "mobile").getVisible());
+        assertFalse(getField(fields, "mobile").getEditable());
+        assertTrue(getField(fields, "email").getEditable());
+        assertFalse(getField(fields, "age").getEditable());
+        Set<String> editableFields = employeeFieldConfigService.getEditableArchiveFieldNames();
+        assertTrue(editableFields.contains("email"));
+        assertFalse(editableFields.contains("mobile"));
+        assertEquals(HrmEmployeeArchiveFieldEnum.values().length, configValuesCaptor.getValue().size());
+    }
+
+    private HrmEmployeeFieldConfigRespVO getField(List<HrmEmployeeFieldConfigRespVO> fields, String name) {
+        return fields.stream().filter(field -> field.getName().equals(name)).findFirst()
+                .orElseThrow(IllegalStateException::new);
+    }
+
+    private HrmEmployeeFieldConfigSaveReqVO createField(String name, Boolean visible, Boolean editable) {
+        HrmEmployeeFieldConfigSaveReqVO field = new HrmEmployeeFieldConfigSaveReqVO();
+        field.setName(name);
+        field.setVisible(visible);
+        field.setEditable(editable);
+        return field;
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordServiceImplTest.java
new file mode 100644
index 0000000..ddf6556
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeChangeRecordServiceImplTest.java
@@ -0,0 +1,126 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeChangeRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeChangeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/**
+ * {@link HrmEmployeeChangeRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeChangeRecordServiceImpl.class)
+public class HrmEmployeeChangeRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeChangeRecordServiceImpl changeRecordService;
+
+    @Resource
+    private HrmEmployeeChangeRecordMapper changeRecordMapper;
+
+    @Test
+    public void testCreateChangeRecord_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeChangeRecordCreateReqVO changeRecord = randomPojo(HrmEmployeeChangeRecordCreateReqVO.class,
+                o -> o.setEmployeeId(employeeId).setType(HrmEmployeeChangeTypeEnum.TRANSFER.getType())
+                        .setReason(1).setEffectTime(LocalDate.now().atTime(15, 30)));
+
+        // 调用
+        changeRecordService.createEmployeeChangeRecord(changeRecord);
+        // 断言
+        HrmEmployeeChangeRecordDO dbChangeRecord = changeRecordMapper.selectListByEmployeeId(employeeId).get(0);
+        assertPojoEquals(changeRecord, dbChangeRecord);
+        assertEquals(LocalDate.now().atStartOfDay(), dbChangeRecord.getEffectTime());
+    }
+
+    @Test
+    public void testCreateChangeRecord_rehireKeepsEntryTime() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        LocalDateTime entryTime = LocalDate.now().atTime(15, 30);
+        HrmEmployeeChangeRecordCreateReqVO changeRecord = randomPojo(HrmEmployeeChangeRecordCreateReqVO.class,
+                o -> o.setEmployeeId(employeeId).setType(HrmEmployeeChangeTypeEnum.REHIRE.getType())
+                        .setReason(1).setEffectTime(entryTime));
+
+        // 调用
+        changeRecordService.createEmployeeChangeRecord(changeRecord);
+
+        // 断言
+        HrmEmployeeChangeRecordDO dbChangeRecord = changeRecordMapper.selectListByEmployeeId(employeeId).get(0);
+        assertEquals(entryTime, dbChangeRecord.getEffectTime());
+    }
+
+    @Test
+    public void testGetChangeRecordList() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        LocalDate beginEffectTime = LocalDate.of(2026, 7, 1);
+        HrmEmployeeChangeRecordDO firstRecord = randomChangeRecordDO(employeeId,
+                HrmEmployeeChangeTypeEnum.TRANSFER, beginEffectTime.plusDays(2));
+        firstRecord.setAppliedTime(beginEffectTime.plusDays(2).atStartOfDay());
+        changeRecordMapper.insert(firstRecord);
+        HrmEmployeeChangeRecordDO secondRecord = randomChangeRecordDO(employeeId,
+                HrmEmployeeChangeTypeEnum.PROMOTION, beginEffectTime.plusDays(10));
+        changeRecordMapper.insert(secondRecord);
+        changeRecordMapper.insert(randomChangeRecordDO(randomLongId(),
+                HrmEmployeeChangeTypeEnum.DEMOTION, beginEffectTime.plusDays(5)));
+        changeRecordMapper.insert(randomChangeRecordDO(employeeId,
+                HrmEmployeeChangeTypeEnum.REHIRE, beginEffectTime.minusDays(1)));
+        LocalDate sameEffectTime = beginEffectTime.plusDays(20);
+        HrmEmployeeChangeRecordDO earlierRecord = randomChangeRecordDO(employeeId,
+                HrmEmployeeChangeTypeEnum.TRANSFER, sameEffectTime);
+        earlierRecord.setCreateTime(LocalDateTime.of(2026, 7, 1, 10, 0));
+        changeRecordMapper.insert(earlierRecord);
+        HrmEmployeeChangeRecordDO laterRecord = randomChangeRecordDO(employeeId,
+                HrmEmployeeChangeTypeEnum.PROMOTION, sameEffectTime);
+        laterRecord.setCreateTime(LocalDateTime.of(2026, 7, 1, 11, 0));
+        changeRecordMapper.insert(laterRecord);
+
+        // 调用
+        List<HrmEmployeeChangeRecordDO> employeeRecords =
+                changeRecordService.getEmployeeChangeRecordListByEmployeeId(employeeId);
+        List<HrmEmployeeChangeRecordDO> rangeRecords =
+                changeRecordService.getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                        Arrays.asList(employeeId, randomLongId()), new LocalDateTime[]{
+                                beginEffectTime.atStartOfDay(), beginEffectTime.plusMonths(1).atTime(23, 59, 59)});
+        List<HrmEmployeeChangeRecordDO> emptyRecords =
+                changeRecordService.getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                        Collections.emptyList(), new LocalDateTime[]{
+                                beginEffectTime.atStartOfDay(), beginEffectTime.plusMonths(1).atTime(23, 59, 59)});
+        List<HrmEmployeeChangeRecordDO> effectTimeRecords =
+                changeRecordService.getPendingEmployeeChangeRecordList(sameEffectTime.atTime(23, 59, 59));
+        // 断言
+        assertEquals(5, employeeRecords.size());
+        assertEquals(laterRecord.getId(), employeeRecords.get(0).getId());
+        assertEquals(4, rangeRecords.size());
+        assertEquals(0, emptyRecords.size());
+        assertEquals(4, effectTimeRecords.size());
+        assertEquals(earlierRecord.getId(), effectTimeRecords.get(2).getId());
+        assertEquals(laterRecord.getId(), effectTimeRecords.get(3).getId());
+    }
+
+    private static HrmEmployeeChangeRecordDO randomChangeRecordDO(
+            Long employeeId, HrmEmployeeChangeTypeEnum changeType, LocalDate effectTime) {
+        return randomPojo(HrmEmployeeChangeRecordDO.class, o -> o.setId(null).setEmployeeId(employeeId)
+                .setType(changeType.getType()).setReason(1).setEffectTime(effectTime.atStartOfDay())
+                .setAppliedTime(null).setDeleted(false));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractServiceImplTest.java
new file mode 100644
index 0000000..b2134bf
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeContractServiceImplTest.java
@@ -0,0 +1,205 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contract.HrmEmployeeContractSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeContractDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeContractMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeContractStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CONTRACT_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmEmployeeContractServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeContractServiceImpl.class)
+public class HrmEmployeeContractServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeContractServiceImpl contractService;
+
+    @Resource
+    private HrmEmployeeContractMapper contractMapper;
+    @Resource
+    private HrmEmployeeMapper employeeMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreateContract_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeContractSaveReqVO reqVO = randomPojo(
+                HrmEmployeeContractSaveReqVO.class,
+                o -> {
+                    o.setId(null).setEmployeeId(employeeId).setSort(10);
+                    o.setType(1).setStatus(1).setExpireRemind(true);
+                    o.setStartTime(LocalDateTime.of(2026, 1, 1, 9, 0))
+                            .setEndTime(LocalDateTime.of(2027, 1, 1, 18, 0))
+                            .setSignTime(LocalDateTime.of(2025, 12, 20, 15, 30));
+                });
+
+        // 调用
+        Long id = contractService.createContract(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmEmployeeContractDO contract = contractMapper.selectById(id);
+        assertPojoEquals(reqVO, contract, "id", "startTime", "endTime", "signTime");
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), contract.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), contract.getEndTime());
+        assertEquals(reqVO.getSignTime().toLocalDate().atStartOfDay(), contract.getSignTime());
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testUpdateContract_success() {
+        // mock 数据
+        HrmEmployeeContractDO dbRecord = randomContractDO(randomLongId(), 20);
+        contractMapper.insert(dbRecord);
+        // 准备参数
+        HrmEmployeeContractSaveReqVO reqVO = randomPojo(
+                HrmEmployeeContractSaveReqVO.class,
+                o -> {
+                    o.setId(dbRecord.getId()).setEmployeeId(dbRecord.getEmployeeId()).setSort(10);
+                    o.setType(2).setStatus(2).setExpireRemind(false);
+                    o.setStartTime(LocalDateTime.of(2026, 1, 1, 9, 0))
+                            .setEndTime(LocalDateTime.of(2027, 1, 1, 18, 0))
+                            .setSignTime(LocalDateTime.of(2025, 12, 25, 18, 0));
+                });
+
+        // 调用
+        contractService.updateContract(reqVO);
+
+        // 断言
+        HrmEmployeeContractDO contract = contractMapper.selectById(dbRecord.getId());
+        assertPojoEquals(reqVO, contract, "employeeId", "term", "startTime", "endTime", "signTime");
+        assertEquals(dbRecord.getEmployeeId(), contract.getEmployeeId());
+        assertNull(contract.getTerm());
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), contract.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), contract.getEndTime());
+        assertEquals(reqVO.getSignTime().toLocalDate().atStartOfDay(), contract.getSignTime());
+    }
+
+    @Test
+    public void testDeleteContract_success() {
+        // mock 数据
+        HrmEmployeeContractDO dbRecord = randomContractDO(randomLongId(), 20);
+        contractMapper.insert(dbRecord);
+        // 准备参数
+        Long id = dbRecord.getId();
+
+        // 调用
+        contractService.deleteContract(id);
+
+        // 断言
+        assertNull(contractMapper.selectById(id));
+    }
+
+    @Test
+    public void testDeleteContract_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> contractService.deleteContract(id), EMPLOYEE_CONTRACT_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetContractListByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeContractDO firstRecord = randomContractDO(employeeId, 20)
+                .setEndTime(LocalDateTime.of(2026, 8, 5, 18, 0));
+        contractMapper.insert(firstRecord);
+        HrmEmployeeContractDO secondRecord = randomContractDO(employeeId, 10)
+                .setEndTime(LocalDateTime.of(2026, 8, 20, 18, 0));
+        contractMapper.insert(secondRecord);
+        // 测试 employeeId 不匹配
+        contractMapper.insert(randomContractDO(randomLongId(), 1));
+
+        // 调用
+        List<HrmEmployeeContractDO> result = contractService.getContractListByEmployeeId(employeeId);
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(secondRecord.getId(), result.get(0).getId());
+        assertEquals(firstRecord.getId(), result.get(1).getId());
+    }
+
+    @Test
+    public void testGetExpireEmployeeCountInMonth() {
+        // mock 数据
+        LocalDate monthStartDate = LocalDate.of(2026, 8, 1);
+        HrmEmployeeDO employee = new HrmEmployeeDO().setName("在职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        employeeMapper.insert(employee);
+        contractMapper.insert(randomContractDO(employee.getId(), 20)
+                .setEndTime(monthStartDate.plusDays(5).atTime(18, 0)));
+        contractMapper.insert(randomContractDO(employee.getId(), 10)
+                .setEndTime(monthStartDate.plusDays(20).atTime(18, 0)));
+        // 测试关闭提醒不计入
+        HrmEmployeeDO remindDisabledEmployee = new HrmEmployeeDO().setName("关闭提醒员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        employeeMapper.insert(remindDisabledEmployee);
+        contractMapper.insert(randomContractDO(remindDisabledEmployee.getId(), 1)
+                .setExpireRemind(false)
+                .setEndTime(monthStartDate.plusDays(8).atTime(18, 0)));
+        // 测试已到期合同不计入
+        HrmEmployeeDO expiredContractEmployee = new HrmEmployeeDO().setName("合同已到期员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        employeeMapper.insert(expiredContractEmployee);
+        contractMapper.insert(randomContractDO(expiredContractEmployee.getId(), 1)
+                .setStatus(HrmEmployeeContractStatusEnum.EXPIRED.getStatus())
+                .setEndTime(monthStartDate.plusDays(9).atTime(18, 0)));
+        // 测试离职员工不计入
+        HrmEmployeeDO leftEmployee = new HrmEmployeeDO().setName("离职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus());
+        employeeMapper.insert(leftEmployee);
+        contractMapper.insert(randomContractDO(leftEmployee.getId(), 1)
+                .setEndTime(monthStartDate.plusDays(10).atTime(18, 0)));
+        // 测试已删除员工不计入到期合同人数
+        HrmEmployeeDO deletedEmployee = new HrmEmployeeDO().setName("已删除员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        employeeMapper.insert(deletedEmployee);
+        contractMapper.insert(randomContractDO(deletedEmployee.getId(), 1)
+                .setEndTime(monthStartDate.plusDays(10).atTime(18, 0)));
+        employeeMapper.deleteById(deletedEmployee.getId());
+
+        // 调用
+        Long expireEmployeeCount = contractService.getExpireEmployeeCountInMonth(
+                new LocalDateTime[]{monthStartDate.atStartOfDay(),
+                        monthStartDate.plusMonths(1).atStartOfDay().minusNanos(1)});
+
+        // 断言
+        assertEquals(1L, expireEmployeeCount);
+    }
+
+    private static HrmEmployeeContractDO randomContractDO(Long employeeId, Integer sort) {
+        return randomPojo(HrmEmployeeContractDO.class, o -> o.setId(null).setEmployeeId(employeeId)
+                .setType(1).setStatus(1).setExpireRemind(true).setSort(sort).setDeleted(false));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoServiceImplTest.java
new file mode 100644
index 0000000..9ef6349
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeQuitInfoServiceImplTest.java
@@ -0,0 +1,158 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.quitinfo.HrmEmployeeQuitInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeQuitInfoMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_QUIT_INFO_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+/**
+ * {@link HrmEmployeeQuitInfoServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeQuitInfoServiceImpl.class)
+public class HrmEmployeeQuitInfoServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeQuitInfoServiceImpl quitInfoService;
+
+    @Resource
+    private HrmEmployeeQuitInfoMapper quitInfoMapper;
+
+    @Test
+    public void testSaveEmployeeQuitInfo_create() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeQuitInfoSaveReqVO reqVO = randomPojo(HrmEmployeeQuitInfoSaveReqVO.class,
+                o -> o.setEmployeeId(employeeId).setPlanQuitTime(LocalDateTime.now().plusDays(10))
+                        .setType(1).setReason(1).setOldEmployeeStatus(1));
+
+        // 调用
+        Long id = quitInfoService.saveEmployeeQuitInfo(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        assertPojoEquals(reqVO, quitInfoMapper.selectById(id));
+    }
+
+    @Test
+    public void testSaveEmployeeQuitInfo_update() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeQuitInfoDO dbQuitInfo =
+                randomQuitInfoDO(employeeId, LocalDateTime.now().plusDays(10));
+        quitInfoMapper.insert(dbQuitInfo);
+        // 准备参数
+        HrmEmployeeQuitInfoSaveReqVO reqVO = randomPojo(HrmEmployeeQuitInfoSaveReqVO.class,
+                o -> o.setEmployeeId(employeeId).setPlanQuitTime(LocalDateTime.now().plusDays(20))
+                        .setType(2).setReason(11).setOldEmployeeStatus(2));
+
+        // 调用
+        Long id = quitInfoService.saveEmployeeQuitInfo(reqVO);
+
+        // 断言
+        assertEquals(dbQuitInfo.getId(), id);
+        assertPojoEquals(reqVO, quitInfoMapper.selectById(id));
+        assertEquals(1, quitInfoMapper.selectList().size());
+    }
+
+    @Test
+    public void testDeleteEmployeeQuitInfo_success() {
+        // mock 数据
+        HrmEmployeeQuitInfoDO quitInfo = randomQuitInfoDO(randomLongId(), LocalDateTime.now().plusDays(10));
+        quitInfoMapper.insert(quitInfo);
+
+        // 调用
+        quitInfoService.deleteEmployeeQuitInfo(quitInfo.getEmployeeId());
+        // 断言
+        assertNull(quitInfoMapper.selectById(quitInfo.getId()));
+    }
+
+    @Test
+    public void testValidateQuitInfoByEmployeeId_notExists() {
+        // 准备参数
+        Long employeeId = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> quitInfoService.validateQuitInfoByEmployeeId(employeeId),
+                EMPLOYEE_QUIT_INFO_NOT_EXISTS);
+    }
+
+    @Test
+    public void testValidateQuitInfoByEmployeeId_duplicateReturnsLatest() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeQuitInfoDO firstQuitInfo = randomQuitInfoDO(
+                employeeId, LocalDateTime.now().plusDays(10));
+        quitInfoMapper.insert(firstQuitInfo);
+        HrmEmployeeQuitInfoDO latestQuitInfo = randomQuitInfoDO(
+                employeeId, LocalDateTime.now().plusDays(20));
+        quitInfoMapper.insert(latestQuitInfo);
+
+        // 调用
+        HrmEmployeeQuitInfoDO result = quitInfoService.validateQuitInfoByEmployeeId(employeeId);
+
+        // 断言
+        assertEquals(latestQuitInfo.getId(), result.getId());
+    }
+
+    @Test
+    public void testGetDueQuitInfoList() {
+        // mock 数据
+        LocalDate planQuitDate = LocalDate.of(2026, 8, 1);
+        HrmEmployeeQuitInfoDO firstRecord = randomQuitInfoDO(randomLongId(), planQuitDate.atTime(9, 30));
+        quitInfoMapper.insert(firstRecord);
+        HrmEmployeeQuitInfoDO secondRecord = randomQuitInfoDO(randomLongId(), planQuitDate.atTime(18, 45));
+        quitInfoMapper.insert(secondRecord);
+        quitInfoMapper.insert(randomQuitInfoDO(randomLongId(), planQuitDate.plusDays(1).atStartOfDay()));
+
+        // 调用
+        List<HrmEmployeeQuitInfoDO> result = quitInfoService.getDueQuitInfoList(planQuitDate.atTime(18, 45));
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(firstRecord.getId(), result.get(0).getId());
+        assertEquals(secondRecord.getId(), result.get(1).getId());
+    }
+
+    @Test
+    public void testGetQuitInfoListByEmployeeIds() {
+        // mock 数据
+        HrmEmployeeQuitInfoDO quitInfo = randomQuitInfoDO(
+                randomLongId(), LocalDateTime.now().plusDays(10));
+        quitInfoMapper.insert(quitInfo);
+        quitInfoMapper.insert(randomQuitInfoDO(randomLongId(), LocalDateTime.now().plusDays(20)));
+
+        // 调用
+        List<HrmEmployeeQuitInfoDO> result = quitInfoService.getQuitInfoListByEmployeeIds(
+                Arrays.asList(quitInfo.getEmployeeId(), randomLongId()));
+
+        // 断言
+        assertEquals(1, result.size());
+        assertEquals(quitInfo.getId(), result.get(0).getId());
+        assertEquals(Collections.emptyList(), quitInfoService.getQuitInfoListByEmployeeIds(Collections.emptyList()));
+    }
+
+    private static HrmEmployeeQuitInfoDO randomQuitInfoDO(Long employeeId, LocalDateTime planQuitTime) {
+        return randomPojo(HrmEmployeeQuitInfoDO.class, o -> o.setId(null).setEmployeeId(employeeId)
+                .setPlanQuitTime(planQuitTime).setType(1).setReason(1).setOldEmployeeStatus(1).setDeleted(false));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardServiceImplTest.java
new file mode 100644
index 0000000..671c5e9
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/employment/HrmEmployeeSalaryCardServiceImplTest.java
@@ -0,0 +1,213 @@
+package cn.iocoder.yudao.module.hrm.service.employee.employment;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.salarycard.HrmEmployeeSalaryCardSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeSalaryCardDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeSalaryCardMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Collections;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_SALARY_CARD_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmEmployeeSalaryCardServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeSalaryCardServiceImpl.class)
+public class HrmEmployeeSalaryCardServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeSalaryCardServiceImpl salaryCardService;
+
+    @Resource
+    private HrmEmployeeSalaryCardMapper salaryCardMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testSaveSalaryCard_create() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeDO employee = randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId));
+        HrmEmployeeSalaryCardSaveReqVO reqVO = randomPojo(HrmEmployeeSalaryCardSaveReqVO.class,
+                o -> o.setId(null).setEmployeeId(employeeId));
+        // mock 方法
+        when(employeeService.validateEmployeeExists(employeeId)).thenReturn(employee);
+
+        // 调用
+        Long id = salaryCardService.saveSalaryCard(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        assertPojoEquals(reqVO, salaryCardMapper.selectById(id), "id");
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testSaveSalaryCard_updateByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeSalaryCardDO dbSalaryCard = randomSalaryCardDO(employeeId);
+        salaryCardMapper.insert(dbSalaryCard);
+        // 准备参数
+        HrmEmployeeSalaryCardSaveReqVO reqVO = randomPojo(HrmEmployeeSalaryCardSaveReqVO.class,
+                o -> o.setId(null).setEmployeeId(employeeId));
+        // mock 方法
+        when(employeeService.validateEmployeeExists(employeeId))
+                .thenReturn(randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId)));
+
+        // 调用
+        Long id = salaryCardService.saveSalaryCard(reqVO);
+
+        // 断言
+        assertEquals(dbSalaryCard.getId(), id);
+        assertPojoEquals(reqVO, salaryCardMapper.selectById(id), "id");
+        assertEquals(1L, salaryCardMapper.selectCount());
+    }
+
+    @Test
+    public void testSaveSalaryCard_updateLatestWhenHistoryDuplicated() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeSalaryCardDO oldSalaryCard = randomSalaryCardDO(employeeId);
+        salaryCardMapper.insert(oldSalaryCard);
+        HrmEmployeeSalaryCardDO latestSalaryCard = randomSalaryCardDO(employeeId);
+        salaryCardMapper.insert(latestSalaryCard);
+        // 准备参数
+        HrmEmployeeSalaryCardSaveReqVO reqVO = randomPojo(HrmEmployeeSalaryCardSaveReqVO.class,
+                o -> o.setId(null).setEmployeeId(employeeId));
+        // mock 方法
+        when(employeeService.validateEmployeeExists(employeeId))
+                .thenReturn(randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId)));
+
+        // 调用
+        Long id = salaryCardService.saveSalaryCard(reqVO);
+
+        // 断言
+        assertEquals(latestSalaryCard.getId(), id);
+        assertPojoEquals(reqVO, salaryCardMapper.selectById(id), "id");
+        assertEquals(2L, salaryCardMapper.selectCount());
+    }
+
+    @Test
+    public void testSaveSalaryCard_employeeMismatch() {
+        // mock 数据
+        HrmEmployeeSalaryCardDO dbSalaryCard = randomSalaryCardDO(randomLongId());
+        salaryCardMapper.insert(dbSalaryCard);
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeSalaryCardSaveReqVO reqVO = randomPojo(HrmEmployeeSalaryCardSaveReqVO.class,
+                o -> o.setId(dbSalaryCard.getId()).setEmployeeId(employeeId));
+        // mock 方法
+        when(employeeService.validateEmployeeExists(employeeId))
+                .thenReturn(randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryCardService.saveSalaryCard(reqVO),
+                EMPLOYEE_RESOURCE_BELONG_INVALID, "工资卡");
+    }
+
+    @Test
+    public void testValidateSalaryCardExists_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryCardService.validateSalaryCardExists(id),
+                EMPLOYEE_SALARY_CARD_NOT_EXISTS);
+    }
+
+    @Test
+    public void testDeleteSalaryCardByEmployeeId_success() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeSalaryCardDO salaryCard = randomSalaryCardDO(employeeId);
+        salaryCardMapper.insert(salaryCard);
+        // mock 方法
+        when(employeeService.validateEmployeeExists(employeeId))
+                .thenReturn(randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId)));
+
+        // 调用
+        salaryCardService.deleteSalaryCardByEmployeeId(employeeId);
+
+        // 断言
+        assertEquals(0L, salaryCardMapper.selectCount());
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testDeleteSalaryCardByEmployeeId_notExists() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        // mock 方法
+        when(employeeService.validateEmployeeExists(employeeId))
+                .thenReturn(randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryCardService.deleteSalaryCardByEmployeeId(employeeId),
+                EMPLOYEE_SALARY_CARD_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetSalaryCardMap() {
+        // mock 数据
+        HrmEmployeeSalaryCardDO firstSalaryCard = randomSalaryCardDO(randomLongId());
+        salaryCardMapper.insert(firstSalaryCard);
+        HrmEmployeeSalaryCardDO secondSalaryCard = randomSalaryCardDO(randomLongId());
+        salaryCardMapper.insert(secondSalaryCard);
+        salaryCardMapper.insert(randomSalaryCardDO(randomLongId()));
+
+        // 调用
+        Map<Long, HrmEmployeeSalaryCardDO> result = salaryCardService.getSalaryCardMap(
+                java.util.Arrays.asList(firstSalaryCard.getEmployeeId(), secondSalaryCard.getEmployeeId()));
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(firstSalaryCard.getId(), result.get(firstSalaryCard.getEmployeeId()).getId());
+        assertEquals(secondSalaryCard.getId(), result.get(secondSalaryCard.getEmployeeId()).getId());
+        assertTrue(salaryCardService.getSalaryCardMap(Collections.emptyList()).isEmpty());
+    }
+
+    @Test
+    public void testGetSalaryCardMap_historyDuplicated() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeSalaryCardDO oldSalaryCard = randomSalaryCardDO(employeeId);
+        salaryCardMapper.insert(oldSalaryCard);
+        HrmEmployeeSalaryCardDO latestSalaryCard = randomSalaryCardDO(employeeId);
+        salaryCardMapper.insert(latestSalaryCard);
+
+        // 调用
+        Map<Long, HrmEmployeeSalaryCardDO> result = salaryCardService.getSalaryCardMap(
+                Collections.singletonList(employeeId));
+
+        // 断言
+        assertEquals(1, result.size());
+        assertEquals(latestSalaryCard.getId(), result.get(employeeId).getId());
+    }
+
+    private static HrmEmployeeSalaryCardDO randomSalaryCardDO(Long employeeId) {
+        return randomPojo(HrmEmployeeSalaryCardDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setDeleted(false));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateServiceImplTest.java
new file mode 100644
index 0000000..68f4a1b
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeCertificateServiceImplTest.java
@@ -0,0 +1,139 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.certificate.HrmEmployeeCertificateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeCertificateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeCertificateMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CERTIFICATE_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmEmployeeCertificateServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeCertificateServiceImpl.class)
+public class HrmEmployeeCertificateServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeCertificateServiceImpl certificateService;
+
+    @Resource
+    private HrmEmployeeCertificateMapper certificateMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreateCertificate_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeCertificateSaveReqVO reqVO = randomPojo(
+                HrmEmployeeCertificateSaveReqVO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10)
+                        .setStartTime(LocalDateTime.of(2025, 1, 1, 9, 30))
+                        .setEndTime(LocalDateTime.of(2027, 1, 1, 18, 0))
+                        .setIssuingTime(LocalDateTime.of(2024, 12, 20, 15, 30)));
+
+        // 调用
+        Long id = certificateService.createCertificate(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmEmployeeCertificateDO certificate = certificateMapper.selectById(id);
+        assertPojoEquals(reqVO, certificate, "id", "startTime", "endTime", "issuingTime");
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), certificate.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), certificate.getEndTime());
+        assertEquals(reqVO.getIssuingTime().toLocalDate().atStartOfDay(), certificate.getIssuingTime());
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testUpdateCertificate_success() {
+        // mock 数据
+        HrmEmployeeCertificateDO dbRecord = randomPojo(HrmEmployeeCertificateDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        certificateMapper.insert(dbRecord);
+        // 准备参数
+        HrmEmployeeCertificateSaveReqVO reqVO = randomPojo(
+                HrmEmployeeCertificateSaveReqVO.class,
+                o -> o.setId(dbRecord.getId()).setEmployeeId(dbRecord.getEmployeeId()).setSort(10)
+                        .setStartTime(LocalDateTime.of(2026, 1, 1, 9, 30))
+                        .setEndTime(LocalDateTime.of(2028, 1, 1, 18, 0))
+                        .setIssuingTime(LocalDateTime.of(2025, 12, 20, 15, 30)));
+
+        // 调用
+        certificateService.updateCertificate(reqVO);
+
+        // 断言
+        HrmEmployeeCertificateDO certificate = certificateMapper.selectById(dbRecord.getId());
+        assertPojoEquals(reqVO, certificate, "employeeId", "startTime", "endTime", "issuingTime");
+        assertEquals(dbRecord.getEmployeeId(), certificate.getEmployeeId());
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), certificate.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), certificate.getEndTime());
+        assertEquals(reqVO.getIssuingTime().toLocalDate().atStartOfDay(), certificate.getIssuingTime());
+    }
+
+    @Test
+    public void testDeleteCertificate_success() {
+        // mock 数据
+        HrmEmployeeCertificateDO dbRecord = randomPojo(HrmEmployeeCertificateDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        certificateMapper.insert(dbRecord);
+        // 准备参数
+        Long id = dbRecord.getId();
+
+        // 调用
+        certificateService.deleteCertificate(id);
+
+        // 断言
+        assertNull(certificateMapper.selectById(id));
+    }
+
+    @Test
+    public void testDeleteCertificate_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> certificateService.deleteCertificate(id), EMPLOYEE_CERTIFICATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetCertificateListByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeCertificateDO firstRecord = randomPojo(HrmEmployeeCertificateDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(20).setDeleted(false));
+        certificateMapper.insert(firstRecord);
+        HrmEmployeeCertificateDO secondRecord = randomPojo(HrmEmployeeCertificateDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10).setDeleted(false));
+        certificateMapper.insert(secondRecord);
+        certificateMapper.insert(randomPojo(HrmEmployeeCertificateDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(1).setDeleted(false)));
+
+        // 调用
+        List<HrmEmployeeCertificateDO> result = certificateService.getCertificateListByEmployeeId(employeeId);
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(secondRecord.getId(), result.get(0).getId());
+        assertEquals(firstRecord.getId(), result.get(1).getId());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceServiceImplTest.java
new file mode 100644
index 0000000..b58ada2
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeEducationExperienceServiceImplTest.java
@@ -0,0 +1,149 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.educationexperience.HrmEmployeeEducationExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeEducationExperienceDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeEducationExperienceMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_EDUCATION_EXPERIENCE_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmEmployeeEducationExperienceServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeEducationExperienceServiceImpl.class)
+public class HrmEmployeeEducationExperienceServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeEducationExperienceServiceImpl educationExperienceService;
+
+    @Resource
+    private HrmEmployeeEducationExperienceMapper educationExperienceMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreateEducationExperience_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeEducationExperienceSaveReqVO reqVO = randomPojo(
+                HrmEmployeeEducationExperienceSaveReqVO.class,
+                o -> {
+                    o.setId(null).setEmployeeId(employeeId).setSort(10);
+                    o.setEducation(1).setTeachingMethods(1).setFirstDegree(true)
+                            .setAdmissionTime(LocalDateTime.of(2020, 9, 1, 9, 30))
+                            .setGraduationTime(LocalDateTime.of(2024, 6, 30, 18, 0));
+                });
+
+        // 调用
+        Long id = educationExperienceService.createEducationExperience(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmEmployeeEducationExperienceDO educationExperience = educationExperienceMapper.selectById(id);
+        assertPojoEquals(reqVO, educationExperience, "id", "admissionTime", "graduationTime");
+        assertEquals(reqVO.getAdmissionTime().toLocalDate().atStartOfDay(), educationExperience.getAdmissionTime());
+        assertEquals(reqVO.getGraduationTime().toLocalDate().atStartOfDay(), educationExperience.getGraduationTime());
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testUpdateEducationExperience_success() {
+        // mock 数据
+        HrmEmployeeEducationExperienceDO dbRecord = randomPojo(HrmEmployeeEducationExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setEducation(1)
+                        .setTeachingMethods(1).setFirstDegree(false).setSort(20).setDeleted(false));
+        educationExperienceMapper.insert(dbRecord);
+        // 准备参数
+        HrmEmployeeEducationExperienceSaveReqVO reqVO = randomPojo(
+                HrmEmployeeEducationExperienceSaveReqVO.class,
+                o -> {
+                    o.setId(dbRecord.getId()).setEmployeeId(dbRecord.getEmployeeId()).setSort(10);
+                    o.setEducation(2).setTeachingMethods(2).setFirstDegree(true)
+                            .setAdmissionTime(LocalDateTime.of(2021, 9, 1, 9, 30))
+                            .setGraduationTime(LocalDateTime.of(2025, 6, 30, 18, 0));
+                });
+
+        // 调用
+        educationExperienceService.updateEducationExperience(reqVO);
+
+        // 断言
+        HrmEmployeeEducationExperienceDO educationExperience = educationExperienceMapper.selectById(dbRecord.getId());
+        assertPojoEquals(reqVO, educationExperience, "employeeId", "admissionTime", "graduationTime");
+        assertEquals(dbRecord.getEmployeeId(), educationExperience.getEmployeeId());
+        assertEquals(reqVO.getAdmissionTime().toLocalDate().atStartOfDay(), educationExperience.getAdmissionTime());
+        assertEquals(reqVO.getGraduationTime().toLocalDate().atStartOfDay(), educationExperience.getGraduationTime());
+    }
+
+    @Test
+    public void testDeleteEducationExperience_success() {
+        // mock 数据
+        HrmEmployeeEducationExperienceDO dbRecord = randomPojo(HrmEmployeeEducationExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setEducation(1)
+                        .setTeachingMethods(1).setFirstDegree(false).setSort(20).setDeleted(false));
+        educationExperienceMapper.insert(dbRecord);
+        // 准备参数
+        Long id = dbRecord.getId();
+
+        // 调用
+        educationExperienceService.deleteEducationExperience(id);
+
+        // 断言
+        assertNull(educationExperienceMapper.selectById(id));
+    }
+
+    @Test
+    public void testDeleteEducationExperience_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> educationExperienceService.deleteEducationExperience(id),
+                EMPLOYEE_EDUCATION_EXPERIENCE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetEducationExperienceListByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeEducationExperienceDO firstRecord = randomPojo(HrmEmployeeEducationExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setEducation(1)
+                        .setTeachingMethods(1).setFirstDegree(true).setSort(20).setDeleted(false));
+        educationExperienceMapper.insert(firstRecord);
+        HrmEmployeeEducationExperienceDO secondRecord = randomPojo(HrmEmployeeEducationExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setEducation(2)
+                        .setTeachingMethods(2).setFirstDegree(false).setSort(10).setDeleted(false));
+        educationExperienceMapper.insert(secondRecord);
+        educationExperienceMapper.insert(randomPojo(HrmEmployeeEducationExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setEducation(3)
+                        .setTeachingMethods(1).setFirstDegree(false).setSort(1).setDeleted(false)));
+
+        // 调用
+        List<HrmEmployeeEducationExperienceDO> result =
+                educationExperienceService.getEducationExperienceListByEmployeeId(employeeId);
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(secondRecord.getId(), result.get(0).getId());
+        assertEquals(firstRecord.getId(), result.get(1).getId());
+        assertNull(educationExperienceMapper.selectById(randomLongId()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceServiceImplTest.java
new file mode 100644
index 0000000..000a421
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeTrainingExperienceServiceImplTest.java
@@ -0,0 +1,137 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.trainingexperience.HrmEmployeeTrainingExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeTrainingExperienceDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeTrainingExperienceMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_TRAINING_EXPERIENCE_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmEmployeeTrainingExperienceServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeTrainingExperienceServiceImpl.class)
+public class HrmEmployeeTrainingExperienceServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeTrainingExperienceServiceImpl trainingExperienceService;
+
+    @Resource
+    private HrmEmployeeTrainingExperienceMapper trainingExperienceMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreateTrainingExperience_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeTrainingExperienceSaveReqVO reqVO = randomPojo(
+                HrmEmployeeTrainingExperienceSaveReqVO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10)
+                        .setStartTime(LocalDateTime.of(2026, 3, 1, 9, 30))
+                        .setEndTime(LocalDateTime.of(2026, 3, 31, 18, 0)));
+
+        // 调用
+        Long id = trainingExperienceService.createTrainingExperience(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmEmployeeTrainingExperienceDO trainingExperience = trainingExperienceMapper.selectById(id);
+        assertPojoEquals(reqVO, trainingExperience, "id", "startTime", "endTime");
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), trainingExperience.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), trainingExperience.getEndTime());
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testUpdateTrainingExperience_success() {
+        // mock 数据
+        HrmEmployeeTrainingExperienceDO dbRecord = randomPojo(HrmEmployeeTrainingExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        trainingExperienceMapper.insert(dbRecord);
+        // 准备参数
+        HrmEmployeeTrainingExperienceSaveReqVO reqVO = randomPojo(
+                HrmEmployeeTrainingExperienceSaveReqVO.class,
+                o -> o.setId(dbRecord.getId()).setEmployeeId(dbRecord.getEmployeeId()).setSort(10)
+                        .setStartTime(LocalDateTime.of(2026, 4, 1, 9, 30))
+                        .setEndTime(LocalDateTime.of(2026, 4, 30, 18, 0)));
+
+        // 调用
+        trainingExperienceService.updateTrainingExperience(reqVO);
+
+        // 断言
+        HrmEmployeeTrainingExperienceDO trainingExperience = trainingExperienceMapper.selectById(dbRecord.getId());
+        assertPojoEquals(reqVO, trainingExperience, "employeeId", "startTime", "endTime");
+        assertEquals(dbRecord.getEmployeeId(), trainingExperience.getEmployeeId());
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), trainingExperience.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), trainingExperience.getEndTime());
+    }
+
+    @Test
+    public void testDeleteTrainingExperience_success() {
+        // mock 数据
+        HrmEmployeeTrainingExperienceDO dbRecord = randomPojo(HrmEmployeeTrainingExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        trainingExperienceMapper.insert(dbRecord);
+        // 准备参数
+        Long id = dbRecord.getId();
+
+        // 调用
+        trainingExperienceService.deleteTrainingExperience(id);
+
+        // 断言
+        assertNull(trainingExperienceMapper.selectById(id));
+    }
+
+    @Test
+    public void testDeleteTrainingExperience_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> trainingExperienceService.deleteTrainingExperience(id),
+                EMPLOYEE_TRAINING_EXPERIENCE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetTrainingExperienceListByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeTrainingExperienceDO firstRecord = randomPojo(HrmEmployeeTrainingExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(20).setDeleted(false));
+        trainingExperienceMapper.insert(firstRecord);
+        HrmEmployeeTrainingExperienceDO secondRecord = randomPojo(HrmEmployeeTrainingExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10).setDeleted(false));
+        trainingExperienceMapper.insert(secondRecord);
+        trainingExperienceMapper.insert(randomPojo(HrmEmployeeTrainingExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(1).setDeleted(false)));
+
+        // 调用
+        List<HrmEmployeeTrainingExperienceDO> result =
+                trainingExperienceService.getTrainingExperienceListByEmployeeId(employeeId);
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(secondRecord.getId(), result.get(0).getId());
+        assertEquals(firstRecord.getId(), result.get(1).getId());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceServiceImplTest.java
new file mode 100644
index 0000000..58e69ea
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/experience/HrmEmployeeWorkExperienceServiceImplTest.java
@@ -0,0 +1,137 @@
+package cn.iocoder.yudao.module.hrm.service.employee.experience;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.workexperience.HrmEmployeeWorkExperienceSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.experience.HrmEmployeeWorkExperienceDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.experience.HrmEmployeeWorkExperienceMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_WORK_EXPERIENCE_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmEmployeeWorkExperienceServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeWorkExperienceServiceImpl.class)
+public class HrmEmployeeWorkExperienceServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeWorkExperienceServiceImpl workExperienceService;
+
+    @Resource
+    private HrmEmployeeWorkExperienceMapper workExperienceMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreateWorkExperience_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeWorkExperienceSaveReqVO reqVO = randomPojo(
+                HrmEmployeeWorkExperienceSaveReqVO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10)
+                        .setStartTime(LocalDateTime.of(2022, 3, 1, 9, 30))
+                        .setEndTime(LocalDateTime.of(2024, 2, 29, 18, 0)));
+
+        // 调用
+        Long id = workExperienceService.createWorkExperience(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmEmployeeWorkExperienceDO workExperience = workExperienceMapper.selectById(id);
+        assertPojoEquals(reqVO, workExperience, "id", "startTime", "endTime");
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), workExperience.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), workExperience.getEndTime());
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testUpdateWorkExperience_success() {
+        // mock 数据
+        HrmEmployeeWorkExperienceDO dbRecord = randomPojo(HrmEmployeeWorkExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        workExperienceMapper.insert(dbRecord);
+        // 准备参数
+        HrmEmployeeWorkExperienceSaveReqVO reqVO = randomPojo(
+                HrmEmployeeWorkExperienceSaveReqVO.class,
+                o -> o.setId(dbRecord.getId()).setEmployeeId(dbRecord.getEmployeeId()).setSort(10)
+                        .setStartTime(LocalDateTime.of(2023, 3, 1, 9, 30))
+                        .setEndTime(LocalDateTime.of(2025, 2, 28, 18, 0)));
+
+        // 调用
+        workExperienceService.updateWorkExperience(reqVO);
+
+        // 断言
+        HrmEmployeeWorkExperienceDO workExperience = workExperienceMapper.selectById(dbRecord.getId());
+        assertPojoEquals(reqVO, workExperience, "employeeId", "startTime", "endTime");
+        assertEquals(dbRecord.getEmployeeId(), workExperience.getEmployeeId());
+        assertEquals(reqVO.getStartTime().toLocalDate().atStartOfDay(), workExperience.getStartTime());
+        assertEquals(reqVO.getEndTime().toLocalDate().atStartOfDay(), workExperience.getEndTime());
+    }
+
+    @Test
+    public void testDeleteWorkExperience_success() {
+        // mock 数据
+        HrmEmployeeWorkExperienceDO dbRecord = randomPojo(HrmEmployeeWorkExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        workExperienceMapper.insert(dbRecord);
+        // 准备参数
+        Long id = dbRecord.getId();
+
+        // 调用
+        workExperienceService.deleteWorkExperience(id);
+
+        // 断言
+        assertNull(workExperienceMapper.selectById(id));
+    }
+
+    @Test
+    public void testDeleteWorkExperience_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> workExperienceService.deleteWorkExperience(id),
+                EMPLOYEE_WORK_EXPERIENCE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetWorkExperienceListByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeWorkExperienceDO firstRecord = randomPojo(HrmEmployeeWorkExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(20).setDeleted(false));
+        workExperienceMapper.insert(firstRecord);
+        HrmEmployeeWorkExperienceDO secondRecord = randomPojo(HrmEmployeeWorkExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10).setDeleted(false));
+        workExperienceMapper.insert(secondRecord);
+        workExperienceMapper.insert(randomPojo(HrmEmployeeWorkExperienceDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(1).setDeleted(false)));
+
+        // 调用
+        List<HrmEmployeeWorkExperienceDO> result =
+                workExperienceService.getWorkExperienceListByEmployeeId(employeeId);
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(secondRecord.getId(), result.get(0).getId());
+        assertEquals(firstRecord.getId(), result.get(1).getId());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactServiceImplTest.java
new file mode 100644
index 0000000..4fdd10c
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeContactServiceImplTest.java
@@ -0,0 +1,124 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.contact.HrmEmployeeContactSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeContactDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeContactMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CONTACT_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmEmployeeContactServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeContactServiceImpl.class)
+public class HrmEmployeeContactServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeContactServiceImpl contactService;
+
+    @Resource
+    private HrmEmployeeContactMapper contactMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreateContact_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeeContactSaveReqVO reqVO = randomPojo(
+                HrmEmployeeContactSaveReqVO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10));
+
+        // 调用
+        Long id = contactService.createContact(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        assertPojoEquals(reqVO, contactMapper.selectById(id), "id");
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testUpdateContact_success() {
+        // mock 数据
+        HrmEmployeeContactDO dbRecord = randomPojo(HrmEmployeeContactDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        contactMapper.insert(dbRecord);
+        // 准备参数
+        HrmEmployeeContactSaveReqVO reqVO = randomPojo(
+                HrmEmployeeContactSaveReqVO.class,
+                o -> o.setId(dbRecord.getId()).setEmployeeId(dbRecord.getEmployeeId()).setSort(10));
+
+        // 调用
+        contactService.updateContact(reqVO);
+
+        // 断言
+        HrmEmployeeContactDO contact = contactMapper.selectById(dbRecord.getId());
+        assertPojoEquals(reqVO, contact, "employeeId");
+        assertEquals(dbRecord.getEmployeeId(), contact.getEmployeeId());
+    }
+
+    @Test
+    public void testDeleteContact_success() {
+        // mock 数据
+        HrmEmployeeContactDO dbRecord = randomPojo(HrmEmployeeContactDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(20).setDeleted(false));
+        contactMapper.insert(dbRecord);
+        // 准备参数
+        Long id = dbRecord.getId();
+
+        // 调用
+        contactService.deleteContact(id);
+
+        // 断言
+        assertNull(contactMapper.selectById(id));
+    }
+
+    @Test
+    public void testDeleteContact_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> contactService.deleteContact(id), EMPLOYEE_CONTACT_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetContactListByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeeContactDO firstRecord = randomPojo(HrmEmployeeContactDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(20).setDeleted(false));
+        contactMapper.insert(firstRecord);
+        HrmEmployeeContactDO secondRecord = randomPojo(HrmEmployeeContactDO.class,
+                o -> o.setId(null).setEmployeeId(employeeId).setSort(10).setDeleted(false));
+        contactMapper.insert(secondRecord);
+        contactMapper.insert(randomPojo(HrmEmployeeContactDO.class,
+                o -> o.setId(null).setEmployeeId(randomLongId()).setSort(1).setDeleted(false)));
+
+        // 调用
+        List<HrmEmployeeContactDO> result = contactService.getContactListByEmployeeId(employeeId);
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(secondRecord.getId(), result.get(0).getId());
+        assertEquals(firstRecord.getId(), result.get(1).getId());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileServiceImplTest.java
new file mode 100644
index 0000000..274a4a7
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeFileServiceImplTest.java
@@ -0,0 +1,77 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.file.HrmEmployeeFileSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeFileDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeFileMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmEmployeeFileServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeeFileServiceImpl.class)
+public class HrmEmployeeFileServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeeFileServiceImpl employeeFileService;
+
+    @Resource
+    private HrmEmployeeFileMapper employeeFileMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testSaveEmployeeFiles_diffByUrl() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        Integer fileType = 21;
+        when(employeeService.validateEmployeeExists(employeeId)).thenReturn(
+                randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId)));
+        HrmEmployeeFileDO retainedFile = createEmployeeFile(employeeId, fileType, "https://example.com/keep.pdf");
+        employeeFileMapper.insert(retainedFile);
+        HrmEmployeeFileDO duplicateFile = createEmployeeFile(employeeId, fileType, retainedFile.getUrl());
+        employeeFileMapper.insert(duplicateFile);
+        HrmEmployeeFileDO deletedFile = createEmployeeFile(employeeId, fileType, "https://example.com/delete.pdf");
+        employeeFileMapper.insert(deletedFile);
+        // 准备参数
+        HrmEmployeeFileSaveReqVO reqVO = new HrmEmployeeFileSaveReqVO().setEmployeeId(employeeId).setType(fileType)
+                .setFileUrls(Arrays.asList(retainedFile.getUrl(), "https://example.com/create.pdf",
+                        retainedFile.getUrl()));
+
+        // 调用
+        employeeFileService.saveEmployeeFiles(reqVO);
+
+        // 断言
+        List<HrmEmployeeFileDO> dbFiles = employeeFileMapper.selectListByEmployeeIdAndType(employeeId, fileType);
+        assertEquals(2, dbFiles.size());
+        Map<String, HrmEmployeeFileDO> dbFileMap = convertMap(dbFiles, HrmEmployeeFileDO::getUrl);
+        assertEquals(retainedFile.getId(), dbFileMap.get(retainedFile.getUrl()).getId());
+        assertEquals("https://example.com/create.pdf", dbFileMap.get("https://example.com/create.pdf").getUrl());
+        assertNull(employeeFileMapper.selectById(duplicateFile.getId()));
+        assertNull(employeeFileMapper.selectById(deletedFile.getId()));
+    }
+
+    private static HrmEmployeeFileDO createEmployeeFile(Long employeeId, Integer fileType, String fileUrl) {
+        return new HrmEmployeeFileDO().setEmployeeId(employeeId).setType(fileType).setUrl(fileUrl);
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteServiceImplTest.java
new file mode 100644
index 0000000..90ec1cb
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeePersonalNoteServiceImplTest.java
@@ -0,0 +1,125 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.personalnote.HrmEmployeePersonalNoteCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeePersonalNoteDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeePersonalNoteMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_PERSONAL_NOTE_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmEmployeePersonalNoteServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmEmployeePersonalNoteServiceImpl.class)
+public class HrmEmployeePersonalNoteServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmEmployeePersonalNoteServiceImpl personalNoteService;
+    @Resource
+    private HrmEmployeePersonalNoteMapper personalNoteMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreatePersonalNote_success() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmEmployeePersonalNoteCreateReqVO reqVO = new HrmEmployeePersonalNoteCreateReqVO();
+        reqVO.setContent("跟进转正材料");
+        reqVO.setReminderTime(LocalDate.now().atTime(15, 30));
+
+        // 调用
+        Long id = personalNoteService.createPersonalNote(employeeId, reqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmEmployeePersonalNoteDO personalNote = personalNoteMapper.selectById(id);
+        assertPojoEquals(reqVO, personalNote);
+        assertEquals(employeeId, personalNote.getEmployeeId());
+        verify(employeeService).validateEmployeeExists(employeeId);
+    }
+
+    @Test
+    public void testDeletePersonalNote_success() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmEmployeePersonalNoteDO personalNote =
+                personalNote(employeeId, "准备周报", LocalDate.now().atTime(17, 30));
+        personalNoteMapper.insert(personalNote);
+
+        // 调用
+        personalNoteService.deletePersonalNote(employeeId, personalNote.getId());
+
+        // 断言
+        assertNull(personalNoteMapper.selectById(personalNote.getId()));
+    }
+
+    @Test
+    public void testDeletePersonalNote_notBelongEmployee() {
+        // mock 数据
+        HrmEmployeePersonalNoteDO personalNote =
+                personalNote(randomLongId(), "准备周报", LocalDate.now().atTime(17, 30));
+        personalNoteMapper.insert(personalNote);
+
+        // 调用，并断言异常
+        assertServiceException(() -> personalNoteService.deletePersonalNote(randomLongId(), personalNote.getId()),
+                EMPLOYEE_PERSONAL_NOTE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetPersonalNoteList() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        LocalDateTime beginTime = LocalDate.now().atStartOfDay();
+        HrmEmployeePersonalNoteDO secondNote =
+                personalNote(employeeId, "下午事项", beginTime.plusHours(15));
+        personalNoteMapper.insert(secondNote);
+        HrmEmployeePersonalNoteDO firstNote =
+                personalNote(employeeId, "上午事项", beginTime.plusHours(9));
+        personalNoteMapper.insert(firstNote);
+        personalNoteMapper.insert(personalNote(randomLongId(), "其他员工事项", beginTime.plusHours(10)));
+        HrmEmployeePersonalNoteDO endBoundaryNote =
+                personalNote(employeeId, "结束边界事项", beginTime.plusDays(1));
+        personalNoteMapper.insert(endBoundaryNote);
+        personalNoteMapper.insert(personalNote(employeeId, "范围外事项", beginTime.plusDays(1).plusSeconds(1)));
+
+        // 调用
+        List<HrmEmployeePersonalNoteDO> result =
+                personalNoteService.getPersonalNoteList(
+                        employeeId, new LocalDateTime[]{beginTime, beginTime.plusDays(1)});
+
+        // 断言
+        assertEquals(3, result.size());
+        assertEquals(firstNote.getId(), result.get(0).getId());
+        assertEquals(secondNote.getId(), result.get(1).getId());
+        assertEquals(endBoundaryNote.getId(), result.get(2).getId());
+    }
+
+    private HrmEmployeePersonalNoteDO personalNote(
+            Long employeeId, String content, LocalDateTime reminderTime) {
+        HrmEmployeePersonalNoteDO personalNote = new HrmEmployeePersonalNoteDO();
+        personalNote.setEmployeeId(employeeId);
+        personalNote.setContent(content);
+        personalNote.setReminderTime(reminderTime);
+        return personalNote;
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeServiceImplTest.java
new file mode 100644
index 0000000..05d0fa7
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/employee/info/HrmEmployeeServiceImplTest.java
@@ -0,0 +1,1710 @@
+package cn.iocoder.yudao.module.hrm.service.employee.info;
+
+import cn.iocoder.yudao.module.hrm.service.employee.config.HrmEmployeeFieldConfigService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeQuitInfoService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeSalaryCardService;
+import cn.iocoder.yudao.framework.common.exception.ServiceException;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeChangeRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeConvertToFullTimeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeRegularReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.changerecord.HrmEmployeeTransferReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCreateFromUserReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeNotifyRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeCancelQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeConfirmEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportExcelVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeImportRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.employee.vo.employee.HrmPortalEmployeeUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeQuitReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeRehireReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.employment.HrmEmployeeChangeRecordMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.config.HrmEmployeeArchiveFieldEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.experience.HrmEmployeeEducationEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeIdTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeImportDuplicateStrategyEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeSurveyTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTodoTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.framework.excel.core.HrmRecruitChannelExcelColumnSelectFunction;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.user.AdminUserApi;
+import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
+import com.mzt.logapi.beans.LogRecord;
+import com.mzt.logapi.service.ILogRecordService;
+import jakarta.annotation.Resource;
+import org.mockito.ArgumentCaptor;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Import;
+import org.springframework.boot.test.context.TestConfiguration;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+import org.springframework.transaction.PlatformTransactionManager;
+import org.springframework.transaction.support.TransactionTemplate;
+
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.Period;
+import java.util.List;
+import java.util.HashSet;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertMap;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.cloneIgnoreId;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomEmail;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomMobile;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomString;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CHANGE_TYPE_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CONFIRM_ENTRY_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_ENTRY_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_IMPORT_LIST_IS_EMPTY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_IMPORT_DUPLICATE_STRATEGY_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_JOB_NUMBER_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_LEADER_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_MOBILE_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_QUIT_CANCEL_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_QUIT_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_REHIRE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_USER_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CHANNEL_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.LogRecordConstants.HRM_EMPLOYEE_TYPE;
+import static java.util.Arrays.asList;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.singleton;
+import static java.util.Collections.singletonList;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.doThrow;
+import static org.mockito.Mockito.lenient;
+import static org.mockito.Mockito.times;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmEmployeeServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import({HrmEmployeeServiceImpl.class, HrmEmployeeServiceImplTest.TransactionTemplateTestConfiguration.class})
+public class HrmEmployeeServiceImplTest extends BaseDbUnitTest {
+
+    @TestConfiguration(proxyBeanMethods = false)
+    static class TransactionTemplateTestConfiguration {
+
+        @Bean
+        TransactionTemplate transactionTemplate(PlatformTransactionManager transactionManager) {
+            return new TransactionTemplate(transactionManager);
+        }
+
+    }
+
+    @Resource
+    private HrmEmployeeServiceImpl employeeService;
+
+    @Resource
+    private HrmEmployeeMapper employeeMapper;
+    @Resource
+    private HrmEmployeeChangeRecordMapper employeeChangeRecordMapper;
+
+    @MockitoBean
+    private AdminUserApi adminUserApi;
+    @MockitoBean
+    private NotifyMessageSendApi notifyMessageSendApi;
+    @MockitoBean
+    private ILogRecordService logRecordService;
+    @MockitoBean
+    private DeptApi deptApi;
+    @MockitoBean
+    private HrmRecruitChannelService recruitChannelService;
+    @MockitoBean
+    private HrmEmployeeFieldConfigService employeeFieldConfigService;
+    @MockitoBean
+    private HrmEmployeeChangeRecordService changeRecordService;
+    @MockitoBean
+    private HrmEmployeeQuitInfoService quitInfoService;
+    @MockitoBean
+    private HrmEmployeeSalaryCardService employeeSalaryCardService;
+    @MockitoBean
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @MockitoBean
+    private HrmInsuranceSchemeService insuranceSchemeService;
+    @MockitoBean
+    private HrmRecruitCandidateService recruitCandidateService;
+
+    @BeforeEach
+    public void setUpChangeRecordService() {
+        lenient().when(changeRecordService.createEmployeeChangeRecord(any())).thenAnswer(invocation -> {
+            HrmEmployeeChangeRecordCreateReqVO reqVO = invocation.getArgument(0);
+            return BeanUtils.toBean(reqVO, HrmEmployeeChangeRecordDO.class).setId(randomLongId());
+        });
+    }
+
+    @Test
+    public void testConfirmEmployeeEntry_success() {
+        // mock 数据
+        Long candidateId = randomLongId();
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())
+                .setEntryTime(null).setCandidateId(candidateId)
+                .setDeptId(10L).setPostName("开发工程师").setPostLevel("P5")
+                .setWorkAddress("杭州").setLeaderEmployeeId(11L)
+                .setRegularTime(LocalDateTime.now().plusMonths(1))
+                .setLeaveTime(LocalDateTime.now().plusYears(1)));
+        employeeMapper.insert(employee);
+        HrmEmployeeConfirmEntryReqVO confirmReqVO = BeanUtils.toBean(
+                randomEmployeeSaveReqVO(o -> o.setId(employee.getId())
+                        .setEntryTime(LocalDateTime.now().minusMinutes(1)).setCandidateId(candidateId)
+                        .setDeptId(null).setPostName(null).setPostLevel(null)
+                        .setWorkAddress(null).setLeaderEmployeeId(null)
+                        .setType(HrmEmployeeTypeEnum.INFORMAL.getType())
+                        .setStatus(HrmEmployeeStatusEnum.INTERN.getStatus())),
+                HrmEmployeeConfirmEntryReqVO.class);
+
+        // 调用
+        employeeService.confirmEmployeeEntry(confirmReqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus(), dbEmployee.getEntryStatus());
+        assertEquals(LocalDate.now(), dbEmployee.getEntryTime().toLocalDate());
+        assertNull(dbEmployee.getDeptId());
+        assertNull(dbEmployee.getPostName());
+        assertNull(dbEmployee.getPostLevel());
+        assertNull(dbEmployee.getWorkAddress());
+        assertNull(dbEmployee.getLeaderEmployeeId());
+        assertNull(dbEmployee.getRegularTime());
+        assertNull(dbEmployee.getLeaveTime());
+        verify(recruitCandidateService).confirmRecruitCandidateEntry(
+                candidateId, dbEmployee.getEntryTime());
+    }
+
+    @Test
+    public void testConfirmEmployeeEntry_statusInvalid() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO();
+        employeeMapper.insert(employee);
+        HrmEmployeeConfirmEntryReqVO reqVO = BeanUtils.toBean(
+                randomEmployeeSaveReqVO(o -> o.setId(employee.getId())), HrmEmployeeConfirmEntryReqVO.class);
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.confirmEmployeeEntry(reqVO),
+                EMPLOYEE_CONFIRM_ENTRY_STATUS_INVALID);
+    }
+
+    @Test
+    public void testRehireEmployee_success() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setLeaveTime(LocalDate.now().minusDays(1).atTime(18, 30))
+                .setDeptId(10L).setPostName("开发工程师").setPostLevel("P5")
+                .setWorkAddress("杭州").setLeaderEmployeeId(11L));
+        employeeMapper.insert(employee);
+        // 准备参数
+        LocalDateTime entryTime = LocalDateTime.now().minusMinutes(1).withNano(0);
+        HrmEmployeeRehireReqVO reqVO = BeanUtils.toBean(
+                randomEmployeeSaveReqVO(), HrmEmployeeRehireReqVO.class);
+        reqVO.setEmployeeId(employee.getId()).setEntryTime(entryTime)
+                .setCompanyAgeStartTime(entryTime)
+                .setDeptId(20L).setPostName("技术经理").setPostLevel("P7")
+                .setLeaderEmployeeId(null).setWorkCity("上海").setWorkAddress("浦东新区")
+                .setWorkDetailAddress("张江路 1 号")
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType()).setStatus(null).setProbation(3);
+
+        // 调用
+        employeeService.rehireEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus(), dbEmployee.getEntryStatus());
+        assertEquals(entryTime, dbEmployee.getEntryTime());
+        assertEquals(entryTime, dbEmployee.getCompanyAgeStartTime());
+        assertNull(dbEmployee.getLeaveTime());
+        assertEquals(HrmEmployeeStatusEnum.PROBATION.getStatus(), dbEmployee.getStatus());
+        assertEquals(20L, dbEmployee.getDeptId());
+        assertEquals("技术经理", dbEmployee.getPostName());
+        assertNull(dbEmployee.getLeaderEmployeeId());
+        verify(quitInfoService).deleteEmployeeQuitInfo(employee.getId());
+        verify(changeRecordService).createEmployeeChangeRecord(argThat((HrmEmployeeChangeRecordCreateReqVO record) ->
+                HrmEmployeeChangeTypeEnum.REHIRE.getType().equals(record.getType())
+                        && employee.getDeptId().equals(record.getOldDeptId())
+                        && reqVO.getDeptId().equals(record.getNewDeptId())));
+    }
+
+    @Test
+    public void testRehireEmployee_statusInvalid() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO();
+        employeeMapper.insert(employee);
+        // 准备参数
+        HrmEmployeeRehireReqVO reqVO = randomPojo(HrmEmployeeRehireReqVO.class,
+                o -> o.setEmployeeId(employee.getId()).setEntryTime(LocalDate.now().atStartOfDay())
+                        .setType(HrmEmployeeTypeEnum.FORMAL.getType()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.rehireEmployee(reqVO), EMPLOYEE_REHIRE_STATUS_INVALID);
+    }
+
+    @Test
+    public void testChangeEmployee_effectiveTransfer() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o.setDeptId(10L)
+                .setPostName("开发工程师").setPostLevel("P5")
+                .setWorkAddress("杭州").setLeaderEmployeeId(11L));
+        employeeMapper.insert(employee);
+        doAnswer(invocation -> {
+            HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+            assertEquals(10L, dbEmployee.getDeptId());
+            assertEquals("开发工程师", dbEmployee.getPostName());
+            HrmEmployeeChangeRecordCreateReqVO record = invocation.getArgument(0);
+            return BeanUtils.toBean(record, HrmEmployeeChangeRecordDO.class).setId(randomLongId());
+        }).when(changeRecordService).createEmployeeChangeRecord(argThat(record ->
+                employee.getId().equals(record.getEmployeeId())));
+        // 准备参数
+        HrmEmployeeTransferReqVO reqVO = new HrmEmployeeTransferReqVO();
+        reqVO.setEmployeeId(employee.getId());
+        reqVO.setReason(1);
+        reqVO.setNewDeptId(20L);
+        reqVO.setNewPostName("技术经理");
+        reqVO.setNewPostLevel("P7");
+        reqVO.setNewWorkAddress("上海");
+        reqVO.setNewLeaderEmployeeId(null);
+        reqVO.setEffectTime(LocalDate.now().atStartOfDay());
+
+        // 调用
+        employeeService.transferEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(20L, dbEmployee.getDeptId());
+        assertEquals("技术经理", dbEmployee.getPostName());
+        verify(changeRecordService).createEmployeeChangeRecord(argThat(record ->
+                employee.getDeptId().equals(record.getOldDeptId())
+                        && employee.getPostName().equals(record.getOldPostName())
+                        && reqVO.getEffectTime().equals(record.getEffectTime())));
+    }
+
+    @Test
+    public void testRegularEmployee_updatePosition() {
+        // mock 数据
+        HrmEmployeeDO leader = randomEmployeeDO();
+        employeeMapper.insert(leader);
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus()).setProbation(3)
+                .setDeptId(10L).setPostName("开发工程师").setPostLevel("P5")
+                .setWorkAddress("杭州").setLeaderEmployeeId(null));
+        employeeMapper.insert(employee);
+        // 准备参数
+        LocalDateTime effectTime = LocalDate.now().atStartOfDay();
+        HrmEmployeeRegularReqVO reqVO = new HrmEmployeeRegularReqVO();
+        reqVO.setEmployeeId(employee.getId()).setReason(1).setEffectTime(effectTime)
+                .setNewDeptId(20L).setNewPostName("技术经理").setNewPostLevel("P7")
+                .setNewWorkAddress("上海").setNewLeaderEmployeeId(leader.getId());
+
+        // 调用
+        employeeService.regularEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeStatusEnum.REGULAR.getStatus(), dbEmployee.getStatus());
+        assertEquals(3, dbEmployee.getProbation());
+        assertEquals(effectTime, dbEmployee.getRegularTime());
+        assertEquals(20L, dbEmployee.getDeptId());
+        assertEquals("技术经理", dbEmployee.getPostName());
+        assertEquals("P7", dbEmployee.getPostLevel());
+        assertEquals("上海", dbEmployee.getWorkAddress());
+        assertEquals(leader.getId(), dbEmployee.getLeaderEmployeeId());
+        verify(changeRecordService).createEmployeeChangeRecord(argThat(record ->
+                employee.getDeptId().equals(record.getOldDeptId())
+                        && reqVO.getNewDeptId().equals(record.getNewDeptId())
+                        && reqVO.getNewPostName().equals(record.getNewPostName())));
+    }
+
+    @Test
+    public void testConvertEmployeeToFullTime_withProbationAndPosition() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setType(HrmEmployeeTypeEnum.INFORMAL.getType())
+                .setStatus(HrmEmployeeStatusEnum.INTERN.getStatus()).setProbation(0)
+                .setDeptId(10L).setPostName("实习开发").setPostLevel("实习")
+                .setWorkAddress("杭州").setLeaderEmployeeId(null));
+        employeeMapper.insert(employee);
+        // 准备参数
+        LocalDateTime effectTime = LocalDate.now().atStartOfDay();
+        HrmEmployeeConvertToFullTimeReqVO reqVO = new HrmEmployeeConvertToFullTimeReqVO();
+        reqVO.setEmployeeId(employee.getId()).setReason(1).setProbation(3).setEffectTime(effectTime)
+                .setNewDeptId(20L).setNewPostName("开发工程师").setNewPostLevel("P5")
+                .setNewWorkAddress("上海");
+
+        // 调用
+        employeeService.convertEmployeeToFullTime(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeTypeEnum.FORMAL.getType(), dbEmployee.getType());
+        assertEquals(HrmEmployeeStatusEnum.PROBATION.getStatus(), dbEmployee.getStatus());
+        assertEquals(3, dbEmployee.getProbation());
+        assertEquals(effectTime.plusMonths(3), dbEmployee.getRegularTime());
+        assertEquals(20L, dbEmployee.getDeptId());
+        assertEquals("开发工程师", dbEmployee.getPostName());
+        verify(changeRecordService).createEmployeeChangeRecord(argThat(record ->
+                Integer.valueOf(3).equals(record.getProbation())
+                        && reqVO.getNewDeptId().equals(record.getNewDeptId())));
+    }
+
+    @Test
+    public void testChangeEmployee_future() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o.setDeptId(10L));
+        employeeMapper.insert(employee);
+        // 准备参数
+        HrmEmployeeTransferReqVO reqVO = new HrmEmployeeTransferReqVO();
+        reqVO.setEmployeeId(employee.getId());
+        reqVO.setReason(1);
+        reqVO.setNewDeptId(20L);
+        reqVO.setEffectTime(LocalDate.now().plusDays(1).atStartOfDay());
+
+        // 调用
+        employeeService.transferEmployee(reqVO);
+
+        // 断言
+        assertEquals(10L, employeeMapper.selectById(employee.getId()).getDeptId());
+        verify(changeRecordService).createEmployeeChangeRecord(argThat(record ->
+                employee.getDeptId().equals(record.getOldDeptId())
+                        && reqVO.getEffectTime().equals(record.getEffectTime())));
+    }
+
+    @Test
+    public void testApplyEmployeeChange_success() {
+        // mock 数据
+        LocalDateTime effectTime = LocalDate.now().atStartOfDay();
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setDeptId(10L).setPostName("开发工程师").setPostLevel("P5")
+                .setWorkAddress("杭州").setLeaderEmployeeId(11L));
+        employeeMapper.insert(employee);
+        HrmEmployeeChangeRecordDO changeRecord = HrmEmployeeChangeRecordDO.builder()
+                .employeeId(employee.getId()).type(HrmEmployeeChangeTypeEnum.TRANSFER.getType())
+                .newDeptId(20L).newPostName("技术经理").newPostLevel("P7")
+                .newWorkAddress("上海").newLeaderEmployeeId(21L).effectTime(effectTime).build();
+
+        // 调用
+        employeeService.applyEmployeeChange(changeRecord);
+
+        // 断言
+        HrmEmployeeDO changedEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(20L, changedEmployee.getDeptId());
+        assertEquals("技术经理", changedEmployee.getPostName());
+    }
+
+    @Test
+    public void testApplyEmployeeChange_typeInvalid() {
+        // 准备参数
+        HrmEmployeeChangeRecordDO changeRecord = HrmEmployeeChangeRecordDO.builder()
+                .employeeId(randomLongId()).type(99).build();
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.applyEmployeeChange(changeRecord),
+                EMPLOYEE_CHANGE_TYPE_INVALID, changeRecord.getType());
+    }
+
+    @Test
+    public void testApplyEmployeeRegular_success() {
+        // mock 数据
+        LocalDateTime regularTime = LocalDateTime.now().minusMinutes(1);
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus())
+                .setRegularTime(regularTime));
+        employeeMapper.insert(employee);
+
+        // 调用
+        List<HrmEmployeeDO> regularEmployees =
+                employeeService.getDueRegularEmployeeList(LocalDateTime.now());
+        assertTrue(employeeService.applyEmployeeRegular(employee.getId()));
+
+        // 断言
+        assertEquals(1, regularEmployees.size());
+        assertEquals(employee.getId(), regularEmployees.get(0).getId());
+        assertEquals(HrmEmployeeStatusEnum.REGULAR.getStatus(),
+                employeeMapper.selectById(employee.getId()).getStatus());
+    }
+
+    @Test
+    public void testApplyEmployeeQuit_success() {
+        // mock 数据
+        LocalDate effectTime = LocalDate.now();
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setCompanyAgeStartTime(effectTime.minusYears(3).atStartOfDay()));
+        employeeMapper.insert(employee);
+        LocalDateTime planQuitTime = LocalDateTime.now().minusMinutes(1);
+        HrmEmployeeQuitInfoDO quitInfo = HrmEmployeeQuitInfoDO.builder()
+                .employeeId(employee.getId()).planQuitTime(planQuitTime).build();
+
+        // 调用
+        boolean result = employeeService.applyEmployeeQuit(quitInfo);
+
+        // 断言
+        assertTrue(result);
+        HrmEmployeeDO leftEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.LEFT.getStatus(), leftEmployee.getEntryStatus());
+        assertEquals(planQuitTime, leftEmployee.getLeaveTime());
+        assertEquals(3, leftEmployee.getCompanyAge());
+    }
+
+    @Test
+    public void testApplyEmployeeRegular_leftEmployee_doesNotRevive() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus())
+                .setRegularTime(LocalDateTime.now().minusDays(1)));
+        employeeMapper.insert(employee);
+
+        // 调用
+        boolean result = employeeService.applyEmployeeRegular(employee.getId());
+
+        // 断言
+        assertFalse(result);
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.LEFT.getStatus(), dbEmployee.getEntryStatus());
+        assertEquals(HrmEmployeeStatusEnum.PROBATION.getStatus(), dbEmployee.getStatus());
+    }
+
+    @Test
+    public void testQuitEmployee_pendingLeave() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus()));
+        employeeMapper.insert(employee);
+        // 准备参数
+        LocalDateTime planQuitTime = LocalDateTime.now().plusDays(10).withNano(0);
+        HrmEmployeeQuitReqVO reqVO = randomPojo(HrmEmployeeQuitReqVO.class,
+                o -> o.setEmployeeId(employee.getId()).setPlanQuitTime(planQuitTime)
+                        .setApplyQuitTime(LocalDateTime.now().minusDays(1).withNano(0))
+                        .setSalarySettlementTime(planQuitTime).setType(1).setReason(1));
+
+        // 调用
+        employeeService.quitEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus(), dbEmployee.getEntryStatus());
+        assertEquals(planQuitTime, dbEmployee.getLeaveTime());
+        verify(quitInfoService).saveEmployeeQuitInfo(argThat(quitInfo ->
+                employee.getId().equals(quitInfo.getEmployeeId())
+                        && employee.getStatus().equals(quitInfo.getOldEmployeeStatus())
+                        && reqVO.getApplyQuitTime().toLocalDate().atStartOfDay()
+                                .equals(quitInfo.getApplyQuitTime())
+                        && reqVO.getSalarySettlementTime().toLocalDate().atStartOfDay()
+                                .equals(quitInfo.getSalarySettlementTime())));
+    }
+
+    @Test
+    public void testQuitEmployee_sameDayNaturalDates() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus()));
+        employeeMapper.insert(employee);
+        // 准备参数：申请、计划离职和薪资结算在同一自然日，时刻先后不影响日期校验
+        LocalDate quitDate = LocalDate.now().plusDays(10);
+        HrmEmployeeQuitReqVO reqVO = randomPojo(HrmEmployeeQuitReqVO.class,
+                o -> o.setEmployeeId(employee.getId()).setPlanQuitTime(quitDate.atTime(9, 0))
+                        .setApplyQuitTime(quitDate.atTime(18, 0))
+                        .setSalarySettlementTime(quitDate.atStartOfDay()).setType(1).setReason(1));
+
+        // 调用
+        employeeService.quitEmployee(reqVO);
+
+        // 断言
+        verify(quitInfoService).saveEmployeeQuitInfo(argThat(quitInfo ->
+                quitDate.atStartOfDay().equals(quitInfo.getApplyQuitTime())
+                        && quitDate.atStartOfDay().equals(quitInfo.getSalarySettlementTime())));
+    }
+
+    @Test
+    public void testQuitEmployee_effective() {
+        // mock 数据
+        LocalDate companyAgeStartDate = LocalDate.now().minusYears(3);
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setCompanyAgeStartTime(companyAgeStartDate.atStartOfDay()));
+        employeeMapper.insert(employee);
+        // 准备参数
+        LocalDateTime planQuitTime = LocalDateTime.now().minusMinutes(1).withNano(0);
+        HrmEmployeeQuitReqVO reqVO = randomPojo(HrmEmployeeQuitReqVO.class,
+                o -> o.setEmployeeId(employee.getId()).setPlanQuitTime(planQuitTime)
+                        .setApplyQuitTime(planQuitTime.minusDays(7))
+                        .setSalarySettlementTime(planQuitTime).setType(1).setReason(1));
+
+        // 调用
+        employeeService.quitEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.LEFT.getStatus(), dbEmployee.getEntryStatus());
+        assertEquals(3, dbEmployee.getCompanyAge());
+    }
+
+    @Test
+    public void testQuitEmployee_statusInvalid() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus()));
+        employeeMapper.insert(employee);
+        // 准备参数
+        HrmEmployeeQuitReqVO reqVO = randomPojo(HrmEmployeeQuitReqVO.class,
+                o -> o.setEmployeeId(employee.getId()).setPlanQuitTime(LocalDateTime.now()).setType(1).setReason(1));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.quitEmployee(reqVO), EMPLOYEE_QUIT_STATUS_INVALID);
+    }
+
+    @Test
+    public void testQuitEmployee_leftUpdate() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setCompanyAgeStartTime(LocalDate.now().minusYears(2).atStartOfDay()));
+        employeeMapper.insert(employee);
+        // 准备参数
+        LocalDateTime planQuitTime = LocalDateTime.now().minusDays(1).withNano(0);
+        HrmEmployeeQuitReqVO reqVO = randomPojo(HrmEmployeeQuitReqVO.class,
+                o -> o.setEmployeeId(employee.getId()).setPlanQuitTime(planQuitTime)
+                        .setApplyQuitTime(planQuitTime.minusDays(7))
+                        .setSalarySettlementTime(planQuitTime).setType(1).setReason(1));
+
+        // 调用
+        employeeService.quitEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.LEFT.getStatus(), dbEmployee.getEntryStatus());
+        assertEquals(planQuitTime, dbEmployee.getLeaveTime());
+        assertEquals(1, dbEmployee.getCompanyAge());
+        verify(quitInfoService).saveEmployeeQuitInfo(argThat(quitInfo ->
+                employee.getId().equals(quitInfo.getEmployeeId())));
+    }
+
+    @Test
+    public void testCancelEmployeeQuit_success() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setLeaveTime(LocalDateTime.now().plusDays(10)));
+        employeeMapper.insert(employee);
+        HrmEmployeeCancelQuitReqVO reqVO = new HrmEmployeeCancelQuitReqVO()
+                .setEmployeeId(employee.getId()).setReason("员工撤回离职");
+
+        // 调用
+        employeeService.cancelEmployeeQuit(reqVO);
+
+        // 断言
+        HrmEmployeeDO dbEmployee = employeeMapper.selectById(employee.getId());
+        assertEquals(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus(), dbEmployee.getEntryStatus());
+        assertNull(dbEmployee.getLeaveTime());
+        verify(quitInfoService).validateQuitInfoByEmployeeId(employee.getId());
+        verify(quitInfoService).deleteEmployeeQuitInfo(employee.getId());
+    }
+
+    @Test
+    public void testCancelEmployeeQuit_statusInvalid() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+        employeeMapper.insert(employee);
+        HrmEmployeeCancelQuitReqVO reqVO = new HrmEmployeeCancelQuitReqVO()
+                .setEmployeeId(employee.getId()).setReason("员工撤回离职");
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.cancelEmployeeQuit(reqVO),
+                EMPLOYEE_QUIT_CANCEL_STATUS_INVALID);
+    }
+
+    @Test
+    public void testCreateEmployee_success() {
+        // 准备参数
+        LocalDateTime entryTime = LocalDate.now().minusMonths(1).atTime(9, 0);
+        LocalDateTime birthday = LocalDate.now().minusYears(30).atTime(8, 30);
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o.setIdType(HrmEmployeeIdTypeEnum.OTHER.getType())
+                .setBirthday(birthday).setEntryTime(entryTime)
+                .setCompanyAgeStartTime(null).setProbation(3));
+
+        // 调用
+        Long employeeId = employeeService.createEmployee(reqVO);
+
+        // 断言
+        assertNotNull(employeeId);
+        HrmEmployeeDO employee = employeeMapper.selectById(employeeId);
+        assertPojoEquals(reqVO, employee, "id", "birthday", "age", "status", "regularTime",
+                "companyAgeStartTime", "companyAge");
+        assertEquals(30, employee.getAge());
+        assertEquals(birthday, employee.getBirthday());
+        assertEquals(HrmEmployeeStatusEnum.PROBATION.getStatus(), employee.getStatus());
+        assertEquals(entryTime.plusMonths(3), employee.getRegularTime());
+        assertEquals(entryTime, employee.getCompanyAgeStartTime());
+        assertEquals(0, employee.getCompanyAge());
+    }
+
+    @Test
+    public void testCreateEmployee_idCard15Birthday() {
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o
+                .setIdType(HrmEmployeeIdTypeEnum.ID_CARD.getType())
+                .setIdNumber("130503670401001")
+                .setBirthday(LocalDateTime.of(2000, 1, 1, 12, 30)));
+
+        // 调用
+        Long employeeId = employeeService.createEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO employee = employeeMapper.selectById(employeeId);
+        assertEquals(LocalDate.of(1967, 4, 1).atStartOfDay(), employee.getBirthday());
+        assertEquals(Period.between(LocalDate.of(1967, 4, 1), LocalDate.now()).getYears(), employee.getAge());
+    }
+
+    @Test
+    public void testCreateEmployee_zeroProbationFutureEntry() {
+        // 准备参数
+        LocalDateTime entryTime = LocalDate.now().plusMonths(1).atTime(9, 0);
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o
+                .setEntryTime(entryTime).setProbation(0));
+
+        // 调用
+        Long employeeId = employeeService.createEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO employee = employeeMapper.selectById(employeeId);
+        assertEquals(HrmEmployeeStatusEnum.REGULAR.getStatus(), employee.getStatus());
+        assertEquals(entryTime, employee.getRegularTime());
+    }
+
+    @Test
+    public void testCreateEmployee_validateRelations() {
+        // mock 数据
+        HrmEmployeeDO leaderEmployee = randomEmployeeDO();
+        employeeMapper.insert(leaderEmployee);
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o.setUserId(randomLongId())
+                .setDeptId(randomLongId()).setLeaderEmployeeId(leaderEmployee.getId())
+                .setChannelId(randomLongId()).setCandidateId(randomLongId()));
+
+        // 调用
+        employeeService.createEmployee(reqVO);
+
+        // 断言
+        verify(adminUserApi).validateUser(reqVO.getUserId());
+        verify(deptApi).validateDeptList(singleton(reqVO.getDeptId()));
+        verify(recruitChannelService).validateRecruitChannelExists(reqVO.getChannelId());
+        verify(recruitCandidateService).validateRecruitCandidateExists(reqVO.getCandidateId());
+    }
+
+    @Test
+    public void testCreateEmployeeList_success() {
+        // mock 数据
+        AdminUserRespDTO firstUser = randomPojo(AdminUserRespDTO.class, o -> o.setId(randomLongId())
+                .setNickname("张三").setMobile("15601691301").setEmail("zhangsan@example.com").setSex(1)
+                .setDeptId(10L));
+        AdminUserRespDTO secondUser = randomPojo(AdminUserRespDTO.class, o -> o.setId(randomLongId())
+                .setNickname("李四").setMobile("15601691302").setEmail("lisi@example.com").setSex(2)
+                .setDeptId(20L));
+        // 准备参数
+        HrmEmployeeCreateFromUserReqVO firstReqVO = new HrmEmployeeCreateFromUserReqVO()
+                .setUserId(firstUser.getId()).setJobNumber("HRM-BATCH-001").setMobile(firstUser.getMobile())
+                .setDeptId(firstUser.getDeptId()).setType(HrmEmployeeTypeEnum.FORMAL.getType())
+                .setProbation(0).setEntryTime(LocalDate.now().atTime(9, 0));
+        HrmEmployeeCreateFromUserReqVO secondReqVO = new HrmEmployeeCreateFromUserReqVO()
+                .setUserId(secondUser.getId()).setJobNumber("HRM-BATCH-002").setMobile(secondUser.getMobile())
+                .setDeptId(secondUser.getDeptId()).setType(HrmEmployeeTypeEnum.INFORMAL.getType())
+                .setStatus(HrmEmployeeStatusEnum.INTERN.getStatus()).setEntryTime(LocalDate.now().atTime(9, 0));
+        List<HrmEmployeeCreateFromUserReqVO> createReqVOList = asList(firstReqVO, secondReqVO);
+        // mock 方法
+        when(adminUserApi.getUserList(argThat(ids -> ids.containsAll(asList(firstUser.getId(), secondUser.getId())))))
+                .thenReturn(asList(firstUser, secondUser));
+        doAnswer(invocation -> {
+            HrmEmployeeSaveReqVO saveReqVO = invocation.getArgument(0);
+            assertNull(saveReqVO.getName());
+            assertNull(saveReqVO.getEmail());
+            assertNull(saveReqVO.getSex());
+            assertNull(saveReqVO.getCompanyAgeStartTime());
+            return null;
+        }).when(employeeFieldConfigService).validateEmployeeCreateFields(any(), any());
+
+        // 调用
+        List<Long> result = employeeService.createEmployeeList(createReqVOList);
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(2L, employeeMapper.selectCount());
+        assertEquals("张三", employeeMapper.selectByUserId(firstUser.getId()).getName());
+        assertEquals("李四", employeeMapper.selectByUserId(secondUser.getId()).getName());
+        assertEquals(firstReqVO.getEntryTime(),
+                employeeMapper.selectByUserId(firstUser.getId()).getCompanyAgeStartTime());
+        verify(adminUserApi).validateUserList(argThat(ids ->
+                ids.containsAll(asList(firstUser.getId(), secondUser.getId()))));
+        ArgumentCaptor<LogRecord> logRecordCaptor = ArgumentCaptor.forClass(LogRecord.class);
+        verify(logRecordService, times(2)).record(logRecordCaptor.capture());
+        Map<String, LogRecord> logRecordMap = convertMap(logRecordCaptor.getAllValues(), LogRecord::getBizNo);
+        HrmEmployeeDO firstEmployee = employeeMapper.selectByUserId(firstUser.getId());
+        HrmEmployeeDO secondEmployee = employeeMapper.selectByUserId(secondUser.getId());
+        assertEquals("从后台用户创建了员工档案【张三】",
+                logRecordMap.get(String.valueOf(firstEmployee.getId())).getAction());
+        assertEquals("从后台用户创建了员工档案【李四】",
+                logRecordMap.get(String.valueOf(secondEmployee.getId())).getAction());
+    }
+
+    @Test
+    public void testSendEmployeeProfileFillMessage_withSkippedAndFailure() {
+        // mock 数据
+        HrmEmployeeDO successEmployee = randomEmployeeDO(o -> o.setUserId(randomLongId()));
+        employeeMapper.insert(successEmployee);
+        HrmEmployeeDO skippedEmployee = randomEmployeeDO(o -> o.setUserId(null));
+        employeeMapper.insert(skippedEmployee);
+        HrmEmployeeDO failureEmployee = randomEmployeeDO(o -> o.setUserId(randomLongId()));
+        employeeMapper.insert(failureEmployee);
+        // 准备参数
+        List<Long> employeeIds = asList(successEmployee.getId(), skippedEmployee.getId(), failureEmployee.getId());
+        // mock 方法
+        doThrow(new IllegalStateException("template unavailable")).when(notifyMessageSendApi)
+                .sendSingleMessageToAdmin(argThat(message -> failureEmployee.getUserId().equals(message.getUserId())));
+
+        // 调用
+        HrmEmployeeNotifyRespVO result = employeeService.sendEmployeeProfileFillMessage(employeeIds);
+
+        // 断言
+        assertEquals(1, result.getSuccessCount());
+        assertEquals(1, result.getSkippedCount());
+        assertEquals(1, result.getFailureCount());
+        verify(notifyMessageSendApi).sendSingleMessageToAdmin(argThat(message ->
+                successEmployee.getUserId().equals(message.getUserId())));
+        ArgumentCaptor<LogRecord> logRecordCaptor = ArgumentCaptor.forClass(LogRecord.class);
+        verify(logRecordService).record(logRecordCaptor.capture());
+        LogRecord logRecord = logRecordCaptor.getValue();
+        assertEquals(HRM_EMPLOYEE_TYPE, logRecord.getType());
+        assertEquals(String.valueOf(successEmployee.getId()), logRecord.getBizNo());
+        assertEquals("向员工【" + successEmployee.getName() + "】发送了填写档案通知",
+                logRecord.getAction());
+    }
+
+    @Test
+    public void testUpdateEmployee_success() {
+        // mock 数据
+        HrmEmployeeDO dbEmployee = randomEmployeeDO();
+        employeeMapper.insert(dbEmployee);
+        // 准备参数
+        LocalDateTime entryTime = LocalDate.now().minusYears(2).atTime(9, 15);
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o.setId(dbEmployee.getId())
+                .setType(HrmEmployeeTypeEnum.INFORMAL.getType())
+                .setStatus(HrmEmployeeStatusEnum.CONSULTANT.getStatus()).setProbation(3)
+                .setEntryTime(entryTime).setCompanyAgeStartTime(entryTime));
+
+        // 调用
+        employeeService.updateEmployee(reqVO);
+
+        // 断言
+        HrmEmployeeDO employee = employeeMapper.selectById(dbEmployee.getId());
+        assertPojoEquals(reqVO, employee, "age", "entryStatus", "type", "status",
+                "probation", "regularTime", "leaveTime", "companyAge");
+        assertEquals(dbEmployee.getType(), employee.getType());
+        assertEquals(dbEmployee.getStatus(), employee.getStatus());
+        assertEquals(dbEmployee.getProbation(), employee.getProbation());
+        assertEquals(dbEmployee.getRegularTime(), employee.getRegularTime());
+        assertEquals(2, employee.getCompanyAge());
+    }
+
+    @Test
+    public void testUpdateEmployee_notExists() {
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o.setId(randomLongId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.updateEmployee(reqVO), EMPLOYEE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testUpdateEmployee_leaderInvalid() {
+        // mock 数据
+        HrmEmployeeDO dbEmployee = randomEmployeeDO();
+        employeeMapper.insert(dbEmployee);
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o
+                .setId(dbEmployee.getId()).setLeaderEmployeeId(dbEmployee.getId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.updateEmployee(reqVO), EMPLOYEE_LEADER_INVALID);
+    }
+
+    @Test
+    public void testUpdateEmployee_leaderDescendantInvalid() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o.setLeaderEmployeeId(null));
+        employeeMapper.insert(employee);
+        HrmEmployeeDO childEmployee = randomEmployeeDO(o -> o.setLeaderEmployeeId(employee.getId()));
+        employeeMapper.insert(childEmployee);
+        HrmEmployeeDO grandchildEmployee = randomEmployeeDO(o -> o.setLeaderEmployeeId(childEmployee.getId()));
+        employeeMapper.insert(grandchildEmployee);
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o
+                .setId(employee.getId()).setLeaderEmployeeId(grandchildEmployee.getId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.updateEmployee(reqVO), EMPLOYEE_LEADER_INVALID);
+    }
+
+    @Test
+    public void testDeleteEmployee_success() {
+        // mock 数据
+        HrmEmployeeDO dbEmployee = randomEmployeeDO();
+        employeeMapper.insert(dbEmployee);
+
+        // 调用
+        employeeService.deleteEmployee(dbEmployee.getId());
+
+        // 断言
+        assertNull(employeeMapper.selectById(dbEmployee.getId()));
+    }
+
+    @Test
+    public void testDeleteEmployee_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.deleteEmployee(id), EMPLOYEE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testDeleteEmployeeList_successAndDeduplicate() {
+        // mock 数据
+        HrmEmployeeDO firstEmployee = randomEmployeeDO();
+        employeeMapper.insert(firstEmployee);
+        HrmEmployeeDO secondEmployee = randomEmployeeDO();
+        employeeMapper.insert(secondEmployee);
+        HrmEmployeeDO retainedEmployee = randomEmployeeDO();
+        employeeMapper.insert(retainedEmployee);
+        // 准备参数
+        List<Long> ids = asList(firstEmployee.getId(), secondEmployee.getId(), firstEmployee.getId());
+
+        // 调用
+        employeeService.deleteEmployeeList(ids);
+
+        // 断言
+        assertNull(employeeMapper.selectById(firstEmployee.getId()));
+        assertNull(employeeMapper.selectById(secondEmployee.getId()));
+        assertNotNull(employeeMapper.selectById(retainedEmployee.getId()));
+    }
+
+    @Test
+    public void testDeleteEmployeeList_ignoreNotExists() {
+        // mock 数据
+        HrmEmployeeDO firstEmployee = randomEmployeeDO();
+        employeeMapper.insert(firstEmployee);
+        HrmEmployeeDO secondEmployee = randomEmployeeDO();
+        employeeMapper.insert(secondEmployee);
+        // 准备参数
+        List<Long> ids = asList(firstEmployee.getId(), randomLongId(), secondEmployee.getId());
+
+        // 调用
+        employeeService.deleteEmployeeList(ids);
+
+        // 断言
+        assertNull(employeeMapper.selectById(firstEmployee.getId()));
+        assertNull(employeeMapper.selectById(secondEmployee.getId()));
+    }
+
+    @Test
+    public void testCreateEmployee_jobNumberDuplicate() {
+        // mock 数据
+        HrmEmployeeDO dbEmployee = randomEmployeeDO();
+        employeeMapper.insert(dbEmployee);
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o.setJobNumber(dbEmployee.getJobNumber()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.createEmployee(reqVO), EMPLOYEE_JOB_NUMBER_DUPLICATE);
+    }
+
+    @Test
+    public void testCreateEmployee_mobileDuplicate() {
+        // mock 数据
+        HrmEmployeeDO dbEmployee = randomEmployeeDO();
+        employeeMapper.insert(dbEmployee);
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o.setMobile(dbEmployee.getMobile()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.createEmployee(reqVO), EMPLOYEE_MOBILE_DUPLICATE);
+    }
+
+    @Test
+    public void testCreateEmployee_userDuplicate() {
+        // mock 数据
+        HrmEmployeeDO dbEmployee = randomEmployeeDO(o -> o.setUserId(randomLongId()));
+        employeeMapper.insert(dbEmployee);
+        // 准备参数
+        HrmEmployeeSaveReqVO reqVO = randomEmployeeSaveReqVO(o -> o.setUserId(dbEmployee.getUserId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.createEmployee(reqVO), EMPLOYEE_USER_DUPLICATE);
+    }
+
+    @Test
+    public void testGetEmployeeByBusinessKey_duplicateReturnsLatest() {
+        // mock 数据
+        Long userId = randomLongId();
+        Long candidateId = randomLongId();
+        String jobNumber = "HRM-DUPLICATE";
+        HrmEmployeeDO firstEmployee = randomEmployeeDO(o -> o.setUserId(userId)
+                .setCandidateId(candidateId).setJobNumber(jobNumber));
+        employeeMapper.insert(firstEmployee);
+        HrmEmployeeDO latestEmployee = randomEmployeeDO(o -> o.setUserId(userId)
+                .setCandidateId(candidateId).setJobNumber(jobNumber));
+        employeeMapper.insert(latestEmployee);
+
+        // 调用，并断言
+        assertEquals(latestEmployee.getId(), employeeService.getEmployeeByUserId(userId).getId());
+        assertEquals(latestEmployee.getId(), employeeService.getEmployeeByJobNumber(jobNumber).getId());
+        assertEquals(latestEmployee.getId(), employeeService.getEmployeeByCandidateId(candidateId).getId());
+    }
+
+    @Test
+    public void testValidateEmployeeListByEntryStatus_success() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+        employeeMapper.insert(employee);
+
+        // 调用
+        employeeService.validateEmployeeListByEntryStatus(
+                singleton(employee.getId()), HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+    }
+
+    @Test
+    public void testValidateEmployeeListByEntryStatus_invalid() {
+        // mock 数据
+        HrmEmployeeDO employee = randomEmployeeDO(o -> o.setName("已离职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus()));
+        employeeMapper.insert(employee);
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.validateEmployeeListByEntryStatus(
+                        singleton(employee.getId()), HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()),
+                EMPLOYEE_ENTRY_STATUS_INVALID, employee.getName());
+    }
+
+    @Test
+    public void testUpdateEmployeeChannelByChannelId_success() {
+        // mock 数据
+        HrmEmployeeDO firstEmployee = randomEmployeeDO(o -> o.setChannelId(10L));
+        employeeMapper.insert(firstEmployee);
+        HrmEmployeeDO secondEmployee = randomEmployeeDO(o -> o.setChannelId(10L));
+        employeeMapper.insert(secondEmployee);
+        HrmEmployeeDO retainedEmployee = randomEmployeeDO(o -> o.setChannelId(30L));
+        employeeMapper.insert(retainedEmployee);
+
+        // 调用
+        employeeService.updateEmployeeChannelByChannelId(10L, 20L);
+
+        // 断言
+        assertEquals(20L, employeeMapper.selectById(firstEmployee.getId()).getChannelId());
+        assertEquals(20L, employeeMapper.selectById(secondEmployee.getId()).getChannelId());
+        assertEquals(30L, employeeMapper.selectById(retainedEmployee.getId()).getChannelId());
+    }
+
+    @Test
+    public void testGetEmployeePage() {
+        // mock 数据
+        LocalDateTime entryTime = LocalDateTime.of(2026, 1, 15, 9, 0);
+        LocalDateTime regularTime = LocalDateTime.of(2026, 4, 15, 9, 0);
+        HrmEmployeeDO dbEmployee = randomEmployeeDO(o -> o.setName("张三").setJobNumber("HRM001")
+                .setMobile("15601691300").setSex(1).setEntryTime(entryTime).setDeptId(100L)
+                .setPostName("Java 开发工程师").setRegularTime(regularTime).setWorkAddress("西湖区")
+                .setChannelId(10L)
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus()));
+        employeeMapper.insert(dbEmployee);
+        // 测试各查询条件不匹配
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setName("李四")));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setJobNumber("RD001")));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setMobile("13900000000")));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setSex(2)));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee,
+                o -> o.setEntryTime(LocalDate.of(2025, 12, 31).atStartOfDay())));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setDeptId(101L)));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setPostName("产品经理")));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee,
+                o -> o.setRegularTime(LocalDate.of(2026, 5, 2).atStartOfDay())));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setWorkAddress("滨江区")));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee, o -> o.setChannelId(20L)));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee,
+                o -> o.setType(HrmEmployeeTypeEnum.INFORMAL.getType())));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee,
+                o -> o.setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        employeeMapper.insert(cloneIgnoreId(dbEmployee,
+                o -> o.setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())));
+        // 准备参数
+        HrmEmployeePageReqVO reqVO = new HrmEmployeePageReqVO();
+        reqVO.setName("张");
+        reqVO.setJobNumber("HRM");
+        reqVO.setMobile("156");
+        reqVO.setSex(1);
+        reqVO.setEntryTime(new LocalDateTime[]{
+                LocalDate.of(2026, 1, 1).atStartOfDay(), LocalDate.of(2026, 2, 1).atStartOfDay()});
+        reqVO.setDeptId(100L);
+        reqVO.setPostName("Java");
+        reqVO.setRegularTime(new LocalDateTime[]{
+                LocalDate.of(2026, 4, 1).atStartOfDay(), LocalDate.of(2026, 5, 1).atStartOfDay()});
+        reqVO.setWorkAddress("西湖");
+        reqVO.setChannelId(10L);
+        reqVO.setType(HrmEmployeeTypeEnum.FORMAL.getType());
+        reqVO.setStatusCategory(HrmEmployeeStatusEnum.PROBATION.getStatus());
+
+        // 调用
+        PageResult<HrmEmployeeDO> pageResult = employeeService.getEmployeePage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(1, pageResult.getList().size());
+        assertPojoEquals(dbEmployee, pageResult.getList().get(0));
+    }
+
+    @Test
+    public void testGetEmployeePage_birthdayTodo() {
+        // mock 数据
+        LocalDate today = LocalDate.now();
+        HrmEmployeeDO birthdayEmployee = randomEmployeeDO(o -> o
+                .setBirthday(today.minusYears(20).atStartOfDay()));
+        employeeMapper.insert(birthdayEmployee);
+        employeeMapper.insert(randomEmployeeDO(o -> o
+                .setBirthday(today.plusMonths(1).minusYears(20).atStartOfDay())));
+        // 准备参数
+        HrmEmployeePageReqVO reqVO = new HrmEmployeePageReqVO();
+        reqVO.setTodoType(HrmEmployeeTodoTypeEnum.BIRTHDAY.getType());
+
+        // 调用
+        PageResult<HrmEmployeeDO> pageResult = employeeService.getEmployeePage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(birthdayEmployee.getId(), pageResult.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetEmployeeList_exportFiltersAndIds() {
+        // mock 数据
+        HrmEmployeeDO selectedEmployee = randomEmployeeDO(o -> o.setName("张三").setDeptId(100L));
+        employeeMapper.insert(selectedEmployee);
+        HrmEmployeeDO unselectedEmployee = randomEmployeeDO(o -> o.setName("张四").setDeptId(100L));
+        employeeMapper.insert(unselectedEmployee);
+        HrmEmployeeDO otherDeptEmployee = randomEmployeeDO(o -> o.setName("张五").setDeptId(200L));
+        employeeMapper.insert(otherDeptEmployee);
+        // 准备参数
+        HrmEmployeeListReqVO reqVO = new HrmEmployeeListReqVO();
+        reqVO.setName("张");
+        reqVO.setDeptId(100L);
+        reqVO.setIds(asList(selectedEmployee.getId(), otherDeptEmployee.getId()));
+
+        // 调用
+        List<HrmEmployeeDO> employees = employeeService.getEmployeeList(reqVO);
+
+        // 断言
+        assertEquals(1, employees.size());
+        assertPojoEquals(selectedEmployee, employees.get(0));
+    }
+
+    @Test
+    public void testGetEmployeeList_notLimitedByPageSize() {
+        // mock 数据
+        for (int i = 1; i <= 105; i++) {
+            int index = i;
+            employeeMapper.insert(randomEmployeeDO(o -> o.setName(String.format("员工%03d", index))
+                    .setJobNumber(String.format("LIST%03d", index)).setDeptId(100L)));
+        }
+        // 准备参数
+        HrmEmployeeListReqVO reqVO = new HrmEmployeeListReqVO();
+        reqVO.setDeptId(100L);
+
+        // 调用
+        List<HrmEmployeeDO> employees = employeeService.getEmployeeList(reqVO);
+
+        // 断言
+        assertEquals(105, employees.size());
+        assertEquals("LIST105", employees.get(0).getJobNumber());
+        assertEquals("LIST001", employees.get(104).getJobNumber());
+    }
+
+    @Test
+    public void testImportEmployeeList_createUpdateAndFailure() {
+        // mock 数据
+        HrmEmployeeDO updateEmployee = randomEmployeeDO(o -> o.setName("导入前")
+                .setJobNumber("IMPORT001").setMobile("15601691501")
+                .setRegularTime(LocalDate.now().minusMonths(1).atStartOfDay()));
+        employeeMapper.insert(updateEmployee);
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("手机号已占用")
+                .setJobNumber("IMPORT_DUP").setMobile("15601691502")));
+        // 准备参数
+        List<HrmEmployeeImportExcelVO> importEmployees = asList(
+                randomEmployeeImportExcelVO(o -> o.setName("新增员工")
+                        .setJobNumber("IMPORT002").setMobile("15601691503")
+                        .setBankCardNumber("622202600001").setBankAreaId(330100)
+                        .setBankName("招商银行").setBankBranchName("杭州高新支行")
+                        .setFirstSocialSecurity(false).setFirstAccumulationFund(false)
+                        .setSocialSecurityNumber("SB20260001")
+                        .setAccumulationFundNumber("GJJ20260001")
+                        .setSocialSecurityStartMonth(LocalDateTime.of(2026, 7, 1, 0, 0))),
+                randomEmployeeImportExcelVO(o -> o.setName("导入后")
+                        .setJobNumber("IMPORT001").setMobile("15601691501")
+                        .setType(HrmEmployeeTypeEnum.INFORMAL.getType())
+                        .setStatus(HrmEmployeeStatusEnum.INTERN.getStatus()).setProbation(3)),
+                randomEmployeeImportExcelVO(o -> o.setName("失败员工")
+                        .setJobNumber("IMPORT003").setMobile("15601691502")));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(importEmployees,
+                HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy());
+
+        // 断言
+        assertEquals(singletonList("IMPORT002"), respVO.getCreateJobNumbers());
+        assertEquals(singletonList("IMPORT001"), respVO.getUpdateJobNumbers());
+        assertEquals(1, respVO.getFailureJobNumbers().size());
+        assertEquals("手机号已绑定员工档案",
+                respVO.getFailureJobNumbers().get("第 4 行（IMPORT003）"));
+        HrmEmployeeDO createdEmployee = employeeMapper.selectByJobNumber("IMPORT002");
+        assertNotNull(createdEmployee);
+        assertEquals("新增员工", createdEmployee.getName());
+        verify(employeeSalaryCardService).saveSalaryCard(argThat(reqVO ->
+                createdEmployee.getId().equals(reqVO.getEmployeeId())
+                        && "622202600001".equals(reqVO.getBankCardNumber())
+                        && Integer.valueOf(330100).equals(reqVO.getBankAreaId())));
+        verify(insuranceEmployeeInfoService).saveInsuranceEmployeeInfo(argThat(reqVO ->
+                createdEmployee.getId().equals(reqVO.getEmployeeId())
+                        && Boolean.FALSE.equals(reqVO.getFirstSocialSecurity())
+                        && "SB20260001".equals(reqVO.getSocialSecurityNumber())));
+        HrmEmployeeDO updatedEmployee = employeeMapper.selectByJobNumber("IMPORT001");
+        assertEquals(updateEmployee.getId(), updatedEmployee.getId());
+        assertEquals("导入后", updatedEmployee.getName());
+        assertEquals(updateEmployee.getType(), updatedEmployee.getType());
+        assertEquals(updateEmployee.getStatus(), updatedEmployee.getStatus());
+        assertEquals(0, updatedEmployee.getProbation());
+        assertEquals(updateEmployee.getRegularTime(), updatedEmployee.getRegularTime());
+    }
+
+    @Test
+    public void testImportEmployeeList_existsWithoutUpdate() {
+        // mock 数据
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("已存在员工")
+                .setJobNumber("IMPORT004").setMobile("15601691504")));
+        // 准备参数
+        List<HrmEmployeeImportExcelVO> importEmployees = singletonList(randomEmployeeImportExcelVO(o -> o
+                .setName("不允许更新").setJobNumber("IMPORT004").setMobile("15601691504")));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(importEmployees,
+                HrmEmployeeImportDuplicateStrategyEnum.FAIL.getStrategy());
+
+        // 断言
+        assertTrue(respVO.getCreateJobNumbers().isEmpty());
+        assertTrue(respVO.getUpdateJobNumbers().isEmpty());
+        assertEquals("员工档案已存在",
+                respVO.getFailureJobNumbers().get("第 2 行（IMPORT004）"));
+    }
+
+    @Test
+    public void testImportEmployeeList_skipExistingEmployee() {
+        // mock 数据
+        HrmEmployeeDO existingEmployee = randomEmployeeDO(o -> o.setName("已存在员工")
+                .setJobNumber("IMPORT_SKIP").setMobile("15601691510"));
+        employeeMapper.insert(existingEmployee);
+        // 准备参数
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("应跳过员工").setJobNumber("IMPORT_SKIP").setMobile("15601691510"));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(singletonList(importEmployee),
+                HrmEmployeeImportDuplicateStrategyEnum.SKIP.getStrategy());
+
+        // 断言
+        assertEquals(singletonList("IMPORT_SKIP"), respVO.getSkipJobNumbers());
+        assertTrue(respVO.getCreateJobNumbers().isEmpty());
+        assertTrue(respVO.getUpdateJobNumbers().isEmpty());
+        assertTrue(respVO.getFailureJobNumbers().isEmpty());
+        assertEquals("已存在员工", employeeMapper.selectById(existingEmployee.getId()).getName());
+    }
+
+    @Test
+    public void testImportEmployeeList_duplicateStrategyInvalid() {
+        // 准备参数
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("导入员工").setJobNumber("IMPORT_INVALID").setMobile("15601691511"));
+
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.importEmployeeList(singletonList(importEmployee), 99),
+                EMPLOYEE_IMPORT_DUPLICATE_STRATEGY_INVALID);
+    }
+
+    @Test
+    public void testImportEmployeeList_resourceFailureRollback() {
+        // 准备参数
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("事务回滚").setJobNumber("IMPORT005").setMobile("15601691505")
+                .setBankCardNumber("622202600005")
+                .setFirstSocialSecurity(false).setFirstAccumulationFund(false));
+        // mock 方法
+        when(insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(any()))
+                .thenThrow(new ServiceException(500, "社保保存失败"));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(
+                singletonList(importEmployee), HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy());
+
+        // 断言
+        assertNull(employeeMapper.selectByJobNumber("IMPORT005"));
+        assertEquals("社保保存失败",
+                respVO.getFailureJobNumbers().get("第 2 行（IMPORT005）"));
+    }
+
+    @Test
+    public void testImportEmployeeList_resolveRecruitChannelOption() {
+        // mock 数据
+        HrmRecruitChannelDO recruitChannel = randomPojo(HrmRecruitChannelDO.class,
+                o -> o.setId(10L).setName("BOSS直聘"));
+        when(recruitChannelService.getRecruitChannelSimpleList()).thenReturn(singletonList(recruitChannel));
+        // 准备参数
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("渠道员工").setJobNumber("IMPORT006").setMobile("15601691506")
+                .setChannelName(HrmRecruitChannelExcelColumnSelectFunction.formatOption(recruitChannel)));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(
+                singletonList(importEmployee), HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy());
+
+        // 断言
+        assertEquals(singletonList("IMPORT006"), respVO.getCreateJobNumbers());
+        assertTrue(respVO.getFailureJobNumbers().isEmpty());
+        assertEquals(recruitChannel.getId(), employeeMapper.selectByJobNumber("IMPORT006").getChannelId());
+        verify(recruitChannelService).validateRecruitChannelExists(recruitChannel.getId());
+    }
+
+    @Test
+    public void testImportEmployeeList_resolvesBusinessReferences() {
+        // mock 数据
+        HrmEmployeeDO leader = randomEmployeeDO(o -> o.setJobNumber("LEADER001"));
+        employeeMapper.insert(leader);
+        AdminUserRespDTO user = new AdminUserRespDTO();
+        user.setId(20L);
+        user.setMobile("15601691600");
+        when(adminUserApi.getUserByMobile(user.getMobile())).thenReturn(user);
+        HrmInsuranceSchemeDO scheme = randomPojo(HrmInsuranceSchemeDO.class,
+                o -> o.setId(30L).setName("杭州标准方案"));
+        when(insuranceSchemeService.getSchemeByName(scheme.getName())).thenReturn(scheme);
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("业务键员工").setJobNumber("IMPORT_BUSINESS_KEY").setMobile("15601691601")
+                .setDeptId(10L).setLeaderJobNumber(leader.getJobNumber())
+                .setUserMobile(user.getMobile()).setSchemeName(scheme.getName())
+                .setFirstSocialSecurity(false).setFirstAccumulationFund(false));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(
+                singletonList(importEmployee), HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy());
+
+        // 断言
+        assertTrue(respVO.getFailureJobNumbers().isEmpty());
+        HrmEmployeeDO employee = employeeMapper.selectByJobNumber(importEmployee.getJobNumber());
+        assertEquals(importEmployee.getDeptId(), employee.getDeptId());
+        assertEquals(leader.getId(), employee.getLeaderEmployeeId());
+        assertEquals(user.getId(), employee.getUserId());
+        verify(insuranceEmployeeInfoService).saveInsuranceEmployeeInfo(argThat(reqVO ->
+                employee.getId().equals(reqVO.getEmployeeId()) && scheme.getId().equals(reqVO.getSchemeId())));
+    }
+
+    @Test
+    public void testImportEmployeeList_resolveRecruitChannelOptionWithDuplicateNames() {
+        // mock 数据
+        HrmRecruitChannelDO firstChannel = randomPojo(HrmRecruitChannelDO.class,
+                o -> o.setId(10L).setName("内部推荐"));
+        HrmRecruitChannelDO secondChannel = randomPojo(HrmRecruitChannelDO.class,
+                o -> o.setId(20L).setName("内部推荐"));
+        when(recruitChannelService.getRecruitChannelSimpleList()).thenReturn(asList(firstChannel, secondChannel));
+        // 准备参数
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("渠道员工").setJobNumber("IMPORT007").setMobile("15601691507")
+                .setChannelName("内部推荐（20）"));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(
+                singletonList(importEmployee), HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy());
+
+        // 断言
+        assertEquals(singletonList("IMPORT007"), respVO.getCreateJobNumbers());
+        assertTrue(respVO.getFailureJobNumbers().isEmpty());
+        assertEquals(secondChannel.getId(), employeeMapper.selectByJobNumber("IMPORT007").getChannelId());
+        verify(recruitChannelService).validateRecruitChannelExists(secondChannel.getId());
+    }
+
+    @Test
+    public void testImportEmployeeList_recruitChannelNameNotSupported() {
+        // mock 数据
+        HrmRecruitChannelDO firstChannel = randomPojo(HrmRecruitChannelDO.class,
+                o -> o.setId(10L).setName("内部推荐"));
+        HrmRecruitChannelDO secondChannel = randomPojo(HrmRecruitChannelDO.class,
+                o -> o.setId(20L).setName("内部推荐"));
+        when(recruitChannelService.getRecruitChannelSimpleList()).thenReturn(asList(firstChannel, secondChannel));
+        // 准备参数
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("重复渠道员工").setJobNumber("IMPORT008").setMobile("15601691508")
+                .setChannelName("内部推荐"));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(
+                singletonList(importEmployee), HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy());
+
+        // 断言
+        assertNull(employeeMapper.selectByJobNumber("IMPORT008"));
+        assertEquals(RECRUIT_CHANNEL_NOT_EXISTS.getMsg(),
+                respVO.getFailureJobNumbers().get("第 2 行（IMPORT008）"));
+    }
+
+    @Test
+    public void testImportEmployeeList_recruitChannelNameNotExists() {
+        // 准备参数
+        HrmEmployeeImportExcelVO importEmployee = randomEmployeeImportExcelVO(o -> o
+                .setName("未知渠道员工").setJobNumber("IMPORT009").setMobile("15601691509")
+                .setChannelName("不存在的渠道"));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(
+                singletonList(importEmployee), HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy());
+
+        // 断言
+        assertNull(employeeMapper.selectByJobNumber("IMPORT009"));
+        assertEquals("招聘渠道不存在",
+                respVO.getFailureJobNumbers().get("第 2 行（IMPORT009）"));
+    }
+
+    @Test
+    public void testImportEmployeeList_empty() {
+        // 调用，并断言异常
+        assertServiceException(() -> employeeService.importEmployeeList(emptyList(),
+                        HrmEmployeeImportDuplicateStrategyEnum.UPDATE.getStrategy()),
+                EMPLOYEE_IMPORT_LIST_IS_EMPTY);
+    }
+
+    @Test
+    public void testImportEmployeeList_duplicateFailuresKeepEveryRow() {
+        // mock 数据
+        employeeMapper.insert(randomEmployeeDO(o -> o.setJobNumber("IMPORT_DUP_ROW")
+                .setMobile("15601691560")));
+        // 准备参数
+        List<HrmEmployeeImportExcelVO> importEmployees = asList(
+                randomEmployeeImportExcelVO(o -> o.setJobNumber("IMPORT_DUP_ROW")
+                        .setMobile("15601691560")),
+                randomEmployeeImportExcelVO(o -> o.setJobNumber("IMPORT_DUP_ROW")
+                        .setMobile("15601691560")));
+
+        // 调用
+        HrmEmployeeImportRespVO respVO = employeeService.importEmployeeList(importEmployees,
+                HrmEmployeeImportDuplicateStrategyEnum.FAIL.getStrategy());
+
+        // 断言
+        assertEquals(2, respVO.getFailureJobNumbers().size());
+        assertEquals("员工档案已存在",
+                respVO.getFailureJobNumbers().get("第 2 行（IMPORT_DUP_ROW）"));
+        assertEquals("员工档案已存在",
+                respVO.getFailureJobNumbers().get("第 3 行（IMPORT_DUP_ROW）"));
+    }
+
+    @Test
+    public void testGetEmployeeStatusCount() {
+        // mock 数据
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("正式员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("试用员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("实习员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.INTERN.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("待离职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("待入职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("离职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+
+        // 调用
+        Map<Integer, Long> countMap = employeeService.getEmployeeStatusCount(new HrmEmployeePageReqVO());
+
+        // 断言
+        assertEquals(2L, countMap.get(HrmEmployeeStatusEnum.REGULAR.getStatus()));
+        assertEquals(1L, countMap.get(HrmEmployeeStatusEnum.PROBATION.getStatus()));
+        assertEquals(1L, countMap.get(HrmEmployeeStatusEnum.INTERN.getStatus()));
+        assertEquals(4L, countMap.get(HrmEmployeeStatusTabEnum.ACTIVE.getStatus()));
+        assertEquals(3L, countMap.get(HrmEmployeeStatusTabEnum.FULL_TIME.getStatus()));
+        assertEquals(1L, countMap.get(HrmEmployeeStatusTabEnum.PENDING_ENTRY.getStatus()));
+        assertEquals(1L, countMap.get(HrmEmployeeStatusTabEnum.PENDING_LEAVE.getStatus()));
+        assertEquals(1L, countMap.get(HrmEmployeeStatusTabEnum.LEFT.getStatus()));
+    }
+
+    @Test
+    public void testGetEmployeeStatusCount_ignoreStatusCategory() {
+        // mock 数据
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("正式员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("离职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        // 准备参数
+        HrmEmployeePageReqVO countReqVO = new HrmEmployeePageReqVO();
+        countReqVO.setName("正式员工");
+        countReqVO.setStatusCategory(HrmEmployeeStatusTabEnum.LEFT.getStatus());
+
+        // 调用
+        Map<Integer, Long> filteredCountMap = employeeService.getEmployeeStatusCount(countReqVO);
+
+        // 断言
+        assertEquals(1L, filteredCountMap.get(HrmEmployeeStatusEnum.REGULAR.getStatus()));
+        assertEquals(1L, filteredCountMap.get(HrmEmployeeStatusTabEnum.ACTIVE.getStatus()));
+        assertEquals(1L, filteredCountMap.get(HrmEmployeeStatusTabEnum.FULL_TIME.getStatus()));
+        assertEquals(0L, filteredCountMap.get(HrmEmployeeStatusTabEnum.LEFT.getStatus()));
+    }
+
+    @Test
+    public void testGetEmployeePage_statusCategory() {
+        // mock 数据
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("正式员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("试用员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("实习员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.INTERN.getStatus())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setName("待离职员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())));
+        // 准备参数
+        HrmEmployeePageReqVO reqVO = new HrmEmployeePageReqVO();
+        reqVO.setStatusCategory(HrmEmployeeStatusTabEnum.FULL_TIME.getStatus());
+
+        // 调用并断言
+        assertEquals(3L, employeeService.getEmployeePage(reqVO).getTotal());
+        reqVO.setStatusCategory(HrmEmployeeStatusEnum.INTERN.getStatus());
+        PageResult<HrmEmployeeDO> internPage = employeeService.getEmployeePage(reqVO);
+        assertEquals(1L, internPage.getTotal());
+        assertEquals("实习员工", internPage.getList().get(0).getName());
+    }
+
+    @Test
+    public void testGetEmployeeCountMapByDeptAndType() {
+        // mock 数据
+        Long firstDeptId = randomLongId();
+        Long secondDeptId = randomLongId();
+        employeeMapper.insert(randomEmployeeDO(o -> o.setDeptId(firstDeptId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setDeptId(firstDeptId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setType(HrmEmployeeTypeEnum.INFORMAL.getType())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setDeptId(firstDeptId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setType(null)));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setDeptId(firstDeptId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType())));
+        employeeMapper.insert(randomEmployeeDO(o -> o.setDeptId(secondDeptId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType())));
+
+        // 调用
+        Map<Long, Map<Integer, Long>> countMap = employeeService.getEmployeeCountMapByDeptAndType();
+
+        // 断言
+        assertEquals(3L, countMap.get(firstDeptId).values().stream().mapToLong(Long::longValue).sum());
+        assertEquals(1L, countMap.get(firstDeptId).get(HrmEmployeeTypeEnum.FORMAL.getType()));
+        assertEquals(1L, countMap.get(firstDeptId).get(HrmEmployeeTypeEnum.INFORMAL.getType()));
+        assertEquals(1L, countMap.get(firstDeptId).get(null));
+        assertEquals(1L, countMap.get(secondDeptId).get(HrmEmployeeTypeEnum.FORMAL.getType()));
+    }
+
+    @Test
+    public void testGetEmployeeSurveyCountMap() {
+        // mock 数据
+        LocalDateTime monthBeginTime = LocalDate.now().withDayOfMonth(1).atStartOfDay();
+        HrmEmployeeDO entryEmployee = randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setEntryTime(monthBeginTime.plusDays(1)));
+        employeeMapper.insert(entryEmployee);
+        employeeMapper.insert(randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())
+                .setEntryTime(monthBeginTime.plusDays(2))));
+        employeeMapper.insert(randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setLeaveTime(monthBeginTime.plusDays(3))));
+        employeeMapper.insert(randomEmployeeDO(o -> o
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setLeaveTime(monthBeginTime.plusDays(4))));
+        employeeChangeRecordMapper.insert(HrmEmployeeChangeRecordDO.builder()
+                .employeeId(entryEmployee.getId()).type(HrmEmployeeChangeTypeEnum.REGULAR.getType())
+                .effectTime(monthBeginTime.plusDays(5)).build());
+        employeeChangeRecordMapper.insert(HrmEmployeeChangeRecordDO.builder()
+                .employeeId(entryEmployee.getId()).type(HrmEmployeeChangeTypeEnum.REGULAR.getType())
+                .effectTime(monthBeginTime.plusDays(6)).build());
+        employeeChangeRecordMapper.insert(HrmEmployeeChangeRecordDO.builder()
+                .employeeId(entryEmployee.getId()).type(HrmEmployeeChangeTypeEnum.TRANSFER.getType())
+                .effectTime(monthBeginTime.plusDays(7)).build());
+
+        // 调用
+        Map<Integer, Long> countMap = employeeService.getEmployeeSurveyCountMap();
+
+        // 断言
+        assertEquals(1L, countMap.get(HrmEmployeeSurveyTypeEnum.ENTRY.getType()));
+        assertEquals(1L, countMap.get(HrmEmployeeSurveyTypeEnum.PENDING_ENTRY.getType()));
+        assertEquals(1L, countMap.get(HrmEmployeeSurveyTypeEnum.LEAVE.getType()));
+        assertEquals(1L, countMap.get(HrmEmployeeSurveyTypeEnum.PENDING_LEAVE.getType()));
+        assertEquals(1L, countMap.get(HrmEmployeeSurveyTypeEnum.REGULAR.getType()));
+        assertEquals(1L, countMap.get(HrmEmployeeSurveyTypeEnum.TRANSFER.getType()));
+    }
+
+    @Test
+    public void testUpdateEmployeeBySelf_success() {
+        // mock 数据
+        Long userId = randomLongId();
+        HrmEmployeeDO dbEmployee = randomEmployeeDO(o -> o.setUserId(userId).setName("修改前")
+                .setMobile("15601691550").setEmail("before@example.com")
+                .setBirthday(LocalDate.of(1990, 1, 1).atStartOfDay()).setAge(36));
+        employeeMapper.insert(dbEmployee);
+        // 准备参数
+        LocalDateTime birthday = LocalDate.now().minusYears(28).atTime(10, 20);
+        HrmPortalEmployeeUpdateReqVO reqVO = randomPojo(HrmPortalEmployeeUpdateReqVO.class, o -> o
+                .setName("修改后").setMobile("15601691551").setEmail("after@example.com")
+                .setBirthday(birthday));
+        // mock 方法
+        when(employeeFieldConfigService.getEditableArchiveFieldNames()).thenReturn(new HashSet<>(asList(
+                HrmEmployeeArchiveFieldEnum.NAME.getName(),
+                HrmEmployeeArchiveFieldEnum.EMAIL.getName(),
+                HrmEmployeeArchiveFieldEnum.BIRTHDAY.getName())));
+
+        // 调用
+        employeeService.updateEmployeeBySelf(userId, reqVO);
+
+        // 断言
+        HrmEmployeeDO employee = employeeMapper.selectById(dbEmployee.getId());
+        assertEquals("修改后", employee.getName());
+        assertEquals("15601691550", employee.getMobile());
+        assertEquals("after@example.com", employee.getEmail());
+        assertEquals(birthday, employee.getBirthday());
+        assertEquals(28, employee.getAge());
+    }
+
+    // ========== 随机对象 ==========
+
+    @SafeVarargs
+    private static HrmEmployeeSaveReqVO randomEmployeeSaveReqVO(Consumer<HrmEmployeeSaveReqVO>... consumers) {
+        Consumer<HrmEmployeeSaveReqVO> consumer = o -> o.setId(null).setName(randomString())
+                .setJobNumber("HRM" + randomLongId()).setUserId(null).setMobile(randomMobile())
+                .setCountry("中国").setNation("汉族").setIdType(HrmEmployeeIdTypeEnum.OTHER.getType())
+                .setIdNumber(randomString()).setSex(1).setEmail(randomEmail()).setNativePlace("浙江杭州")
+                .setBirthday(LocalDate.now().minusYears(30).atStartOfDay()).setAge(null)
+                .setAddress("杭州市西湖区").setHighestEducation(HrmEmployeeEducationEnum.BACHELOR.getEducation())
+                .setDeptId(null).setLeaderEmployeeId(null)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType())
+                .setEntryTime(LocalDate.now().minusYears(1).atStartOfDay())
+                .setProbation(0).setRegularTime(null).setLeaveTime(null)
+                .setPostName(randomString()).setPostLevel("P6").setWorkCity("杭州").setWorkAddress("西湖区")
+                .setWorkDetailAddress("文三路").setChannelId(null).setCompanyAgeStartTime(null)
+                .setCompanyAge(null).setCandidateId(null).setRemark(randomString());
+        return randomPojo(HrmEmployeeSaveReqVO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmEmployeeDO randomEmployeeDO(Consumer<HrmEmployeeDO>... consumers) {
+        Consumer<HrmEmployeeDO> consumer = o -> o.setName(randomString())
+                .setJobNumber("HRM" + randomLongId()).setUserId(null).setMobile(randomMobile())
+                .setCountry("中国").setNation("汉族").setIdType(HrmEmployeeIdTypeEnum.OTHER.getType())
+                .setIdNumber(randomString()).setSex(1).setEmail(randomEmail()).setNativePlace("浙江杭州")
+                .setBirthday(LocalDate.now().minusYears(30).atStartOfDay()).setAge(30)
+                .setAddress("杭州市西湖区").setHighestEducation(HrmEmployeeEducationEnum.BACHELOR.getEducation())
+                .setDeptId(null).setLeaderEmployeeId(null)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType())
+                .setEntryTime(LocalDate.now().minusYears(1).atStartOfDay()).setProbation(0)
+                .setRegularTime(LocalDate.now().minusYears(1).atStartOfDay()).setLeaveTime(null)
+                .setPostName(randomString()).setPostLevel("P6").setWorkCity("杭州").setWorkAddress("西湖区")
+                .setWorkDetailAddress("文三路").setChannelId(null)
+                .setCompanyAgeStartTime(LocalDate.now().minusYears(1).atStartOfDay()).setCompanyAge(1)
+                .setCandidateId(null).setRemark(randomString()).setDeleted(false);
+        return randomPojo(HrmEmployeeDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmEmployeeImportExcelVO randomEmployeeImportExcelVO(
+            Consumer<HrmEmployeeImportExcelVO>... consumers) {
+        Consumer<HrmEmployeeImportExcelVO> consumer = o -> o.setName(randomString())
+                .setJobNumber("IMPORT" + randomLongId()).setMobile(randomMobile())
+                .setCountry("中国").setNation("汉族").setIdType(HrmEmployeeIdTypeEnum.OTHER.getType())
+                .setIdNumber(randomString()).setSex(1).setEmail(randomEmail()).setNativePlace("浙江杭州")
+                .setBirthday(LocalDate.now().minusYears(30).atStartOfDay())
+                .setAddress("杭州市西湖区")
+                .setHighestEducation(HrmEmployeeEducationEnum.BACHELOR.getEducation())
+                .setDeptId(null).setLeaderJobNumber(null).setPostName(randomString()).setPostLevel("P6")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setType(HrmEmployeeTypeEnum.FORMAL.getType())
+                .setEntryTime(LocalDate.now().minusMonths(1).atStartOfDay()).setProbation(0)
+                .setRegularTime(null).setLeaveTime(null).setWorkCity("杭州").setWorkAddress("西湖区")
+                .setWorkDetailAddress("文三路").setChannelName(null).setCompanyAgeStartTime(null)
+                .setUserMobile(null).setBankCardNumber(null).setBankAreaId(null).setBankName(null)
+                .setBankBranchName(null).setFirstSocialSecurity(null).setFirstAccumulationFund(null)
+                .setSocialSecurityNumber(null).setAccumulationFundNumber(null)
+                .setSocialSecurityStartMonth(null).setSchemeName(null).setRemark(randomString());
+        return randomPojo(HrmEmployeeImportExcelVO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeServiceImplTest.java
new file mode 100644
index 0000000..8807414
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/home/HrmHomeServiceImplTest.java
@@ -0,0 +1,500 @@
+package cn.iocoder.yudao.module.hrm.service.home;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.test.core.ut.BaseMockitoUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHomeCalendarItemRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmHrHomeStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.home.vo.HrmTeamHomeStatisticsRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.attendance.record.HrmAttendanceClockDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeQuitInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeePersonalNoteDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusTabEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeSurveyTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.home.HrmHomeCalendarItemTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.attendance.record.HrmAttendanceClockService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeContractService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeQuitInfoService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeePersonalNoteService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitInterviewService;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import cn.iocoder.yudao.module.system.enums.common.SexEnum;
+import org.junit.jupiter.api.Test;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.AdditionalMatchers.aryEq;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmHomeServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+public class HrmHomeServiceImplTest extends BaseMockitoUnitTest {
+
+    @InjectMocks
+    private HrmHomeServiceImpl homeService;
+
+    @Mock
+    private HrmEmployeeContractService employeeContractService;
+    @Mock
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @Mock
+    private HrmEmployeeQuitInfoService employeeQuitInfoService;
+    @Mock
+    private HrmEmployeeService employeeService;
+    @Mock
+    private HrmEmployeePersonalNoteService personalNoteService;
+    @Mock
+    private HrmRecruitPostService recruitPostService;
+    @Mock
+    private HrmRecruitCandidateService recruitCandidateService;
+    @Mock
+    private HrmRecruitInterviewService recruitInterviewService;
+    @Mock
+    private HrmAttendanceClockService attendanceClockService;
+    @Mock
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+    @Mock
+    private HrmSalaryMonthEmployeeRecordService salaryMonthEmployeeRecordService;
+    @Mock
+    private DeptApi deptApi;
+
+    @Test
+    public void testGetTeamHomeStatisticsSummary() {
+        // mock 数据
+        LocalDate today = LocalDate.now();
+        HrmEmployeeDO leader = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("主管");
+        HrmEmployeeDO activeEmployee = new HrmEmployeeDO().setId(2L).setName("张三")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus()).setSex(1)
+                .setBirthday(today.minusYears(30).atStartOfDay())
+                .setCompanyAgeStartTime(today.minusYears(2).atStartOfDay())
+                .setEntryTime(today.atTime(9, 0));
+        HrmEmployeeDO pendingLeaveEmployee = new HrmEmployeeDO().setId(3L).setName("李四")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus()).setSex(2)
+                .setBirthday(today.minusYears(24).atStartOfDay())
+                .setCompanyAgeStartTime(today.minusMonths(4).atStartOfDay())
+                .setEntryTime(today.minusMonths(4).atStartOfDay());
+        HrmEmployeeDO leftEmployee = new HrmEmployeeDO().setId(4L).setName("王五")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setEntryTime(today.minusYears(3).atStartOfDay()).setLeaveTime(today.atTime(18, 0));
+        HrmEmployeeDO pendingEntryEmployee = new HrmEmployeeDO().setId(5L).setName("赵六")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())
+                .setStatus(HrmEmployeeStatusEnum.PROBATION.getStatus())
+                .setEntryTime(today.atTime(9, 0));
+        List<HrmEmployeeDO> teamEmployees = Arrays.asList(
+                activeEmployee, pendingLeaveEmployee, leftEmployee, pendingEntryEmployee);
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(leader);
+        when(employeeService.getEmployeeListByLeaderEmployeeId(leader.getId())).thenReturn(teamEmployees);
+        when(employeeChangeRecordService.getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                anyCollection(), any())).thenReturn(Collections.singletonList(
+                new HrmEmployeeChangeRecordDO().setEmployeeId(activeEmployee.getId())
+                        .setType(HrmEmployeeChangeTypeEnum.REGULAR.getType())
+                        .setEffectTime(today.atTime(10, 0))));
+
+        // 调用
+        HrmTeamHomeStatisticsRespVO summary = homeService.getTeamHomeStatisticsSummary(100L);
+
+        // 断言
+        assertEquals(leader.getId(), summary.getLeaderEmployeeId());
+        assertEquals(2L, summary.getTeamOverview().getEmployeeCount());
+        assertEquals(1L, summary.getTeamOverview().getEntryThisMonthCount());
+        assertEquals(1L, summary.getTeamOverview().getLeaveThisMonthCount());
+        assertEquals(1L, summary.getTeamOverview().getRegularThisMonthCount());
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getStatusAnalysis(),
+                item -> HrmEmployeeStatusEnum.REGULAR.getStatus().equals(item.getType())).getCount());
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getStatusAnalysis(),
+                item -> HrmEmployeeStatusEnum.PROBATION.getStatus().equals(item.getType())).getCount());
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getSexAnalysis(),
+                item -> SexEnum.MALE.getSex().equals(item.getType())).getCount());
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getSexAnalysis(),
+                item -> SexEnum.FEMALE.getSex().equals(item.getType())).getCount());
+    }
+
+    @Test
+    public void testGetTeamHomeStatisticsSummary_ageNotFilled() {
+        // mock 数据
+        HrmEmployeeDO leader = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("主管");
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(2L).setName("未填写年龄的员工")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(leader);
+        when(employeeService.getEmployeeListByLeaderEmployeeId(leader.getId()))
+                .thenReturn(Collections.singletonList(employee));
+        when(employeeChangeRecordService.getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                anyCollection(), any())).thenReturn(Collections.emptyList());
+
+        // 调用
+        HrmTeamHomeStatisticsRespVO summary = homeService.getTeamHomeStatisticsSummary(100L);
+
+        // 断言
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getStatusAnalysis(),
+                item -> item.getType() == null).getCount());
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getSexAnalysis(),
+                item -> item.getType() == null).getCount());
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getAgeAnalysis(),
+                item -> item.getType() == null).getCount());
+        assertEquals(1L, CollUtil.findOne(summary.getTeamSurvey().getCompanyAgeAnalysis(),
+                item -> item.getType() == null).getCount());
+    }
+
+    @Test
+    public void testGetTeamHomeCalendar() {
+        // mock 数据
+        LocalDate date = LocalDate.of(2026, 7, 30);
+        HrmEmployeeDO leader = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("主管");
+        HrmEmployeeDO teamEmployee = new HrmEmployeeDO().setId(2L).setName("张三")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())
+                .setBirthday(date.minusYears(28).atStartOfDay()).setAge(28)
+                .setEntryTime(date.atTime(9, 0));
+        HrmEmployeePersonalNoteDO personalNote = HrmEmployeePersonalNoteDO.builder()
+                .id(10L).employeeId(leader.getId()).content("团队周会")
+                .reminderTime(date.atTime(8, 30)).build();
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(leader);
+        when(employeeService.getEmployeeListByLeaderEmployeeId(leader.getId()))
+                .thenReturn(Collections.singletonList(teamEmployee));
+        when(personalNoteService.getPersonalNoteList(
+                eq(leader.getId()), aryEq(new LocalDateTime[]{
+                        date.atStartOfDay(), date.atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Collections.singletonList(personalNote));
+
+        // 调用
+        List<HrmHomeCalendarItemRespVO> items = homeService.getTeamHomeCalendar(100L, date, date);
+
+        // 断言
+        assertEquals(3, items.size());
+        assertTrue(items.stream().anyMatch(item -> personalNote.getId().equals(item.getPersonalNoteId())));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 2
+                && teamEmployee.getId().equals(item.getTypeId())));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 3
+                && teamEmployee.getId().equals(item.getTypeId())));
+    }
+
+    @Test
+    public void testGetHrHomeStatisticsSummary() {
+        // mock 员工和待办数据
+        when(employeeService.getEmployeeStatusCount(any())).thenReturn(Collections.singletonMap(
+                HrmEmployeeStatusTabEnum.ACTIVE.getStatus(), 2L));
+        Map<Integer, Long> employeeSurveyCountMap = new HashMap<>();
+        employeeSurveyCountMap.put(HrmEmployeeSurveyTypeEnum.ENTRY.getType(), 1L);
+        employeeSurveyCountMap.put(HrmEmployeeSurveyTypeEnum.PENDING_ENTRY.getType(), 1L);
+        employeeSurveyCountMap.put(HrmEmployeeSurveyTypeEnum.LEAVE.getType(), 1L);
+        employeeSurveyCountMap.put(HrmEmployeeSurveyTypeEnum.PENDING_LEAVE.getType(), 1L);
+        employeeSurveyCountMap.put(HrmEmployeeSurveyTypeEnum.REGULAR.getType(), 1L);
+        when(employeeService.getEmployeeSurveyCountMap()).thenReturn(employeeSurveyCountMap);
+        when(employeeContractService.getExpireEmployeeCountInMonth(any())).thenReturn(1L);
+
+        // mock 招聘数据
+        when(recruitPostService.getRecruitPostStatusCount(any())).thenReturn(Collections.singletonMap(
+                HrmRecruitPostStatusEnum.RECRUITING.getStatus(), 1L));
+        Map<Integer, Long> candidateStatusCount = new HashMap<>();
+        candidateStatusCount.put(HrmRecruitCandidateStatusEnum.NEW.getStatus(), 1L);
+        candidateStatusCount.put(HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus(), 1L);
+        candidateStatusCount.put(HrmRecruitCandidateStatusEnum.JOINED.getStatus(), 1L);
+        candidateStatusCount.put(HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus(), 1L);
+        when(recruitCandidateService.getRecruitCandidateStatusCount(any())).thenReturn(candidateStatusCount);
+        when(recruitCandidateService.getRecruitCandidateCountByStatusAndStatusUpdateTimeBetween(
+                eq(HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus()), any())).thenReturn(1L);
+        when(recruitCandidateService.getRecruitCandidateCountByStatusAndEntryTimeBetween(
+                eq(HrmRecruitCandidateStatusEnum.JOINED.getStatus()), any())).thenReturn(1L);
+
+        // mock 薪资数据
+        LocalDate lastMonth = LocalDate.now().minusMonths(1);
+        HrmSalaryMonthRecordDO salaryMonthRecord = new HrmSalaryMonthRecordDO().setId(10L)
+                .setYear(lastMonth.getYear()).setMonth(lastMonth.getMonthValue())
+                .setStatus(HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus());
+        when(salaryMonthRecordService.getMonthRecordByYearMonth(
+                lastMonth.getYear(), lastMonth.getMonthValue())).thenReturn(salaryMonthRecord);
+        when(salaryMonthRecordService.getMonthRecordListByStatus(
+                HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus()))
+                .thenReturn(Collections.singletonList(new HrmSalaryMonthRecordDO()));
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords = Arrays.asList(
+                new HrmSalaryMonthEmployeeRecordDO().setEmployeeId(1L)
+                        .setRealPaySalary(BigDecimal.valueOf(600)),
+                new HrmSalaryMonthEmployeeRecordDO().setEmployeeId(2L)
+                        .setRealPaySalary(BigDecimal.valueOf(300)));
+        when(salaryMonthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(10L))
+                .thenReturn(employeeRecords);
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(1L, new HrmEmployeeDO().setId(1L).setDeptId(10L));
+        employeeMap.put(2L, new HrmEmployeeDO().setId(2L).setDeptId(20L));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(employeeMap);
+        Map<Long, DeptRespDTO> deptMap = new HashMap<>();
+        DeptRespDTO developmentDept = new DeptRespDTO();
+        developmentDept.setId(10L);
+        developmentDept.setName("研发部");
+        deptMap.put(developmentDept.getId(), developmentDept);
+        DeptRespDTO humanResourceDept = new DeptRespDTO();
+        humanResourceDept.setId(20L);
+        humanResourceDept.setName("人事部");
+        deptMap.put(humanResourceDept.getId(), humanResourceDept);
+        when(deptApi.getDeptMap(anyCollection())).thenReturn(deptMap);
+
+        // 调用
+        HrmHrHomeStatisticsRespVO summary = homeService.getHrHomeStatisticsSummary();
+
+        // 断言
+        assertEquals(2L, summary.getEmployeeSurvey().getActiveCount());
+        assertEquals(1L, summary.getEmployeeSurvey().getEntryThisMonthCount());
+        assertEquals(1L, summary.getEmployeeSurvey().getPendingEntryThisMonthCount());
+        assertEquals(1L, summary.getEmployeeSurvey().getLeaveThisMonthCount());
+        assertEquals(1L, summary.getEmployeeSurvey().getPendingLeaveThisMonthCount());
+        assertEquals(1L, summary.getEmployeeSurvey().getRegularThisMonthCount());
+        assertEquals(0L, summary.getEmployeeSurvey().getTransferThisMonthCount());
+
+        assertEquals(1L, summary.getRecruitSurvey().getRecruitingPostCount());
+        assertEquals(1L, summary.getRecruitSurvey().getCandidateInProcessCount());
+        assertEquals(1L, summary.getRecruitSurvey().getPendingEntryCount());
+        assertEquals(1L, summary.getRecruitSurvey().getJoinedCount());
+
+        assertEquals(2, summary.getSalarySurvey().getEmployeeCount());
+        assertEquals(0, BigDecimal.valueOf(900).compareTo(summary.getSalarySurvey().getRealPaySalary()));
+        assertEquals(2, summary.getSalarySurvey().getDeptProportions().size());
+        assertEquals("研发部", summary.getSalarySurvey().getDeptProportions().get(0).getDeptName());
+        assertEquals(0, new BigDecimal("0.6667").compareTo(
+                summary.getSalarySurvey().getDeptProportions().get(0).getProportion()));
+        assertEquals("人事部", summary.getSalarySurvey().getDeptProportions().get(1).getDeptName());
+        assertEquals(0, new BigDecimal("0.3334").compareTo(
+                summary.getSalarySurvey().getDeptProportions().get(1).getProportion()));
+
+        assertEquals(1L, summary.getTodoSurvey().getToEntryCount());
+        assertEquals(1L, summary.getTodoSurvey().getToLeaveCount());
+        assertEquals(1L, summary.getTodoSurvey().getToExpireContractCount());
+        assertEquals(2L, summary.getTodoSurvey().getToRegularCount());
+        assertEquals(1L, summary.getTodoSurvey().getToSalaryComputeCount());
+        assertEquals(2L, summary.getTodoSurvey().getToBirthdayCount());
+    }
+
+    @Test
+    public void testGetCalendar() {
+        // mock 数据
+        LocalDate date = LocalDate.of(2026, 7, 30);
+        HrmEmployeeDO loginEmployee = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("张三");
+        HrmEmployeeDO birthdayEmployee = new HrmEmployeeDO().setId(2L).setName("李四")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setBirthday(date.minusYears(28).atStartOfDay())
+                .setAge(28).setRegularTime(date.atTime(10, 0));
+        HrmEmployeeDO pendingEntryEmployee = new HrmEmployeeDO().setId(3L).setName("赵六")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())
+                .setEntryTime(date.atTime(9, 0));
+        HrmEmployeeDO pendingLeaveEmployee = new HrmEmployeeDO().setId(4L).setName("孙七")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_LEAVE.getStatus())
+                .setLeaveTime(date.minusDays(1).atTime(18, 0));
+        HrmEmployeeDO leftEmployee = new HrmEmployeeDO().setId(5L).setName("周八")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setBirthday(date.minusYears(30).atStartOfDay()).setLeaveTime(date.atTime(18, 0));
+        HrmEmployeeQuitInfoDO quitInfo = new HrmEmployeeQuitInfoDO()
+                .setEmployeeId(pendingLeaveEmployee.getId()).setPlanQuitTime(date.atTime(17, 0));
+        HrmEmployeePersonalNoteDO personalNote = HrmEmployeePersonalNoteDO.builder()
+                .id(10L).employeeId(loginEmployee.getId()).content("准备员工月报")
+                .reminderTime(date.atTime(8, 30)).build();
+        HrmRecruitInterviewDO interview = new HrmRecruitInterviewDO().setCandidateId(20L)
+                .setStageNumber(2).setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult())
+                .setInterviewTime(date.atTime(14, 0));
+        HrmRecruitInterviewDO cancelledInterview = new HrmRecruitInterviewDO().setCandidateId(20L)
+                .setStageNumber(2).setResult(HrmRecruitInterviewResultEnum.CANCEL.getResult())
+                .setInterviewTime(date.atTime(15, 0));
+        HrmRecruitInterviewDO historyInterview = new HrmRecruitInterviewDO().setCandidateId(20L)
+                .setStageNumber(1).setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult())
+                .setInterviewTime(date.atTime(16, 0));
+        HrmRecruitCandidateDO candidate = new HrmRecruitCandidateDO().setId(20L).setName("王五")
+                .setStatus(HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus()).setStageNumber(2);
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(loginEmployee);
+        when(personalNoteService.getPersonalNoteList(
+                eq(loginEmployee.getId()), aryEq(new LocalDateTime[]{
+                        date.atStartOfDay(), date.atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Collections.singletonList(personalNote));
+        when(employeeService.getEmployeeList(any()))
+                .thenReturn(Arrays.asList(loginEmployee, birthdayEmployee, pendingEntryEmployee,
+                        pendingLeaveEmployee, leftEmployee));
+        when(employeeQuitInfoService.getQuitInfoListByEmployeeIds(anyCollection()))
+                .thenReturn(Collections.singletonList(quitInfo));
+        when(recruitInterviewService.getRecruitInterviewListByInterviewTimeBetween(
+                aryEq(new LocalDateTime[]{date.atStartOfDay(), date.atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Arrays.asList(interview, cancelledInterview, historyInterview));
+        when(recruitCandidateService.getRecruitCandidateMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(candidate.getId(), candidate));
+
+        // 调用
+        List<HrmHomeCalendarItemRespVO> items = homeService.getHrHomeCalendar(100L, date, date);
+
+        // 断言
+        assertEquals(6, items.size());
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 1
+                && personalNote.getId().equals(item.getPersonalNoteId())));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 2
+                && birthdayEmployee.getId().equals(item.getTypeId())));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 3));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 4));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 5));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 5
+                && pendingLeaveEmployee.getId().equals(item.getTypeId())
+                && quitInfo.getPlanQuitTime().equals(item.getEventTime())));
+        assertTrue(items.stream().noneMatch(item -> leftEmployee.getId().equals(item.getTypeId())));
+        assertTrue(items.stream().anyMatch(item -> item.getType() == 6
+                && "王五下午14:00面试".equals(item.getContent())));
+        assertEquals(1L, items.stream().filter(item -> item.getType() == 6).count());
+    }
+
+    @Test
+    public void testGetCalendarRange() {
+        // mock 数据
+        LocalDate date = LocalDate.of(2026, 7, 30);
+        HrmEmployeeDO loginEmployee = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("张三");
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(loginEmployee);
+        when(personalNoteService.getPersonalNoteList(
+                eq(loginEmployee.getId()), aryEq(new LocalDateTime[]{
+                        date.atStartOfDay(), date.plusDays(1).atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Arrays.asList(
+                        HrmEmployeePersonalNoteDO.builder().id(1L).employeeId(1L).content("事项一")
+                                .reminderTime(date.atTime(9, 0)).build(),
+                        HrmEmployeePersonalNoteDO.builder().id(2L).employeeId(1L).content("事项二")
+                                .reminderTime(date.atTime(10, 0)).build()));
+        when(employeeService.getEmployeeList(any())).thenReturn(Collections.emptyList());
+        when(recruitInterviewService.getRecruitInterviewListByInterviewTimeBetween(
+                aryEq(new LocalDateTime[]{
+                        date.atStartOfDay(), date.plusDays(1).atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Collections.emptyList());
+        when(recruitCandidateService.getRecruitCandidateMap(anyCollection()))
+                .thenReturn(Collections.emptyMap());
+
+        // 调用
+        List<HrmHomeCalendarItemRespVO> items =
+                homeService.getHrHomeCalendar(100L, date, date.plusDays(1));
+
+        // 断言
+        assertEquals(2, items.size());
+        assertTrue(items.stream().allMatch(item -> date.equals(item.getDate())));
+    }
+
+    @Test
+    public void testGetCalendar_birthdayAcrossYear() {
+        // mock 数据
+        LocalDate startDate = LocalDate.of(2026, 12, 31);
+        LocalDate endDate = LocalDate.of(2027, 1, 1);
+        HrmEmployeeDO loginEmployee = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("张三");
+        HrmEmployeeDO birthdayEmployee = new HrmEmployeeDO().setId(2L).setName("李四")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setAge(20)
+                .setBirthday(LocalDate.of(1990, 1, 1).atStartOfDay());
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(loginEmployee);
+        when(personalNoteService.getPersonalNoteList(eq(loginEmployee.getId()), any()))
+                .thenReturn(Collections.emptyList());
+        when(employeeService.getEmployeeList(any())).thenReturn(Collections.singletonList(birthdayEmployee));
+        when(recruitInterviewService.getRecruitInterviewListByInterviewTimeBetween(any()))
+                .thenReturn(Collections.emptyList());
+        when(recruitCandidateService.getRecruitCandidateMap(anyCollection()))
+                .thenReturn(Collections.emptyMap());
+
+        // 调用
+        List<HrmHomeCalendarItemRespVO> items =
+                homeService.getHrHomeCalendar(100L, startDate, endDate);
+
+        // 断言
+        assertEquals(1, items.size());
+        assertEquals(HrmHomeCalendarItemTypeEnum.BIRTHDAY.getType(), items.get(0).getType());
+        assertEquals("李四37岁生日", items.get(0).getContent());
+        assertEquals(endDate, items.get(0).getDate());
+    }
+
+    @Test
+    public void testGetEmployeeCalendar() {
+        // mock 数据
+        LocalDate date = LocalDate.of(2026, 7, 30);
+        LocalDateTime reminderTime = date.atTime(15, 30);
+        HrmEmployeeDO loginEmployee = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("张三");
+        HrmEmployeePersonalNoteDO personalNote = HrmEmployeePersonalNoteDO.builder()
+                .id(10L).employeeId(loginEmployee.getId()).content("跟进转正材料")
+                .reminderTime(reminderTime).build();
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(loginEmployee);
+        when(personalNoteService.getPersonalNoteList(eq(loginEmployee.getId()),
+                aryEq(new LocalDateTime[]{date.atStartOfDay(), date.atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Collections.singletonList(personalNote));
+
+        // 调用
+        List<HrmHomeCalendarItemRespVO> items =
+                homeService.getEmployeeCalendar(100L, date, date);
+
+        // 断言
+        assertTrue(items.stream().anyMatch(item -> personalNote.getId().equals(item.getPersonalNoteId())
+                && item.getType() == 1 && reminderTime.equals(item.getEventTime())));
+    }
+
+    @Test
+    public void testGetEmployeeCalendarAttendanceItem() {
+        // mock 数据
+        LocalDate date = LocalDate.of(2026, 7, 30);
+        HrmEmployeeDO loginEmployee = new HrmEmployeeDO().setId(1L).setUserId(100L).setName("张三");
+        when(employeeService.getEmployeeByUserId(100L)).thenReturn(loginEmployee);
+        when(personalNoteService.getPersonalNoteList(eq(loginEmployee.getId()),
+                aryEq(new LocalDateTime[]{date.atStartOfDay(), date.atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Collections.emptyList());
+        when(attendanceClockService.getAttendanceClockListByEmployeeIdAndClockTime(
+                eq(loginEmployee.getId()), aryEq(new LocalDateTime[]{
+                        date.atStartOfDay(), date.atTime(java.time.LocalTime.MAX)})))
+                .thenReturn(Arrays.asList(
+                        clock(loginEmployee.getId(), date.atTime(9, 0)),
+                        clock(loginEmployee.getId(), date.atTime(18, 0))));
+
+        // 调用
+        List<HrmHomeCalendarItemRespVO> items =
+                homeService.getEmployeeCalendar(100L, date, date);
+
+        // 断言
+        assertEquals(1, items.size());
+        assertEquals(7, items.get(0).getType());
+        assertEquals(date, items.get(0).getDate());
+        verify(attendanceClockService).getAttendanceClockListByEmployeeIdAndClockTime(
+                eq(loginEmployee.getId()), aryEq(new LocalDateTime[]{
+                        date.atStartOfDay(), date.atTime(java.time.LocalTime.MAX)}));
+    }
+
+    private HrmAttendanceClockDO clock(Long employeeId, LocalDateTime clockTime) {
+        HrmAttendanceClockDO clock = new HrmAttendanceClockDO();
+        clock.setId(1L);
+        clock.setEmployeeId(employeeId);
+        clock.setClockTime(clockTime);
+        clock.setType(1);
+        clock.setAttendanceTime(clockTime);
+        clock.setStatus(1);
+        return clock;
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeServiceImplTest.java
new file mode 100644
index 0000000..b01bd80
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceSchemeServiceImplTest.java
@@ -0,0 +1,285 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.config;
+
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordService;
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeProjectSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.scheme.HrmInsuranceSchemeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.config.HrmInsuranceSchemeProjectMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.config.HrmInsuranceSchemeMapper;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceSchemeTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_AREA_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_PROJECT_EMPTY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_PROJECT_TYPE_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_SCHEME_USED;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmInsuranceSchemeServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmInsuranceSchemeServiceImpl.class)
+public class HrmInsuranceSchemeServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmInsuranceSchemeServiceImpl insuranceSchemeService;
+
+    @Resource
+    private HrmInsuranceSchemeMapper insuranceSchemeMapper;
+    @Resource
+    private HrmInsuranceSchemeProjectMapper insuranceSchemeProjectMapper;
+
+    @MockitoBean
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @MockitoBean
+    private HrmInsuranceMonthEmployeeRecordService insuranceMonthEmployeeRecordService;
+
+    @Test
+    public void testCreateScheme_success() {
+        // 准备参数
+        HrmInsuranceSchemeSaveReqVO reqVO = createProportionSchemeReqVO("深圳标准方案");
+
+        // 调用
+        Long schemeId = insuranceSchemeService.createScheme(reqVO);
+
+        // 断言
+        assertNotNull(schemeId);
+        assertEquals(reqVO.getName(), insuranceSchemeMapper.selectById(schemeId).getName());
+        assertEquals(reqVO.getName(), insuranceSchemeService.getScheme(schemeId).getName());
+        List<HrmInsuranceSchemeProjectDO> projects =
+                insuranceSchemeProjectMapper.selectListBySchemeId(schemeId);
+        assertEquals(2, projects.size());
+        assertAmount(1600, projects.get(0).getCorporateAmount());
+        assertAmount(800, projects.get(0).getPersonalAmount());
+    }
+
+    @Test
+    public void testUpdateScheme_success() {
+        // mock 数据
+        Long schemeId = insuranceSchemeService.createScheme(
+                createProportionSchemeReqVO("深圳标准方案"));
+        List<HrmInsuranceSchemeProjectDO> projects =
+                insuranceSchemeProjectMapper.selectListBySchemeId(schemeId);
+        Long retainedProjectId = projects.get(0).getId();
+        Long deletedProjectId = projects.get(1).getId();
+        // 准备参数
+        HrmInsuranceSchemeSaveReqVO reqVO = createAmountSchemeReqVO("北京固定金额方案");
+        reqVO.setId(schemeId);
+        HrmInsuranceSchemeProjectSaveReqVO retainedProject =
+                reqVO.getProjectList().get(0).setId(retainedProjectId);
+        reqVO.setProjectList(Arrays.asList(retainedProject,
+                project(HrmInsuranceProjectTypeEnum.MEDICAL_INSURANCE.getType(),
+                        "医疗保险", BigDecimal.ZERO, BigDecimal.ZERO, BigDecimal.ZERO,
+                        BigDecimal.valueOf(500), BigDecimal.valueOf(200))));
+
+        // 调用
+        insuranceSchemeService.updateScheme(reqVO);
+
+        // 断言
+        assertNull(insuranceSchemeMapper.selectById(schemeId));
+        assertNull(insuranceSchemeProjectMapper.selectById(retainedProjectId));
+        assertNull(insuranceSchemeProjectMapper.selectById(deletedProjectId));
+        HrmInsuranceSchemeDO newScheme = insuranceSchemeMapper.selectByName(reqVO.getName());
+        assertNotNull(newScheme);
+        assertNotEquals(schemeId, newScheme.getId());
+        List<HrmInsuranceSchemeProjectDO> updatedProjects =
+                insuranceSchemeProjectMapper.selectListBySchemeId(newScheme.getId());
+        assertEquals(2, updatedProjects.size());
+        HrmInsuranceSchemeProjectDO amountProject = CollUtil.findOne(updatedProjects,
+                project -> HrmInsuranceProjectTypeEnum.PENSION_INSURANCE.getType().equals(project.getType()));
+        assertNotNull(amountProject);
+        assertNotEquals(retainedProjectId, amountProject.getId());
+        assertAmount(900, amountProject.getCorporateAmount());
+        assertAmount(300, amountProject.getPersonalAmount());
+        HrmInsuranceSchemeProjectDO createdProject = CollUtil.findOne(updatedProjects,
+                project -> HrmInsuranceProjectTypeEnum.MEDICAL_INSURANCE.getType().equals(project.getType()));
+        assertNotNull(createdProject);
+        assertAmount(500, createdProject.getCorporateAmount());
+        assertEquals(HrmInsuranceSchemeTypeEnum.AMOUNT.getType(),
+                newScheme.getType());
+        verify(insuranceEmployeeInfoService).updateInsuranceEmployeeInfoSchemeIdBySchemeId(
+                schemeId, newScheme.getId());
+        verify(insuranceMonthEmployeeRecordService).updateInsuranceMonthEmployeeRecordSchemeIdBySchemeId(
+                schemeId, newScheme.getId());
+    }
+
+    @Test
+    public void testDeleteScheme_success() {
+        // mock 数据
+        Long schemeId = insuranceSchemeService.createScheme(
+                createProportionSchemeReqVO("深圳标准方案"));
+
+        // 调用
+        insuranceSchemeService.deleteScheme(schemeId);
+
+        // 断言
+        assertNull(insuranceSchemeMapper.selectById(schemeId));
+        assertEquals(0, insuranceSchemeProjectMapper.selectListBySchemeId(schemeId).size());
+    }
+
+    @Test
+    public void testCreateScheme_nameDuplicate() {
+        // mock 数据
+        insuranceSchemeService.createScheme(createProportionSchemeReqVO("重复方案"));
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceSchemeService.createScheme(
+                createProportionSchemeReqVO("重复方案")), INSURANCE_SCHEME_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testGetSchemeListByAreaId_success() {
+        // mock 数据
+        insuranceSchemeService.createScheme(createProportionSchemeReqVO("深圳比例方案A"));
+        insuranceSchemeService.createScheme(createProportionSchemeReqVO("深圳比例方案B"));
+        insuranceSchemeService.createScheme(createAmountSchemeReqVO("北京金额方案"));
+
+        // 调用，并断言异常
+        List<HrmInsuranceSchemeDO> schemeList = insuranceSchemeService.getSchemeListByAreaId(440300);
+        assertEquals(2, schemeList.size());
+        assertEquals(3, insuranceSchemeService.getSchemeList().size());
+    }
+
+    @Test
+    public void testCreateScheme_onlyProvidentFund() {
+        // 准备参数
+        HrmInsuranceSchemeSaveReqVO reqVO = createProportionSchemeReqVO("仅公积金方案");
+        reqVO.setProjectList(Collections.singletonList(project(
+                HrmInsuranceProjectTypeEnum.PROVIDENT_FUND.getType(), "公积金",
+                BigDecimal.valueOf(10000), BigDecimal.valueOf(7), BigDecimal.valueOf(7),
+                BigDecimal.ZERO, BigDecimal.ZERO)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceSchemeService.createScheme(reqVO),
+                INSURANCE_SCHEME_PROJECT_EMPTY);
+    }
+
+    @Test
+    public void testCreateScheme_projectTypeDuplicate() {
+        // 准备参数
+        HrmInsuranceSchemeSaveReqVO reqVO = createProportionSchemeReqVO("重复项目方案");
+        reqVO.setProjectList(Arrays.asList(
+                project(HrmInsuranceProjectTypeEnum.PENSION_INSURANCE.getType(), "养老保险",
+                        BigDecimal.valueOf(10000), BigDecimal.valueOf(16),
+                        BigDecimal.valueOf(8), BigDecimal.ZERO, BigDecimal.ZERO),
+                project(HrmInsuranceProjectTypeEnum.PENSION_INSURANCE.getType(), "重复养老保险",
+                        BigDecimal.valueOf(8000), BigDecimal.valueOf(12),
+                        BigDecimal.valueOf(6), BigDecimal.ZERO, BigDecimal.ZERO)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceSchemeService.createScheme(reqVO),
+                INSURANCE_SCHEME_PROJECT_TYPE_DUPLICATE);
+    }
+
+    @Test
+    public void testCreateScheme_normalizesDistrictToCity() {
+        // 准备参数
+        HrmInsuranceSchemeSaveReqVO reqVO = createProportionSchemeReqVO("南山标准方案")
+                .setAreaId(440305);
+
+        // 调用
+        Long schemeId = insuranceSchemeService.createScheme(reqVO);
+
+        // 断言
+        assertEquals(440300, insuranceSchemeMapper.selectById(schemeId).getAreaId());
+    }
+
+    @Test
+    public void testCreateScheme_provinceAreaIllegal() {
+        // 准备参数
+        HrmInsuranceSchemeSaveReqVO reqVO = createProportionSchemeReqVO("广东标准方案")
+                .setAreaId(440000);
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceSchemeService.createScheme(reqVO),
+                INSURANCE_SCHEME_AREA_INVALID);
+    }
+
+    @Test
+    public void testDeleteScheme_usedByEmployee() {
+        // mock 数据
+        Long schemeId = insuranceSchemeService.createScheme(createProportionSchemeReqVO("使用中方案"));
+        // mock 方法
+        when(insuranceEmployeeInfoService.getInsuranceEmployeeInfoCountBySchemeId(schemeId)).thenReturn(1L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceSchemeService.deleteScheme(schemeId), INSURANCE_SCHEME_USED);
+    }
+
+    @Test
+    public void testDeleteScheme_usedByMonthRecord() {
+        // mock 数据
+        Long schemeId = insuranceSchemeService.createScheme(createProportionSchemeReqVO("使用中方案"));
+        // mock 方法
+        when(insuranceMonthEmployeeRecordService.getMonthEmployeeRecordCountBySchemeId(schemeId)).thenReturn(1L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceSchemeService.deleteScheme(schemeId), INSURANCE_SCHEME_USED);
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmInsuranceSchemeSaveReqVO createProportionSchemeReqVO(String name) {
+        HrmInsuranceSchemeSaveReqVO reqVO = new HrmInsuranceSchemeSaveReqVO();
+        reqVO.setName(name).setAreaId(440300).setHouseholdType("深户")
+                .setType(HrmInsuranceSchemeTypeEnum.PROPORTION.getType());
+        reqVO.setProjectList(Arrays.asList(
+                project(1, "养老保险", BigDecimal.valueOf(10000), BigDecimal.valueOf(16), BigDecimal.valueOf(8),
+                        BigDecimal.ZERO, BigDecimal.ZERO),
+                project(10, "公积金", BigDecimal.valueOf(10000), BigDecimal.valueOf(7), BigDecimal.valueOf(7),
+                        BigDecimal.ZERO, BigDecimal.ZERO)));
+        return reqVO;
+    }
+
+    private HrmInsuranceSchemeSaveReqVO createAmountSchemeReqVO(String name) {
+        HrmInsuranceSchemeSaveReqVO reqVO = new HrmInsuranceSchemeSaveReqVO();
+        reqVO.setName(name).setAreaId(110100).setHouseholdType("城镇")
+                .setType(HrmInsuranceSchemeTypeEnum.AMOUNT.getType());
+        reqVO.setProjectList(Collections.singletonList(project(1, "养老保险", BigDecimal.ZERO,
+                BigDecimal.ZERO, BigDecimal.ZERO, BigDecimal.valueOf(900), BigDecimal.valueOf(300))));
+        return reqVO;
+    }
+
+    private static HrmInsuranceSchemeProjectSaveReqVO project(
+            Integer type, String name, BigDecimal baseAmount,
+            BigDecimal corporateRate, BigDecimal personalRate,
+            BigDecimal corporateAmount, BigDecimal personalAmount) {
+        HrmInsuranceSchemeProjectSaveReqVO project = new HrmInsuranceSchemeProjectSaveReqVO();
+        project.setType(type);
+        project.setName(name);
+        project.setBaseAmount(baseAmount);
+        project.setCorporateRate(corporateRate);
+        project.setPersonalRate(personalRate);
+        project.setCorporateAmount(corporateAmount);
+        project.setPersonalAmount(personalAmount);
+        return project;
+    }
+
+    private static void assertAmount(int expected, BigDecimal actual) {
+        assertNotNull(actual);
+        assertEquals(0, BigDecimal.valueOf(expected).compareTo(actual));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardServiceImplTest.java
new file mode 100644
index 0000000..9628c3e
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/config/HrmInsuranceStandardServiceImplTest.java
@@ -0,0 +1,97 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.config;
+
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardProjectRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.standard.HrmInsuranceStandardTypeRespVO;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceProjectTypeEnum;
+import org.junit.jupiter.api.Test;
+
+import java.math.BigDecimal;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+/**
+ * {@link HrmInsuranceStandardServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+public class HrmInsuranceStandardServiceImplTest {
+
+    private final HrmInsuranceStandardServiceImpl insuranceStandardService =
+            new HrmInsuranceStandardServiceImpl();
+
+    @Test
+    public void testParseTypeList_success() {
+        // 准备参数
+        String body = "{\"data\":{\"SocialTypes\":["
+                + "{\"AccountNo\":\"SS100172\",\"InsuredType\":\"非深户一档\"},"
+                + "{\"AccountNo\":\"SS100173\",\"InsuredType\":\"深户一档\"}]}}";
+
+        // 调用
+        List<HrmInsuranceStandardTypeRespVO> result = insuranceStandardService.parseTypeList(body);
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals("SS100172", result.get(0).getCode());
+        assertEquals("非深户一档", result.get(0).getName());
+        assertEquals("SS100173", result.get(1).getCode());
+        assertEquals("深户一档", result.get(1).getName());
+    }
+
+    @Test
+    public void testParseProjectList_success() {
+        // 准备参数
+        String body = "<table><tr><th>项目</th></tr>"
+                + "<tr><td>养老保险</td><td>10,000.00</td><td></td><td>16%</td><td>8%</td>"
+                + "<td>1,600.00</td><td>800.00</td></tr>"
+                + "<tr><td>失业保险</td><td>2520</td><td></td><td>0.8%</td><td>0.2%</td>"
+                + "<td>20.16</td><td>5.04</td></tr>"
+                + "<tr><td>工伤保险</td><td>2520</td><td></td><td>0.5%</td><td>0%</td>"
+                + "<td>12.60</td><td>0</td></tr>"
+                + "<tr><td>未知项目</td><td>0</td><td></td><td>0</td><td>0</td>"
+                + "<td>0</td><td>0</td></tr></table>";
+
+        // 调用
+        List<HrmInsuranceStandardProjectRespVO> result = insuranceStandardService.parseProjectList(body);
+
+        // 断言
+        assertEquals(3, result.size());
+        HrmInsuranceStandardProjectRespVO pension = result.get(0);
+        assertEquals(HrmInsuranceProjectTypeEnum.PENSION_INSURANCE.getType(), pension.getType());
+        assertAmount("10000.00", pension.getBaseAmount());
+        assertAmount("16", pension.getCorporateRate());
+        assertAmount("800.00", pension.getPersonalAmount());
+        assertEquals(HrmInsuranceProjectTypeEnum.UNEMPLOYMENT_INSURANCE.getType(), result.get(1).getType());
+        assertEquals(HrmInsuranceProjectTypeEnum.WORK_INJURY_INSURANCE.getType(), result.get(2).getType());
+    }
+
+    @Test
+    public void testGetCityName_success() {
+        assertEquals("深圳", HrmInsuranceStandardServiceImpl.getCityName(440305));
+        assertEquals("北京", HrmInsuranceStandardServiceImpl.getCityName(110105));
+        assertNull(HrmInsuranceStandardServiceImpl.getCityName(-1));
+    }
+
+    @Test
+    public void testParseProjectList_duplicateTypeUsesFirst() {
+        // 准备参数
+        String body = "<table>"
+                + "<tr><td>养老保险</td><td>10000</td><td></td><td>16%</td><td>8%</td>"
+                + "<td>1600</td><td>800</td></tr>"
+                + "<tr><td>养老保险单位部分</td><td>8000</td><td></td><td>12%</td><td>6%</td>"
+                + "<td>960</td><td>480</td></tr></table>";
+
+        // 调用
+        List<HrmInsuranceStandardProjectRespVO> result = insuranceStandardService.parseProjectList(body);
+
+        // 断言
+        assertEquals(1, result.size());
+        assertAmount("10000", result.get(0).getBaseAmount());
+    }
+
+    private void assertAmount(String expected, BigDecimal actual) {
+        assertEquals(0, new BigDecimal(expected).compareTo(actual));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoServiceImplTest.java
new file mode 100644
index 0000000..d0043e2
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/employee/HrmInsuranceEmployeeInfoServiceImplTest.java
@@ -0,0 +1,447 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.employee;
+
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.employeeinfo.HrmInsuranceEmployeeInfoSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.employee.HrmInsuranceEmployeeInfoMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_RESOURCE_BELONG_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_EMPLOYEE_INFO_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_EMP_STATUS_ILLEGAL;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmInsuranceEmployeeInfoServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmInsuranceEmployeeInfoServiceImpl.class)
+public class HrmInsuranceEmployeeInfoServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmInsuranceEmployeeInfoServiceImpl insuranceEmployeeInfoService;
+
+    @Resource
+    private HrmInsuranceEmployeeInfoMapper insuranceEmployeeInfoMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private HrmInsuranceSchemeService insuranceSchemeService;
+
+    @Test
+    public void testSaveInsuranceEmployeeInfo_create() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        Long schemeId = randomLongId();
+        HrmEmployeeDO employee = randomEligibleEmployee(employeeId);
+        HrmInsuranceSchemeDO scheme = randomPojo(HrmInsuranceSchemeDO.class, o -> o.setId(schemeId));
+        HrmInsuranceEmployeeInfoSaveReqVO reqVO = randomInsuranceEmployeeInfoReqVO(employeeId, schemeId);
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId)).thenReturn(employee);
+        when(insuranceSchemeService.validateSchemeExists(schemeId)).thenReturn(scheme);
+
+        // 调用
+        Long id = insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        assertPojoEquals(reqVO, insuranceEmployeeInfoMapper.selectById(id), "id");
+        verify(employeeService).validateEmployeeExistsForUpdate(employeeId);
+        verify(insuranceSchemeService).validateSchemeExists(schemeId);
+    }
+
+    @Test
+    public void testSaveInsuranceEmployeeInfo_normalizeSocialSecurityStartMonth() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmInsuranceEmployeeInfoSaveReqVO reqVO = randomInsuranceEmployeeInfoReqVO(employeeId, null)
+                .setSocialSecurityStartMonth(LocalDateTime.of(2026, 1, 18, 13, 45, 20));
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId))
+                .thenReturn(randomEligibleEmployee(employeeId));
+
+        // 调用
+        Long id = insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(reqVO);
+
+        // 断言
+        assertEquals(LocalDateTime.of(2026, 1, 1, 0, 0), insuranceEmployeeInfoMapper.selectById(id)
+                .getSocialSecurityStartMonth());
+    }
+
+    @Test
+    public void testSaveInsuranceEmployeeInfo_updateByEmployeeId() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO dbInsuranceEmployeeInfo = randomInsuranceEmployeeInfoDO(employeeId);
+        insuranceEmployeeInfoMapper.insert(dbInsuranceEmployeeInfo);
+        // 准备参数
+        HrmInsuranceEmployeeInfoSaveReqVO reqVO = randomInsuranceEmployeeInfoReqVO(
+                employeeId, dbInsuranceEmployeeInfo.getSchemeId());
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId))
+                .thenReturn(randomEligibleEmployee(employeeId));
+        when(insuranceSchemeService.validateSchemeExists(dbInsuranceEmployeeInfo.getSchemeId()))
+                .thenReturn(randomPojo(HrmInsuranceSchemeDO.class,
+                        o -> o.setId(dbInsuranceEmployeeInfo.getSchemeId())));
+
+        // 调用
+        Long id = insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(reqVO);
+
+        // 断言
+        assertEquals(dbInsuranceEmployeeInfo.getId(), id);
+        assertPojoEquals(reqVO, insuranceEmployeeInfoMapper.selectById(id), "id");
+        assertEquals(1L, insuranceEmployeeInfoMapper.selectCount());
+    }
+
+    @Test
+    public void testSaveInsuranceEmployeeInfo_employeeMismatch() {
+        // mock 数据
+        HrmInsuranceEmployeeInfoDO dbInsuranceEmployeeInfo = randomInsuranceEmployeeInfoDO(randomLongId());
+        insuranceEmployeeInfoMapper.insert(dbInsuranceEmployeeInfo);
+        // 准备参数
+        Long employeeId = randomLongId();
+        HrmInsuranceEmployeeInfoSaveReqVO reqVO = randomInsuranceEmployeeInfoReqVO(employeeId, null);
+        reqVO.setId(dbInsuranceEmployeeInfo.getId());
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId))
+                .thenReturn(randomEligibleEmployee(employeeId));
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(reqVO),
+                EMPLOYEE_RESOURCE_BELONG_INVALID, "参保信息");
+    }
+
+    @Test
+    public void testSaveInsuranceEmployeeInfo_leftEmployeeKeepsScheme() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        Long schemeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO oldEmployeeInfo = randomInsuranceEmployeeInfoDO(employeeId)
+                .setSchemeId(schemeId);
+        insuranceEmployeeInfoMapper.insert(oldEmployeeInfo);
+        HrmEmployeeDO employee = randomEligibleEmployee(employeeId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus());
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId)).thenReturn(employee);
+        // 准备参数
+        HrmInsuranceEmployeeInfoSaveReqVO reqVO = randomInsuranceEmployeeInfoReqVO(employeeId, schemeId)
+                .setId(oldEmployeeInfo.getId()).setSocialSecurityNumber("SB-UPDATED");
+
+        // 调用
+        insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(reqVO);
+
+        // 断言
+        assertEquals("SB-UPDATED", insuranceEmployeeInfoMapper.selectById(oldEmployeeInfo.getId())
+                .getSocialSecurityNumber());
+    }
+
+    @Test
+    public void testSaveInsuranceEmployeeInfo_leftEmployeeChangesSchemeIllegal() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO oldEmployeeInfo = randomInsuranceEmployeeInfoDO(employeeId)
+                .setSchemeId(randomLongId());
+        insuranceEmployeeInfoMapper.insert(oldEmployeeInfo);
+        HrmEmployeeDO employee = randomEligibleEmployee(employeeId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus());
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId)).thenReturn(employee);
+        // 准备参数
+        HrmInsuranceEmployeeInfoSaveReqVO reqVO = randomInsuranceEmployeeInfoReqVO(
+                employeeId, randomLongId()).setId(oldEmployeeInfo.getId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceEmployeeInfoService.saveInsuranceEmployeeInfo(reqVO),
+                INSURANCE_EMP_STATUS_ILLEGAL);
+    }
+
+    @Test
+    public void testGetInsuranceEmployeeInfoByEmployeeId_returnsLatest() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO firstEmployeeInfo = randomInsuranceEmployeeInfoDO(employeeId)
+                .setSocialSecurityNumber("SB-OLD");
+        insuranceEmployeeInfoMapper.insert(firstEmployeeInfo);
+        HrmInsuranceEmployeeInfoDO lastEmployeeInfo = randomInsuranceEmployeeInfoDO(employeeId)
+                .setSocialSecurityNumber("SB-NEW");
+        insuranceEmployeeInfoMapper.insert(lastEmployeeInfo);
+
+        // 调用
+        HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoService
+                .getInsuranceEmployeeInfoByEmployeeId(employeeId);
+
+        // 断言
+        assertEquals(lastEmployeeInfo.getId(), employeeInfo.getId());
+    }
+
+    @Test
+    public void testValidateInsuranceEmployeeExists_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceEmployeeInfoService.validateInsuranceEmployeeInfoExists(id),
+                INSURANCE_EMPLOYEE_INFO_NOT_EXISTS);
+    }
+
+    @Test
+    public void testUpdateEmployeeScheme_create() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        Long schemeId = randomLongId();
+        HrmEmployeeDO employee = randomEligibleEmployee(employeeId);
+        HrmInsuranceSchemeDO scheme = randomPojo(
+                HrmInsuranceSchemeDO.class, o -> o.setId(schemeId));
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId)).thenReturn(employee);
+        when(insuranceSchemeService.validateSchemeExists(schemeId)).thenReturn(scheme);
+        when(insuranceSchemeService.getScheme(schemeId)).thenReturn(scheme);
+
+        // 调用
+        insuranceEmployeeInfoService.updateEmployeeScheme(employeeId, schemeId);
+
+        // 断言
+        HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoMapper
+                .selectByEmployeeId(employeeId);
+        assertEquals(schemeId, employeeInfo.getSchemeId());
+        assertFalse(employeeInfo.getFirstSocialSecurity());
+        assertFalse(employeeInfo.getFirstAccumulationFund());
+    }
+
+    @Test
+    public void testUpdateEmployeeScheme_update() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        insuranceEmployeeInfoMapper.insert(
+                randomInsuranceEmployeeInfoDO(employeeId).setSchemeId(randomLongId()));
+        Long schemeId = randomLongId();
+        HrmInsuranceSchemeDO scheme = randomPojo(
+                HrmInsuranceSchemeDO.class, o -> o.setId(schemeId));
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId))
+                .thenReturn(randomEligibleEmployee(employeeId));
+        when(insuranceSchemeService.validateSchemeExists(schemeId)).thenReturn(scheme);
+
+        // 调用
+        insuranceEmployeeInfoService.updateEmployeeScheme(employeeId, schemeId);
+
+        // 断言
+        assertEquals(schemeId, insuranceEmployeeInfoMapper
+                .selectByEmployeeId(employeeId).getSchemeId());
+    }
+
+    @Test
+    public void testUpdateInsuranceEmployeeInfoSchemeIdBySchemeId() {
+        // mock 数据
+        Long oldSchemeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO migratedEmployeeInfo = randomInsuranceEmployeeInfoDO(randomLongId())
+                .setSchemeId(oldSchemeId);
+        insuranceEmployeeInfoMapper.insert(migratedEmployeeInfo);
+        HrmInsuranceEmployeeInfoDO retainedEmployeeInfo = randomInsuranceEmployeeInfoDO(randomLongId())
+                .setSchemeId(randomLongId());
+        insuranceEmployeeInfoMapper.insert(retainedEmployeeInfo);
+        // 准备参数
+        Long newSchemeId = randomLongId();
+
+        // 调用
+        insuranceEmployeeInfoService.updateInsuranceEmployeeInfoSchemeIdBySchemeId(
+                oldSchemeId, newSchemeId);
+
+        // 断言
+        assertEquals(newSchemeId, insuranceEmployeeInfoMapper.selectById(migratedEmployeeInfo.getId())
+                .getSchemeId());
+        assertEquals(retainedEmployeeInfo.getSchemeId(),
+                insuranceEmployeeInfoMapper.selectById(retainedEmployeeInfo.getId()).getSchemeId());
+    }
+
+    @Test
+    public void testUpdateEmployeeScheme_employeeStatusIllegal() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        Long schemeId = randomLongId();
+        HrmEmployeeDO employee = randomEligibleEmployee(employeeId)
+                .setStatus(HrmEmployeeStatusEnum.INTERN.getStatus());
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId)).thenReturn(employee);
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceEmployeeInfoService.updateEmployeeScheme(employeeId, schemeId),
+                INSURANCE_EMP_STATUS_ILLEGAL);
+    }
+
+    @Test
+    public void testUpdateEmployeeScheme_pendingEntryIllegal() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        Long schemeId = randomLongId();
+        HrmEmployeeDO employee = randomEligibleEmployee(employeeId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus());
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId)).thenReturn(employee);
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceEmployeeInfoService.updateEmployeeScheme(employeeId, schemeId),
+                INSURANCE_EMP_STATUS_ILLEGAL);
+    }
+
+    @Test
+    public void testUpdateEmployeeScheme_leftIllegal() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        Long schemeId = randomLongId();
+        HrmEmployeeDO employee = randomEligibleEmployee(employeeId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus());
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId)).thenReturn(employee);
+
+        // 调用，并断言异常
+        assertServiceException(() -> insuranceEmployeeInfoService.updateEmployeeScheme(employeeId, schemeId),
+                INSURANCE_EMP_STATUS_ILLEGAL);
+    }
+
+    @Test
+    public void testUpdateSocialSecurityStartMonthIfAbsent() {
+        // 准备参数
+        Long employeeId = randomLongId();
+        LocalDateTime startMonth = LocalDateTime.of(2026, 1, 18, 13, 45, 20);
+        // mock 方法
+        when(employeeService.validateEmployeeExistsForUpdate(employeeId))
+                .thenReturn(randomEligibleEmployee(employeeId));
+
+        // 调用
+        insuranceEmployeeInfoService.updateSocialSecurityStartMonthIfAbsent(employeeId, startMonth);
+        insuranceEmployeeInfoService.updateSocialSecurityStartMonthIfAbsent(employeeId, startMonth.plusMonths(1));
+
+        // 断言
+        HrmInsuranceEmployeeInfoDO employeeInfo = insuranceEmployeeInfoMapper
+                .selectByEmployeeId(employeeId);
+        assertEquals(LocalDateTime.of(2026, 1, 1, 0, 0), employeeInfo.getSocialSecurityStartMonth());
+        assertFalse(employeeInfo.getFirstSocialSecurity());
+        assertFalse(employeeInfo.getFirstAccumulationFund());
+    }
+
+    @Test
+    public void testGetInsuranceEmployeeInfoMap() {
+        // mock 数据
+        Long firstSchemeId = randomLongId();
+        Long secondSchemeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO firstInsuranceEmployeeInfo = randomInsuranceEmployeeInfoDO(randomLongId())
+                .setSchemeId(firstSchemeId);
+        insuranceEmployeeInfoMapper.insert(firstInsuranceEmployeeInfo);
+        HrmInsuranceEmployeeInfoDO secondInsuranceEmployeeInfo = randomInsuranceEmployeeInfoDO(randomLongId())
+                .setSchemeId(secondSchemeId);
+        insuranceEmployeeInfoMapper.insert(secondInsuranceEmployeeInfo);
+        insuranceEmployeeInfoMapper.insert(randomInsuranceEmployeeInfoDO(randomLongId()).setSchemeId(firstSchemeId));
+
+        // 调用
+        Map<Long, HrmInsuranceEmployeeInfoDO> insuranceEmployeeInfoMap = insuranceEmployeeInfoService
+                .getInsuranceEmployeeInfoMap(Arrays.asList(firstInsuranceEmployeeInfo.getEmployeeId(),
+                        secondInsuranceEmployeeInfo.getEmployeeId()));
+        // 断言
+        assertEquals(2, insuranceEmployeeInfoMap.size());
+        assertTrue(insuranceEmployeeInfoService
+                .getInsuranceEmployeeInfoMap(Collections.emptyList()).isEmpty());
+    }
+
+    @Test
+    public void testGetInsuranceEmployeeInfoCountMapBySchemeIds() {
+        // mock 数据
+        Long firstSchemeId = randomLongId();
+        Long secondSchemeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO firstEmployeeInfo =
+                randomInsuranceEmployeeInfoDO(randomLongId()).setSchemeId(firstSchemeId);
+        insuranceEmployeeInfoMapper.insert(firstEmployeeInfo);
+        HrmInsuranceEmployeeInfoDO secondEmployeeInfo =
+                randomInsuranceEmployeeInfoDO(randomLongId()).setSchemeId(secondSchemeId);
+        insuranceEmployeeInfoMapper.insert(secondEmployeeInfo);
+        HrmInsuranceEmployeeInfoDO thirdEmployeeInfo =
+                randomInsuranceEmployeeInfoDO(randomLongId()).setSchemeId(firstSchemeId);
+        insuranceEmployeeInfoMapper.insert(thirdEmployeeInfo);
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(firstEmployeeInfo.getEmployeeId(), randomEligibleEmployee(firstEmployeeInfo.getEmployeeId()));
+        employeeMap.put(secondEmployeeInfo.getEmployeeId(), randomEligibleEmployee(secondEmployeeInfo.getEmployeeId()));
+        employeeMap.put(thirdEmployeeInfo.getEmployeeId(), randomEligibleEmployee(thirdEmployeeInfo.getEmployeeId()));
+        when(employeeService.getEmployeeMap(org.mockito.ArgumentMatchers.anyCollection())).thenReturn(employeeMap);
+        // 准备参数
+        List<Long> schemeIds = Arrays.asList(firstSchemeId, secondSchemeId);
+
+        // 调用
+        Map<Long, Long> countMap =
+                insuranceEmployeeInfoService.getInsuranceEmployeeInfoCountMapBySchemeIds(schemeIds);
+
+        // 断言
+        assertEquals(2L, countMap.get(firstSchemeId));
+        assertEquals(1L, countMap.get(secondSchemeId));
+        assertTrue(insuranceEmployeeInfoService
+                .getInsuranceEmployeeInfoCountMapBySchemeIds(Collections.emptyList()).isEmpty());
+    }
+
+    @Test
+    public void testGetInsuranceEmployeeInfoCountMap_ignoresDeletedEmployee() {
+        // mock 数据
+        Long schemeId = randomLongId();
+        HrmInsuranceEmployeeInfoDO employeeInfo = randomInsuranceEmployeeInfoDO(randomLongId())
+                .setSchemeId(schemeId);
+        insuranceEmployeeInfoMapper.insert(employeeInfo);
+        when(employeeService.getEmployeeMap(org.mockito.ArgumentMatchers.anyCollection()))
+                .thenReturn(Collections.emptyMap());
+
+        // 调用
+        Map<Long, Long> countMap = insuranceEmployeeInfoService
+                .getInsuranceEmployeeInfoCountMapBySchemeIds(Collections.singleton(schemeId));
+
+        // 断言
+        assertEquals(0L, countMap.getOrDefault(schemeId, 0L));
+    }
+
+    // ========== 随机对象 ==========
+
+    private static HrmInsuranceEmployeeInfoSaveReqVO randomInsuranceEmployeeInfoReqVO(
+            Long employeeId, Long schemeId) {
+        return randomPojo(HrmInsuranceEmployeeInfoSaveReqVO.class, o -> {
+            o.setId(null).setEmployeeId(employeeId).setSchemeId(schemeId);
+            o.setFirstSocialSecurity(true).setFirstAccumulationFund(false);
+            o.setSocialSecurityStartMonth(LocalDateTime.of(2026, 1, 1, 0, 0));
+        });
+    }
+
+    private static HrmInsuranceEmployeeInfoDO randomInsuranceEmployeeInfoDO(Long employeeId) {
+        return randomPojo(HrmInsuranceEmployeeInfoDO.class, o -> {
+            o.setId(null).setEmployeeId(employeeId).setDeleted(false);
+            o.setFirstSocialSecurity(true).setFirstAccumulationFund(false);
+            o.setSocialSecurityStartMonth(LocalDateTime.of(2026, 1, 1, 0, 0));
+        });
+    }
+
+    private static HrmEmployeeDO randomEligibleEmployee(Long employeeId) {
+        return randomPojo(HrmEmployeeDO.class, o -> o.setId(employeeId)
+                .setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordServiceImplTest.java
new file mode 100644
index 0000000..566516b
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthEmployeeRecordServiceImplTest.java
@@ -0,0 +1,502 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.monthrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeProjectUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordCreateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.employee.HrmInsuranceMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.config.HrmInsuranceSchemeProjectDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.employee.HrmInsuranceEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO.Project;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.config.HrmInsuranceSchemeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.employee.HrmInsuranceEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.config.HrmInsuranceSchemeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.employee.HrmInsuranceEmployeeInfoService;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_EMPLOYEE_SCHEME_NOT_CONFIGURED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_EMPLOYEE_NOT_ELIGIBLE;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmInsuranceMonthEmployeeRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmInsuranceMonthEmployeeRecordServiceImpl.class)
+public class HrmInsuranceMonthEmployeeRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordServiceImpl monthEmployeeRecordService;
+
+    @Resource
+    private HrmInsuranceMonthEmployeeRecordMapper monthEmployeeRecordMapper;
+
+    @MockitoBean
+    private HrmInsuranceMonthRecordService monthRecordService;
+    @MockitoBean
+    private HrmInsuranceSchemeService insuranceSchemeService;
+    @MockitoBean
+    private HrmInsuranceEmployeeInfoService insuranceEmployeeInfoService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    @Test
+    public void testCreateMonthEmployeeRecordList_success() {
+        // mock 数据
+        Long employeeId = 1001L;
+        Long schemeId = 2001L;
+        HrmInsuranceMonthRecordDO monthRecord = new HrmInsuranceMonthRecordDO()
+                .setId(3001L).setYear(2026).setMonth(7);
+        HrmInsuranceEmployeeInfoDO insuranceEmployeeInfo = new HrmInsuranceEmployeeInfoDO()
+                .setEmployeeId(employeeId).setSchemeId(schemeId)
+                .setSocialSecurityStartMonth(LocalDateTime.of(2026, 1, 1, 0, 0));
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(employeeId).setName("张三").setUserId(5001L)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+        HrmInsuranceSchemeDO scheme = new HrmInsuranceSchemeDO().setId(schemeId)
+                .setType(HrmInsuranceSchemeTypeEnum.PROPORTION.getType());
+        List<HrmInsuranceSchemeProjectDO> projects = Arrays.asList(
+                project(4001L, 1, BigDecimal.valueOf(10000), BigDecimal.valueOf(16), BigDecimal.valueOf(8)),
+                project(4002L, 10, BigDecimal.valueOf(10000), BigDecimal.valueOf(7), BigDecimal.valueOf(7)));
+        when(insuranceEmployeeInfoService.getInsuranceEmployeeInfoList())
+                .thenReturn(Collections.singletonList(insuranceEmployeeInfo));
+        when(insuranceSchemeService.getSchemeListByIds(anyCollection()))
+                .thenReturn(Collections.singletonList(scheme));
+        when(insuranceSchemeService.getSchemeProjectListMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(schemeId, projects));
+        when(employeeService.getEmployeeMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(employeeId, employee));
+
+        // 调用
+        monthEmployeeRecordService.createMonthEmployeeRecordList(monthRecord);
+
+        // 断言
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord =
+                monthEmployeeRecordMapper.selectByMonthRecordIdAndEmployeeId(monthRecord.getId(), employeeId);
+        assertEquals(0, BigDecimal.valueOf(800).compareTo(employeeRecord.getPersonalInsuranceAmount()));
+        assertEquals(0, BigDecimal.valueOf(700).compareTo(employeeRecord.getPersonalProvidentFundAmount()));
+        assertEquals(0, BigDecimal.valueOf(1600).compareTo(employeeRecord.getCorporateInsuranceAmount()));
+        verify(insuranceEmployeeInfoService).updateSocialSecurityStartMonthIfAbsent(
+                employeeId, LocalDateTime.of(2026, 7, 1, 0, 0));
+        verify(notifyMessageSendApi).sendSingleMessageToAdmin(any());
+    }
+
+    @Test
+    public void testCreateMonthEmployeeRecordList_leftInTargetMonth() {
+        // mock 数据
+        Long employeeId = 1001L;
+        Long schemeId = 2001L;
+        HrmInsuranceMonthRecordDO monthRecord = new HrmInsuranceMonthRecordDO()
+                .setId(3001L).setYear(2026).setMonth(7);
+        HrmInsuranceEmployeeInfoDO insuranceEmployeeInfo = new HrmInsuranceEmployeeInfoDO()
+                .setEmployeeId(employeeId).setSchemeId(schemeId);
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(employeeId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setEntryTime(LocalDateTime.of(2025, 1, 1, 0, 0))
+                .setLeaveTime(LocalDateTime.of(2026, 7, 20, 0, 0));
+        HrmInsuranceSchemeDO scheme = new HrmInsuranceSchemeDO().setId(schemeId)
+                .setType(HrmInsuranceSchemeTypeEnum.AMOUNT.getType());
+        when(insuranceEmployeeInfoService.getInsuranceEmployeeInfoList())
+                .thenReturn(Collections.singletonList(insuranceEmployeeInfo));
+        when(insuranceSchemeService.getSchemeListByIds(anyCollection()))
+                .thenReturn(Collections.singletonList(scheme));
+        when(insuranceSchemeService.getSchemeProjectListMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(schemeId, Collections.singletonList(
+                        project(4001L, 1, BigDecimal.ZERO, BigDecimal.ZERO, BigDecimal.ZERO))));
+        when(employeeService.getEmployeeMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(employeeId, employee));
+
+        // 调用
+        monthEmployeeRecordService.createMonthEmployeeRecordList(monthRecord);
+
+        // 断言
+        assertNotNull(monthEmployeeRecordMapper.selectByMonthRecordIdAndEmployeeId(monthRecord.getId(), employeeId));
+    }
+
+    @Test
+    public void testUpdateMonthEmployeeRecord_success() {
+        // mock 数据
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = randomEmployeeRecord(3001L, 1001L);
+        monthEmployeeRecordMapper.insert(employeeRecord);
+        HrmInsuranceMonthRecordDO monthRecord = new HrmInsuranceMonthRecordDO().setId(3001L);
+        HrmInsuranceSchemeDO scheme = new HrmInsuranceSchemeDO().setId(2001L)
+                .setType(HrmInsuranceSchemeTypeEnum.AMOUNT.getType());
+        HrmInsuranceSchemeProjectDO schemeProject = project(
+                4001L, 1, BigDecimal.ZERO, BigDecimal.ZERO, BigDecimal.ZERO);
+        when(monthRecordService.validateMonthRecordEditableForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(insuranceSchemeService.validateSchemeExists(scheme.getId())).thenReturn(scheme);
+        when(insuranceSchemeService.getSchemeProjectList(scheme.getId()))
+                .thenReturn(Collections.singletonList(schemeProject));
+        when(employeeService.getEmployee(employeeRecord.getEmployeeId())).thenReturn(new HrmEmployeeDO()
+                .setId(employeeRecord.getEmployeeId()).setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+        // 准备参数
+        HrmInsuranceMonthEmployeeRecordUpdateReqVO reqVO =
+                new HrmInsuranceMonthEmployeeRecordUpdateReqVO()
+                        .setId(employeeRecord.getId()).setSchemeId(scheme.getId())
+                        .setProjects(Collections.singletonList(
+                                new HrmInsuranceMonthEmployeeProjectUpdateReqVO()
+                                        .setSchemeProjectId(schemeProject.getId())
+                                        .setCorporateAmount(BigDecimal.valueOf(900))
+                                        .setPersonalAmount(BigDecimal.valueOf(300))));
+
+        // 调用
+        monthEmployeeRecordService.updateMonthEmployeeRecord(reqVO);
+
+        // 断言
+        HrmInsuranceMonthEmployeeRecordDO dbEmployeeRecord =
+                monthEmployeeRecordMapper.selectById(employeeRecord.getId());
+        assertEquals(scheme.getId(), dbEmployeeRecord.getSchemeId());
+        assertEquals(0, BigDecimal.valueOf(900).compareTo(dbEmployeeRecord.getCorporateInsuranceAmount()));
+        assertEquals(0, BigDecimal.valueOf(300).compareTo(dbEmployeeRecord.getPersonalInsuranceAmount()));
+        verify(insuranceEmployeeInfoService).updateEmployeeScheme(employeeRecord.getEmployeeId(), scheme.getId());
+        verify(monthRecordService).updateMonthRecordSummary(monthRecord.getId());
+    }
+
+    @Test
+    public void testStopMonthEmployeeRecordList_success() {
+        // mock 数据
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = randomEmployeeRecord(3001L, 1001L);
+        monthEmployeeRecordMapper.insert(employeeRecord);
+        when(monthRecordService.validateMonthRecordEditableForUpdate(employeeRecord.getMonthRecordId()))
+                .thenReturn(new HrmInsuranceMonthRecordDO().setId(employeeRecord.getMonthRecordId()));
+
+        // 调用
+        monthEmployeeRecordService.stopMonthEmployeeRecordList(
+                Collections.singletonList(employeeRecord.getId()));
+
+        // 断言
+        assertEquals(HrmInsuranceEmployeeStatusEnum.STOPPED.getStatus(),
+                monthEmployeeRecordMapper.selectById(employeeRecord.getId()).getStatus());
+        verify(monthRecordService).updateMonthRecordSummary(employeeRecord.getMonthRecordId());
+    }
+
+    @Test
+    public void testGetMonthEmployeeRecordPage_filters() {
+        // mock 数据
+        HrmInsuranceMonthEmployeeRecordDO matchedRecord = randomEmployeeRecord(3001L, 1001L);
+        matchedRecord.setSchemeId(2001L);
+        monthEmployeeRecordMapper.insert(matchedRecord);
+        HrmInsuranceMonthEmployeeRecordDO anotherRecord = randomEmployeeRecord(3001L, 1002L);
+        anotherRecord.setSchemeId(2002L);
+        monthEmployeeRecordMapper.insert(anotherRecord);
+        when(employeeService.getEmployeeList(any(HrmEmployeeListReqVO.class)))
+                .thenReturn(Collections.singletonList(new HrmEmployeeDO().setId(matchedRecord.getEmployeeId())));
+        when(insuranceSchemeService.getSchemeListByAreaId(440300))
+                .thenReturn(Collections.singletonList(new HrmInsuranceSchemeDO().setId(matchedRecord.getSchemeId())));
+        // 准备参数
+        HrmInsuranceMonthEmployeeRecordPageReqVO reqVO =
+                new HrmInsuranceMonthEmployeeRecordPageReqVO()
+                        .setMonthRecordId(matchedRecord.getMonthRecordId())
+                        .setEmployeeName("张").setAreaId(440300);
+
+        // 调用
+        PageResult<HrmInsuranceMonthEmployeeRecordDO> pageResult =
+                monthEmployeeRecordService.getMonthEmployeeRecordPage(reqVO);
+
+        // 断言
+        assertEquals(1, pageResult.getTotal());
+        assertEquals(matchedRecord.getId(), pageResult.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetMonthEmployeeRecordPage_employeeNotFound() {
+        // mock 方法
+        when(employeeService.getEmployeeList(any(HrmEmployeeListReqVO.class)))
+                .thenReturn(Collections.emptyList());
+        // 准备参数
+        HrmInsuranceMonthEmployeeRecordPageReqVO reqVO =
+                new HrmInsuranceMonthEmployeeRecordPageReqVO()
+                        .setMonthRecordId(3001L).setEmployeeName("不存在");
+
+        // 调用
+        PageResult<HrmInsuranceMonthEmployeeRecordDO> pageResult =
+                monthEmployeeRecordService.getMonthEmployeeRecordPage(reqVO);
+
+        // 断言
+        assertEquals(0, pageResult.getTotal());
+    }
+
+    @Test
+    public void testGetUninsuredEmployeeList() {
+        // mock 数据
+        Long monthRecordId = 3001L;
+        HrmInsuranceMonthRecordDO monthRecord =
+                new HrmInsuranceMonthRecordDO().setId(monthRecordId).setYear(2026).setMonth(7);
+        HrmEmployeeDO activeEmployee = new HrmEmployeeDO().setId(1001L)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setEntryTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        HrmEmployeeDO pendingEmployee = new HrmEmployeeDO().setId(1002L)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus());
+        when(monthRecordService.getMonthRecord(monthRecordId)).thenReturn(monthRecord);
+        when(employeeService.getEmployeeList(any(HrmEmployeeListReqVO.class)))
+                .thenReturn(Arrays.asList(activeEmployee, pendingEmployee));
+        HrmInsuranceEmployeeInfoDO employeeInfo = new HrmInsuranceEmployeeInfoDO()
+                .setEmployeeId(activeEmployee.getId()).setSchemeId(2001L);
+        when(insuranceEmployeeInfoService.getInsuranceEmployeeInfoMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(activeEmployee.getId(), employeeInfo));
+        when(insuranceSchemeService.getSchemeListByIds(anyCollection()))
+                .thenReturn(Collections.singletonList(new HrmInsuranceSchemeDO().setId(2001L)));
+
+        // 调用
+        List<HrmEmployeeDO> employees =
+                monthEmployeeRecordService.getUninsuredEmployeeList(monthRecordId);
+
+        // 断言
+        assertEquals(1, employees.size());
+        assertEquals(activeEmployee.getId(), employees.get(0).getId());
+    }
+
+    @Test
+    public void testGetUninsuredEmployeeList_monthRecordNotExists() {
+        // 调用
+        List<HrmEmployeeDO> employees = monthEmployeeRecordService.getUninsuredEmployeeList(3001L);
+
+        // 断言
+        assertTrue(employees.isEmpty());
+    }
+
+    @Test
+    public void testCreateMonthEmployeeRecordList_schemeNotConfigured() {
+        // mock 数据
+        HrmInsuranceMonthRecordDO monthRecord = new HrmInsuranceMonthRecordDO()
+                .setId(3001L).setYear(2026).setMonth(7);
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(1001L)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setEntryTime(LocalDateTime.of(2026, 1, 1, 0, 0));
+        when(monthRecordService.validateMonthRecordEditableForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(employeeService.getEmployeeMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(employee.getId(), employee));
+        // 准备参数
+        HrmInsuranceMonthEmployeeRecordCreateListReqVO reqVO =
+                new HrmInsuranceMonthEmployeeRecordCreateListReqVO()
+                        .setMonthRecordId(monthRecord.getId())
+                        .setEmployeeIds(Collections.singletonList(employee.getId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthEmployeeRecordService.createMonthEmployeeRecordList(reqVO),
+                INSURANCE_EMPLOYEE_SCHEME_NOT_CONFIGURED);
+    }
+
+    @Test
+    public void testCreateMonthEmployeeRecordList_futureEntryIllegal() {
+        // mock 数据
+        Long employeeId = 1001L;
+        Long schemeId = 2001L;
+        HrmInsuranceMonthRecordDO monthRecord = new HrmInsuranceMonthRecordDO()
+                .setId(3001L).setYear(2026).setMonth(7);
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(employeeId)
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .setEntryTime(LocalDateTime.of(2026, 8, 1, 0, 0));
+        HrmInsuranceEmployeeInfoDO employeeInfo = new HrmInsuranceEmployeeInfoDO()
+                .setEmployeeId(employeeId).setSchemeId(schemeId);
+        when(monthRecordService.validateMonthRecordEditableForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(employeeService.getEmployeeMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(employeeId, employee));
+        when(insuranceEmployeeInfoService.getInsuranceEmployeeInfoMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(employeeId, employeeInfo));
+        when(insuranceSchemeService.getSchemeListByIds(anyCollection()))
+                .thenReturn(Collections.singletonList(new HrmInsuranceSchemeDO().setId(schemeId)));
+        when(insuranceSchemeService.getSchemeProjectListMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(schemeId, Collections.singletonList(
+                        project(4001L, 1, BigDecimal.ZERO, BigDecimal.ZERO, BigDecimal.ZERO))));
+        // 准备参数
+        HrmInsuranceMonthEmployeeRecordCreateListReqVO reqVO =
+                new HrmInsuranceMonthEmployeeRecordCreateListReqVO()
+                        .setMonthRecordId(monthRecord.getId())
+                        .setEmployeeIds(Collections.singletonList(employeeId));
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthEmployeeRecordService.createMonthEmployeeRecordList(reqVO),
+                INSURANCE_MONTH_EMPLOYEE_NOT_ELIGIBLE);
+    }
+
+    @Test
+    public void testUpdateMonthEmployeeRecord_historicalLeftEmployee() {
+        // mock 数据
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = randomEmployeeRecord(3001L, 1001L);
+        monthEmployeeRecordMapper.insert(employeeRecord);
+        HrmInsuranceMonthRecordDO monthRecord = new HrmInsuranceMonthRecordDO()
+                .setId(3001L).setYear(2026).setMonth(7);
+        HrmInsuranceSchemeDO scheme = new HrmInsuranceSchemeDO().setId(2001L)
+                .setType(HrmInsuranceSchemeTypeEnum.AMOUNT.getType());
+        HrmInsuranceSchemeProjectDO schemeProject = project(
+                4001L, 1, BigDecimal.ZERO, BigDecimal.ZERO, BigDecimal.ZERO);
+        when(monthRecordService.validateMonthRecordEditableForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(insuranceSchemeService.validateSchemeExists(scheme.getId())).thenReturn(scheme);
+        when(insuranceSchemeService.getSchemeProjectList(scheme.getId()))
+                .thenReturn(Collections.singletonList(schemeProject));
+        when(employeeService.getEmployee(employeeRecord.getEmployeeId())).thenReturn(new HrmEmployeeDO()
+                .setId(employeeRecord.getEmployeeId()).setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setLeaveTime(LocalDateTime.of(2026, 7, 20, 0, 0)));
+        // 准备参数
+        HrmInsuranceMonthEmployeeRecordUpdateReqVO reqVO = new HrmInsuranceMonthEmployeeRecordUpdateReqVO()
+                .setId(employeeRecord.getId()).setSchemeId(scheme.getId())
+                .setProjects(Collections.singletonList(new HrmInsuranceMonthEmployeeProjectUpdateReqVO()
+                        .setSchemeProjectId(schemeProject.getId())
+                        .setCorporateAmount(BigDecimal.valueOf(900))
+                        .setPersonalAmount(BigDecimal.valueOf(300))));
+
+        // 调用
+        monthEmployeeRecordService.updateMonthEmployeeRecord(reqVO);
+
+        // 断言
+        assertEquals(0, BigDecimal.valueOf(300).compareTo(monthEmployeeRecordMapper
+                .selectById(employeeRecord.getId()).getPersonalInsuranceAmount()));
+    }
+
+    @Test
+    public void testGetNormalMonthEmployeeRecordMap() {
+        // mock 数据
+        HrmInsuranceMonthEmployeeRecordDO normalRecord = randomEmployeeRecord(3001L, 1001L);
+        monthEmployeeRecordMapper.insert(normalRecord);
+        HrmInsuranceMonthEmployeeRecordDO stoppedRecord = randomEmployeeRecord(3001L, 1002L)
+                .setStatus(HrmInsuranceEmployeeStatusEnum.STOPPED.getStatus());
+        monthEmployeeRecordMapper.insert(stoppedRecord);
+
+        // 调用
+        Map<Long, HrmInsuranceMonthEmployeeRecordDO> recordMap =
+                monthEmployeeRecordService.getNormalMonthEmployeeRecordMap(2026, 7);
+
+        // 断言
+        assertEquals(1, recordMap.size());
+        assertTrue(recordMap.containsKey(normalRecord.getEmployeeId()));
+    }
+
+    @Test
+    public void testUpdateInsuranceMonthEmployeeRecordSchemeIdBySchemeId_keepsSnapshot() {
+        // mock 数据
+        Long oldSchemeId = 2001L;
+        List<Project> projects = Collections.singletonList(Project.builder()
+                .schemeProjectId(4001L).type(1).name("养老保险")
+                .baseAmount(BigDecimal.valueOf(10000))
+                .corporateAmount(BigDecimal.valueOf(1600))
+                .personalAmount(BigDecimal.valueOf(800)).build());
+        HrmInsuranceMonthEmployeeRecordDO migratedRecord = randomEmployeeRecord(3001L, 1001L)
+                .setSchemeId(oldSchemeId).setProjects(projects);
+        monthEmployeeRecordMapper.insert(migratedRecord);
+        HrmInsuranceMonthEmployeeRecordDO retainedRecord = randomEmployeeRecord(3001L, 1002L)
+                .setSchemeId(2002L);
+        monthEmployeeRecordMapper.insert(retainedRecord);
+        // 准备参数
+        Long newSchemeId = 2003L;
+
+        // 调用
+        monthEmployeeRecordService.updateInsuranceMonthEmployeeRecordSchemeIdBySchemeId(
+                oldSchemeId, newSchemeId);
+
+        // 断言
+        HrmInsuranceMonthEmployeeRecordDO dbMigratedRecord =
+                monthEmployeeRecordMapper.selectById(migratedRecord.getId());
+        assertEquals(newSchemeId, dbMigratedRecord.getSchemeId());
+        assertEquals(projects, dbMigratedRecord.getProjects());
+        assertEquals(0, migratedRecord.getPersonalInsuranceAmount()
+                .compareTo(dbMigratedRecord.getPersonalInsuranceAmount()));
+        assertEquals(0, migratedRecord.getCorporateInsuranceAmount()
+                .compareTo(dbMigratedRecord.getCorporateInsuranceAmount()));
+        assertEquals(retainedRecord.getSchemeId(),
+                monthEmployeeRecordMapper.selectById(retainedRecord.getId()).getSchemeId());
+    }
+
+    @Test
+    public void testUpdateMonthEmployeeRecord_afterSchemeVersioning() {
+        // mock 数据
+        Long oldSchemeId = 2001L;
+        Long newSchemeId = 2002L;
+        HrmInsuranceMonthEmployeeRecordDO employeeRecord = randomEmployeeRecord(3001L, 1001L)
+                .setSchemeId(oldSchemeId)
+                .setProjects(Collections.singletonList(Project.builder()
+                        .schemeProjectId(4001L).type(1).name("养老保险")
+                        .corporateAmount(BigDecimal.valueOf(600))
+                        .personalAmount(BigDecimal.valueOf(300)).build()));
+        monthEmployeeRecordMapper.insert(employeeRecord);
+        monthEmployeeRecordService.updateInsuranceMonthEmployeeRecordSchemeIdBySchemeId(
+                oldSchemeId, newSchemeId);
+        HrmInsuranceMonthRecordDO monthRecord = new HrmInsuranceMonthRecordDO().setId(3001L);
+        HrmInsuranceSchemeDO scheme = new HrmInsuranceSchemeDO().setId(newSchemeId)
+                .setType(HrmInsuranceSchemeTypeEnum.AMOUNT.getType());
+        when(monthRecordService.validateMonthRecordEditableForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(insuranceSchemeService.validateSchemeExists(newSchemeId)).thenReturn(scheme);
+        when(employeeService.getEmployee(employeeRecord.getEmployeeId())).thenReturn(new HrmEmployeeDO()
+                .setId(employeeRecord.getEmployeeId()).setStatus(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+        // 准备参数
+        HrmInsuranceMonthEmployeeRecordUpdateReqVO reqVO =
+                new HrmInsuranceMonthEmployeeRecordUpdateReqVO()
+                        .setId(employeeRecord.getId()).setSchemeId(newSchemeId)
+                        .setProjects(Collections.singletonList(
+                                new HrmInsuranceMonthEmployeeProjectUpdateReqVO()
+                                        .setSchemeProjectId(4001L)
+                                        .setCorporateAmount(BigDecimal.valueOf(900))
+                                        .setPersonalAmount(BigDecimal.valueOf(400))));
+
+        // 调用
+        monthEmployeeRecordService.updateMonthEmployeeRecord(reqVO);
+
+        // 断言
+        HrmInsuranceMonthEmployeeRecordDO dbEmployeeRecord =
+                monthEmployeeRecordMapper.selectById(employeeRecord.getId());
+        Project project = CollUtil.getFirst(dbEmployeeRecord.getProjects());
+        assertEquals(4001L, project.getSchemeProjectId());
+        assertEquals(0, BigDecimal.valueOf(900).compareTo(
+                project.getCorporateAmount()));
+        assertEquals(0, BigDecimal.valueOf(400).compareTo(
+                project.getPersonalAmount()));
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmInsuranceMonthEmployeeRecordDO randomEmployeeRecord(Long monthRecordId, Long employeeId) {
+        return randomPojo(HrmInsuranceMonthEmployeeRecordDO.class, record -> record
+                .setId(null).setMonthRecordId(monthRecordId).setEmployeeId(employeeId).setSchemeId(2001L)
+                .setYear(2026).setMonth(7).setStatus(HrmInsuranceEmployeeStatusEnum.NORMAL.getStatus())
+                .setPersonalInsuranceAmount(BigDecimal.valueOf(100))
+                .setPersonalProvidentFundAmount(BigDecimal.valueOf(50))
+                .setCorporateInsuranceAmount(BigDecimal.valueOf(200))
+                .setCorporateProvidentFundAmount(BigDecimal.valueOf(50))
+                .setProjects(Collections.emptyList()));
+    }
+
+    private HrmInsuranceSchemeProjectDO project(Long id, Integer type, BigDecimal baseAmount,
+                                                BigDecimal corporateRate, BigDecimal personalRate) {
+        return new HrmInsuranceSchemeProjectDO().setId(id).setSchemeId(2001L)
+                .setType(type).setName("参保项目")
+                .setBaseAmount(baseAmount)
+                .setCorporateRate(corporateRate).setPersonalRate(personalRate)
+                .setCorporateAmount(BigDecimal.ZERO).setPersonalAmount(BigDecimal.ZERO);
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordServiceImplTest.java
new file mode 100644
index 0000000..2cb1d21
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/insurance/monthrecord/HrmInsuranceMonthRecordServiceImplTest.java
@@ -0,0 +1,174 @@
+package cn.iocoder.yudao.module.hrm.service.insurance.monthrecord;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.insurance.vo.monthrecord.HrmInsuranceMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.insurance.monthrecord.HrmInsuranceMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.insurance.monthrecord.HrmInsuranceMonthRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.insurance.employee.HrmInsuranceEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.insurance.monthrecord.HrmInsuranceMonthStatusEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Collections;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_FIRST_MONTH_RECORD_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_RECORD_CANNOT_DELETE_ONLY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.INSURANCE_MONTH_RECORD_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyLong;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmInsuranceMonthRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmInsuranceMonthRecordServiceImpl.class)
+public class HrmInsuranceMonthRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmInsuranceMonthRecordServiceImpl monthRecordService;
+
+    @Resource
+    private HrmInsuranceMonthRecordMapper monthRecordMapper;
+
+    @MockitoBean
+    private HrmInsuranceMonthEmployeeRecordService monthEmployeeRecordService;
+
+    @Test
+    public void testCreateFirstMonthRecord_success() {
+        // 准备参数
+        HrmInsuranceMonthRecordCreateReqVO reqVO =
+                new HrmInsuranceMonthRecordCreateReqVO().setYear(2026).setMonth(7);
+        when(monthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(anyLong()))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        Long id = monthRecordService.createFirstMonthRecord(reqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmInsuranceMonthRecordDO monthRecord = monthRecordMapper.selectById(id);
+        assertEquals("2026年7月社保表", monthRecord.getTitle());
+        assertEquals(HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus(), monthRecord.getStatus());
+        assertEquals(0, monthRecord.getInsuredEmployeeCount());
+        assertEquals(0, BigDecimal.ZERO.compareTo(monthRecord.getPersonalInsuranceAmount()));
+        verify(monthEmployeeRecordService).createMonthEmployeeRecordList(any(HrmInsuranceMonthRecordDO.class));
+    }
+
+    @Test
+    public void testCreateFirstMonthRecord_recordExists() {
+        // mock 数据
+        monthRecordMapper.insert(randomMonthRecord(2026, 6,
+                HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus()));
+        // 准备参数
+        HrmInsuranceMonthRecordCreateReqVO reqVO =
+                new HrmInsuranceMonthRecordCreateReqVO().setYear(2026).setMonth(7);
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.createFirstMonthRecord(reqVO),
+                INSURANCE_FIRST_MONTH_RECORD_EXISTS);
+    }
+
+    @Test
+    public void testCreateNextMonthRecord_firstMonthNotExists() {
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.createNextMonthRecord(),
+                INSURANCE_MONTH_RECORD_NOT_EXISTS);
+    }
+
+    @Test
+    public void testCreateNextMonthRecord_emptyMonthSuccess() {
+        // mock 数据
+        HrmInsuranceMonthRecordDO currentMonthRecord = randomMonthRecord(2026, 6,
+                HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus());
+        monthRecordMapper.insert(currentMonthRecord);
+        when(monthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(anyLong()))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        Long nextMonthRecordId = monthRecordService.createNextMonthRecord();
+
+        // 断言
+        assertEquals(HrmInsuranceMonthStatusEnum.ARCHIVED.getStatus(),
+                monthRecordMapper.selectById(currentMonthRecord.getId()).getStatus());
+        assertEquals(7, monthRecordMapper.selectById(nextMonthRecordId).getMonth());
+    }
+
+    @Test
+    public void testCreateNextMonthRecord_success() {
+        // mock 数据
+        HrmInsuranceMonthRecordDO currentMonthRecord = randomMonthRecord(2026, 12,
+                HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus());
+        monthRecordMapper.insert(currentMonthRecord);
+        when(monthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(anyLong()))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        Long nextMonthRecordId = monthRecordService.createNextMonthRecord();
+
+        // 断言
+        assertEquals(HrmInsuranceMonthStatusEnum.ARCHIVED.getStatus(),
+                monthRecordMapper.selectById(currentMonthRecord.getId()).getStatus());
+        HrmInsuranceMonthRecordDO nextMonthRecord = monthRecordMapper.selectById(nextMonthRecordId);
+        assertEquals(2027, nextMonthRecord.getYear());
+        assertEquals(1, nextMonthRecord.getMonth());
+    }
+
+    @Test
+    public void testDeleteMonthRecord_success() {
+        // mock 数据
+        HrmInsuranceMonthRecordDO previousMonthRecord = randomMonthRecord(2026, 6,
+                HrmInsuranceMonthStatusEnum.ARCHIVED.getStatus());
+        monthRecordMapper.insert(previousMonthRecord);
+        HrmInsuranceMonthRecordDO currentMonthRecord = randomMonthRecord(2026, 7,
+                HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus());
+        monthRecordMapper.insert(currentMonthRecord);
+
+        // 调用
+        monthRecordService.deleteMonthRecord(currentMonthRecord.getId());
+
+        // 断言
+        assertNull(monthRecordMapper.selectById(currentMonthRecord.getId()));
+        assertEquals(HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus(),
+                monthRecordMapper.selectById(previousMonthRecord.getId()).getStatus());
+        verify(monthEmployeeRecordService)
+                .deleteMonthEmployeeRecordListByMonthRecordId(currentMonthRecord.getId());
+    }
+
+    @Test
+    public void testDeleteMonthRecord_onlyOne() {
+        // mock 数据
+        HrmInsuranceMonthRecordDO monthRecord = randomMonthRecord(2026, 7,
+                HrmInsuranceMonthStatusEnum.UNARCHIVED.getStatus());
+        monthRecordMapper.insert(monthRecord);
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.deleteMonthRecord(monthRecord.getId()),
+                INSURANCE_MONTH_RECORD_CANNOT_DELETE_ONLY);
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmInsuranceMonthRecordDO randomMonthRecord(Integer year, Integer month, Integer status) {
+        return randomPojo(HrmInsuranceMonthRecordDO.class, record -> record
+                .setId(null).setTitle(year + "年" + month + "月社保表")
+                .setYear(year).setMonth(month)
+                .setInsuredEmployeeCount(1).setStoppedEmployeeCount(0).setStatus(status)
+                .setPersonalInsuranceAmount(BigDecimal.valueOf(100))
+                .setPersonalProvidentFundAmount(BigDecimal.valueOf(50))
+                .setCorporateInsuranceAmount(BigDecimal.valueOf(200))
+                .setCorporateProvidentFundAmount(BigDecimal.valueOf(50)));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordServiceImplTest.java
new file mode 100644
index 0000000..94806e8
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentActionRecordServiceImplTest.java
@@ -0,0 +1,67 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentActionRecordDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * {@link HrmPerformanceAssessmentActionRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmPerformanceAssessmentActionRecordServiceImpl.class)
+public class HrmPerformanceAssessmentActionRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmPerformanceAssessmentActionRecordServiceImpl actionRecordService;
+
+    @Test
+    public void testCreateListAndDeletePerformanceAssessmentActionRecord() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        Long assessmentId = randomLongId();
+        Long stageId = randomLongId();
+
+        // 调用
+        actionRecordService.createPerformanceAssessmentActionRecord(
+                employeeId, assessmentId, stageId,
+                HrmPerformanceAssessmentActionTypeEnum.SUBMIT_APPEAL,
+                Arrays.asList("https://example.com/a.pdf", "https://example.com/b.png"),
+                HrmPerformanceAssessmentStageStatusEnum.APPEALED.getStatus(), "申请复核评分结果");
+        actionRecordService.createPerformanceAssessmentActionRecord(
+                null, assessmentId, stageId,
+                HrmPerformanceAssessmentActionTypeEnum.APPEAL_TIMEOUT_REJECT,
+                null, HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus(),
+                "，意见：申诉确认超期，系统自动驳回");
+
+        // 断言创建和查询
+        List<HrmPerformanceAssessmentActionRecordDO> records = actionRecordService
+                .getPerformanceAssessmentActionRecordList(assessmentId);
+        assertEquals(2, records.size());
+        assertEquals(employeeId, records.get(0).getEmployeeId());
+        assertEquals("提交绩效申诉", records.get(0).getTitle());
+        assertEquals("提交了绩效申诉，原因：申请复核评分结果", records.get(0).getContent());
+        assertEquals(Arrays.asList("https://example.com/a.pdf", "https://example.com/b.png"),
+                records.get(0).getFileUrls());
+        assertEquals(HrmPerformanceAssessmentActionTypeEnum.APPEAL_TIMEOUT_REJECT.getType(),
+                records.get(1).getType());
+
+        // 调用并断言删除
+        actionRecordService.deletePerformanceAssessmentActionRecordList(
+                Collections.singleton(assessmentId));
+        assertTrue(actionRecordService.getPerformanceAssessmentActionRecordList(assessmentId).isEmpty());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessServiceImplTest.java
new file mode 100644
index 0000000..4c7be85
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentProcessServiceImplTest.java
@@ -0,0 +1,1009 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceAppealReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceConfirmReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceHandleStageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceProcessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.HandlerStage;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ResultConfig;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ReviewStage;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO.Level;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaScoreMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentStageMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.plan.HrmPerformancePlanMapper;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealTimeoutActionEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceConfirmationResultEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentProcessStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanOperationTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceResultAuditStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewScoringTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewVisibleContentEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_NO_PERMISSION;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_HANDLER_USER_NOT_BOUND;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_TARGET_CONFIRM_NO_PERMISSION;
+import static cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants.PERFORMANCE_PROCESS_RESULT;
+import static cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants.PERFORMANCE_TASK_PENDING;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmPerformanceAssessmentProcessServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmPerformanceAssessmentProcessServiceImpl.class)
+public class HrmPerformanceAssessmentProcessServiceImplTest extends BaseDbUnitTest {
+
+    private static final Long EMPLOYEE_ID = 200L;
+    private static final Long EMPLOYEE_USER_ID = 1001L;
+    private static final Long HANDLER_USER_ID = 2001L;
+    private static final Long LEADER_EMPLOYEE_ID = 201L;
+
+    @Resource
+    private HrmPerformanceAssessmentProcessServiceImpl processService;
+
+    @Resource
+    private HrmPerformanceAssessmentMapper assessmentMapper;
+    @Resource
+    private HrmPerformanceAssessmentStageMapper assessmentStageMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaMapper assessmentQuotaMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaScoreMapper assessmentQuotaScoreMapper;
+    @Resource
+    private HrmPerformancePlanMapper planMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private DeptApi deptApi;
+    @MockitoBean
+    private HrmPerformancePlanService planService;
+    @MockitoBean
+    private NotifyMessageSendApi notifyMessageSendApi;
+    @MockitoBean
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+
+    @Test
+    public void testInitializeAssessmentStages_unboundEmployee_fail() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan()
+                .setReviewStages(Collections.singletonList(ReviewStage.builder()
+                        .name("员工自评")
+                        .rater(HandlerStage.builder()
+                                .type(HrmPerformanceRaterTypeEnum.SELF.getType()).build())
+                        .weight(new BigDecimal("100"))
+                        .scoringType(HrmPerformanceReviewScoringTypeEnum.QUOTA.getType())
+                        .visibleContent(HrmPerformanceReviewVisibleContentEnum.ALL.getContent())
+                        .requiredSetting(false).rejectAuthority(false).build()))
+                .setResultAudit(false).setResultConfirmation(false);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.NOT_STARTED.getType());
+        assessmentMapper.insert(assessment);
+        when(employeeService.validateEmployeeExists(EMPLOYEE_ID)).thenReturn(
+                HrmEmployeeDO.builder().id(EMPLOYEE_ID).name("测试员工").userId(null).build());
+
+        when(employeeService.getEmployeeMap(Collections.singleton(EMPLOYEE_ID))).thenReturn(
+                Collections.singletonMap(EMPLOYEE_ID,
+                        HrmEmployeeDO.builder().id(EMPLOYEE_ID).name("测试员工").userId(null).build()));
+
+        // 调用、断言
+        assertServiceException(() -> processService.initializeAssessmentStages(plan, assessment),
+                PERFORMANCE_STAGE_HANDLER_USER_NOT_BOUND, "测试员工");
+        assertTrue(assessmentStageMapper.selectListByAssessmentId(assessment.getId()).isEmpty());
+    }
+
+    @Test
+    public void testInitializeAssessmentStages_sameHandler_mergesStages() {
+        // mock 数据
+        HandlerStage superior = HandlerStage.builder()
+                .type(HrmPerformanceRaterTypeEnum.SUPERIOR.getType()).level(1).build();
+        HandlerStage specified = HandlerStage.builder()
+                .type(HrmPerformanceRaterTypeEnum.SPECIFIED.getType())
+                .employeeId(LEADER_EMPLOYEE_ID).build();
+        HrmPerformancePlanDO plan = randomPlan()
+                .setReviewStages(Arrays.asList(
+                        ReviewStage.builder().name("上级评分").rater(superior)
+                                .weight(new BigDecimal("40"))
+                                .scoringType(HrmPerformanceReviewScoringTypeEnum.QUOTA.getType())
+                                .visibleContent(HrmPerformanceReviewVisibleContentEnum.SELF.getContent())
+                                .requiredSetting(true).rejectAuthority(true).build(),
+                        ReviewStage.builder().name("指定员工评分").rater(specified)
+                                .weight(new BigDecimal("60"))
+                                .scoringType(HrmPerformanceReviewScoringTypeEnum.QUOTA.getType())
+                                .visibleContent(HrmPerformanceReviewVisibleContentEnum.ALL.getContent())
+                                .requiredSetting(false).rejectAuthority(false).build()))
+                .setResultAudit(true).setResultAuditStages(Arrays.asList(superior, specified))
+                .setResultConfirmation(true).setAppealStages(Arrays.asList(superior, specified));
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.NOT_STARTED.getType());
+        assessmentMapper.insert(assessment);
+        HrmEmployeeDO employee = HrmEmployeeDO.builder().id(EMPLOYEE_ID)
+                .name("测试员工").leaderEmployeeId(LEADER_EMPLOYEE_ID).build();
+        HrmEmployeeDO leader = HrmEmployeeDO.builder().id(LEADER_EMPLOYEE_ID)
+                .name("测试上级").build();
+        when(employeeService.validateEmployeeExists(EMPLOYEE_ID)).thenReturn(employee);
+        when(employeeService.getEmployee(LEADER_EMPLOYEE_ID)).thenReturn(leader);
+        employee.setUserId(EMPLOYEE_USER_ID);
+        leader.setUserId(HANDLER_USER_ID);
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(EMPLOYEE_ID, employee);
+        employeeMap.put(LEADER_EMPLOYEE_ID, leader);
+        when(employeeService.getEmployeeMap(any())).thenReturn(employeeMap);
+
+        // 调用
+        processService.initializeAssessmentStages(plan, assessment);
+
+        // 断言
+        List<HrmPerformanceAssessmentStageDO> stages =
+                assessmentStageMapper.selectListByAssessmentId(assessment.getId());
+        assertEquals(5, stages.size());
+        HrmPerformanceAssessmentStageDO reviewStage = stages.get(0);
+        assertEquals(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(), reviewStage.getType());
+        assertEquals(LEADER_EMPLOYEE_ID, reviewStage.getHandlerEmployeeId());
+        assertEquals(new BigDecimal("100.00"), reviewStage.getWeight());
+        assertEquals("上级评分", reviewStage.getName());
+        assertEquals(HrmPerformanceReviewVisibleContentEnum.SELF.getContent(),
+                reviewStage.getVisibleContent());
+        assertTrue(reviewStage.getRequiredSetting());
+        assertTrue(reviewStage.getRejectAuthority());
+        assertEquals(HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(), stages.get(1).getType());
+        assertEquals(LEADER_EMPLOYEE_ID, stages.get(1).getHandlerEmployeeId());
+        assertEquals(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), stages.get(2).getType());
+        assertEquals(HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(), stages.get(3).getType());
+        assertEquals(LEADER_EMPLOYEE_ID, stages.get(3).getHandlerEmployeeId());
+        assertEquals(HrmPerformanceStageTypeEnum.END.getType(), stages.get(4).getType());
+    }
+
+    @Test
+    public void testConfirmTarget_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType());
+        assessmentMapper.insert(assessment);
+        assessmentStageMapper.insert(randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(),
+                "目标确认", HANDLER_USER_ID, 1,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        mockHandlerEmployee(HANDLER_USER_ID);
+        HrmPortalPerformanceConfirmReqVO reqVO = new HrmPortalPerformanceConfirmReqVO();
+        reqVO.setAssessmentId(assessment.getId());
+        reqVO.setPass(HrmPerformanceConfirmationResultEnum.PASS.getResult());
+        reqVO.setComment("目标确认通过");
+
+        // 调用
+        processService.confirmTarget(HANDLER_USER_ID, reqVO);
+
+        // 断言
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceStageTypeEnum.EXECUTING.getType(), updated.getStageType());
+        assertEquals(HrmPerformanceConfirmationResultEnum.PASS.getResult(),
+                updated.getTargetConfirmationResult());
+        assertEquals("目标确认通过", updated.getTargetConfirmationComment());
+    }
+
+    @Test
+    public void testConfirmTarget_otherUser() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType());
+        assessmentMapper.insert(assessment);
+        assessmentStageMapper.insert(randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(),
+                "目标确认", HANDLER_USER_ID, 1,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        mockHandlerEmployee(HANDLER_USER_ID);
+        // 准备参数
+        HrmPortalPerformanceConfirmReqVO reqVO = new HrmPortalPerformanceConfirmReqVO();
+        reqVO.setAssessmentId(assessment.getId());
+        reqVO.setPass(HrmPerformanceConfirmationResultEnum.PASS.getResult());
+        reqVO.setComment("目标确认通过");
+
+        // 调用，并断言异常
+        assertServiceException(() -> processService.confirmTarget(3001L, reqVO),
+                PERFORMANCE_TARGET_CONFIRM_NO_PERMISSION);
+    }
+
+    @Test
+    public void testConfirmTarget_rejectReopensFillQuotaStage() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO fillStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.FILL_QUOTA.getType(),
+                "指标填写", EMPLOYEE_ID, 1,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.insert(fillStage);
+        HrmPerformanceAssessmentStageDO targetStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(),
+                "目标确认", HANDLER_USER_ID, 2,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        assessmentStageMapper.insert(targetStage);
+        mockEmployee();
+        mockHandlerEmployee(HANDLER_USER_ID);
+        HrmPortalPerformanceConfirmReqVO reqVO = new HrmPortalPerformanceConfirmReqVO();
+        reqVO.setAssessmentId(assessment.getId());
+        reqVO.setPass(HrmPerformanceConfirmationResultEnum.REJECT.getResult());
+        reqVO.setComment("指标需要调整");
+
+        // 调用
+        processService.confirmTarget(HANDLER_USER_ID, reqVO);
+
+        // 断言
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceStageTypeEnum.FILL_QUOTA.getType(), updated.getStageType());
+        assertEquals(fillStage.getSort(), updated.getStageSort());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(fillStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus(),
+                assessmentStageMapper.selectById(targetStage.getId()).getStatus());
+    }
+
+    @Test
+    public void testHandleResultAudit_sequentialPass() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO firstStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "结果审核（第1级）", HANDLER_USER_ID, 3,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        assessmentStageMapper.insert(firstStage);
+        HrmPerformanceAssessmentStageDO secondStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "结果审核（第2级）", 2002L, 4,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(secondStage);
+        HrmPerformanceAssessmentStageDO resultConfirmStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                "结果确认", EMPLOYEE_USER_ID, 5,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(resultConfirmStage);
+        mockHandlerEmployee(HANDLER_USER_ID);
+        mockHandlerEmployee(2002L);
+
+        // 调用
+        processService.handleResultAudit(HANDLER_USER_ID,
+                buildHandleReqVO(assessment.getId(), firstStage.getId(),
+                        HrmPerformanceConfirmationResultEnum.PASS.getResult()));
+        processService.handleResultAudit(2002L,
+                buildHandleReqVO(assessment.getId(), secondStage.getId(),
+                        HrmPerformanceConfirmationResultEnum.PASS.getResult()));
+
+        // 断言
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(firstStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(secondStage.getId()).getStatus());
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceResultAuditStatusEnum.PASS.getStatus(), updated.getResultAuditStatus());
+        assertNotNull(updated.getResultAuditTime());
+        assertEquals(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), updated.getStageType());
+        assertEquals(resultConfirmStage.getSort(), updated.getStageSort());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(resultConfirmStage.getId()).getStatus());
+        verify(planService).updatePerformancePlanStageTypeAndOperationType(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                HrmPerformancePlanOperationTypeEnum.START_INTERVIEW.getType());
+    }
+
+    @Test
+    public void testGetMyResultConfirmationTaskPage_onlyPendingStage() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        planMapper.insert(plan);
+        HrmPerformanceAssessmentDO pendingAssessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        assessmentMapper.insert(pendingAssessment);
+        assessmentStageMapper.insert(randomStage(
+                pendingAssessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                "结果确认", HANDLER_USER_ID, 4,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        HrmPerformancePlanDO waitingPlan = randomPlan();
+        planMapper.insert(waitingPlan);
+        HrmPerformanceAssessmentDO waitingAssessment = randomAssessment(
+                waitingPlan.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        assessmentMapper.insert(waitingAssessment);
+        assessmentStageMapper.insert(randomStage(
+                waitingAssessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                "结果确认", HANDLER_USER_ID, 4,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus()));
+        mockHandlerEmployee(HANDLER_USER_ID);
+
+        // 准备参数
+        HrmPortalPerformanceTaskPageReqVO reqVO = new HrmPortalPerformanceTaskPageReqVO();
+        reqVO.setPageNo(1);
+        reqVO.setPageSize(10);
+        reqVO.setStageStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+
+        // 调用
+        PageResult<HrmPerformanceAssessmentStageDO> result =
+                processService.getMyResultConfirmationTaskPage(HANDLER_USER_ID, reqVO);
+
+        // 断言
+        assertEquals(1, result.getList().size());
+        assertEquals(pendingAssessment.getId(), CollUtil.getFirst(result.getList()).getAssessmentId());
+    }
+
+    @Test
+    public void testNotifyPendingStage_accountRebound_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        HrmPerformanceAssessmentStageDO stage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "结果审核", HANDLER_USER_ID, 4,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        when(employeeService.getEmployee(HANDLER_USER_ID)).thenReturn(
+                new HrmEmployeeDO().setId(HANDLER_USER_ID).setUserId(3001L));
+        when(planService.getPerformancePlan(plan.getId())).thenReturn(plan);
+
+        // 调用
+        processService.notifyPendingStage(assessment, stage);
+
+        // 断言
+        ArgumentCaptor<NotifySendSingleToUserReqDTO> captor =
+                ArgumentCaptor.forClass(NotifySendSingleToUserReqDTO.class);
+        verify(notifyMessageSendApi).sendSingleMessageToAdmin(captor.capture());
+        assertEquals(3001L, captor.getValue().getUserId());
+        assertEquals(PERFORMANCE_TASK_PENDING, captor.getValue().getTemplateCode());
+        assertEquals(plan.getName(), captor.getValue().getTemplateParams().get("planName"));
+        assertEquals(stage.getName(), captor.getValue().getTemplateParams().get("stageName"));
+        assertEquals("/hrm/portal/performance/assessment",
+                captor.getValue().getTemplateParams().get("route"));
+    }
+
+    @Test
+    public void testNotifyProcessResult_accountRebound_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        when(employeeService.getEmployeeListByIds(Collections.singleton(EMPLOYEE_ID)))
+                .thenReturn(Collections.singletonList(
+                        new HrmEmployeeDO().setId(EMPLOYEE_ID).setUserId(3001L)));
+        when(planService.getPerformancePlan(plan.getId())).thenReturn(plan);
+
+        // 调用
+        processService.notifyProcessResult(assessment, Collections.singleton(EMPLOYEE_ID),
+                "结果审核", "已驳回，请重新评分");
+
+        // 断言
+        ArgumentCaptor<NotifySendSingleToUserReqDTO> captor =
+                ArgumentCaptor.forClass(NotifySendSingleToUserReqDTO.class);
+        verify(notifyMessageSendApi).sendSingleMessageToAdmin(captor.capture());
+        assertEquals(3001L, captor.getValue().getUserId());
+        assertEquals(PERFORMANCE_PROCESS_RESULT, captor.getValue().getTemplateCode());
+        assertEquals(plan.getName(), captor.getValue().getTemplateParams().get("planName"));
+        assertEquals("结果审核", captor.getValue().getTemplateParams().get("actionName"));
+        assertEquals("已驳回，请重新评分", captor.getValue().getTemplateParams().get("result"));
+        assertEquals("/hrm/portal/performance/assessment",
+                captor.getValue().getTemplateParams().get("route"));
+    }
+
+    @Test
+    public void testGetMyTaskCountMap_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        planMapper.insert(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.SELF_SCORE.getType());
+        assessmentMapper.insert(assessment);
+        assessmentStageMapper.insert(randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.SELF_SCORE.getType(),
+                "员工自评", HANDLER_USER_ID, 1,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        assessmentStageMapper.insert(randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType(),
+                "目标确认", HANDLER_USER_ID, 2,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()));
+        mockHandlerEmployee(HANDLER_USER_ID);
+
+        // 调用
+        Map<Integer, Map<Integer, Long>> countMap =
+                processService.getMyTaskCountMap(HANDLER_USER_ID, null);
+
+        // 断言
+        assertEquals(1L, countMap.get(HrmPerformanceStageTypeEnum.SELF_SCORE.getType())
+                .get(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        assertEquals(1L, countMap.get(HrmPerformanceStageTypeEnum.TARGET_CONFIRM.getType())
+                .get(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()));
+    }
+
+    @Test
+    public void testValidateTaskStage_completedStage() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                randomLongId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO stage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "结果审核", HANDLER_USER_ID, 3,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.insert(stage);
+        mockHandlerEmployee(HANDLER_USER_ID);
+
+        // 调用
+        HrmPerformanceAssessmentStageDO result = processService.validateTaskStage(
+                HANDLER_USER_ID, assessment.getId(), stage.getId());
+
+        // 断言
+        assertEquals(stage.getId(), result.getId());
+    }
+
+    @Test
+    public void testValidateTaskStage_otherUser() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                randomLongId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO stage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "结果审核", HANDLER_USER_ID, 3,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.insert(stage);
+        mockHandlerEmployee(HANDLER_USER_ID);
+
+        // 调用，并断言异常
+        assertServiceException(() -> processService.validateTaskStage(
+                3001L, assessment.getId(), stage.getId()), PERFORMANCE_STAGE_NO_PERMISSION);
+    }
+
+    @Test
+    public void testStartResultAudit_withoutAuditWaitsForInterview() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        plan.setResultAudit(false);
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.OTHER_SCORE.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO resultConfirmStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                "结果确认", EMPLOYEE_USER_ID, 4,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(resultConfirmStage);
+
+        // 调用
+        processService.startResultAudit(assessment.getId());
+
+        // 断言
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceResultAuditStatusEnum.PASS.getStatus(), updated.getResultAuditStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), updated.getStageType());
+        assertEquals(resultConfirmStage.getSort(), updated.getStageSort());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(resultConfirmStage.getId()).getStatus());
+        verify(planService).updatePerformancePlanStageTypeAndOperationType(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                HrmPerformancePlanOperationTypeEnum.START_INTERVIEW.getType());
+    }
+
+    @Test
+    public void testStartResultAudit_preservesProcessedAuditStage() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        plan.setResultAudit(true);
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.OTHER_SCORE.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO processedStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "一级结果审核", 2001L, 4,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.insert(processedStage);
+        HrmPerformanceAssessmentStageDO resumeStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "二级结果审核", HANDLER_USER_ID, 5,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(resumeStage);
+        when(employeeService.getEmployee(HANDLER_USER_ID))
+                .thenReturn(new HrmEmployeeDO().setId(HANDLER_USER_ID).setUserId(HANDLER_USER_ID));
+
+        // 调用
+        HrmPortalPerformanceProcessRespVO result = processService.startResultAudit(assessment.getId());
+
+        // 断言
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(processedStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(resumeStage.getId()).getStatus());
+        assertEquals(resumeStage.getId(), result.getNextStageId());
+    }
+
+    @Test
+    public void testStartResultAudit_withoutAuditAndResultConfirmationCompletesEndStage() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        plan.setResultAudit(false).setResultConfirmation(false);
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.OTHER_SCORE.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO endStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.END.getType(),
+                "结束", null, 4, HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(endStage);
+
+        // 调用
+        HrmPortalPerformanceProcessRespVO processResult = processService.startResultAudit(assessment.getId());
+
+        // 断言
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus(), updated.getProcessStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.END.getType(), updated.getStageType());
+        assertEquals(endStage.getSort(), updated.getStageSort());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(endStage.getId()).getStatus());
+        assertNull(processResult.getNextStageId());
+        verify(planService).updatePerformancePlanStageTypeAndOperationType(
+                plan.getId(), HrmPerformanceStageTypeEnum.END.getType(),
+                HrmPerformancePlanOperationTypeEnum.START_INTERVIEW.getType());
+    }
+
+    @Test
+    public void testHandleResultAudit_afterAppealReactivatesResultConfirmation() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO auditStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "结果复核", HANDLER_USER_ID, 3,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        assessmentStageMapper.insert(auditStage);
+        HrmPerformanceAssessmentStageDO resultConfirmStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                "结果确认", EMPLOYEE_USER_ID, 4,
+                HrmPerformanceAssessmentStageStatusEnum.APPEALED.getStatus());
+        assessmentStageMapper.insert(resultConfirmStage);
+        mockHandlerEmployee(HANDLER_USER_ID);
+
+        // 调用
+        processService.handleResultAudit(HANDLER_USER_ID,
+                buildHandleReqVO(assessment.getId(), auditStage.getId(),
+                        HrmPerformanceConfirmationResultEnum.PASS.getResult()));
+
+        // 断言：申诉前已经发起绩效面谈，重评完成后无需再次发起
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), updated.getStageType());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(resultConfirmStage.getId()).getStatus());
+        verify(planService).updatePerformancePlanStageTypeAndOperationType(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), null);
+    }
+
+    @Test
+    public void testHandleResultAudit_rejectReopensReviewStage() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType());
+        assessment.setScore(new BigDecimal("88.00")).setResultLevel("B").setCoefficient(BigDecimal.ONE);
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentStageDO firstReviewStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(),
+                "员工自评", EMPLOYEE_ID, 1,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.insert(firstReviewStage);
+        HrmPerformanceAssessmentStageDO middleReviewStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(),
+                "直属上级评分", HANDLER_USER_ID, 2,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.insert(middleReviewStage);
+        HrmPerformanceAssessmentStageDO lastReviewStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(),
+                "部门负责人评分", 2003L, 3,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        assessmentStageMapper.insert(lastReviewStage);
+        HrmPerformanceAssessmentStageDO auditStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_AUDIT.getType(),
+                "结果审核", 2002L, 4, HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        assessmentStageMapper.insert(auditStage);
+        HrmPerformanceAssessmentQuotaDO quota = HrmPerformanceAssessmentQuotaDO.builder()
+                .assessmentId(assessment.getId()).dimensionId(1L)
+                .preset(true).name("目标达成率")
+                .finalScore(new BigDecimal("88.00")).build();
+        assessmentQuotaMapper.insert(quota);
+        assessmentQuotaScoreMapper.insert(new HrmPerformanceAssessmentQuotaScoreDO()
+                .setAssessmentStageId(firstReviewStage.getId()).setAssessmentQuotaId(quota.getId())
+                .setScore(new BigDecimal("80.00")));
+        assessmentQuotaScoreMapper.insert(new HrmPerformanceAssessmentQuotaScoreDO()
+                .setAssessmentStageId(middleReviewStage.getId()).setAssessmentQuotaId(quota.getId())
+                .setScore(new BigDecimal("88.00")));
+        assessmentQuotaScoreMapper.insert(new HrmPerformanceAssessmentQuotaScoreDO()
+                .setAssessmentStageId(lastReviewStage.getId()).setAssessmentQuotaId(quota.getId())
+                .setScore(new BigDecimal("92.00")));
+        HrmPortalPerformanceHandleStageReqVO reqVO = buildHandleReqVO(assessment.getId(), auditStage.getId(),
+                HrmPerformanceConfirmationResultEnum.REJECT.getResult());
+        reqVO.setReviewStageIds(Arrays.asList(firstReviewStage.getId(), lastReviewStage.getId()));
+        mockHandlerEmployee(2002L);
+
+        // 调用
+        processService.handleResultAudit(2002L, reqVO);
+
+        // 断言
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(), updated.getStageType());
+        assertNull(updated.getScore());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(firstReviewStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(middleReviewStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(lastReviewStage.getId()).getStatus());
+        assertNull(assessmentQuotaMapper.selectById(quota.getId()).getFinalScore());
+        assertEquals(0, assessmentQuotaScoreMapper.selectListByAssessmentStageIds(
+                Arrays.asList(firstReviewStage.getId(), lastReviewStage.getId())).size());
+        assertEquals(1, assessmentQuotaScoreMapper.selectListByAssessmentStageIds(
+                Collections.singleton(middleReviewStage.getId())).size());
+    }
+
+    @Test
+    public void testConfirmResult_completesEndStage() {
+        // mock 数据
+        HrmPerformancePlanDO plan = randomPlan();
+        mockPlan(plan);
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        assessmentMapper.insert(assessment);
+        assessmentStageMapper.insert(randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                "结果确认", EMPLOYEE_USER_ID, 4,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()));
+        HrmPerformanceAssessmentStageDO appealStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(),
+                "申诉确认", HANDLER_USER_ID, 5,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(appealStage);
+        HrmPerformanceAssessmentStageDO endStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.END.getType(),
+                "结束", null, 6, HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(endStage);
+        mockEmployee();
+        HrmPortalPerformanceConfirmReqVO reqVO = new HrmPortalPerformanceConfirmReqVO();
+        reqVO.setAssessmentId(assessment.getId());
+        reqVO.setPass(HrmPerformanceConfirmationResultEnum.PASS.getResult());
+        reqVO.setComment("认可绩效结果");
+
+        // 调用
+        processService.confirmResult(EMPLOYEE_USER_ID, reqVO);
+
+        // 断言
+        HrmPerformanceAssessmentDO updated = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus(), updated.getProcessStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.END.getType(), updated.getStageType());
+        assertEquals(endStage.getSort(), updated.getStageSort());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(endStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(appealStage.getId()).getStatus());
+    }
+
+    @Test
+    public void testHandleAppeal_approveReopensReviewStage() {
+        // mock 数据
+        AppealFixture fixture = randomAppealFixture();
+        mockPlan(fixture.plan);
+        assessmentMapper.insert(fixture.assessment);
+        assessmentStageMapper.insert(fixture.reviewStage);
+        assessmentStageMapper.insert(fixture.resultConfirmStage);
+        assessmentStageMapper.insert(fixture.appealStage);
+        assessmentStageMapper.insert(fixture.endStage);
+        mockEmployee();
+        mockHandlerEmployee(HANDLER_USER_ID);
+        HrmPortalPerformanceAppealReqVO appealReqVO = new HrmPortalPerformanceAppealReqVO();
+        appealReqVO.setAssessmentId(fixture.assessment.getId());
+        appealReqVO.setAppealReason("评分结果需要复核");
+        appealReqVO.setReviewStageIds(Collections.singletonList(fixture.reviewStage.getId()));
+
+        // mock 数据：先提交申诉
+        processService.submitAppeal(EMPLOYEE_USER_ID, appealReqVO);
+        HrmPerformanceAssessmentStageDO appealStage = assessmentStageMapper.selectById(fixture.appealStage.getId());
+
+        // 调用
+        processService.handleAppeal(HANDLER_USER_ID,
+                buildHandleReqVO(fixture.assessment.getId(), appealStage.getId(),
+                        HrmPerformanceConfirmationResultEnum.PASS.getResult()));
+
+        // 断言
+        HrmPerformanceAssessmentDO updated =
+                assessmentMapper.selectById(fixture.assessment.getId());
+        assertEquals(HrmPerformanceAppealStatusEnum.PASS.getStatus(), updated.getAppealStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(), updated.getStageType());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(fixture.reviewStage.getId()).getStatus());
+    }
+
+    @Test
+    public void testHandleAppeal_rejectCompletesEndStage() {
+        // mock 数据
+        AppealFixture fixture = randomAppealFixture();
+        mockPlan(fixture.plan);
+        assessmentMapper.insert(fixture.assessment);
+        assessmentStageMapper.insert(fixture.reviewStage);
+        assessmentStageMapper.insert(fixture.resultConfirmStage);
+        assessmentStageMapper.insert(fixture.appealStage);
+        fixture.endStage.setSort(7);
+        HrmPerformanceAssessmentStageDO laterAppealStage = randomStage(
+                fixture.assessment.getId(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(),
+                "申诉确认（第2级）", 2002L, 6,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        assessmentStageMapper.insert(laterAppealStage);
+        assessmentStageMapper.insert(fixture.endStage);
+        mockEmployee();
+        mockHandlerEmployee(HANDLER_USER_ID);
+        HrmPortalPerformanceAppealReqVO appealReqVO = new HrmPortalPerformanceAppealReqVO();
+        appealReqVO.setAssessmentId(fixture.assessment.getId());
+        appealReqVO.setAppealReason("评分结果需要复核");
+        appealReqVO.setReviewStageIds(Collections.singletonList(fixture.reviewStage.getId()));
+
+        // mock 数据：先提交申诉
+        processService.submitAppeal(EMPLOYEE_USER_ID, appealReqVO);
+
+        // 调用
+        processService.handleAppeal(HANDLER_USER_ID,
+                buildHandleReqVO(fixture.assessment.getId(), fixture.appealStage.getId(),
+                        HrmPerformanceConfirmationResultEnum.REJECT.getResult()));
+
+        // 断言
+        HrmPerformanceAssessmentDO updated =
+                assessmentMapper.selectById(fixture.assessment.getId());
+        assertEquals(HrmPerformanceAppealStatusEnum.REJECT.getStatus(), updated.getAppealStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.END.getType(), updated.getStageType());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(fixture.endStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(laterAppealStage.getId()).getStatus());
+    }
+
+    @Test
+    public void testProcessAppealTimeout_reject() {
+        // mock 数据
+        AppealFixture fixture = randomAppealFixture();
+        mockPlan(fixture.plan);
+        assessmentMapper.insert(fixture.assessment);
+        assessmentStageMapper.insert(fixture.reviewStage);
+        assessmentStageMapper.insert(fixture.resultConfirmStage);
+        assessmentStageMapper.insert(fixture.appealStage);
+        assessmentStageMapper.insert(fixture.endStage);
+        mockEmployee();
+        fixture.appealStage.setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus())
+                .setDeadlineTime(LocalDateTime.now().minusMinutes(1));
+        assessmentStageMapper.updateById(fixture.appealStage);
+        fixture.assessment.setStageType(HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType())
+                .setAppealStatus(HrmPerformanceAppealStatusEnum.PENDING.getStatus());
+        assessmentMapper.updateById(fixture.assessment);
+        // 调用
+        List<HrmPerformanceAssessmentStageDO> timeoutStages =
+                processService.getAppealTimeoutStageList(LocalDateTime.now());
+        assertEquals(1, timeoutStages.size());
+        assertTrue(processService.processAppealTimeout(fixture.appealStage.getId()));
+        assertFalse(processService.processAppealTimeout(fixture.appealStage.getId()));
+
+        // 断言
+        HrmPerformanceAssessmentDO updated =
+                assessmentMapper.selectById(fixture.assessment.getId());
+        assertEquals(HrmPerformanceAppealStatusEnum.REJECT.getStatus(), updated.getAppealStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.END.getType(), updated.getStageType());
+        HrmPerformanceAssessmentStageDO updatedStage =
+                assessmentStageMapper.selectById(fixture.appealStage.getId());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus(), updatedStage.getStatus());
+        assertEquals("申诉确认超期，系统自动驳回", updatedStage.getRejectReason());
+    }
+
+    // ========== 随机对象 ==========
+
+    private AppealFixture randomAppealFixture() {
+        HrmPerformancePlanDO plan = randomPlan();
+        plan.setAppealTimeoutAction(HrmPerformanceAppealTimeoutActionEnum.REJECT.getAction());
+        HrmPerformanceAssessmentDO assessment = randomAssessment(
+                plan.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        assessment.setScore(new BigDecimal("88.00")).setResultLevel("B").setCoefficient(BigDecimal.ONE);
+        HrmPerformanceAssessmentStageDO reviewStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(),
+                "直属上级评分", HANDLER_USER_ID, 2,
+                HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        HrmPerformanceAssessmentStageDO resultConfirmStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(),
+                "结果确认", EMPLOYEE_USER_ID, 4,
+                HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        HrmPerformanceAssessmentStageDO appealStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(),
+                "申诉确认", HANDLER_USER_ID, 5,
+                HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        HrmPerformanceAssessmentStageDO endStage = randomStage(
+                assessment.getId(), HrmPerformanceStageTypeEnum.END.getType(),
+                "结束", null, 6, HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus());
+        return new AppealFixture(plan, assessment, reviewStage, resultConfirmStage, appealStage, endStage);
+    }
+
+    private HrmPerformancePlanDO randomPlan() {
+        return randomPojo(HrmPerformancePlanDO.class, plan -> plan
+                .setId(randomLongId()).setOperationType(null)
+                .setCycleType(HrmPerformanceCycleTypeEnum.MONTH.getType())
+                .setCycle("2026-07").setQuarter(null)
+                .setAssessmentTemplateId(randomLongId()).setAssessmentConfig(buildAssessmentConfig())
+                .setScopes(Collections.emptyList()).setQuotaSettingType(null)
+                .setTargetConfirmation(false).setTargetConfirmationStage(null)
+                .setReviewStages(Collections.emptyList())
+                .setResultAudit(true).setResultAuditStages(Collections.emptyList())
+                .setResultConfirmation(true).setAppealStages(Collections.emptyList())
+                .setAppealTimeoutDays(2)
+                .setAppealTimeoutAction(HrmPerformanceAppealTimeoutActionEnum.REJECT.getAction())
+                .setResultTemplateId(randomLongId()).setResultConfig(buildResultConfig())
+                .setSyncToSalary(false).setPaidForMonth(null)
+                .setStatus(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                .setStageType(HrmPerformanceStageTypeEnum.EXECUTING.getType()));
+    }
+
+    private HrmPerformanceAssessmentDO randomAssessment(Long planId, Integer stageType) {
+        return randomPojo(HrmPerformanceAssessmentDO.class, assessment -> assessment
+                .setId(randomLongId()).setPlanId(planId).setEmployeeId(EMPLOYEE_ID)
+                .setStatus(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                .setProcessStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                .setStageType(stageType).setStageSort(null)
+                .setScore(null).setResultLevel(null).setCoefficient(null)
+                .setTargetConfirmationResult(null).setTargetConfirmationComment(null)
+                .setTargetConfirmationTime(null).setSelfComment(null).setReviewerComment(null)
+                .setResultComment(null).setResultConfirmationTime(null)
+                .setResultAuditStatus(null).setResultAuditTime(null).setResultAuditReason(null)
+                .setAppealReason(null).setAppealFileUrls(Collections.emptyList()).setAppealSubmitTime(null)
+                .setAppealStatus(HrmPerformanceAppealStatusEnum.NONE.getStatus())
+                .setAppealTime(null).setAppealComment(null).setArchiveTime(null));
+    }
+
+    private HrmPerformanceAssessmentStageDO randomStage(
+            Long assessmentId, Integer type, String name, Long handlerEmployeeId,
+            Integer sort, Integer status) {
+        HrmPerformanceAssessmentStageDO stage = randomPojo(HrmPerformanceAssessmentStageDO.class,
+                item -> item.setId(randomLongId()).setAssessmentId(assessmentId)
+                        .setType(type).setName(name)
+                        .setHandlerEmployeeId(handlerEmployeeId)
+                        .setRaterType(null).setWeight(null).setScoringType(null).setVisibleContent(null)
+                        .setRequiredSetting(false).setRejectAuthority(false)
+                        .setSort(sort).setStatus(status)
+                        .setScore(null).setResultLevel(null).setComment(null).setRejectReason(null)
+                        .setSubmitTime(null).setDeadlineTime(null));
+        if (HrmPerformanceStageTypeEnum.OTHER_SCORE.getType().equals(type)) {
+            stage.setRaterType(HrmPerformanceRaterTypeEnum.SPECIFIED.getType())
+                    .setWeight(new BigDecimal("100"));
+        }
+        return stage;
+    }
+
+    private HrmPortalPerformanceHandleStageReqVO buildHandleReqVO(
+            Long assessmentId, Long stageId, Integer pass) {
+        HrmPortalPerformanceHandleStageReqVO reqVO = new HrmPortalPerformanceHandleStageReqVO();
+        reqVO.setAssessmentId(assessmentId);
+        reqVO.setStageId(stageId);
+        reqVO.setPass(pass);
+        reqVO.setComment(HrmPerformanceConfirmationResultEnum.PASS.getResult().equals(pass)
+                ? "审核通过" : "退回重新评分");
+        return reqVO;
+    }
+
+    private void mockEmployee() {
+        HrmEmployeeDO employee = randomPojo(HrmEmployeeDO.class,
+                item -> item.setId(EMPLOYEE_ID).setName("测试员工").setUserId(EMPLOYEE_USER_ID));
+        when(employeeService.getEmployee(EMPLOYEE_ID)).thenReturn(employee);
+        when(employeeService.getEmployeeByUserId(EMPLOYEE_USER_ID)).thenReturn(employee);
+    }
+
+    private void mockHandlerEmployee(Long userId) {
+        when(employeeService.getEmployeeByUserId(userId))
+                .thenReturn(new HrmEmployeeDO().setId(userId).setUserId(userId));
+    }
+
+    private void mockPlan(HrmPerformancePlanDO plan) {
+        when(planService.validatePerformancePlanExists(plan.getId())).thenReturn(plan);
+        when(planService.getPerformancePlan(plan.getId())).thenReturn(plan);
+    }
+
+    private HrmPerformanceAssessmentTemplateDO.AssessmentConfig buildAssessmentConfig() {
+        return HrmPerformanceAssessmentTemplateDO.AssessmentConfig.builder()
+                .name("季度考核模板").scoreCalculation(1).upperLimitType(1)
+                .upperLimitScore(new BigDecimal("100")).dimensions(Collections.singletonList(
+                        HrmPerformanceAssessmentTemplateDO.Dimension.builder()
+                                .name("业绩").quotaType(1).weight(new BigDecimal("100"))
+                                .allowEdit(false).quotas(Collections.singletonList(
+                                        HrmPerformanceAssessmentTemplateDO.Quota.builder()
+                                                .name("目标达成率").weight(new BigDecimal("100"))
+                                                .scoreType(1).build()))
+                                .build()))
+                .build();
+    }
+
+    private ResultConfig buildResultConfig() {
+        Level level = new Level().setName("A").setMinScore(BigDecimal.ZERO)
+                .setMaxScore(new BigDecimal("100")).setCoefficient(BigDecimal.ONE);
+        return new ResultConfig().setName("默认结果模板").setLevels(Collections.singletonList(level));
+    }
+
+    private static final class AppealFixture {
+
+        private final HrmPerformancePlanDO plan;
+        private final HrmPerformanceAssessmentDO assessment;
+        private final HrmPerformanceAssessmentStageDO reviewStage;
+        private final HrmPerformanceAssessmentStageDO resultConfirmStage;
+        private final HrmPerformanceAssessmentStageDO appealStage;
+        private final HrmPerformanceAssessmentStageDO endStage;
+
+        private AppealFixture(HrmPerformancePlanDO plan,
+                              HrmPerformanceAssessmentDO assessment,
+                              HrmPerformanceAssessmentStageDO reviewStage,
+                              HrmPerformanceAssessmentStageDO resultConfirmStage,
+                              HrmPerformanceAssessmentStageDO appealStage,
+                              HrmPerformanceAssessmentStageDO endStage) {
+            this.plan = plan;
+            this.assessment = assessment;
+            this.reviewStage = reviewStage;
+            this.resultConfirmStage = resultConfirmStage;
+            this.appealStage = appealStage;
+            this.endStage = endStage;
+        }
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryServiceImplTest.java
new file mode 100644
index 0000000..baf38e4
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentQueryServiceImplTest.java
@@ -0,0 +1,387 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceProcessRecordRespVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentAppealRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentActionRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDimensionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAppealRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewVisibleContentEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.extension.ExtendWith;
+import org.mockito.InjectMocks;
+import org.mockito.Mock;
+import org.mockito.junit.jupiter.MockitoExtension;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmPerformanceAssessmentQueryServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@ExtendWith(MockitoExtension.class)
+public class HrmPerformanceAssessmentQueryServiceImplTest {
+
+    private static final Long ASSESSMENT_ID = 1L;
+    private static final Long PLAN_ID = 2L;
+    private static final Long EMPLOYEE_ID = 3L;
+    private static final Long HANDLER_EMPLOYEE_ID = 4L;
+    private static final Long HANDLER_USER_ID = 5L;
+    private static final Long DIMENSION_ID = 6L;
+    private static final Long QUOTA_ID = 7L;
+    private static final Long STAGE_ID = 8L;
+
+    @InjectMocks
+    private HrmPerformanceAssessmentQueryServiceImpl assessmentQueryService;
+
+    @Mock
+    private HrmPerformanceAssessmentService assessmentService;
+    @Mock
+    private HrmPerformancePlanService planService;
+    @Mock
+    private HrmEmployeeService employeeService;
+    @Mock
+    private DeptApi deptApi;
+    @Mock
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+
+    @Test
+    public void testBuildAssessmentRespVO_enrichesRelatedData() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.SELF_SCORE.getType());
+        HrmPerformanceAssessmentStageDO stage = buildStage(
+                HrmPerformanceStageTypeEnum.SELF_SCORE.getType(),
+                HrmPerformanceReviewVisibleContentEnum.ALL.getContent());
+        mockRelatedData(stage);
+
+        // 调用
+        HrmPerformanceAssessmentRespVO respVO = assessmentQueryService.getPerformanceAssessmentRespVO(assessment);
+
+        // 断言
+        assertEquals("季度绩效", respVO.getName());
+        assertEquals("张三", respVO.getEmployeeName());
+        assertEquals("研发部", respVO.getDeptName());
+        assertEquals("业绩", respVO.getQuotas().get(0).getDimensionName());
+        assertEquals("李经理", respVO.getStages().get(0).getHandlerName());
+        assertEquals(new BigDecimal("90"), respVO.getStages().get(0)
+                .getQuotaScoreList().get(0).getScore());
+        assertFalse(respVO.getStages().get(0).getCanHandle());
+    }
+
+    @Test
+    public void testBuildProcessAssessmentRespVO_marksCurrentHandlerAndAppealStages() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType());
+        HrmPerformanceAssessmentStageDO stage = buildStage(
+                HrmPerformanceStageTypeEnum.APPEAL_CONFIRM.getType(),
+                HrmPerformanceReviewVisibleContentEnum.ALL.getContent());
+        mockRelatedData(stage);
+        HrmPerformanceAssessmentAppealRecordDO appealRecord =
+                new HrmPerformanceAssessmentAppealRecordDO().setAssessmentId(ASSESSMENT_ID)
+                        .setStageId(99L)
+                        .setStatus(HrmPerformanceAppealRecordStatusEnum.NOT_PROCESSED.getStatus());
+        when(assessmentService.getPerformanceAssessmentAppealRecordList(any(), any()))
+                .thenReturn(Collections.singletonList(appealRecord));
+        when(employeeService.getEmployeeByUserId(HANDLER_USER_ID)).thenReturn(
+                HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).userId(HANDLER_USER_ID).build());
+
+        // 调用
+        HrmPerformanceAssessmentRespVO respVO =
+                assessmentQueryService.getPerformanceAssessmentProcessRespVO(assessment, HANDLER_USER_ID);
+
+        // 断言
+        assertEquals(STAGE_ID, respVO.getCurrentStage().getId());
+        assertTrue(respVO.getCurrentStage().getCanHandle());
+        assertFalse(respVO.getCurrentStage().getCanScore());
+        assertEquals(Collections.singletonList(99L), respVO.getAppealReviewStageIds());
+    }
+
+    @Test
+    public void testBuildReviewTaskRespVO_hidesOtherReviewContent() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.SELF_SCORE.getType());
+        assessment.setSelfComment("历史自评").setReviewerComment("历史他评");
+        HrmPerformanceAssessmentStageDO stage = buildStage(
+                HrmPerformanceStageTypeEnum.SELF_SCORE.getType(),
+                HrmPerformanceReviewVisibleContentEnum.SELF.getContent());
+        mockRelatedData(stage);
+        when(employeeService.getEmployeeByUserId(HANDLER_USER_ID)).thenReturn(
+                HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).userId(HANDLER_USER_ID).build());
+
+        // 调用
+        HrmPerformanceAssessmentRespVO respVO =
+                assessmentQueryService.getPerformanceAssessmentTaskRespVO(
+                        assessment, STAGE_ID, HANDLER_USER_ID);
+
+        // 断言
+        assertEquals(STAGE_ID, respVO.getCurrentReviewStage().getId());
+        assertTrue(respVO.getCurrentReviewStage().getCanScore());
+        assertEquals(1, respVO.getReviewStages().size());
+        assertNull(respVO.getSelfComment());
+        assertNull(respVO.getReviewerComment());
+        assertNull(respVO.getQuotas().get(0).getSelfScore());
+        assertNull(respVO.getQuotas().get(0).getReviewerScore());
+        assertNull(respVO.getQuotas().get(0).getFinalScore());
+    }
+
+    @Test
+    public void testBuildProcessAssessmentRespVO_completedSelfVisibility_hidesOtherReviewContent() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        assessment.setSelfComment("历史自评").setReviewerComment("历史他评");
+        HrmPerformanceAssessmentStageDO stage = buildStage(
+                HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(),
+                HrmPerformanceReviewVisibleContentEnum.SELF.getContent())
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        mockRelatedData(stage);
+        when(employeeService.getEmployeeByUserId(HANDLER_USER_ID)).thenReturn(
+                HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).userId(HANDLER_USER_ID).build());
+
+        // 调用
+        HrmPerformanceAssessmentRespVO respVO =
+                assessmentQueryService.getPerformanceAssessmentProcessRespVO(assessment, HANDLER_USER_ID);
+
+        // 断言
+        assertEquals(1, respVO.getReviewStages().size());
+        assertEquals(STAGE_ID, respVO.getReviewStages().get(0).getId());
+        assertNull(respVO.getSelfComment());
+        assertNull(respVO.getReviewerComment());
+        assertNull(respVO.getQuotas().get(0).getReviewerScore());
+        assertNull(respVO.getQuotas().get(0).getFinalScore());
+    }
+
+    @Test
+    public void testGetProcessRecordList_mergeAndSort() {
+        // mock 数据
+        LocalDateTime beginTime = LocalDateTime.of(2026, 7, 1, 9, 0);
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        HrmPerformanceAssessmentActionRecordDO quotaAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.FILL_QUOTA, null,
+                HrmPerformanceAssessmentActionTypeEnum.FILL_QUOTA.getTitle(),
+                "填写并提交了绩效指标", beginTime);
+        HrmPerformanceAssessmentActionRecordDO targetAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.CONFIRM_TARGET, HANDLER_EMPLOYEE_ID,
+                "确认绩效目标", "确认了绩效目标，意见：目标合理", beginTime.plusDays(1));
+        HrmPerformanceAssessmentActionRecordDO scoreAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.SCORE, HANDLER_EMPLOYEE_ID,
+                "提交绩效评分", "填写并提交了评分，阶段得分：88", beginTime.plusDays(2));
+        HrmPerformanceAssessmentActionRecordDO appealAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.SUBMIT_APPEAL, null,
+                "提交绩效申诉", "提交了绩效申诉，原因：申请复核", beginTime.plusDays(3));
+        HrmPerformanceAssessmentActionRecordDO terminateAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.TERMINATE, null,
+                "终止绩效考核", "终止了绩效考核", beginTime.plusDays(5));
+        when(assessmentActionRecordService.getPerformanceAssessmentActionRecordList(ASSESSMENT_ID))
+                .thenReturn(Arrays.asList(terminateAction, scoreAction, quotaAction, appealAction, targetAction));
+        when(employeeService.getEmployeeMap(any())).thenReturn(
+                Collections.singletonMap(HANDLER_EMPLOYEE_ID,
+                        HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).name("李经理").build()));
+
+        // 调用
+        List<HrmPerformanceProcessRecordRespVO> records =
+                assessmentQueryService.getPerformanceAssessmentProcessRecordList(assessment);
+
+        // 断言
+        assertEquals(5, records.size());
+        assertEquals("提交绩效指标", records.get(0).getTitle());
+        assertEquals("确认绩效目标", records.get(1).getTitle());
+        assertEquals("提交绩效评分", records.get(2).getTitle());
+        assertEquals("提交绩效申诉", records.get(3).getTitle());
+        assertEquals("终止绩效考核", records.get(4).getTitle());
+        assertEquals("ACTION", records.get(1).getSource());
+        assertEquals("李经理", records.get(1).getOperatorName());
+    }
+
+    @Test
+    public void testGetProcessRecordList_containsReviewRejectReason() {
+        // mock 数据
+        LocalDateTime createTime = LocalDateTime.of(2026, 7, 1, 9, 0);
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.OTHER_SCORE.getType());
+        HrmPerformanceAssessmentActionRecordDO rejectAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.REJECT_SCORE, HANDLER_EMPLOYEE_ID,
+                "驳回绩效评分", "驳回到【直属上级评分】，原因：评分依据不完整", createTime);
+        when(assessmentActionRecordService.getPerformanceAssessmentActionRecordList(ASSESSMENT_ID))
+                .thenReturn(Collections.singletonList(rejectAction));
+        when(employeeService.getEmployeeMap(any())).thenReturn(
+                Collections.singletonMap(HANDLER_EMPLOYEE_ID,
+                        HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).name("李经理").build()));
+
+        // 调用
+        List<HrmPerformanceProcessRecordRespVO> records =
+                assessmentQueryService.getPerformanceAssessmentProcessRecordList(assessment);
+
+        // 断言
+        assertEquals(1, records.size());
+        assertEquals("驳回绩效评分", records.get(0).getTitle());
+        assertTrue(records.get(0).getContent().contains("原因：评分依据不完整"));
+    }
+
+    @Test
+    public void testGetProcessRecordList_keepsRepeatedActionsAndFiles() {
+        // mock 数据
+        LocalDateTime createTime = LocalDateTime.of(2026, 7, 1, 9, 0);
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.OTHER_SCORE.getType());
+        assessment.setCreateTime(createTime);
+        HrmPerformanceAssessmentActionRecordDO scoreAction =
+                new HrmPerformanceAssessmentActionRecordDO()
+                        .setAssessmentId(ASSESSMENT_ID).setStageId(STAGE_ID)
+                        .setEmployeeId(HANDLER_EMPLOYEE_ID)
+                        .setType(HrmPerformanceAssessmentActionTypeEnum.SCORE.getType())
+                        .setTitle("提交绩效评分").setContent("阶段得分：88")
+                        .setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        scoreAction.setCreateTime(createTime.plusDays(1));
+        HrmPerformanceAssessmentActionRecordDO rejectAction =
+                new HrmPerformanceAssessmentActionRecordDO()
+                        .setAssessmentId(ASSESSMENT_ID).setStageId(STAGE_ID)
+                        .setEmployeeId(HANDLER_EMPLOYEE_ID)
+                        .setType(HrmPerformanceAssessmentActionTypeEnum.REJECT_SCORE.getType())
+                        .setTitle("驳回绩效评分").setContent("评分依据不完整")
+                        .setFileUrls(Collections.singletonList("https://example.com/evidence.pdf"))
+                        .setStatus(HrmPerformanceAssessmentStageStatusEnum.REJECTED.getStatus());
+        rejectAction.setCreateTime(createTime.plusDays(2));
+        when(assessmentActionRecordService.getPerformanceAssessmentActionRecordList(ASSESSMENT_ID))
+                .thenReturn(Arrays.asList(scoreAction, rejectAction));
+        when(employeeService.getEmployeeMap(any())).thenReturn(
+                Collections.singletonMap(HANDLER_EMPLOYEE_ID,
+                        HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).name("李经理").build()));
+
+        // 调用
+        List<HrmPerformanceProcessRecordRespVO> records =
+                assessmentQueryService.getPerformanceAssessmentProcessRecordList(assessment);
+
+        // 断言
+        assertEquals(2, records.size());
+        assertEquals("提交绩效评分", records.get(0).getTitle());
+        assertEquals("驳回绩效评分", records.get(1).getTitle());
+        assertEquals("ACTION", records.get(0).getSource());
+        assertEquals("李经理", records.get(1).getOperatorName());
+        assertEquals(Collections.singletonList("https://example.com/evidence.pdf"),
+                records.get(1).getFileUrls());
+    }
+
+    @Test
+    public void testGetProcessRecordList_selfVisibility_hidesOtherReviewerScoreAction() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = buildAssessment(
+                HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+        HrmPerformanceAssessmentStageDO viewerStage = buildStage(
+                HrmPerformanceStageTypeEnum.OTHER_SCORE.getType(),
+                HrmPerformanceReviewVisibleContentEnum.SELF.getContent())
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus());
+        HrmPerformanceAssessmentActionRecordDO ownScoreAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.SCORE, HANDLER_EMPLOYEE_ID,
+                "提交绩效评分", "阶段得分：88", LocalDateTime.now().minusDays(1));
+        HrmPerformanceAssessmentActionRecordDO otherScoreAction = buildActionRecord(
+                HrmPerformanceAssessmentActionTypeEnum.SCORE, 99L,
+                "提交绩效评分", "阶段得分：96，评语：表现优秀", LocalDateTime.now());
+        when(assessmentActionRecordService.getPerformanceAssessmentActionRecordList(ASSESSMENT_ID))
+                .thenReturn(Arrays.asList(ownScoreAction, otherScoreAction));
+        when(employeeService.getEmployeeByUserId(HANDLER_USER_ID)).thenReturn(
+                HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).userId(HANDLER_USER_ID).build());
+        when(assessmentService.getPerformanceAssessmentStageList(any()))
+                .thenReturn(Collections.singletonList(viewerStage));
+        when(employeeService.getEmployeeMap(any())).thenReturn(Collections.singletonMap(
+                HANDLER_EMPLOYEE_ID,
+                HrmEmployeeDO.builder().id(HANDLER_EMPLOYEE_ID).name("李经理").build()));
+
+        // 调用
+        List<HrmPerformanceProcessRecordRespVO> records = assessmentQueryService
+                .getPerformanceAssessmentProcessRecordList(assessment, HANDLER_USER_ID);
+
+        // 断言
+        assertEquals(1, records.size());
+        assertEquals("阶段得分：88", records.get(0).getContent());
+        assertEquals("李经理", records.get(0).getOperatorName());
+    }
+
+    private HrmPerformanceAssessmentActionRecordDO buildActionRecord(
+            HrmPerformanceAssessmentActionTypeEnum type, Long employeeId,
+            String title, String content, LocalDateTime createTime) {
+        HrmPerformanceAssessmentActionRecordDO actionRecord = new HrmPerformanceAssessmentActionRecordDO()
+                .setAssessmentId(ASSESSMENT_ID).setEmployeeId(employeeId)
+                .setType(type.getType()).setTitle(title).setContent(content);
+        actionRecord.setCreateTime(createTime);
+        return actionRecord;
+    }
+
+    private void mockRelatedData(HrmPerformanceAssessmentStageDO stage) {
+        HrmPerformancePlanDO plan = HrmPerformancePlanDO.builder().id(PLAN_ID).name("季度绩效").build();
+        when(planService.getPerformancePlanMap(any())).thenReturn(Collections.singletonMap(PLAN_ID, plan));
+        HrmPerformanceAssessmentDimensionDO dimension = new HrmPerformanceAssessmentDimensionDO()
+                .setId(DIMENSION_ID).setAssessmentId(ASSESSMENT_ID).setName("业绩")
+                .setWeight(new BigDecimal("100")).setAllowEdit(false);
+        when(assessmentService.getPerformanceAssessmentDimensionList(any()))
+                .thenReturn(Collections.singletonList(dimension));
+        HrmPerformanceAssessmentQuotaDO quota = HrmPerformanceAssessmentQuotaDO.builder()
+                .id(QUOTA_ID).assessmentId(ASSESSMENT_ID).dimensionId(DIMENSION_ID)
+                .name("目标达成率").selfScore(new BigDecimal("80"))
+                .reviewerScore(new BigDecimal("90")).finalScore(new BigDecimal("86")).build();
+        when(assessmentService.getPerformanceAssessmentQuotaList(any()))
+                .thenReturn(Collections.singletonList(quota));
+        when(assessmentService.getPerformanceAssessmentStageList(any()))
+                .thenReturn(Collections.singletonList(stage));
+        HrmPerformanceAssessmentQuotaScoreDO quotaScore =
+                new HrmPerformanceAssessmentQuotaScoreDO().setAssessmentStageId(STAGE_ID)
+                        .setAssessmentQuotaId(QUOTA_ID).setScore(new BigDecimal("90"));
+        when(assessmentService.getPerformanceAssessmentQuotaScoreList(any()))
+                .thenReturn(Collections.singletonList(quotaScore));
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(EMPLOYEE_ID, HrmEmployeeDO.builder()
+                .id(EMPLOYEE_ID).name("张三").deptId(10L).build());
+        HrmEmployeeDO handler = HrmEmployeeDO.builder()
+                .id(HANDLER_EMPLOYEE_ID).name("李经理").userId(HANDLER_USER_ID).build();
+        employeeMap.put(HANDLER_EMPLOYEE_ID, handler);
+        when(employeeService.getEmployeeMap(any())).thenReturn(employeeMap);
+        DeptRespDTO dept = new DeptRespDTO();
+        dept.setId(10L);
+        dept.setName("研发部");
+        when(deptApi.getDeptMap(any())).thenReturn(Collections.singletonMap(10L, dept));
+    }
+
+    private HrmPerformanceAssessmentDO buildAssessment(Integer stageType) {
+        return HrmPerformanceAssessmentDO.builder().id(ASSESSMENT_ID).planId(PLAN_ID)
+                .employeeId(EMPLOYEE_ID).stageType(stageType).build();
+    }
+
+    private HrmPerformanceAssessmentStageDO buildStage(Integer type, Integer visibleContent) {
+        return new HrmPerformanceAssessmentStageDO().setId(STAGE_ID).setAssessmentId(ASSESSMENT_ID)
+                .setType(type).setName("处理节点").setHandlerEmployeeId(HANDLER_EMPLOYEE_ID)
+                .setVisibleContent(visibleContent)
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewServiceImplTest.java
new file mode 100644
index 0000000..68775ec
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentReviewServiceImplTest.java
@@ -0,0 +1,552 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceQuotaSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.process.HrmPortalPerformanceProcessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScorePreviewRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.review.HrmPortalPerformanceScoreReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.task.HrmPortalPerformanceTaskPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDimensionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentQuotaScoreDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentStageDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ResultConfig;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO.Level;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentDimensionMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentQuotaScoreMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentStageMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.plan.HrmPerformancePlanMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.config.HrmPerformanceResultTemplateMapper;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentStageStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.config.HrmPerformanceUpperLimitTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_REVIEW_STAGE_NO_PERMISSION;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_RESULT_LEVEL_NOT_MATCH;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmPerformanceAssessmentReviewServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmPerformanceAssessmentReviewServiceImpl.class)
+public class HrmPerformanceAssessmentReviewServiceImplTest extends BaseDbUnitTest {
+
+    private static final Long QUOTA_TEMPLATE_ID = 100L;
+    private static final Long QUOTA_ASSESSMENT_ID = 300L;
+
+    @Resource
+    private HrmPerformanceAssessmentReviewServiceImpl reviewService;
+
+    @Resource
+    private HrmPerformancePlanMapper planMapper;
+    @Resource
+    private HrmPerformanceResultTemplateMapper resultTemplateMapper;
+    @Resource
+    private HrmPerformanceAssessmentMapper assessmentMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaMapper assessmentQuotaMapper;
+    @Resource
+    private HrmPerformanceAssessmentDimensionMapper assessmentDimensionMapper;
+    @Resource
+    private HrmPerformanceAssessmentStageMapper assessmentStageMapper;
+    @Resource
+    private HrmPerformanceAssessmentQuotaScoreMapper assessmentQuotaScoreMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private HrmPerformanceAssessmentProcessService processService;
+    @MockitoBean
+    private HrmPerformancePlanService planService;
+    @MockitoBean
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+
+    @Test
+    public void testGetMyFillQuotaTaskPage_success() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        HrmPerformanceAssessmentStageDO fillStage = new HrmPerformanceAssessmentStageDO()
+                .setAssessmentId(fixture.assessment.getId()).setName("员工填写")
+                .setType(HrmPerformanceStageTypeEnum.FILL_QUOTA.getType())
+                .setHandlerEmployeeId(200L)
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()).setSort(0);
+        assessmentStageMapper.insert(fillStage);
+
+        // 准备参数
+        HrmPortalPerformanceTaskPageReqVO reqVO = buildPendingTaskPageReqVO();
+
+        // 调用
+        PageResult<HrmPerformanceAssessmentStageDO> result =
+                reviewService.getMyFillQuotaTaskPage(1001L, reqVO);
+
+        // 断言
+        assertEquals(1, result.getList().size());
+        assertEquals(fillStage.getId(), result.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetMyReviewTaskPage_success() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        when(planService.getPerformancePlanList(any()))
+                .thenReturn(Collections.singletonList(fixture.plan));
+
+        // 准备参数
+        HrmPortalPerformanceTaskPageReqVO reqVO = buildPendingTaskPageReqVO();
+
+        // 调用
+        PageResult<HrmPerformanceAssessmentStageDO> result =
+                reviewService.getMyReviewTaskPage(1001L, reqVO);
+
+        // 断言
+        assertEquals(1, result.getList().size());
+        assertEquals(fixture.reviewStage.getId(), result.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetMyReviewTaskPage_accountRebound_success() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        when(employeeService.getEmployeeByUserId(2002L)).thenReturn(
+                HrmEmployeeDO.builder().id(200L).userId(2002L).build());
+        when(planService.getPerformancePlanList(any()))
+                .thenReturn(Collections.singletonList(fixture.plan));
+
+        // 准备参数
+        HrmPortalPerformanceTaskPageReqVO reqVO = buildPendingTaskPageReqVO();
+
+        // 调用
+        PageResult<HrmPerformanceAssessmentStageDO> result =
+                reviewService.getMyReviewTaskPage(2002L, reqVO);
+
+        // 断言
+        assertEquals(1, result.getList().size());
+        assertEquals(fixture.reviewStage.getId(), result.getList().get(0).getId());
+    }
+
+    @Test
+    public void testPreviewScore_readOnly_success() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        HrmPortalPerformanceQuotaSaveReqVO quotaReqVO = new HrmPortalPerformanceQuotaSaveReqVO();
+        quotaReqVO.setId(fixture.quota.getId());
+        quotaReqVO.setSelfScore(new BigDecimal("80"));
+        HrmPortalPerformanceScoreReqVO reqVO = new HrmPortalPerformanceScoreReqVO();
+        reqVO.setAssessmentId(fixture.assessment.getId());
+        reqVO.setReviewStageId(fixture.reviewStage.getId());
+        reqVO.setQuotas(Collections.singletonList(quotaReqVO));
+
+        // 调用
+        HrmPortalPerformanceScorePreviewRespVO preview = reviewService.previewScore(1001L, reqVO);
+
+        // 断言
+        assertEquals(new BigDecimal("80.00"), preview.getStageScore());
+        assertEquals("B", preview.getStageResultLevel());
+        assertEquals(new BigDecimal("80.00"), preview.getCumulativeScore());
+        assertEquals("B", preview.getCumulativeResultLevel());
+        assertTrue(assessmentQuotaScoreMapper.selectListByAssessmentStageIds(
+                Collections.singleton(fixture.reviewStage.getId())).isEmpty());
+        HrmPerformanceAssessmentQuotaDO quota = assessmentQuotaMapper.selectById(fixture.quota.getId());
+        assertEquals(new BigDecimal("0.00"), quota.getSelfScore());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(fixture.reviewStage.getId()).getStatus());
+    }
+
+    @Test
+    public void testPreviewScore_otherReviewer() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        HrmPortalPerformanceScoreReqVO reqVO = new HrmPortalPerformanceScoreReqVO();
+        reqVO.setAssessmentId(fixture.assessment.getId());
+        reqVO.setReviewStageId(fixture.reviewStage.getId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> reviewService.previewScore(2002L, reqVO),
+                PERFORMANCE_REVIEW_STAGE_NO_PERMISSION);
+    }
+
+    @Test
+    public void testPreviewScore_resultTemplateChanged_usePlanSnapshot() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        fixture.resultTemplate.setLevels(Collections.singletonList(
+                Level.builder().name("S").minScore(BigDecimal.ZERO)
+                        .maxScore(new BigDecimal("100")).coefficient(new BigDecimal("2")).build()));
+        resultTemplateMapper.updateById(fixture.resultTemplate);
+        HrmPortalPerformanceQuotaSaveReqVO quotaReqVO = new HrmPortalPerformanceQuotaSaveReqVO();
+        quotaReqVO.setId(fixture.quota.getId());
+        quotaReqVO.setSelfScore(new BigDecimal("80"));
+        HrmPortalPerformanceScoreReqVO reqVO = new HrmPortalPerformanceScoreReqVO();
+        reqVO.setAssessmentId(fixture.assessment.getId());
+        reqVO.setReviewStageId(fixture.reviewStage.getId());
+        reqVO.setQuotas(Collections.singletonList(quotaReqVO));
+
+        // 调用
+        HrmPortalPerformanceScorePreviewRespVO preview = reviewService.previewScore(1001L, reqVO);
+
+        // 断言
+        assertEquals("B", preview.getStageResultLevel());
+        assertEquals("B", preview.getCumulativeResultLevel());
+    }
+
+    @Test
+    public void testPreviewScore_multipleStages_hidesCumulativeLevel() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        fixture.reviewStage.setWeight(new BigDecimal("50"));
+        assessmentStageMapper.updateById(fixture.reviewStage);
+        assessmentStageMapper.insert(new HrmPerformanceAssessmentStageDO()
+                .setAssessmentId(fixture.assessment.getId()).setName("直属上级评分")
+                .setType(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType())
+                .setRaterType(HrmPerformanceRaterTypeEnum.SUPERIOR.getType()).setHandlerEmployeeId(201L)
+                .setWeight(new BigDecimal("50"))
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus()).setSort(2));
+        HrmPortalPerformanceQuotaSaveReqVO quotaReqVO = new HrmPortalPerformanceQuotaSaveReqVO()
+                .setId(fixture.quota.getId()).setSelfScore(new BigDecimal("80"));
+        HrmPortalPerformanceScoreReqVO reqVO = new HrmPortalPerformanceScoreReqVO()
+                .setAssessmentId(fixture.assessment.getId()).setReviewStageId(fixture.reviewStage.getId())
+                .setQuotas(Collections.singletonList(quotaReqVO));
+
+        // 调用
+        HrmPortalPerformanceScorePreviewRespVO preview = reviewService.previewScore(1001L, reqVO);
+
+        // 断言
+        assertEquals(new BigDecimal("40.00"), preview.getCumulativeScore());
+        assertNull(preview.getCumulativeResultLevel());
+    }
+
+    @Test
+    public void testScoreAssessment_resultLevelNotMatch() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        fixture.plan.setResultConfig(ResultConfig.builder().name("不完整结果模板")
+                .levels(Collections.singletonList(Level.builder().name("A")
+                        .minScore(new BigDecimal("90")).maxScore(new BigDecimal("100"))
+                        .coefficient(BigDecimal.ONE).build())).build());
+        HrmPortalPerformanceQuotaSaveReqVO quotaReqVO = new HrmPortalPerformanceQuotaSaveReqVO()
+                .setId(fixture.quota.getId()).setSelfScore(new BigDecimal("80"));
+        HrmPortalPerformanceScoreReqVO reqVO = new HrmPortalPerformanceScoreReqVO()
+                .setAssessmentId(fixture.assessment.getId()).setReviewStageId(fixture.reviewStage.getId())
+                .setQuotas(Collections.singletonList(quotaReqVO));
+
+        // 调用，并断言未命中等级时不保存空结果
+        assertServiceException(() -> reviewService.scoreAssessment(1001L, reqVO),
+                PERFORMANCE_RESULT_LEVEL_NOT_MATCH);
+    }
+
+    @Test
+    public void testScoreAssessment_multipleReviewer_refreshPartialScore() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        fixture.assessment.setStageType(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType());
+        assessmentMapper.updateById(fixture.assessment);
+        fixture.quota.setSelfScore(new BigDecimal("99")).setReviewerScore(new BigDecimal("60"));
+        assessmentQuotaMapper.updateById(fixture.quota);
+        fixture.reviewStage.setType(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType())
+                .setName("上级评分").setRaterType(HrmPerformanceRaterTypeEnum.SUPERIOR.getType())
+                .setHandlerEmployeeId(201L).setWeight(new BigDecimal("20"))
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus()).setSort(1);
+        assessmentStageMapper.updateById(fixture.reviewStage);
+        assessmentQuotaScoreMapper.insert(new HrmPerformanceAssessmentQuotaScoreDO()
+                .setAssessmentStageId(fixture.reviewStage.getId())
+                .setAssessmentQuotaId(fixture.quota.getId()).setScore(new BigDecimal("60")));
+        HrmPerformanceAssessmentStageDO currentStage = new HrmPerformanceAssessmentStageDO()
+                .setAssessmentId(fixture.assessment.getId())
+                .setType(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType()).setName("部门负责人评分")
+                .setRaterType(HrmPerformanceRaterTypeEnum.DEPT_LEADER.getType())
+                .setHandlerEmployeeId(200L).setWeight(new BigDecimal("30"))
+                .setRequiredSetting(false).setRejectAuthority(false)
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()).setSort(2);
+        assessmentStageMapper.insert(currentStage);
+        HrmPerformanceAssessmentStageDO nextStage = new HrmPerformanceAssessmentStageDO()
+                .setAssessmentId(fixture.assessment.getId())
+                .setType(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType()).setName("指定评分人评分")
+                .setRaterType(HrmPerformanceRaterTypeEnum.SPECIFIED.getType())
+                .setHandlerEmployeeId(202L).setWeight(new BigDecimal("50"))
+                .setRequiredSetting(false).setRejectAuthority(false)
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.NOT_PROCESSED.getStatus()).setSort(3);
+        assessmentStageMapper.insert(nextStage);
+        HrmPortalPerformanceQuotaSaveReqVO quotaReqVO = new HrmPortalPerformanceQuotaSaveReqVO();
+        quotaReqVO.setId(fixture.quota.getId());
+        quotaReqVO.setReviewerScore(new BigDecimal("80"));
+        HrmPortalPerformanceScoreReqVO reqVO = new HrmPortalPerformanceScoreReqVO();
+        reqVO.setAssessmentId(fixture.assessment.getId());
+        reqVO.setReviewStageId(currentStage.getId());
+        reqVO.setQuotas(Collections.singletonList(quotaReqVO));
+
+        // 调用
+        HrmPortalPerformanceProcessRespVO result = reviewService.scoreAssessment(1001L, reqVO);
+
+        // 断言
+        assertEquals(fixture.assessment.getId(), result.getId());
+        HrmPerformanceAssessmentQuotaDO quota = assessmentQuotaMapper.selectById(fixture.quota.getId());
+        assertNull(quota.getSelfScore());
+        assertEquals(new BigDecimal("72.00"), quota.getReviewerScore());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(nextStage.getId()).getStatus());
+    }
+
+    @Test
+    public void testScoreAssessment_multiplePendingStage_scoreInParallel() {
+        // mock 数据
+        PreviewFixture fixture = createPreviewFixture();
+        HrmPerformanceAssessmentStageDO otherReviewStage = new HrmPerformanceAssessmentStageDO()
+                .setAssessmentId(fixture.assessment.getId())
+                .setType(HrmPerformanceStageTypeEnum.OTHER_SCORE.getType()).setName("直属上级评分")
+                .setRaterType(HrmPerformanceRaterTypeEnum.SUPERIOR.getType())
+                .setHandlerEmployeeId(200L).setWeight(new BigDecimal("50"))
+                .setRequiredSetting(false).setRejectAuthority(false)
+                .setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()).setSort(2);
+        assessmentStageMapper.insert(otherReviewStage);
+        HrmPortalPerformanceQuotaSaveReqVO quotaReqVO = new HrmPortalPerformanceQuotaSaveReqVO();
+        quotaReqVO.setId(fixture.quota.getId());
+        quotaReqVO.setReviewerScore(new BigDecimal("80"));
+        HrmPortalPerformanceScoreReqVO reqVO = new HrmPortalPerformanceScoreReqVO();
+        reqVO.setAssessmentId(fixture.assessment.getId());
+        reqVO.setReviewStageId(otherReviewStage.getId());
+        reqVO.setQuotas(Collections.singletonList(quotaReqVO));
+
+        // 调用
+        reviewService.scoreAssessment(1001L, reqVO);
+
+        // 断言
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PROCESSED.getStatus(),
+                assessmentStageMapper.selectById(otherReviewStage.getId()).getStatus());
+        assertEquals(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus(),
+                assessmentStageMapper.selectById(fixture.reviewStage.getId()).getStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.SELF_SCORE.getType(),
+                assessmentMapper.selectById(fixture.assessment.getId()).getStageType());
+    }
+
+    @Test
+    public void testEnsureAssessmentQuotaList_success() {
+        // 准备参数
+        HrmPerformancePlanDO plan = buildQuotaPlan(new BigDecimal("100"));
+        HrmPerformanceAssessmentDO assessment = buildQuotaAssessment();
+
+        // 调用
+        reviewService.ensureAssessmentQuotaList(plan, assessment);
+
+        // 断言
+        List<HrmPerformanceAssessmentQuotaDO> quotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId());
+        HrmPerformanceAssessmentDimensionDO dimension =
+                assessmentDimensionMapper.selectListByAssessmentId(assessment.getId()).get(0);
+        assertEquals(1, quotas.size());
+        HrmPerformanceAssessmentQuotaDO quota = quotas.get(0);
+        assertEquals(dimension.getId(), quota.getDimensionId());
+        assertTrue(quota.getPreset());
+        assertEquals("目标达成率", quota.getName());
+        assertEquals(new BigDecimal("100.00"), quota.getWeight());
+        assertEquals(new BigDecimal("0.00"), quota.getSelfScore());
+        assertEquals(new BigDecimal("0.00"), quota.getReviewerScore());
+        assertEquals(new BigDecimal("0.00"), quota.getFinalScore());
+    }
+
+    @Test
+    public void testEnsureAssessmentQuotaList_existingQuota() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = buildQuotaAssessment();
+        HrmPerformanceAssessmentQuotaDO existingQuota = HrmPerformanceAssessmentQuotaDO.builder()
+                .assessmentId(assessment.getId()).dimensionId(1L).preset(true)
+                .name("存量指标").weight(new BigDecimal("100")).build();
+        assessmentQuotaMapper.insert(existingQuota);
+        // 准备参数
+        HrmPerformancePlanDO plan = buildQuotaPlan(new BigDecimal("100"));
+
+        // 调用
+        reviewService.ensureAssessmentQuotaList(plan, assessment);
+
+        // 断言
+        assertEquals(1L, assessmentQuotaMapper.selectCount());
+        assertEquals("存量指标", assessmentQuotaMapper.selectById(existingQuota.getId()).getName());
+    }
+
+    @Test
+    public void testReplaceAssessmentQuotaList_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildQuotaPlan(new BigDecimal("60"));
+        HrmPerformanceAssessmentDO assessment = buildQuotaAssessment();
+        reviewService.ensureAssessmentQuotaList(plan, assessment);
+        HrmPerformanceAssessmentQuotaDO presetQuota =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId()).get(0);
+        Long dimensionId = presetQuota.getDimensionId();
+        assessmentQuotaMapper.insert(HrmPerformanceAssessmentQuotaDO.builder()
+                .assessmentId(assessment.getId()).dimensionId(dimensionId).preset(false)
+                .name("旧自定义指标").standard("旧标准").weight(new BigDecimal("40"))
+                .scoreType(1).sort(2).build());
+        // 准备参数
+        HrmPortalPerformanceQuotaSaveReqVO presetReqVO = new HrmPortalPerformanceQuotaSaveReqVO();
+        presetReqVO.setId(presetQuota.getId());
+        HrmPortalPerformanceQuotaSaveReqVO customReqVO = new HrmPortalPerformanceQuotaSaveReqVO();
+        customReqVO.setDimensionId(dimensionId);
+        customReqVO.setName(" 新自定义指标 ");
+        customReqVO.setStandard(" 新标准 ");
+        customReqVO.setWeight(new BigDecimal("40"));
+        customReqVO.setScoreType(1);
+
+        // 调用
+        reviewService.replaceAssessmentQuotaList(plan, assessment,
+                Arrays.asList(presetReqVO, customReqVO));
+
+        // 断言
+        List<HrmPerformanceAssessmentQuotaDO> quotas =
+                assessmentQuotaMapper.selectListByAssessmentId(assessment.getId());
+        assertEquals(2, quotas.size());
+        HrmPerformanceAssessmentQuotaDO customQuota = quotas.stream()
+                .filter(quota -> !quota.getPreset()).findFirst().orElse(null);
+        assertNotNull(customQuota);
+        assertEquals(dimensionId, customQuota.getDimensionId());
+        assertEquals("新自定义指标", customQuota.getName());
+        assertEquals("新标准", customQuota.getStandard());
+        assertEquals(new BigDecimal("40.00"), customQuota.getWeight());
+    }
+
+    @Test
+    public void testUpdateAssessmentQuotaList_incompleteIds() {
+        // mock 数据
+        HrmPerformanceAssessmentQuotaDO firstQuota = HrmPerformanceAssessmentQuotaDO.builder()
+                .assessmentId(QUOTA_ASSESSMENT_ID).dimensionId(1L)
+                .preset(true).name("指标一").build();
+        assessmentQuotaMapper.insert(firstQuota);
+        assessmentQuotaMapper.insert(HrmPerformanceAssessmentQuotaDO.builder()
+                .assessmentId(QUOTA_ASSESSMENT_ID).dimensionId(1L)
+                .preset(true).name("指标二").build());
+        // 准备参数
+        HrmPortalPerformanceQuotaSaveReqVO reqVO = new HrmPortalPerformanceQuotaSaveReqVO();
+        reqVO.setId(firstQuota.getId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> reviewService.updateAssessmentQuotaList(
+                QUOTA_ASSESSMENT_ID, Collections.singletonList(reqVO)), PERFORMANCE_DATA_ILLEGAL);
+    }
+
+    private HrmPortalPerformanceTaskPageReqVO buildPendingTaskPageReqVO() {
+        HrmPortalPerformanceTaskPageReqVO reqVO = new HrmPortalPerformanceTaskPageReqVO();
+        reqVO.setPageNo(1);
+        reqVO.setPageSize(10);
+        reqVO.setStageStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus());
+        return reqVO;
+    }
+
+    private PreviewFixture createPreviewFixture() {
+        HrmPerformanceResultTemplateDO resultTemplate = HrmPerformanceResultTemplateDO.builder()
+                .name("季度结果模板").levels(buildResultConfig().getLevels()).build();
+        resultTemplateMapper.insert(resultTemplate);
+        HrmPerformancePlanDO plan = HrmPerformancePlanDO.builder()
+                .name("季度绩效计划").assessmentTemplateId(100L)
+                .assessmentConfig(HrmPerformanceAssessmentTemplateDO.AssessmentConfig.builder()
+                        .name("季度考核模板").upperLimitType(HrmPerformanceUpperLimitTypeEnum.UNIFIED.getType())
+                        .upperLimitScore(new BigDecimal("100")).dimensions(Collections.emptyList()).build())
+                .scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .resultTemplateId(resultTemplate.getId()).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).stageType(HrmPerformanceStageTypeEnum.SELF_SCORE.getType()).build();
+        planMapper.insert(plan);
+        when(planService.validatePerformancePlanExists(plan.getId())).thenReturn(plan);
+        HrmPerformanceAssessmentDO assessment = HrmPerformanceAssessmentDO.builder()
+                .planId(plan.getId()).employeeId(200L).status(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                .stageType(HrmPerformanceStageTypeEnum.SELF_SCORE.getType()).build();
+        assessmentMapper.insert(assessment);
+        when(employeeService.getEmployeeByUserId(1001L)).thenReturn(
+                HrmEmployeeDO.builder().id(200L).userId(1001L).build());
+        HrmPerformanceAssessmentQuotaDO quota = HrmPerformanceAssessmentQuotaDO.builder()
+                .assessmentId(assessment.getId()).dimensionId(1L)
+                .preset(true).name("目标达成率")
+                .weight(new BigDecimal("100"))
+                .selfScore(BigDecimal.ZERO).reviewerScore(BigDecimal.ZERO).finalScore(BigDecimal.ZERO).build();
+        assessmentQuotaMapper.insert(quota);
+        HrmPerformanceAssessmentStageDO reviewStage = new HrmPerformanceAssessmentStageDO();
+        reviewStage.setAssessmentId(assessment.getId()).setName("员工自评")
+                .setType(HrmPerformanceStageTypeEnum.SELF_SCORE.getType())
+                .setRaterType(HrmPerformanceRaterTypeEnum.SELF.getType()).setHandlerEmployeeId(200L)
+                .setWeight(new BigDecimal("100")).setStatus(HrmPerformanceAssessmentStageStatusEnum.PENDING.getStatus()).setSort(1);
+        assessmentStageMapper.insert(reviewStage);
+        return new PreviewFixture(resultTemplate, plan, assessment, quota, reviewStage);
+    }
+
+    private ResultConfig buildResultConfig() {
+        return ResultConfig.builder().name("季度结果模板").levels(Arrays.asList(
+                Level.builder().name("A").minScore(BigDecimal.valueOf(90))
+                        .maxScore(BigDecimal.valueOf(100)).coefficient(BigDecimal.valueOf(1.2)).build(),
+                Level.builder().name("B").minScore(BigDecimal.valueOf(80))
+                        .maxScore(BigDecimal.valueOf(89.99)).coefficient(BigDecimal.ONE).build(),
+                Level.builder().name("C").minScore(BigDecimal.ZERO)
+                        .maxScore(BigDecimal.valueOf(79.99)).coefficient(BigDecimal.valueOf(0.8)).build()
+        )).build();
+    }
+
+    private HrmPerformancePlanDO buildQuotaPlan(BigDecimal weight) {
+        HrmPerformanceAssessmentTemplateDO.Quota quota = HrmPerformanceAssessmentTemplateDO.Quota.builder()
+                .name("目标达成率").illustrate("目标达成情况").standard("按完成质量评分")
+                .weight(weight).scoreType(1).build();
+        HrmPerformanceAssessmentTemplateDO.Dimension dimension =
+                HrmPerformanceAssessmentTemplateDO.Dimension.builder()
+                        .name("业绩").quotaType(1).weight(new BigDecimal("100"))
+                        .allowEdit(true).quotas(Collections.singletonList(quota)).build();
+        HrmPerformanceAssessmentTemplateDO.AssessmentConfig config =
+                HrmPerformanceAssessmentTemplateDO.AssessmentConfig.builder()
+                        .name("季度考核").scoreCalculation(1).upperLimitType(1)
+                        .upperLimitScore(new BigDecimal("100"))
+                        .dimensions(Collections.singletonList(dimension)).build();
+        return HrmPerformancePlanDO.builder().id(10L).assessmentTemplateId(QUOTA_TEMPLATE_ID)
+                .assessmentConfig(config).scopes(Collections.emptyList())
+                .reviewStages(Collections.emptyList()).build();
+    }
+
+    private HrmPerformanceAssessmentDO buildQuotaAssessment() {
+        return HrmPerformanceAssessmentDO.builder().id(QUOTA_ASSESSMENT_ID)
+                .planId(10L).employeeId(20L).build();
+    }
+
+    private static final class PreviewFixture {
+
+        private final HrmPerformanceResultTemplateDO resultTemplate;
+        private final HrmPerformancePlanDO plan;
+        private final HrmPerformanceAssessmentDO assessment;
+        private final HrmPerformanceAssessmentQuotaDO quota;
+        private final HrmPerformanceAssessmentStageDO reviewStage;
+
+        private PreviewFixture(HrmPerformanceResultTemplateDO resultTemplate, HrmPerformancePlanDO plan,
+                               HrmPerformanceAssessmentDO assessment,
+                               HrmPerformanceAssessmentQuotaDO quota,
+                               HrmPerformanceAssessmentStageDO reviewStage) {
+            this.resultTemplate = resultTemplate;
+            this.plan = plan;
+            this.assessment = assessment;
+            this.quota = quota;
+            this.reviewStage = reviewStage;
+        }
+
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentServiceImplTest.java
new file mode 100644
index 0000000..b1d8748
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/assessment/HrmPerformanceAssessmentServiceImplTest.java
@@ -0,0 +1,387 @@
+package cn.iocoder.yudao.module.hrm.service.performance.assessment;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceArchiveEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.portal.performance.vo.assessment.HrmPortalPerformanceAssessmentPageReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentAppealRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ResultConfig;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.assessment.HrmPerformanceAssessmentDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO.Level;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.assessment.HrmPerformanceAssessmentAppealRecordMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.employee.info.HrmEmployeeMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.plan.HrmPerformancePlanMapper;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentActionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.assessment.HrmPerformanceAssessmentProcessStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.Map;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.verify;
+
+/**
+ * {@link HrmPerformanceAssessmentServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmPerformanceAssessmentServiceImpl.class)
+public class HrmPerformanceAssessmentServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmPerformanceAssessmentServiceImpl assessmentService;
+
+    @Resource
+    private HrmPerformancePlanMapper planMapper;
+    @Resource
+    private HrmPerformanceAssessmentMapper assessmentMapper;
+    @Resource
+    private HrmPerformanceAssessmentAppealRecordMapper assessmentAppealRecordMapper;
+    @Resource
+    private HrmEmployeeMapper employeeMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private HrmPerformanceAssessmentProcessService assessmentProcessService;
+    @MockitoBean
+    private HrmPerformanceAssessmentReviewService assessmentReviewService;
+    @MockitoBean
+    private HrmPerformanceAssessmentActionRecordService assessmentActionRecordService;
+
+    @Test
+    public void testTerminateAssessmentListByPlanId_success() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                .processStatus(HrmPerformanceAssessmentProcessStatusEnum.PROCESSING.getStatus())
+                .stageType(HrmPerformanceStageTypeEnum.SELF_SCORE.getType()).build();
+        assessmentMapper.insert(assessment);
+
+        // 调用
+        assessmentService.terminatePerformanceAssessmentListByPlanId(1L, 300L);
+
+        // 断言
+        HrmPerformanceAssessmentDO updatedAssessment = assessmentMapper.selectById(assessment.getId());
+        assertEquals(HrmPerformancePlanStatusEnum.TERMINATED.getStatus(), updatedAssessment.getStatus());
+        assertEquals(HrmPerformanceAssessmentProcessStatusEnum.FINISHED.getStatus(),
+                updatedAssessment.getProcessStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.SELF_SCORE.getType(), updatedAssessment.getStageType());
+        verify(assessmentActionRecordService).createPerformanceAssessmentActionRecord(
+                300L, assessment.getId(), null, HrmPerformanceAssessmentActionTypeEnum.TERMINATE,
+                null, null);
+    }
+
+    @Test
+    public void testGetAssessmentMap_success() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment1 = HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(100L).status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        assessmentMapper.insert(assessment1);
+        HrmPerformanceAssessmentDO assessment2 = HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(200L).status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        assessmentMapper.insert(assessment2);
+
+        // 调用
+        Map<Long, HrmPerformanceAssessmentDO> assessmentMap = assessmentService.getPerformanceAssessmentMap(
+                Arrays.asList(assessment1.getId(), assessment2.getId()));
+
+        // 断言
+        assertEquals(2, assessmentMap.size());
+        assertEquals(assessment1.getId(), assessmentMap.get(assessment1.getId()).getId());
+        assertEquals(assessment2.getId(), assessmentMap.get(assessment2.getId()).getId());
+    }
+
+    @Test
+    public void testGetAssessmentPage_resultLevelEmpty() {
+        // mock 数据
+        HrmPerformanceAssessmentDO unclassifiedAssessment = HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(100L).status(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                .resultLevel(null).build();
+        assessmentMapper.insert(unclassifiedAssessment);
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(200L).status(HrmPerformancePlanStatusEnum.RUNNING.getStatus())
+                .resultLevel("A").build());
+
+        // 准备参数
+        HrmPerformanceAssessmentPageReqVO reqVO = new HrmPerformanceAssessmentPageReqVO();
+        reqVO.setPlanId(1L);
+        reqVO.setResultLevelEmpty(true);
+
+        // 调用
+        PageResult<HrmPerformanceAssessmentDO> pageResult = assessmentService.getPerformanceAssessmentPage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(unclassifiedAssessment.getId(), pageResult.getList().get(0).getId());
+        assertNull(pageResult.getList().get(0).getResultLevel());
+    }
+
+    @Test
+    public void testGetPortalAssessmentPage() {
+        // mock 数据
+        HrmPerformancePlanDO runningPlan = HrmPerformancePlanDO.builder()
+                .name("研发季度绩效").scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .assessmentTemplateId(1L).assessmentConfig(buildAssessmentConfig())
+                .resultTemplateId(1L).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        planMapper.insert(runningPlan);
+        HrmPerformancePlanDO archivedPlan = HrmPerformancePlanDO.builder()
+                .name("研发季度绩效归档").scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .assessmentTemplateId(1L).assessmentConfig(buildAssessmentConfig())
+                .resultTemplateId(1L).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        planMapper.insert(archivedPlan);
+        HrmPerformanceAssessmentDO runningAssessment = HrmPerformanceAssessmentDO.builder()
+                .planId(runningPlan.getId()).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        assessmentMapper.insert(runningAssessment);
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(archivedPlan.getId()).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build());
+
+        // 准备参数
+        HrmPortalPerformanceAssessmentPageReqVO reqVO = new HrmPortalPerformanceAssessmentPageReqVO();
+        reqVO.setPageNo(1);
+        reqVO.setPageSize(10);
+        reqVO.setSearch("研发季度");
+        reqVO.setArchived(false);
+
+        // 调用
+        PageResult<HrmPerformanceAssessmentDO> pageResult =
+                assessmentService.getPortalPerformanceAssessmentPage(reqVO, 100L);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(runningAssessment.getId(), pageResult.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetAssessmentStatusCountMapByEmployeeId() {
+        // mock 数据
+        HrmPerformancePlanDO runningPlan = HrmPerformancePlanDO.builder()
+                .name("研发季度绩效").scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .assessmentTemplateId(1L).assessmentConfig(buildAssessmentConfig())
+                .resultTemplateId(1L).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        planMapper.insert(runningPlan);
+        HrmPerformancePlanDO archivedPlan = HrmPerformancePlanDO.builder()
+                .name("研发季度绩效归档").scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .assessmentTemplateId(1L).assessmentConfig(buildAssessmentConfig())
+                .resultTemplateId(1L).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        planMapper.insert(archivedPlan);
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(runningPlan.getId()).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build());
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(archivedPlan.getId()).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build());
+
+        // 调用
+        Map<Integer, Long> countMap =
+                assessmentService.getPerformanceAssessmentStatusCountMapByEmployeeId(100L, "研发季度");
+
+        // 断言
+        assertEquals(1L, countMap.get(HrmPerformancePlanStatusEnum.RUNNING.getStatus()));
+        assertEquals(1L, countMap.get(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()));
+    }
+
+    @Test
+    public void testGetArchiveEmployeePage_distinctAndSearch() {
+        // mock 数据
+        HrmEmployeeDO matchedEmployee = HrmEmployeeDO.builder()
+                .name("研发员工").jobNumber("DEV-001").build();
+        employeeMapper.insert(matchedEmployee);
+        HrmEmployeeDO unmatchedEmployee = HrmEmployeeDO.builder()
+                .name("销售员工").jobNumber("SALE-001").build();
+        employeeMapper.insert(unmatchedEmployee);
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(matchedEmployee.getId())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build());
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(2L).employeeId(matchedEmployee.getId())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build());
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(3L).employeeId(unmatchedEmployee.getId())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build());
+
+        // 准备参数
+        HrmPerformanceArchiveEmployeePageReqVO reqVO = new HrmPerformanceArchiveEmployeePageReqVO();
+        reqVO.setPageNo(1);
+        reqVO.setPageSize(10);
+        reqVO.setSearch("DEV-001");
+
+        // 调用
+        PageResult<HrmEmployeeDO> pageResult =
+                assessmentService.getPerformanceArchiveEmployeePage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(matchedEmployee.getId(), pageResult.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetPerformanceAssessmentArchive() {
+        // mock 数据
+        HrmPerformanceAssessmentDO archivedAssessment = HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        assessmentMapper.insert(archivedAssessment);
+        HrmPerformanceAssessmentDO runningAssessment = HrmPerformanceAssessmentDO.builder()
+                .planId(2L).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        assessmentMapper.insert(runningAssessment);
+
+        // 调用，并断言
+        assertEquals(archivedAssessment.getId(),
+                assessmentService.getPerformanceAssessmentArchive(archivedAssessment.getId()).getId());
+        assertNull(assessmentService.getPerformanceAssessmentArchive(runningAssessment.getId()));
+        assertNull(assessmentService.getPerformanceAssessmentArchive(9999L));
+    }
+
+    @Test
+    public void testDeleteArchiveRecordsByEmployeeIds_onlyDeletesArchivedRecords() {
+        // mock 数据
+        HrmPerformanceAssessmentDO archivedAssessment = HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        assessmentMapper.insert(archivedAssessment);
+        HrmPerformanceAssessmentDO runningAssessment = HrmPerformanceAssessmentDO.builder()
+                .planId(2L).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        assessmentMapper.insert(runningAssessment);
+
+        // 调用
+        assessmentService.deletePerformanceArchiveRecordsByEmployeeIds(Collections.singletonList(100L));
+
+        // 断言
+        assertNull(assessmentMapper.selectById(archivedAssessment.getId()));
+        assertEquals(runningAssessment.getId(), assessmentMapper.selectById(runningAssessment.getId()).getId());
+    }
+
+    @Test
+    public void testDeleteArchiveRecords_deletesAppealRecords() {
+        // mock 数据
+        HrmPerformanceAssessmentDO assessment = HrmPerformanceAssessmentDO.builder()
+                .planId(1L).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        assessmentMapper.insert(assessment);
+        HrmPerformanceAssessmentAppealRecordDO appealRecord = new HrmPerformanceAssessmentAppealRecordDO()
+                .setAssessmentId(assessment.getId()).setStageId(1L).setStatus(0);
+        assessmentAppealRecordMapper.insert(appealRecord);
+        HrmPerformanceAssessmentDO runningAssessment = HrmPerformanceAssessmentDO.builder()
+                .planId(2L).employeeId(200L)
+                .status(HrmPerformancePlanStatusEnum.RUNNING.getStatus()).build();
+        assessmentMapper.insert(runningAssessment);
+
+        // 调用
+        assessmentService.deletePerformanceArchiveRecords(Arrays.asList(
+                assessment.getId(), runningAssessment.getId()));
+
+        // 断言
+        assertEquals(0, assessmentAppealRecordMapper.selectListByAssessmentIdAndStatus(
+                assessment.getId(), null).size());
+        assertEquals(runningAssessment.getId(),
+                assessmentMapper.selectById(runningAssessment.getId()).getId());
+    }
+
+    @Test
+    public void testGetArchivedEmployeeCoefficientMap_success() {
+        // mock 数据
+        HrmPerformancePlanDO julyPlan = HrmPerformancePlanDO.builder()
+                .name("2026-07 绩效考核").paidForMonth("2026-07")
+                .scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .assessmentTemplateId(1L).assessmentConfig(buildAssessmentConfig())
+                .resultTemplateId(1L).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        planMapper.insert(julyPlan);
+        HrmPerformancePlanDO oldJulyPlan = HrmPerformancePlanDO.builder()
+                .name("2026-07 绩效考核（旧）").paidForMonth("2026-07")
+                .scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .assessmentTemplateId(1L).assessmentConfig(buildAssessmentConfig())
+                .resultTemplateId(1L).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        planMapper.insert(oldJulyPlan);
+        HrmPerformancePlanDO augustPlan = HrmPerformancePlanDO.builder()
+                .name("2026-08 绩效考核").paidForMonth("2026-08")
+                .scopes(Collections.emptyList()).reviewStages(Collections.emptyList())
+                .assessmentTemplateId(1L).assessmentConfig(buildAssessmentConfig())
+                .resultTemplateId(1L).resultConfig(buildResultConfig())
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()).build();
+        planMapper.insert(augustPlan);
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(oldJulyPlan.getId()).employeeId(100L)
+                .status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())
+                .coefficient(new BigDecimal("0.80")).archiveTime(LocalDateTime.of(2026, 7, 10, 9, 0)).build());
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(julyPlan.getId()).employeeId(100L).status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())
+                .coefficient(new BigDecimal("1.20")).archiveTime(LocalDateTime.of(2026, 7, 31, 18, 0)).build());
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(julyPlan.getId()).employeeId(200L).status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())
+                .archiveTime(LocalDateTime.of(2026, 7, 31, 18, 0)).build());
+        assessmentMapper.insert(HrmPerformanceAssessmentDO.builder()
+                .planId(augustPlan.getId()).employeeId(100L).status(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus())
+                .coefficient(new BigDecimal("2.00")).archiveTime(LocalDateTime.of(2026, 8, 31, 18, 0)).build());
+
+        // 调用
+        Map<Long, BigDecimal> coefficientMap = assessmentService.getPerformanceArchiveEmployeeCoefficientMap(
+                Arrays.asList(julyPlan.getId(), oldJulyPlan.getId()), Arrays.asList(100L, 200L));
+
+        // 断言
+        assertEquals(2, coefficientMap.size());
+        assertEquals(new BigDecimal("1.20"), coefficientMap.get(100L));
+        assertEquals(new BigDecimal("1.00"), coefficientMap.get(200L));
+    }
+
+    @Test
+    public void testGetArchivedEmployeeCoefficientMap_emptyEmployeeIds() {
+        // 调用
+        Map<Long, BigDecimal> coefficientMap = assessmentService.getPerformanceArchiveEmployeeCoefficientMap(
+                Collections.singletonList(1L), Collections.emptyList());
+
+        // 断言
+        assertTrue(coefficientMap.isEmpty());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmPerformanceAssessmentTemplateDO.AssessmentConfig buildAssessmentConfig() {
+        return HrmPerformanceAssessmentTemplateDO.AssessmentConfig.builder()
+                .name("季度考核模板").scoreCalculation(1).upperLimitType(1)
+                .upperLimitScore(new BigDecimal("100")).dimensions(Collections.singletonList(
+                        HrmPerformanceAssessmentTemplateDO.Dimension.builder()
+                                .name("业绩").quotaType(1).weight(new BigDecimal("100"))
+                                .allowEdit(false).quotas(Collections.singletonList(
+                                        HrmPerformanceAssessmentTemplateDO.Quota.builder()
+                                                .name("目标达成率").weight(new BigDecimal("100"))
+                                                .scoreType(1).build()))
+                                .build()))
+                .build();
+    }
+
+    private ResultConfig buildResultConfig() {
+        Level level = new Level().setName("A").setMinScore(BigDecimal.ZERO)
+                .setMaxScore(new BigDecimal("100")).setCoefficient(BigDecimal.ONE);
+        return new ResultConfig().setName("默认结果模板").setLevels(Collections.singletonList(level));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateServiceImplTest.java
new file mode 100644
index 0000000..05088dc
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceAssessmentTemplateServiceImplTest.java
@@ -0,0 +1,306 @@
+package cn.iocoder.yudao.module.hrm.service.performance.config;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessmenttemplate.HrmPerformanceAssessmentTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.config.HrmPerformanceAssessmentTemplateMapper;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ASSESSMENT_TEMPLATE_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmPerformanceAssessmentTemplateServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmPerformanceAssessmentTemplateServiceImpl.class)
+public class HrmPerformanceAssessmentTemplateServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmPerformanceAssessmentTemplateServiceImpl assessmentTemplateService;
+
+    @Resource
+    private HrmPerformanceAssessmentTemplateMapper assessmentTemplateMapper;
+
+    @MockitoBean
+    private HrmPerformancePlanService performancePlanService;
+
+    @Test
+    public void testCreateAssessmentTemplate_success() {
+        // 准备参数
+        HrmPerformanceAssessmentTemplateSaveReqVO reqVO =
+                createAssessmentTemplateReqVO("季度考核模板");
+
+        // 调用
+        Long templateId = assessmentTemplateService.createPerformanceAssessmentTemplate(reqVO);
+
+        // 断言
+        assertNotNull(templateId);
+        HrmPerformanceAssessmentTemplateDO template = assessmentTemplateMapper.selectById(templateId);
+        assertEquals(reqVO.getName(), template.getName());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), template.getStatus());
+        assertEquals(2, template.getDimensionCount());
+        assertEquals(3, template.getQuotaCount());
+        assertEquals(2, template.getDimensions().size());
+        assertEquals(2, template.getDimensions().get(0).getQuotas().size());
+    }
+
+    @Test
+    public void testCreateAssessmentTemplate_nameDuplicate() {
+        // mock 数据
+        assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+        // 准备参数
+        HrmPerformanceAssessmentTemplateSaveReqVO reqVO =
+                createAssessmentTemplateReqVO("季度考核模板");
+
+        // 调用，并断言异常
+        assertServiceException(() -> assessmentTemplateService.createPerformanceAssessmentTemplate(
+                        reqVO),
+                PERFORMANCE_ASSESSMENT_TEMPLATE_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateAssessmentTemplate_success() {
+        // mock 数据
+        Long templateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+        // 准备参数
+        HrmPerformanceAssessmentTemplateSaveReqVO reqVO =
+                createAssessmentTemplateReqVO("年度考核模板");
+        reqVO.setId(templateId);
+        reqVO.setDimensions(Collections.singletonList(reqVO.getDimensions().get(0)));
+        reqVO.getDimensions().get(0).setWeight(BigDecimal.valueOf(100));
+
+        // 调用
+        assessmentTemplateService.updatePerformanceAssessmentTemplate(reqVO);
+
+        // 断言
+        HrmPerformanceAssessmentTemplateDO oldTemplate = assessmentTemplateMapper.selectById(templateId);
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(), oldTemplate.getStatus());
+        assertEquals("季度考核模板", oldTemplate.getName());
+        HrmPerformanceAssessmentTemplateDO template = assessmentTemplateMapper.selectByName(reqVO.getName());
+        assertNotNull(template);
+        assertNotEquals(templateId, template.getId());
+        assertEquals(reqVO.getName(), template.getName());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), template.getStatus());
+        assertEquals(1, template.getDimensions().size());
+        assertEquals(2, template.getDimensions().get(0).getQuotas().size());
+        assertEquals(1, template.getDimensionCount());
+        assertEquals(2, template.getQuotaCount());
+    }
+
+    @Test
+    public void testUpdateAssessmentTemplate_notExists() {
+        // 准备参数
+        HrmPerformanceAssessmentTemplateSaveReqVO reqVO =
+                createAssessmentTemplateReqVO("年度考核模板").setId(randomLongId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> assessmentTemplateService.updatePerformanceAssessmentTemplate(reqVO),
+                PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testUpdateAssessmentTemplate_disabled() {
+        // mock 数据
+        Long templateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+        assessmentTemplateMapper.updateById(new HrmPerformanceAssessmentTemplateDO()
+                .setId(templateId).setStatus(CommonStatusEnum.DISABLE.getStatus()));
+        // 准备参数
+        HrmPerformanceAssessmentTemplateSaveReqVO reqVO =
+                createAssessmentTemplateReqVO("年度考核模板").setId(templateId);
+
+        // 调用，并断言异常
+        assertServiceException(() -> assessmentTemplateService.updatePerformanceAssessmentTemplate(reqVO),
+                PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testUpdateAssessmentTemplate_usedByPlan() {
+        // mock 数据
+        Long templateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+        // 准备参数
+        HrmPerformanceAssessmentTemplateSaveReqVO reqVO =
+                createAssessmentTemplateReqVO("年度考核模板").setId(templateId);
+
+        // mock 方法：模拟模板已经被计划引用
+        when(performancePlanService.getPerformancePlanCountByAssessmentTemplateId(templateId)).thenReturn(1L);
+
+        // 调用
+        assessmentTemplateService.updatePerformanceAssessmentTemplate(reqVO);
+
+        // 断言：既有计划继续引用旧版本，新版本使用新的模板编号
+        HrmPerformanceAssessmentTemplateDO oldTemplate = assessmentTemplateMapper.selectById(templateId);
+        assertEquals("季度考核模板", oldTemplate.getName());
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(), oldTemplate.getStatus());
+        HrmPerformanceAssessmentTemplateDO newTemplate = assessmentTemplateMapper.selectByName(reqVO.getName());
+        assertNotNull(newTemplate);
+        assertNotEquals(templateId, newTemplate.getId());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), newTemplate.getStatus());
+    }
+
+    @Test
+    public void testDeleteAssessmentTemplate_success() {
+        // mock 数据
+        Long templateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+
+        // 调用
+        assessmentTemplateService.deletePerformanceAssessmentTemplate(templateId);
+
+        // 断言
+        assertNull(assessmentTemplateMapper.selectById(templateId));
+    }
+
+    @Test
+    public void testDeleteAssessmentTemplate_notExists() {
+        // 准备参数
+        Long templateId = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> assessmentTemplateService.deletePerformanceAssessmentTemplate(templateId),
+                PERFORMANCE_ASSESSMENT_TEMPLATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testDeleteAssessmentTemplate_usedByPlan() {
+        // mock 数据
+        Long templateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+        when(performancePlanService.getPerformancePlanCountByAssessmentTemplateId(templateId)).thenReturn(1L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> assessmentTemplateService.deletePerformanceAssessmentTemplate(templateId),
+                PERFORMANCE_DATA_ILLEGAL);
+    }
+
+    @Test
+    public void testDeleteAssessmentTemplateList_success() {
+        // mock 数据
+        Long firstTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+        Long secondTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("年度考核模板"));
+        // 准备参数
+        List<Long> templateIds = Arrays.asList(firstTemplateId, secondTemplateId);
+
+        // 调用
+        assessmentTemplateService.deletePerformanceAssessmentTemplateList(templateIds);
+
+        // 断言
+        assertNull(assessmentTemplateMapper.selectById(firstTemplateId));
+        assertNull(assessmentTemplateMapper.selectById(secondTemplateId));
+    }
+
+    @Test
+    public void testGetAssessmentTemplatePage() {
+        // mock 数据
+        Long oldTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("年度考核模板"));
+        Long newTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("年度管理层考核模板"));
+        Long disabledTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("已停用年度模板"));
+        assessmentTemplateMapper.updateById(new HrmPerformanceAssessmentTemplateDO()
+                .setId(disabledTemplateId).setStatus(CommonStatusEnum.DISABLE.getStatus()));
+        updateAssessmentTemplateTime(oldTemplateId, LocalDateTime.of(2026, 1, 1, 0, 0));
+        updateAssessmentTemplateTime(newTemplateId, LocalDateTime.of(2027, 1, 1, 0, 0));
+        // 准备参数
+        HrmPerformanceAssessmentTemplatePageReqVO pageReqVO = new HrmPerformanceAssessmentTemplatePageReqVO();
+        pageReqVO.setName("年度");
+
+        // 调用
+        PageResult<HrmPerformanceAssessmentTemplateDO> pageResult =
+                assessmentTemplateService.getPerformanceAssessmentTemplatePage(pageReqVO);
+
+        // 断言
+        assertEquals(2, pageResult.getTotal());
+        assertEquals(newTemplateId, pageResult.getList().get(0).getId());
+        assertEquals(oldTemplateId, pageResult.getList().get(1).getId());
+    }
+
+    @Test
+    public void testGetAssessmentTemplateListByStatus() {
+        // mock 数据
+        Long oldTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("季度考核模板"));
+        Long newTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("年度考核模板"));
+        Long disabledTemplateId = assessmentTemplateService.createPerformanceAssessmentTemplate(
+                createAssessmentTemplateReqVO("停用模板"));
+        assessmentTemplateMapper.updateById(new HrmPerformanceAssessmentTemplateDO()
+                .setId(disabledTemplateId).setStatus(CommonStatusEnum.DISABLE.getStatus()));
+        updateAssessmentTemplateTime(oldTemplateId, LocalDateTime.of(2026, 1, 1, 0, 0));
+        updateAssessmentTemplateTime(newTemplateId, LocalDateTime.of(2027, 1, 1, 0, 0));
+
+        // 调用
+        List<HrmPerformanceAssessmentTemplateDO> templates =
+                assessmentTemplateService.getPerformanceAssessmentTemplateListByStatus(
+                        CommonStatusEnum.ENABLE.getStatus());
+
+        // 断言
+        assertEquals(2, templates.size());
+        assertEquals(newTemplateId, templates.get(0).getId());
+        assertEquals(oldTemplateId, templates.get(1).getId());
+    }
+
+    // ========== 随机对象 ==========
+
+    private void updateAssessmentTemplateTime(Long id, LocalDateTime updateTime) {
+        assessmentTemplateMapper.update(null, new LambdaUpdateWrapper<HrmPerformanceAssessmentTemplateDO>()
+                .set(HrmPerformanceAssessmentTemplateDO::getUpdateTime, updateTime)
+                .eq(HrmPerformanceAssessmentTemplateDO::getId, id));
+    }
+
+    private HrmPerformanceAssessmentTemplateSaveReqVO createAssessmentTemplateReqVO(String name) {
+        return randomPojo(HrmPerformanceAssessmentTemplateSaveReqVO.class, reqVO -> reqVO.setId(null)
+                .setName(name).setIllustrate("用于季度/年度考核")
+                .setScoreCalculation(1).setUpperLimitType(1).setUpperLimitScore(BigDecimal.valueOf(100))
+                .setDimensions(Arrays.asList(
+                        dimension("业绩", 70, Arrays.asList(
+                                quota("目标达成率", 60), quota("关键项目", 40))),
+                        dimension("协作", 30,
+                                Collections.singletonList(quota("跨团队协作", 100))))));
+    }
+
+    private HrmPerformanceAssessmentTemplateSaveReqVO.Dimension dimension(
+            String name, int weight, List<HrmPerformanceAssessmentTemplateSaveReqVO.Quota> quotas) {
+        return randomPojo(HrmPerformanceAssessmentTemplateSaveReqVO.Dimension.class, dimension ->
+                dimension.setName(name).setQuotaType(1).setWeight(BigDecimal.valueOf(weight))
+                        .setRemark(null).setAllowEdit(true).setQuotas(quotas));
+    }
+
+    private HrmPerformanceAssessmentTemplateSaveReqVO.Quota quota(String name, int weight) {
+        return randomPojo(HrmPerformanceAssessmentTemplateSaveReqVO.Quota.class, quota ->
+                quota.setName(name).setIllustrate(name + "说明").setStandard("按完成质量评分")
+                        .setWeight(BigDecimal.valueOf(weight)).setScoreType(1));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateServiceImplTest.java
new file mode 100644
index 0000000..5e96e84
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/config/HrmPerformanceResultTemplateServiceImplTest.java
@@ -0,0 +1,318 @@
+package cn.iocoder.yudao.module.hrm.service.performance.config;
+
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.resulttemplate.HrmPerformanceResultTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO.Level;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.config.HrmPerformanceResultTemplateMapper;
+import com.baomidou.mybatisplus.core.conditions.update.LambdaUpdateWrapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.getFirst;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_DATA_ILLEGAL;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_RESULT_TEMPLATE_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmPerformanceResultTemplateServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmPerformanceResultTemplateServiceImpl.class)
+public class HrmPerformanceResultTemplateServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmPerformanceResultTemplateServiceImpl resultTemplateService;
+
+    @Resource
+    private HrmPerformanceResultTemplateMapper resultTemplateMapper;
+
+    @MockitoBean
+    private HrmPerformancePlanService performancePlanService;
+
+    @Test
+    public void testGetResultTemplate_notExists() {
+        assertNull(resultTemplateService.getPerformanceResultTemplate(1L));
+    }
+
+    @Test
+    public void testCreateResultTemplate_success() {
+        // 准备参数
+        HrmPerformanceResultTemplateSaveReqVO createReqVO = randomResultTemplateSaveReqVO("默认等级模板");
+
+        // 调用
+        Long templateId = resultTemplateService.createPerformanceResultTemplate(createReqVO);
+
+        // 断言
+        HrmPerformanceResultTemplateDO template = resultTemplateMapper.selectById(templateId);
+        assertEquals("默认等级模板", template.getName());
+        assertEquals(BeanUtils.toBean(createReqVO.getLevels(), Level.class), template.getLevels());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), template.getStatus());
+    }
+
+    @Test
+    public void testCreateResultTemplate_nameDuplicate() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template = randomResultTemplateDO(
+                "默认等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template);
+
+        // 准备参数
+        HrmPerformanceResultTemplateSaveReqVO createReqVO = randomResultTemplateSaveReqVO(template.getName());
+
+        // 调用，并断言异常
+        assertServiceException(() -> resultTemplateService.createPerformanceResultTemplate(createReqVO),
+                PERFORMANCE_RESULT_TEMPLATE_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateResultTemplate_success() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template = randomResultTemplateDO(
+                "默认等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template);
+
+        // 准备参数
+        HrmPerformanceResultTemplateSaveReqVO updateReqVO =
+                randomResultTemplateSaveReqVO(template.getName());
+        updateReqVO.setId(template.getId());
+        updateReqVO.setLevels(Arrays.asList(
+                randomSaveLevel("A", 80, 100, 1.2),
+                randomSaveLevel("B", 0, 79.99, 0.8)));
+
+        // 调用
+        resultTemplateService.updatePerformanceResultTemplate(updateReqVO);
+
+        // 断言
+        HrmPerformanceResultTemplateDO oldTemplate = resultTemplateMapper.selectById(template.getId());
+        assertEquals(CommonStatusEnum.DISABLE.getStatus(), oldTemplate.getStatus());
+        assertEquals("默认等级模板", oldTemplate.getName());
+        HrmPerformanceResultTemplateDO newTemplate = resultTemplateMapper.selectByName(updateReqVO.getName());
+        assertNotNull(newTemplate);
+        assertNotEquals(template.getId(), newTemplate.getId());
+        assertEquals(BeanUtils.toBean(updateReqVO.getLevels(), Level.class), newTemplate.getLevels());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), newTemplate.getStatus());
+    }
+
+    @Test
+    public void testUpdateResultTemplate_nameDuplicate() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template01 = randomResultTemplateDO(
+                "季度等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template01);
+        HrmPerformanceResultTemplateDO template02 = randomResultTemplateDO(
+                "年度等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template02);
+
+        // 准备参数
+        HrmPerformanceResultTemplateSaveReqVO updateReqVO =
+                randomResultTemplateSaveReqVO(template02.getName());
+        updateReqVO.setId(template01.getId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> resultTemplateService.updatePerformanceResultTemplate(updateReqVO),
+                PERFORMANCE_RESULT_TEMPLATE_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateResultTemplate_notExists() {
+        // 准备参数
+        HrmPerformanceResultTemplateSaveReqVO updateReqVO = randomResultTemplateSaveReqVO("绩效等级模板");
+        updateReqVO.setId(1L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> resultTemplateService.updatePerformanceResultTemplate(updateReqVO),
+                PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testUpdateResultTemplate_disabled() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template = randomResultTemplateDO(
+                "默认等级模板", CommonStatusEnum.DISABLE.getStatus());
+        resultTemplateMapper.insert(template);
+        // 准备参数
+        HrmPerformanceResultTemplateSaveReqVO updateReqVO = randomResultTemplateSaveReqVO("新等级模板");
+        updateReqVO.setId(template.getId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> resultTemplateService.updatePerformanceResultTemplate(updateReqVO),
+                PERFORMANCE_RESULT_TEMPLATE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testDeleteResultTemplate_success() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template = randomResultTemplateDO(
+                "默认等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template);
+
+        // 调用
+        resultTemplateService.deletePerformanceResultTemplate(template.getId());
+
+        // 断言
+        assertNull(resultTemplateMapper.selectById(template.getId()));
+    }
+
+    @Test
+    public void testDeleteResultTemplate_usedByPlan() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template = randomResultTemplateDO(
+                "默认等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template);
+
+        // mock 方法
+        when(performancePlanService.getPerformancePlanCountByResultTemplateId(template.getId())).thenReturn(1L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> resultTemplateService.deletePerformanceResultTemplate(template.getId()),
+                PERFORMANCE_DATA_ILLEGAL);
+        assertEquals(template.getName(), resultTemplateMapper.selectById(template.getId()).getName());
+    }
+
+    @Test
+    public void testDeleteResultTemplateList_success() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template01 = randomResultTemplateDO(
+                "季度等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template01);
+        HrmPerformanceResultTemplateDO template02 = randomResultTemplateDO(
+                "年度等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template02);
+
+        // 调用
+        resultTemplateService.deletePerformanceResultTemplateList(
+                Arrays.asList(template01.getId(), template02.getId()));
+
+        // 断言
+        assertNull(resultTemplateMapper.selectById(template01.getId()));
+        assertNull(resultTemplateMapper.selectById(template02.getId()));
+    }
+
+    @Test
+    public void testDeleteResultTemplateList_usedByPlan() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template01 = randomResultTemplateDO(
+                "季度等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template01);
+        HrmPerformanceResultTemplateDO template02 = randomResultTemplateDO(
+                "年度等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template02);
+
+        // mock 方法
+        when(performancePlanService.getPerformancePlanCountByResultTemplateId(template02.getId())).thenReturn(1L);
+
+        // 调用，并断言异常：批量删除失败时，已处理的模板也不能被删除
+        assertServiceException(() -> resultTemplateService.deletePerformanceResultTemplateList(
+                Arrays.asList(template01.getId(), template02.getId())), PERFORMANCE_DATA_ILLEGAL);
+        assertEquals(template01.getName(), resultTemplateMapper.selectById(template01.getId()).getName());
+        assertEquals(template02.getName(), resultTemplateMapper.selectById(template02.getId()).getName());
+    }
+
+    @Test
+    public void testGetResultTemplatePage() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO template01 = randomResultTemplateDO(
+                "季度等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(template01);
+        HrmPerformanceResultTemplateDO template02 = randomResultTemplateDO(
+                "季度停用等级模板", CommonStatusEnum.DISABLE.getStatus());
+        resultTemplateMapper.insert(template02);
+
+        // 准备参数
+        HrmPerformanceResultTemplatePageReqVO pageReqVO = new HrmPerformanceResultTemplatePageReqVO();
+        pageReqVO.setName("季度");
+
+        // 调用
+        PageResult<HrmPerformanceResultTemplateDO> pageResult =
+                resultTemplateService.getPerformanceResultTemplatePage(pageReqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(template01.getId(), getFirst(pageResult.getList()).getId());
+    }
+
+    @Test
+    public void testGetResultTemplateList() {
+        // mock 数据
+        HrmPerformanceResultTemplateDO enableTemplate = randomResultTemplateDO(
+                "启用等级模板", CommonStatusEnum.ENABLE.getStatus());
+        resultTemplateMapper.insert(enableTemplate);
+        HrmPerformanceResultTemplateDO disableTemplate = randomResultTemplateDO(
+                "停用等级模板", CommonStatusEnum.DISABLE.getStatus());
+        resultTemplateMapper.insert(disableTemplate);
+        updateResultTemplateTime(enableTemplate.getId(), LocalDateTime.of(2027, 1, 1, 0, 0));
+        updateResultTemplateTime(disableTemplate.getId(), LocalDateTime.of(2026, 1, 1, 0, 0));
+
+        // 调用
+        List<HrmPerformanceResultTemplateDO> enableTemplates =
+                resultTemplateService.getPerformanceResultTemplateList(CommonStatusEnum.ENABLE.getStatus());
+        List<HrmPerformanceResultTemplateDO> allTemplates =
+                resultTemplateService.getPerformanceResultTemplateList(null);
+
+        // 断言
+        assertEquals(1, enableTemplates.size());
+        assertEquals(enableTemplate.getId(), getFirst(enableTemplates).getId());
+        assertEquals(2, allTemplates.size());
+        assertEquals(enableTemplate.getId(), getFirst(allTemplates).getId());
+    }
+
+    // ========== 随机对象 ==========
+
+    private void updateResultTemplateTime(Long id, LocalDateTime updateTime) {
+        resultTemplateMapper.update(null, new LambdaUpdateWrapper<HrmPerformanceResultTemplateDO>()
+                .set(HrmPerformanceResultTemplateDO::getUpdateTime, updateTime)
+                .eq(HrmPerformanceResultTemplateDO::getId, id));
+    }
+
+    private HrmPerformanceResultTemplateSaveReqVO randomResultTemplateSaveReqVO(String name) {
+        return randomPojo(HrmPerformanceResultTemplateSaveReqVO.class, reqVO -> reqVO.setId(null)
+                .setName(name).setLevels(Arrays.asList(
+                        randomSaveLevel("A", 90, 100, 1.2),
+                        randomSaveLevel("B", 80, 89.99, 1.1),
+                        randomSaveLevel("C", 0, 79.99, 0.8))));
+    }
+
+    private HrmPerformanceResultTemplateDO randomResultTemplateDO(String name, Integer status) {
+        return randomPojo(HrmPerformanceResultTemplateDO.class, template -> template.setId(null)
+                .setName(name).setStatus(status).setLevels(Arrays.asList(
+                        randomLevel("A", 90, 100, 1.2),
+                        randomLevel("B", 80, 89.99, 1.1),
+                        randomLevel("C", 0, 79.99, 0.8))).setCreator("1"));
+    }
+
+    private Level randomLevel(String name, double minScore, double maxScore, double coefficient) {
+        return randomPojo(Level.class, level -> level.setName(name)
+                .setMinScore(BigDecimal.valueOf(minScore)).setMaxScore(BigDecimal.valueOf(maxScore))
+                .setCoefficient(BigDecimal.valueOf(coefficient)));
+    }
+
+    private HrmPerformanceResultTemplateSaveReqVO.Level randomSaveLevel(
+            String name, double minScore, double maxScore, double coefficient) {
+        return randomPojo(HrmPerformanceResultTemplateSaveReqVO.Level.class, level -> level.setName(name)
+                .setMinScore(BigDecimal.valueOf(minScore)).setMaxScore(BigDecimal.valueOf(maxScore))
+                .setCoefficient(BigDecimal.valueOf(coefficient)));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanServiceImplTest.java
new file mode 100644
index 0000000..46d560f
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/performance/plan/HrmPerformancePlanServiceImplTest.java
@@ -0,0 +1,657 @@
+package cn.iocoder.yudao.module.hrm.service.performance.plan;
+
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentService;
+import cn.iocoder.yudao.module.hrm.service.performance.config.HrmPerformanceAssessmentTemplateService;
+import cn.iocoder.yudao.module.hrm.service.performance.config.HrmPerformanceResultTemplateService;
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.assessment.HrmPerformanceAssessmentBatchReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.performance.vo.plan.HrmPerformancePlanSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceAssessmentTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.HandlerStage;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ResultConfig;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.ReviewStage;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO.Scope;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.config.HrmPerformanceResultTemplateDO.Level;
+import cn.iocoder.yudao.module.hrm.dal.mysql.performance.plan.HrmPerformancePlanMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanOperationTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanScopeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformancePlanStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceQuotaSettingTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceRaterTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewScoringTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceReviewVisibleContentEnum;
+import cn.iocoder.yudao.module.hrm.enums.performance.plan.HrmPerformanceStageTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Objects;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_PLAN_STATUS_NOT_ALLOW_DELETE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.PERFORMANCE_STAGE_ACTION_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.clearInvocations;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmPerformancePlanServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmPerformancePlanServiceImpl.class)
+public class HrmPerformancePlanServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmPerformancePlanServiceImpl planService;
+
+    @Resource
+    private HrmPerformancePlanMapper planMapper;
+
+    @MockitoBean
+    private HrmPerformanceAssessmentService assessmentService;
+    @MockitoBean
+    private HrmPerformanceAssessmentTemplateService assessmentTemplateService;
+    @MockitoBean
+    private HrmPerformanceResultTemplateService resultTemplateService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private DeptApi deptApi;
+
+    @Test
+    public void testCreatePlan_success() {
+        // 准备参数
+        HrmPerformancePlanSaveReqVO reqVO = buildPlanSaveReqVO("季度绩效计划", 200L);
+        CollUtil.getFirst(reqVO.getAssessmentConfig().getDimensions()).setName("计划专用业绩");
+
+        // 调用
+        Long planId = planService.createPerformancePlan(reqVO);
+
+        // 断言
+        HrmPerformancePlanDO plan = planMapper.selectById(planId);
+        assertEquals(HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), plan.getStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.NOT_STARTED.getType(), plan.getStageType());
+        assertNull(plan.getOperationType());
+        assertEquals(true, plan.getResultAudit());
+        assertEquals(true, plan.getResultConfirmation());
+        assertEquals("季度考核模板", plan.getAssessmentConfig().getName());
+        assertEquals("业绩",
+                CollUtil.getFirst(plan.getAssessmentConfig().getDimensions()).getName());
+        assertEquals("季度结果模板", plan.getResultConfig().getName());
+        verify(assessmentTemplateService).validatePerformanceAssessmentTemplateEnabled(
+                reqVO.getAssessmentTemplateId());
+        verify(resultTemplateService).validatePerformanceResultTemplateEnabled(
+                reqVO.getResultTemplateId());
+        verify(assessmentService).addPerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(planId, actualPlan.getId())), eq(Collections.singletonList(200L)));
+    }
+
+    @Test
+    public void testCreatePlan_scopeIntersectionNoMatch() {
+        // mock 方法
+        when(employeeService.getEmployeeList(any())).thenReturn(Collections.emptyList());
+        // 准备参数
+        HrmPerformancePlanSaveReqVO reqVO = buildPlanSaveReqVO("考评范围交集为空", 200L);
+        HrmPerformancePlanSaveReqVO.Scope employmentScope = new HrmPerformancePlanSaveReqVO.Scope()
+                .setType(HrmPerformancePlanScopeTypeEnum.EMPLOYMENT.getType())
+                .setEmployeeType(HrmEmployeeTypeEnum.FORMAL.getType())
+                .setEmployeeStatuses(Collections.singletonList(HrmEmployeeStatusEnum.REGULAR.getStatus()));
+        reqVO.setScopes(Arrays.asList(CollUtil.getFirst(reqVO.getScopes()), employmentScope));
+
+        // 调用
+        Long planId = planService.createPerformancePlan(reqVO);
+
+        // 断言
+        verify(assessmentService).addPerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(planId, actualPlan.getId())), eq(Collections.emptyList()));
+    }
+
+    @Test
+    public void testUpdatePlan_success() {
+        // mock 数据
+        HrmPerformancePlanDO dbPlan = buildPlan(
+                "季度绩效计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(dbPlan);
+        // 准备参数
+        HrmPerformancePlanSaveReqVO reqVO =
+                buildPlanSaveReqVO("年度绩效计划", 200L, 201L).setId(dbPlan.getId());
+
+        // 调用
+        planService.updatePerformancePlan(reqVO);
+
+        // 断言
+        HrmPerformancePlanDO plan = planMapper.selectById(dbPlan.getId());
+        assertEquals(reqVO.getName(), plan.getName());
+        assertEquals(dbPlan.getStatus(), plan.getStatus());
+        verify(resultTemplateService).validatePerformanceResultTemplateExists(reqVO.getResultTemplateId());
+        verify(assessmentService).syncPerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(plan.getId(), actualPlan.getId())
+                        && Objects.equals(plan.getName(), actualPlan.getName())),
+                eq(Arrays.asList(200L, 201L)));
+    }
+
+    @Test
+    public void testUpdatePlan_changeAssessmentTemplate() {
+        // mock 数据
+        HrmPerformancePlanDO dbPlan = buildPlan(
+                "季度绩效计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(dbPlan);
+        HrmPerformanceAssessmentTemplateDO newTemplate = buildAssessmentTemplate().setId(101L);
+        when(assessmentTemplateService.validatePerformanceAssessmentTemplateEnabled(newTemplate.getId()))
+                .thenReturn(newTemplate);
+        // 准备参数
+        HrmPerformancePlanSaveReqVO reqVO =
+                buildPlanSaveReqVO("年度绩效计划", 200L).setId(dbPlan.getId())
+                        .setAssessmentTemplateId(newTemplate.getId());
+
+        // 调用
+        planService.updatePerformancePlan(reqVO);
+
+        // 断言
+        HrmPerformancePlanDO plan = planMapper.selectById(dbPlan.getId());
+        assertEquals(newTemplate.getId(), plan.getAssessmentTemplateId());
+        verify(assessmentTemplateService).validatePerformanceAssessmentTemplateEnabled(newTemplate.getId());
+    }
+
+    @Test
+    public void testUpdatePlan_changeResultTemplate() {
+        // mock 数据
+        HrmPerformancePlanDO dbPlan = buildPlan(
+                "季度绩效计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(dbPlan);
+        HrmPerformanceResultTemplateDO newTemplate = buildResultTemplate().setId(201L);
+        when(resultTemplateService.validatePerformanceResultTemplateEnabled(newTemplate.getId()))
+                .thenReturn(newTemplate);
+        // 准备参数
+        HrmPerformancePlanSaveReqVO reqVO =
+                buildPlanSaveReqVO("年度绩效计划", 200L).setId(dbPlan.getId())
+                        .setResultTemplateId(newTemplate.getId());
+
+        // 调用
+        planService.updatePerformancePlan(reqVO);
+
+        // 断言
+        HrmPerformancePlanDO plan = planMapper.selectById(dbPlan.getId());
+        assertEquals(newTemplate.getId(), plan.getResultTemplateId());
+        verify(resultTemplateService).validatePerformanceResultTemplateEnabled(newTemplate.getId());
+    }
+
+    @Test
+    public void testUpdatePlan_keepsExcludedEmployees() {
+        // mock 数据
+        HrmPerformancePlanDO dbPlan = buildPlan(
+                "季度绩效计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L, 201L);
+        dbPlan.setScopes(Arrays.asList(
+                CollUtil.getFirst(dbPlan.getScopes()),
+                new Scope().setType(HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType())
+                        .setEmployeeIds(Collections.singletonList(200L))));
+        planMapper.insert(dbPlan);
+        // 准备参数
+        HrmPerformancePlanSaveReqVO reqVO =
+                buildPlanSaveReqVO("年度绩效计划", 200L, 201L).setId(dbPlan.getId());
+
+        // 调用
+        planService.updatePerformancePlan(reqVO);
+
+        // 断言
+        HrmPerformancePlanDO plan = planMapper.selectById(dbPlan.getId());
+        Scope excludedScope = CollUtil.findOne(plan.getScopes(), scope -> Objects.equals(
+                scope.getType(), HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType()));
+        assertEquals(Collections.singletonList(200L), excludedScope.getEmployeeIds());
+        verify(assessmentService).syncPerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(plan.getId(), actualPlan.getId())),
+                eq(Collections.singletonList(201L)));
+    }
+
+    @Test
+    public void testDeletePlan_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "已归档计划", HrmPerformancePlanStatusEnum.ARCHIVED.getStatus(), 200L);
+        planMapper.insert(plan);
+
+        // 调用
+        planService.deletePerformancePlan(plan.getId());
+
+        // 断言
+        assertNull(planMapper.selectById(plan.getId()));
+        verify(assessmentService).deletePerformanceAssessmentListByPlanId(plan.getId());
+    }
+
+    @Test
+    public void testDeletePlan_running() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "进行中计划", HrmPerformancePlanStatusEnum.RUNNING.getStatus(), 200L);
+        planMapper.insert(plan);
+
+        // 调用，并断言异常
+        assertServiceException(() -> planService.deletePerformancePlan(plan.getId()),
+                PERFORMANCE_PLAN_STATUS_NOT_ALLOW_DELETE);
+        verify(assessmentService, never()).deletePerformanceAssessmentListByPlanId(plan.getId());
+    }
+
+    @Test
+    public void testAddAssessments_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待添加员工计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(plan);
+        // 准备参数
+        HrmPerformanceAssessmentBatchReqVO reqVO = new HrmPerformanceAssessmentBatchReqVO()
+                .setPlanId(plan.getId()).setEmployeeIds(Collections.singletonList(201L));
+
+        // 调用
+        planService.addPerformancePlanEmployees(reqVO);
+
+        // 断言
+        verify(employeeService).validateEmployeeListExists(reqVO.getEmployeeIds());
+        verify(assessmentService).addPerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(plan.getId(), actualPlan.getId())), eq(reqVO.getEmployeeIds()));
+    }
+
+    @Test
+    public void testAddAssessments_persistsIncludedEmployeeForStart() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待添加范围外员工计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(plan);
+        when(assessmentService.startPerformanceAssessmentList(any(HrmPerformancePlanDO.class)))
+                .thenReturn(HrmPerformanceStageTypeEnum.EXECUTING.getType());
+        HrmPerformanceAssessmentBatchReqVO reqVO = new HrmPerformanceAssessmentBatchReqVO()
+                .setPlanId(plan.getId()).setEmployeeIds(Collections.singletonList(201L));
+
+        // 调用
+        planService.addPerformancePlanEmployees(reqVO);
+
+        // 断言额外员工已写入普通员工范围，不依赖当前考核明细反推范围
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        Scope employeeScope = CollUtil.findOne(updatedPlan.getScopes(), scope -> Objects.equals(
+                scope.getType(), HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType()));
+        assertEquals(Arrays.asList(200L, 201L), employeeScope.getEmployeeIds());
+        clearInvocations(assessmentService);
+
+        // 再次调用启动计划，并断言范围包含原范围和额外员工
+        planService.startPerformancePlan(plan.getId());
+        verify(assessmentService).addPerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(plan.getId(), actualPlan.getId())), eq(Arrays.asList(200L, 201L)));
+    }
+
+    @Test
+    public void testRemoveAssessments_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待移除员工计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L, 201L);
+        planMapper.insert(plan);
+        // 准备参数
+        HrmPerformanceAssessmentBatchReqVO reqVO = new HrmPerformanceAssessmentBatchReqVO()
+                .setPlanId(plan.getId()).setEmployeeIds(Collections.singletonList(200L));
+
+        // 调用
+        planService.removePerformancePlanEmployees(reqVO);
+
+        // 断言
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        Scope excludedScope = CollUtil.findOne(updatedPlan.getScopes(), scope -> Objects.equals(
+                scope.getType(), HrmPerformancePlanScopeTypeEnum.EXCLUDED_EMPLOYEE.getType()));
+        assertEquals(reqVO.getEmployeeIds(), excludedScope.getEmployeeIds());
+        verify(assessmentService).deletePerformanceAssessmentList(plan.getId(), reqVO.getEmployeeIds());
+    }
+
+    @Test
+    public void testRemoveAssessments_emptyEmployeeIds() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待移除员工计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(plan);
+        // 准备参数
+        HrmPerformanceAssessmentBatchReqVO reqVO = new HrmPerformanceAssessmentBatchReqVO()
+                .setPlanId(plan.getId()).setEmployeeIds(Collections.emptyList());
+
+        // 调用
+        planService.removePerformancePlanEmployees(reqVO);
+
+        // 断言
+        verify(assessmentService, never()).deletePerformanceAssessmentList(
+                eq(plan.getId()), any());
+    }
+
+    @Test
+    public void testStartPlan_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待启动计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(plan);
+        when(assessmentService.startPerformanceAssessmentList(any(HrmPerformancePlanDO.class)))
+                .thenReturn(HrmPerformanceStageTypeEnum.EXECUTING.getType());
+
+        // 调用
+        planService.startPerformancePlan(plan.getId());
+
+        // 断言
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        assertEquals(HrmPerformancePlanStatusEnum.RUNNING.getStatus(), updatedPlan.getStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.EXECUTING.getType(), updatedPlan.getStageType());
+        assertEquals(HrmPerformancePlanOperationTypeEnum.START_SCORING.getType(),
+                updatedPlan.getOperationType());
+        verify(assessmentService).addPerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(plan.getId(), actualPlan.getId())), eq(Collections.singletonList(200L)));
+    }
+
+    @Test
+    public void testOpenScoring_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待开启评分计划", HrmPerformancePlanStatusEnum.RUNNING.getStatus(), 200L);
+        planMapper.insert(plan);
+        when(assessmentService.openPerformanceAssessmentScoring(any(HrmPerformancePlanDO.class)))
+                .thenReturn(HrmPerformanceStageTypeEnum.SELF_SCORE.getType());
+
+        // 调用
+        planService.openPerformancePlanScoring(plan.getId());
+
+        // 断言
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        assertEquals(HrmPerformanceStageTypeEnum.SELF_SCORE.getType(), updatedPlan.getStageType());
+        assertNull(updatedPlan.getOperationType());
+    }
+
+    @Test
+    public void testStartPerformancePlanInterview_withResultConfirmation() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待发起面谈计划", HrmPerformancePlanStatusEnum.RUNNING.getStatus(), 200L);
+        plan.setResultConfirmation(true);
+        planMapper.insert(plan);
+        when(assessmentService.startPerformanceAssessmentInterview(any(HrmPerformancePlanDO.class)))
+                .thenReturn(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType());
+
+        // 调用
+        planService.startPerformancePlanInterview(plan.getId());
+
+        // 断言
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        assertEquals(HrmPerformanceStageTypeEnum.RESULT_CONFIRM.getType(), updatedPlan.getStageType());
+        assertNull(updatedPlan.getOperationType());
+    }
+
+    @Test
+    public void testStartPerformancePlanInterview_withoutResultConfirmation() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "无需结果确认计划", HrmPerformancePlanStatusEnum.RUNNING.getStatus(), 200L);
+        plan.setResultConfirmation(false);
+        planMapper.insert(plan);
+        when(assessmentService.startPerformanceAssessmentInterview(any(HrmPerformancePlanDO.class)))
+                .thenReturn(HrmPerformanceStageTypeEnum.END.getType());
+
+        // 调用
+        planService.startPerformancePlanInterview(plan.getId());
+
+        // 断言
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        assertEquals(HrmPerformanceStageTypeEnum.END.getType(), updatedPlan.getStageType());
+        assertEquals(HrmPerformancePlanOperationTypeEnum.ARCHIVE.getType(),
+                updatedPlan.getOperationType());
+    }
+
+    @Test
+    public void testArchivePlan_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待归档计划", HrmPerformancePlanStatusEnum.RUNNING.getStatus(), 200L);
+        planMapper.insert(plan);
+
+        // 调用
+        planService.archivePerformancePlan(plan.getId());
+
+        // 断言
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        assertEquals(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus(), updatedPlan.getStatus());
+        assertEquals(HrmPerformanceStageTypeEnum.ARCHIVED.getType(), updatedPlan.getStageType());
+        assertNull(updatedPlan.getOperationType());
+        verify(assessmentService).archivePerformanceAssessmentList(argThat(actualPlan ->
+                Objects.equals(plan.getId(), actualPlan.getId())));
+    }
+
+    @Test
+    public void testTerminatePlan_success() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "待终止计划", HrmPerformancePlanStatusEnum.RUNNING.getStatus(), 200L);
+        planMapper.insert(plan);
+
+        // 调用
+        planService.terminatePerformancePlan(1L, plan.getId());
+
+        // 断言
+        HrmPerformancePlanDO updatedPlan = planMapper.selectById(plan.getId());
+        assertEquals(HrmPerformancePlanStatusEnum.TERMINATED.getStatus(), updatedPlan.getStatus());
+        assertNull(updatedPlan.getOperationType());
+        assertNotNull(updatedPlan.getTerminateTime());
+        verify(assessmentService).terminatePerformanceAssessmentListByPlanId(plan.getId(), null);
+    }
+
+    @Test
+    public void testTerminatePlan_notRunning() {
+        // mock 数据
+        HrmPerformancePlanDO plan = buildPlan(
+                "未开始计划", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus(), 200L);
+        planMapper.insert(plan);
+
+        // 调用，并断言异常
+        assertServiceException(() -> planService.terminatePerformancePlan(1L, plan.getId()),
+                PERFORMANCE_STAGE_ACTION_INVALID);
+        verify(assessmentService, never()).terminatePerformanceAssessmentListByPlanId(any(), any());
+    }
+
+    @Test
+    public void testGetPlanStatusCount() {
+        // mock 数据
+        planMapper.insert(buildPlan(
+                "研发季度考核", HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus()));
+        planMapper.insert(buildPlan(
+                "研发月度考核", HrmPerformancePlanStatusEnum.RUNNING.getStatus()));
+        // 测试 name 不匹配
+        planMapper.insert(buildPlan(
+                "销售季度考核", HrmPerformancePlanStatusEnum.ARCHIVED.getStatus()));
+        // 准备参数
+        HrmPerformancePlanPageReqVO reqVO = new HrmPerformancePlanPageReqVO();
+        reqVO.setName("研发");
+        reqVO.setStatus(HrmPerformancePlanStatusEnum.ARCHIVED.getStatus());
+
+        // 调用
+        Map<Integer, Long> countMap = planService.getPerformancePlanStatusCount(reqVO);
+
+        // 断言
+        assertEquals(2, countMap.size());
+        assertEquals(1L, countMap.get(HrmPerformancePlanStatusEnum.NOT_STARTED.getStatus()));
+        assertEquals(1L, countMap.get(HrmPerformancePlanStatusEnum.RUNNING.getStatus()));
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmPerformancePlanSaveReqVO buildPlanSaveReqVO(String name, Long... employeeIds) {
+        HrmPerformanceAssessmentTemplateDO template = buildAssessmentTemplate();
+        when(assessmentTemplateService.validatePerformanceAssessmentTemplateExists(template.getId()))
+                .thenReturn(template);
+        when(assessmentTemplateService.validatePerformanceAssessmentTemplateEnabled(template.getId()))
+                .thenReturn(template);
+        HrmPerformanceResultTemplateDO resultTemplate = buildResultTemplate();
+        when(resultTemplateService.validatePerformanceResultTemplateExists(resultTemplate.getId()))
+                .thenReturn(resultTemplate);
+        when(resultTemplateService.validatePerformanceResultTemplateEnabled(resultTemplate.getId()))
+                .thenReturn(resultTemplate);
+        HrmPerformancePlanSaveReqVO.Scope scope = new HrmPerformancePlanSaveReqVO.Scope()
+                .setType(HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType())
+                .setEmployeeIds(Arrays.asList(employeeIds));
+        HrmPerformancePlanSaveReqVO reqVO = new HrmPerformancePlanSaveReqVO();
+        reqVO.setName(name);
+        reqVO.setAssessmentTemplateId(template.getId());
+        reqVO.setAssessmentConfig(buildAssessmentTemplateSaveConfig());
+        reqVO.setResultTemplateId(resultTemplate.getId());
+        reqVO.setResultConfig(buildResultSaveConfig(resultTemplate.getName()));
+        reqVO.setResultAuditStages(Collections.singletonList(buildHandlerStage()));
+        reqVO.setAppealStages(Collections.singletonList(buildHandlerStage()));
+        reqVO.setAppealTimeoutDays(2);
+        reqVO.setAppealTimeoutAction(1);
+        reqVO.setScopes(Collections.singletonList(scope));
+        fillPlanProcessConfig(reqVO);
+        return reqVO;
+    }
+
+    private HrmPerformancePlanDO buildPlan(String name, Integer status, Long... employeeIds) {
+        Scope scope = new Scope().setType(HrmPerformancePlanScopeTypeEnum.EMPLOYEE_DEPT.getType())
+                .setEmployeeIds(Arrays.asList(employeeIds));
+        return HrmPerformancePlanDO.builder().name(name).assessmentTemplateId(100L)
+                .assessmentConfig(buildAssessmentTemplateConfig())
+                .scopes(Collections.singletonList(scope)).reviewStages(buildReviewStages())
+                .resultTemplateId(200L).resultConfig(buildResultConfig("季度结果模板"))
+                .resultAudit(true).resultConfirmation(true)
+                .appealTimeoutDays(2).appealTimeoutAction(1)
+                .status(status).stageType(HrmPerformanceStageTypeEnum.NOT_STARTED.getType()).build();
+    }
+
+    private static void fillPlanProcessConfig(HrmPerformancePlanSaveReqVO reqVO) {
+        reqVO.setCycleType(HrmPerformanceCycleTypeEnum.MONTH.getType());
+        reqVO.setQuotaSettingType(HrmPerformanceQuotaSettingTypeEnum.SYSTEM.getType());
+        reqVO.setTargetConfirmation(false);
+        reqVO.setReviewStages(buildReviewSaveStages());
+        reqVO.setResultAudit(true);
+        reqVO.setResultConfirmation(true);
+        reqVO.setSyncToSalary(false);
+    }
+
+    private static List<ReviewStage> buildReviewStages() {
+        ReviewStage selfStage = new ReviewStage();
+        selfStage.setName("员工自评");
+        selfStage.setRater(new HandlerStage().setType(HrmPerformanceRaterTypeEnum.SELF.getType()));
+        selfStage.setWeight(BigDecimal.valueOf(30));
+        selfStage.setScoringType(HrmPerformanceReviewScoringTypeEnum.QUOTA.getType());
+        selfStage.setVisibleContent(HrmPerformanceReviewVisibleContentEnum.ALL.getContent());
+        selfStage.setRequiredSetting(false);
+        selfStage.setRejectAuthority(false);
+
+        ReviewStage superiorStage = new ReviewStage();
+        superiorStage.setName("直属上级评分");
+        superiorStage.setRater(new HandlerStage()
+                .setType(HrmPerformanceRaterTypeEnum.SUPERIOR.getType()).setLevel(1));
+        superiorStage.setWeight(BigDecimal.valueOf(70));
+        superiorStage.setScoringType(HrmPerformanceReviewScoringTypeEnum.QUOTA.getType());
+        superiorStage.setVisibleContent(HrmPerformanceReviewVisibleContentEnum.ALL.getContent());
+        superiorStage.setRequiredSetting(true);
+        superiorStage.setRejectAuthority(true);
+        return Arrays.asList(selfStage, superiorStage);
+    }
+
+    private static List<HrmPerformancePlanSaveReqVO.ReviewStage> buildReviewSaveStages() {
+        HrmPerformancePlanSaveReqVO.ReviewStage selfStage =
+                new HrmPerformancePlanSaveReqVO.ReviewStage();
+        selfStage.setName("员工自评");
+        selfStage.setRater(new HrmPerformancePlanSaveReqVO.HandlerStage()
+                .setType(HrmPerformanceRaterTypeEnum.SELF.getType()));
+        selfStage.setWeight(BigDecimal.valueOf(30));
+        selfStage.setScoringType(HrmPerformanceReviewScoringTypeEnum.QUOTA.getType());
+        selfStage.setVisibleContent(HrmPerformanceReviewVisibleContentEnum.ALL.getContent());
+        selfStage.setRequiredSetting(false);
+        selfStage.setRejectAuthority(false);
+
+        HrmPerformancePlanSaveReqVO.ReviewStage superiorStage =
+                new HrmPerformancePlanSaveReqVO.ReviewStage();
+        superiorStage.setName("直属上级评分");
+        superiorStage.setRater(new HrmPerformancePlanSaveReqVO.HandlerStage()
+                .setType(HrmPerformanceRaterTypeEnum.SUPERIOR.getType()).setLevel(1));
+        superiorStage.setWeight(BigDecimal.valueOf(70));
+        superiorStage.setScoringType(HrmPerformanceReviewScoringTypeEnum.QUOTA.getType());
+        superiorStage.setVisibleContent(HrmPerformanceReviewVisibleContentEnum.ALL.getContent());
+        superiorStage.setRequiredSetting(true);
+        superiorStage.setRejectAuthority(true);
+        return Arrays.asList(selfStage, superiorStage);
+    }
+
+    private static HrmPerformanceAssessmentTemplateDO buildAssessmentTemplate() {
+        HrmPerformanceAssessmentTemplateDO.AssessmentConfig config =
+                buildAssessmentTemplateConfig();
+        return HrmPerformanceAssessmentTemplateDO.builder().id(100L).name(config.getName())
+                .scoreCalculation(config.getScoreCalculation())
+                .upperLimitType(config.getUpperLimitType())
+                .upperLimitScore(config.getUpperLimitScore())
+                .dimensions(config.getDimensions()).build();
+    }
+
+    private static HrmPerformanceAssessmentTemplateDO.AssessmentConfig buildAssessmentTemplateConfig() {
+        HrmPerformanceAssessmentTemplateDO.Quota quota =
+                HrmPerformanceAssessmentTemplateDO.Quota.builder()
+                        .name("目标达成率").standard("按完成质量评分")
+                        .weight(BigDecimal.valueOf(100)).scoreType(1).build();
+        HrmPerformanceAssessmentTemplateDO.Dimension dimension =
+                HrmPerformanceAssessmentTemplateDO.Dimension.builder()
+                        .name("业绩").quotaType(1).weight(BigDecimal.valueOf(100))
+                        .allowEdit(false).quotas(Collections.singletonList(quota)).build();
+        return HrmPerformanceAssessmentTemplateDO.AssessmentConfig.builder()
+                .name("季度考核模板").scoreCalculation(1).upperLimitType(1)
+                .upperLimitScore(BigDecimal.valueOf(100))
+                .dimensions(Collections.singletonList(dimension)).build();
+    }
+
+    private static HrmPerformancePlanSaveReqVO.AssessmentConfig buildAssessmentTemplateSaveConfig() {
+        return BeanUtils.toBean(buildAssessmentTemplateConfig(),
+                HrmPerformancePlanSaveReqVO.AssessmentConfig.class);
+    }
+
+    private static HrmPerformanceResultTemplateDO buildResultTemplate() {
+        return HrmPerformanceResultTemplateDO.builder().id(200L).name("季度结果模板")
+                .levels(buildResultLevels()).build();
+    }
+
+    private static ResultConfig buildResultConfig(String name) {
+        return ResultConfig.builder().name(name).levels(buildResultLevels()).build();
+    }
+
+    private static HrmPerformancePlanSaveReqVO.ResultConfig buildResultSaveConfig(String name) {
+        return BeanUtils.toBean(buildResultConfig(name), HrmPerformancePlanSaveReqVO.ResultConfig.class);
+    }
+
+    private static HrmPerformancePlanSaveReqVO.HandlerStage buildHandlerStage() {
+        return new HrmPerformancePlanSaveReqVO.HandlerStage()
+                .setType(HrmPerformanceRaterTypeEnum.SUPERIOR.getType()).setLevel(1);
+    }
+
+    private static List<Level> buildResultLevels() {
+        return Arrays.asList(
+                Level.builder().name("A").minScore(BigDecimal.valueOf(90))
+                        .maxScore(BigDecimal.valueOf(100))
+                        .coefficient(BigDecimal.valueOf(1.2)).build(),
+                Level.builder().name("B").minScore(BigDecimal.valueOf(80))
+                        .maxScore(BigDecimal.valueOf(89.99))
+                        .coefficient(BigDecimal.ONE).build(),
+                Level.builder().name("C").minScore(BigDecimal.ZERO)
+                        .maxScore(BigDecimal.valueOf(79.99))
+                        .coefficient(BigDecimal.valueOf(0.8)).build());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateServiceImplTest.java
new file mode 100644
index 0000000..846064e
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitCandidateServiceImplTest.java
@@ -0,0 +1,792 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.candidate;
+
+import cn.iocoder.yudao.module.hrm.service.recruit.config.HrmRecruitChannelService;
+import cn.iocoder.yudao.module.hrm.service.recruit.post.HrmRecruitPostService;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateEntryReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidatePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateChannelReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateEliminateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdatePostReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.candidate.HrmRecruitCandidateUpdateStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.candidate.HrmRecruitCandidateMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.candidate.HrmRecruitInterviewMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.post.HrmRecruitPostMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDateTime;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.cloneIgnoreId;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.*;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_CANDIDATE_CONVERTED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_CONVERT_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_DELETE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_ELIMINATE_STATUS_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_HAS_EMPLOYEE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_CANDIDATE_STATUS_TRANSITION_INVALID;
+import static java.util.Arrays.asList;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.singletonList;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+/**
+ * {@link HrmRecruitCandidateServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmRecruitCandidateServiceImpl.class)
+public class HrmRecruitCandidateServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmRecruitCandidateServiceImpl recruitCandidateService;
+
+    @Resource
+    private HrmRecruitCandidateMapper recruitCandidateMapper;
+    @Resource
+    private HrmRecruitPostMapper recruitPostMapper;
+    @Resource
+    private HrmRecruitInterviewMapper recruitInterviewMapper;
+
+    @MockitoBean
+    private HrmRecruitPostService recruitPostService;
+    @MockitoBean
+    private HrmRecruitChannelService recruitChannelService;
+    @MockitoBean
+    private HrmRecruitInterviewService recruitInterviewService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testCreateRecruitCandidate_success() {
+        // 准备参数
+        HrmRecruitCandidateSaveReqVO reqVO = randomRecruitCandidateSaveReqVO();
+        // mock 方法
+        when(recruitPostService.validateRecruitPostExists(eq(reqVO.getPostId())))
+                .thenReturn(randomRecruitPostDO(o -> o.setId(reqVO.getPostId())));
+        when(recruitChannelService.validateRecruitChannelExists(eq(reqVO.getChannelId())))
+                .thenReturn(randomPojo(HrmRecruitChannelDO.class, o -> o.setId(reqVO.getChannelId())));
+
+        // 调用
+        Long candidateId = recruitCandidateService.createRecruitCandidate(reqVO);
+
+        // 断言
+        assertNotNull(candidateId);
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(candidateId);
+        assertPojoEquals(reqVO, candidate, "id");
+        assertEquals(HrmRecruitCandidateStatusEnum.NEW.getStatus(), candidate.getStatus());
+        assertEquals(0, candidate.getStageNumber());
+        assertNotNull(candidate.getStatusUpdateTime());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidate_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+        // 准备参数
+        HrmRecruitCandidateSaveReqVO reqVO = randomRecruitCandidateSaveReqVO(o -> o.setId(dbCandidate.getId()));
+        // mock 方法
+        when(recruitPostService.validateRecruitPostExists(eq(reqVO.getPostId())))
+                .thenReturn(randomRecruitPostDO(o -> o.setId(reqVO.getPostId())));
+        when(recruitChannelService.validateRecruitChannelExists(eq(reqVO.getChannelId())))
+                .thenReturn(randomPojo(HrmRecruitChannelDO.class, o -> o.setId(reqVO.getChannelId())));
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidate(reqVO);
+
+        // 断言
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(dbCandidate.getId());
+        assertPojoEquals(reqVO, candidate);
+    }
+
+    @Test
+    public void testUpdateRecruitCandidate_clearOptionalFieldsAndKeepEntryTime() {
+        // mock 数据
+        LocalDateTime entryTime = LocalDateTime.of(2026, 7, 1, 9, 0);
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO(o -> o.setEntryTime(entryTime));
+        recruitCandidateMapper.insert(dbCandidate);
+        // 准备参数
+        HrmRecruitCandidateSaveReqVO reqVO = randomRecruitCandidateSaveReqVO(o -> o
+                .setId(dbCandidate.getId()).setAge(null).setEmail(null).setWorkTime(null)
+                .setGraduateSchool(null).setLatestWorkPlace(null).setChannelId(null)
+                .setRemark(null).setResumeUrls(null));
+        when(recruitPostService.validateRecruitPostExists(eq(reqVO.getPostId())))
+                .thenReturn(randomRecruitPostDO(o -> o.setId(reqVO.getPostId())));
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidate(reqVO);
+
+        // 断言
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(dbCandidate.getId());
+        assertNull(candidate.getAge());
+        assertNull(candidate.getEmail());
+        assertNull(candidate.getWorkTime());
+        assertNull(candidate.getGraduateSchool());
+        assertNull(candidate.getLatestWorkPlace());
+        assertNull(candidate.getChannelId());
+        assertNull(candidate.getRemark());
+        assertNull(candidate.getResumeUrls());
+        assertEquals(entryTime, candidate.getEntryTime());
+        assertEquals(dbCandidate.getStatus(), candidate.getStatus());
+    }
+
+    @Test
+    public void testDeleteRecruitCandidate_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+
+        // 调用
+        recruitCandidateService.deleteRecruitCandidate(dbCandidate.getId());
+
+        // 断言
+        assertNull(recruitCandidateMapper.selectById(dbCandidate.getId()));
+        verify(recruitInterviewService).deleteRecruitInterviewByCandidateId(dbCandidate.getId());
+    }
+
+    @Test
+    public void testDeleteRecruitCandidate_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitCandidateService.deleteRecruitCandidate(id),
+                RECRUIT_CANDIDATE_NOT_EXISTS);
+        verifyNoInteractions(recruitInterviewService);
+    }
+
+    @Test
+    public void testDeleteRecruitCandidate_hasEmployee() {
+        // mock 数据
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO(
+                o -> o.setStatus(HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus()));
+        recruitCandidateMapper.insert(candidate);
+        when(employeeService.getEmployeeByCandidateId(candidate.getId()))
+                .thenReturn(new HrmEmployeeDO().setId(randomLongId()).setCandidateId(candidate.getId()));
+
+        // 调用、断言
+        assertServiceException(() -> recruitCandidateService.deleteRecruitCandidate(candidate.getId()),
+                RECRUIT_CANDIDATE_HAS_EMPLOYEE);
+        assertNotNull(recruitCandidateMapper.selectById(candidate.getId()));
+        verifyNoInteractions(recruitInterviewService);
+    }
+
+    @Test
+    public void testDeleteRecruitCandidate_statusInvalid() {
+        // mock 数据
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO(
+                o -> o.setStatus(HrmRecruitCandidateStatusEnum.OFFER_SENT.getStatus()));
+        recruitCandidateMapper.insert(candidate);
+
+        // 调用、断言
+        assertServiceException(() -> recruitCandidateService.deleteRecruitCandidate(candidate.getId()),
+                RECRUIT_CANDIDATE_DELETE_STATUS_INVALID);
+        assertNotNull(recruitCandidateMapper.selectById(candidate.getId()));
+        verifyNoInteractions(recruitInterviewService, employeeService);
+    }
+
+    @Test
+    public void testGetRecruitCandidate() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+
+        // 调用
+        HrmRecruitCandidateDO candidate = recruitCandidateService.getRecruitCandidate(dbCandidate.getId());
+
+        // 断言
+        assertPojoEquals(dbCandidate, candidate);
+    }
+
+    @Test
+    public void testGetRecruitCandidate_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用
+        HrmRecruitCandidateDO candidate = recruitCandidateService.getRecruitCandidate(id);
+
+        // 断言
+        assertNull(candidate);
+    }
+
+    @Test
+    public void testGetRecruitCandidatePage_joinFilters() {
+        // mock 职位数据
+        HrmRecruitPostDO targetPost = randomRecruitPostDO(o -> o.setOwnerEmployeeId(100L));
+        recruitPostMapper.insert(targetPost);
+        HrmRecruitPostDO otherOwnerPost = cloneIgnoreId(targetPost, o -> o.setOwnerEmployeeId(200L));
+        recruitPostMapper.insert(otherOwnerPost);
+        // mock 候选人及面试数据
+        LocalDateTime interviewTime = LocalDateTime.of(2026, 7, 17, 10, 0);
+        HrmRecruitCandidateDO targetCandidate = randomRecruitCandidateDO(o -> o
+                .setPostId(targetPost.getId()).setStageNumber(2)
+                .setStatus(HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus()));
+        recruitCandidateMapper.insert(targetCandidate);
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(targetCandidate.getId()).setStageNumber(2)
+                .setInterviewEmployeeId(10L).setInterviewTime(interviewTime)));
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(targetCandidate.getId()).setStageNumber(2)
+                .setInterviewEmployeeId(11L).setOtherInterviewEmployeeIds(singletonList(10L))
+                .setInterviewTime(interviewTime.plusHours(1))
+                .setResult(HrmRecruitInterviewResultEnum.PASS.getResult())));
+        // 测试面试轮次不匹配
+        HrmRecruitCandidateDO historyOnlyCandidate = cloneIgnoreId(targetCandidate, o -> o.setName("历史轮次"));
+        recruitCandidateMapper.insert(historyOnlyCandidate);
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(historyOnlyCandidate.getId()).setStageNumber(1)
+                .setInterviewEmployeeId(10L).setInterviewTime(interviewTime)));
+        // 测试面试已取消
+        HrmRecruitCandidateDO canceledCandidate = cloneIgnoreId(targetCandidate, o -> o.setName("面试取消"));
+        recruitCandidateMapper.insert(canceledCandidate);
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(canceledCandidate.getId()).setStageNumber(2)
+                .setInterviewEmployeeId(10L).setInterviewTime(interviewTime)
+                .setResult(HrmRecruitInterviewResultEnum.CANCEL.getResult())));
+        // 测试招聘负责人不匹配
+        HrmRecruitCandidateDO otherOwnerCandidate = cloneIgnoreId(targetCandidate,
+                o -> o.setName("负责人不匹配").setPostId(otherOwnerPost.getId()));
+        recruitCandidateMapper.insert(otherOwnerCandidate);
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(otherOwnerCandidate.getId()).setStageNumber(2)
+                .setInterviewEmployeeId(10L).setInterviewTime(interviewTime)));
+        // 准备参数
+        HrmRecruitCandidatePageReqVO reqVO = new HrmRecruitCandidatePageReqVO()
+                .setOwnerEmployeeId(100L).setInterviewEmployeeId(10L)
+                .setInterviewTime(new LocalDateTime[]{interviewTime.minusDays(1), interviewTime.plusDays(1)});
+
+        // 调用
+        PageResult<HrmRecruitCandidateDO> pageResult = recruitCandidateService.getRecruitCandidatePage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(1, pageResult.getList().size());
+        assertPojoEquals(targetCandidate, pageResult.getList().get(0));
+    }
+
+    @Test
+    public void testUpdateRecruitCandidateInterview_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+        // 准备参数
+        Integer stageNumber = 2;
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidateInterview(dbCandidate.getId(), stageNumber);
+
+        // 断言
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(dbCandidate.getId());
+        assertEquals(HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus(), candidate.getStatus());
+        assertEquals(stageNumber, candidate.getStageNumber());
+        assertNotNull(candidate.getStatusUpdateTime());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidateStatusByInterviewResult_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+        // 准备参数
+        Integer status = HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus();
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidateStatusByInterviewResult(dbCandidate.getId(), status);
+
+        // 断言
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(dbCandidate.getId());
+        assertEquals(status, candidate.getStatus());
+        assertNotNull(candidate.getStatusUpdateTime());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidateStatus_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+        // 准备参数
+        HrmRecruitCandidateUpdateStatusReqVO reqVO = randomPojo(HrmRecruitCandidateUpdateStatusReqVO.class, o -> o
+                .setId(dbCandidate.getId()).setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus()));
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidateStatus(reqVO);
+
+        // 断言
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(dbCandidate.getId());
+        assertEquals(reqVO.getStatus(), candidate.getStatus());
+        assertNotNull(candidate.getStatusUpdateTime());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidateStatus_cannotJumpToInterview() {
+        // mock 数据
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(candidate);
+        HrmRecruitCandidateUpdateStatusReqVO reqVO = new HrmRecruitCandidateUpdateStatusReqVO()
+                .setId(candidate.getId()).setStatus(HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus());
+
+        // 调用、断言
+        assertServiceException(() -> recruitCandidateService.updateRecruitCandidateStatus(reqVO),
+                RECRUIT_CANDIDATE_STATUS_TRANSITION_INVALID,
+                HrmRecruitCandidateStatusEnum.INTERVIEW.getName());
+        assertEquals(HrmRecruitCandidateStatusEnum.NEW.getStatus(),
+                recruitCandidateMapper.selectById(candidate.getId()).getStatus());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidateStatus_sameJoinedStatus() {
+        // mock 数据
+        LocalDateTime entryTime = LocalDateTime.of(2026, 6, 1, 9, 0);
+        LocalDateTime statusUpdateTime = LocalDateTime.of(2026, 7, 1, 10, 0);
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus())
+                .setEntryTime(entryTime).setStatusUpdateTime(statusUpdateTime));
+        recruitCandidateMapper.insert(candidate);
+        HrmRecruitCandidateUpdateStatusReqVO reqVO = new HrmRecruitCandidateUpdateStatusReqVO()
+                .setId(candidate.getId()).setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus());
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidateStatus(reqVO);
+
+        // 断言
+        HrmRecruitCandidateDO dbCandidate = recruitCandidateMapper.selectById(candidate.getId());
+        assertEquals(entryTime, dbCandidate.getEntryTime());
+        assertEquals(statusUpdateTime, dbCandidate.getStatusUpdateTime());
+    }
+
+    @Test
+    public void testConfirmRecruitCandidateEntry_success() {
+        // mock 数据
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus()));
+        recruitCandidateMapper.insert(candidate);
+        LocalDateTime entryTime = LocalDateTime.now().minusMinutes(1);
+
+        // 调用
+        recruitCandidateService.confirmRecruitCandidateEntry(candidate.getId(), entryTime);
+
+        // 断言
+        HrmRecruitCandidateDO dbCandidate = recruitCandidateMapper.selectById(candidate.getId());
+        assertEquals(HrmRecruitCandidateStatusEnum.JOINED.getStatus(), dbCandidate.getStatus());
+        assertEquals(entryTime, dbCandidate.getEntryTime());
+        assertNotNull(dbCandidate.getStatusUpdateTime());
+    }
+
+    @Test
+    public void testConfirmRecruitCandidateEntry_statusInvalid() {
+        // mock 数据
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.OFFER_SENT.getStatus()));
+        recruitCandidateMapper.insert(candidate);
+
+        // 调用、断言
+        assertServiceException(() -> recruitCandidateService.confirmRecruitCandidateEntry(
+                        candidate.getId(), LocalDateTime.now()),
+                RECRUIT_CANDIDATE_STATUS_TRANSITION_INVALID,
+                HrmRecruitCandidateStatusEnum.JOINED.getName());
+        assertEquals(HrmRecruitCandidateStatusEnum.OFFER_SENT.getStatus(),
+                recruitCandidateMapper.selectById(candidate.getId()).getStatus());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidatePost_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+        HrmRecruitPostDO recruitPost = randomRecruitPostDO();
+        // 准备参数
+        HrmRecruitCandidateUpdatePostReqVO reqVO = randomPojo(HrmRecruitCandidateUpdatePostReqVO.class, o -> o
+                .setId(dbCandidate.getId()).setPostId(recruitPost.getId()));
+        // mock 方法
+        when(recruitPostService.validateRecruitPostExists(eq(reqVO.getPostId()))).thenReturn(recruitPost);
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidatePost(reqVO);
+
+        // 断言
+        assertEquals(reqVO.getPostId(), recruitCandidateMapper.selectById(dbCandidate.getId()).getPostId());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidateChannel_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO();
+        recruitCandidateMapper.insert(dbCandidate);
+        HrmRecruitChannelDO recruitChannel = randomPojo(HrmRecruitChannelDO.class);
+        // 准备参数
+        HrmRecruitCandidateUpdateChannelReqVO reqVO = randomPojo(HrmRecruitCandidateUpdateChannelReqVO.class, o -> o
+                .setId(dbCandidate.getId()).setChannelId(recruitChannel.getId()));
+        // mock 方法
+        when(recruitChannelService.validateRecruitChannelExists(eq(reqVO.getChannelId()))).thenReturn(recruitChannel);
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidateChannel(reqVO);
+
+        // 断言
+        assertEquals(reqVO.getChannelId(), recruitCandidateMapper.selectById(dbCandidate.getId()).getChannelId());
+    }
+
+    @Test
+    public void testUpdateRecruitCandidateChannelByChannelId_success() {
+        // mock 数据
+        HrmRecruitCandidateDO firstCandidate = randomRecruitCandidateDO(o -> o.setChannelId(10L));
+        recruitCandidateMapper.insert(firstCandidate);
+        HrmRecruitCandidateDO secondCandidate = randomRecruitCandidateDO(o -> o.setChannelId(10L));
+        recruitCandidateMapper.insert(secondCandidate);
+        // 测试招聘渠道不匹配
+        HrmRecruitCandidateDO retainedCandidate = randomRecruitCandidateDO(o -> o.setChannelId(30L));
+        recruitCandidateMapper.insert(retainedCandidate);
+
+        // 调用
+        recruitCandidateService.updateRecruitCandidateChannelByChannelId(10L, 20L);
+
+        // 断言
+        assertEquals(20L, recruitCandidateMapper.selectById(firstCandidate.getId()).getChannelId());
+        assertEquals(20L, recruitCandidateMapper.selectById(secondCandidate.getId()).getChannelId());
+        assertEquals(30L, recruitCandidateMapper.selectById(retainedCandidate.getId()).getChannelId());
+    }
+
+    @Test
+    public void testEliminateRecruitCandidate_success() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus()));
+        recruitCandidateMapper.insert(dbCandidate);
+        HrmEmployeeDO employee = randomPojo(HrmEmployeeDO.class);
+        when(employeeService.getEmployeeByCandidateId(eq(dbCandidate.getId()))).thenReturn(employee);
+        // 准备参数
+        HrmRecruitCandidateUpdateEliminateReqVO reqVO = randomPojo(HrmRecruitCandidateUpdateEliminateReqVO.class,
+                o -> o.setId(dbCandidate.getId()));
+
+        // 调用
+        recruitCandidateService.eliminateRecruitCandidate(reqVO);
+
+        // 断言
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(dbCandidate.getId());
+        assertEquals(HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus(), candidate.getStatus());
+        assertEquals(reqVO.getEliminate(), candidate.getEliminate());
+        assertEquals(reqVO.getRemark(), candidate.getRemark());
+        verify(recruitInterviewService).finishCurrentRecruitInterviewForElimination(
+                dbCandidate.getId(), reqVO.getEliminate());
+        verify(employeeService).deleteEmployee(employee.getId());
+    }
+
+    @Test
+    public void testEliminateRecruitCandidate_joinedStatusInvalid() {
+        // mock 数据
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus()));
+        recruitCandidateMapper.insert(candidate);
+        HrmRecruitCandidateUpdateEliminateReqVO reqVO = randomPojo(
+                HrmRecruitCandidateUpdateEliminateReqVO.class, o -> o.setId(candidate.getId()));
+
+        // 调用、断言
+        assertServiceException(() -> recruitCandidateService.eliminateRecruitCandidate(reqVO),
+                RECRUIT_CANDIDATE_ELIMINATE_STATUS_INVALID);
+        verifyNoInteractions(recruitInterviewService, employeeService);
+    }
+
+    @Test
+    public void testConvertRecruitCandidateToEmployee_success() {
+        // mock 数据
+        HrmRecruitPostDO recruitPost = randomRecruitPostDO(o -> o
+                .setPostName("Java 开发工程师").setDeptId(100L).setAreaId(310100));
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO(o -> o
+                .setName("张三").setPostId(recruitPost.getId()).setChannelId(10L)
+                .setStatus(HrmRecruitCandidateStatusEnum.OFFER_SENT.getStatus()));
+        recruitCandidateMapper.insert(dbCandidate);
+        // 准备参数
+        HrmRecruitCandidateEntryReqVO reqVO = randomRecruitCandidateEntryReqVO(dbCandidate.getId());
+        reqVO.setChannelId(20L);
+        Long employeeId = randomLongId();
+        // mock 方法
+        when(recruitPostService.validateRecruitPostExists(eq(recruitPost.getId()))).thenReturn(recruitPost);
+        when(employeeService.createEmployee(any())).thenReturn(employeeId);
+
+        // 调用
+        Long result = recruitCandidateService.convertRecruitCandidateToEmployee(reqVO);
+
+        // 断言
+        assertEquals(employeeId, result);
+        ArgumentCaptor<HrmEmployeeSaveReqVO> employeeCaptor = ArgumentCaptor.forClass(HrmEmployeeSaveReqVO.class);
+        verify(employeeService).createEmployee(employeeCaptor.capture());
+        HrmEmployeeSaveReqVO employeeReqVO = employeeCaptor.getValue();
+        assertEquals(reqVO.getName(), employeeReqVO.getName());
+        assertEquals(reqVO.getJobNumber(), employeeReqVO.getJobNumber());
+        assertEquals(reqVO.getEntryTime(), employeeReqVO.getEntryTime());
+        assertEquals(reqVO.getCompanyAgeStartTime(), employeeReqVO.getCompanyAgeStartTime());
+        assertEquals(reqVO.getDeptId(), employeeReqVO.getDeptId());
+        assertEquals(reqVO.getPostName(), employeeReqVO.getPostName());
+        assertEquals(reqVO.getWorkCity(), employeeReqVO.getWorkCity());
+        assertEquals(dbCandidate.getChannelId(), employeeReqVO.getChannelId());
+        assertEquals(dbCandidate.getId(), employeeReqVO.getCandidateId());
+        assertNull(employeeReqVO.getId());
+        HrmRecruitCandidateDO candidate = recruitCandidateMapper.selectById(dbCandidate.getId());
+        assertEquals(HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus(), candidate.getStatus());
+        assertEquals(reqVO.getEntryTime(), candidate.getEntryTime());
+    }
+
+    @Test
+    public void testConvertRecruitCandidateToEmployee_converted() {
+        // mock 数据
+        HrmRecruitCandidateDO dbCandidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.OFFER_SENT.getStatus()));
+        recruitCandidateMapper.insert(dbCandidate);
+        when(employeeService.getEmployeeByCandidateId(eq(dbCandidate.getId())))
+                .thenReturn(randomPojo(HrmEmployeeDO.class));
+        // 准备参数
+        HrmRecruitCandidateEntryReqVO reqVO = randomRecruitCandidateEntryReqVO(dbCandidate.getId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitCandidateService.convertRecruitCandidateToEmployee(reqVO),
+                EMPLOYEE_CANDIDATE_CONVERTED);
+        verify(employeeService, never()).createEmployee(any());
+        verifyNoInteractions(recruitPostService);
+    }
+
+    @Test
+    public void testConvertRecruitCandidateToEmployee_statusInvalid() {
+        // mock 数据
+        HrmRecruitCandidateDO candidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.NEW.getStatus()));
+        recruitCandidateMapper.insert(candidate);
+        HrmRecruitCandidateEntryReqVO reqVO = randomRecruitCandidateEntryReqVO(candidate.getId());
+
+        // 调用、断言
+        assertServiceException(() -> recruitCandidateService.convertRecruitCandidateToEmployee(reqVO),
+                RECRUIT_CANDIDATE_CONVERT_STATUS_INVALID);
+        verifyNoInteractions(employeeService, recruitPostService);
+    }
+
+    @Test
+    public void testGetRecruitCandidateList() {
+        // mock 数据
+        LocalDateTime now = LocalDateTime.of(2026, 7, 17, 12, 0);
+        HrmRecruitCandidateDO expiredCandidate = randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())
+                .setStatusUpdateTime(now.minusDays(5)));
+        recruitCandidateMapper.insert(expiredCandidate);
+        // 测试状态时间不匹配
+        recruitCandidateMapper.insert(cloneIgnoreId(expiredCandidate,
+                o -> o.setStatusUpdateTime(now.minusDays(1))));
+        // 测试候选人状态不匹配
+        recruitCandidateMapper.insert(cloneIgnoreId(expiredCandidate,
+                o -> o.setStatus(HrmRecruitCandidateStatusEnum.NEW.getStatus())));
+        // 准备参数
+        List<Integer> statuses = singletonList(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus());
+        LocalDateTime statusUpdateTime = now.minusDays(3);
+
+        // 调用
+        List<HrmRecruitCandidateDO> candidates = recruitCandidateService.getRecruitCandidateList(
+                statuses, statusUpdateTime);
+
+        // 断言
+        assertEquals(1, candidates.size());
+        assertPojoEquals(expiredCandidate, candidates.get(0));
+    }
+
+    @Test
+    public void testGetRecruitCandidateList_emptyStatuses() {
+        // mock 数据
+        recruitCandidateMapper.insert(randomRecruitCandidateDO());
+
+        // 调用
+        List<HrmRecruitCandidateDO> candidates = recruitCandidateService.getRecruitCandidateList(
+                emptyList(), randomLocalDateTime());
+
+        // 断言
+        assertTrue(candidates.isEmpty());
+    }
+
+    @Test
+    public void testGetJoinedCandidateCountMap() {
+        // mock 数据
+        Long javaPostId = randomLongId();
+        Long productPostId = randomLongId();
+        Long testPostId = randomLongId();
+        recruitCandidateMapper.insert(randomRecruitCandidateDO(o -> o
+                .setPostId(javaPostId).setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus())));
+        recruitCandidateMapper.insert(randomRecruitCandidateDO(o -> o
+                .setPostId(javaPostId).setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus())));
+        // 测试候选人状态不匹配
+        recruitCandidateMapper.insert(randomRecruitCandidateDO(o -> o
+                .setPostId(javaPostId).setStatus(HrmRecruitCandidateStatusEnum.PENDING_ENTRY.getStatus())));
+        recruitCandidateMapper.insert(randomRecruitCandidateDO(o -> o
+                .setPostId(productPostId).setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus())));
+
+        // 调用
+        Map<Long, Long> countMap = recruitCandidateService.getJoinedCandidateCountMap(
+                asList(javaPostId, productPostId, testPostId));
+
+        // 断言
+        assertEquals(2L, countMap.get(javaPostId));
+        assertEquals(1L, countMap.get(productPostId));
+        assertNull(countMap.get(testPostId));
+    }
+
+    @Test
+    public void testGetJoinedCandidateCountMap_emptyPostIds() {
+        // mock 数据
+        recruitCandidateMapper.insert(randomRecruitCandidateDO(o -> o
+                .setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus())));
+
+        // 调用
+        Map<Long, Long> countMap = recruitCandidateService.getJoinedCandidateCountMap(emptyList());
+
+        // 断言
+        assertTrue(countMap.isEmpty());
+    }
+
+    @Test
+    public void testGetRecruitCandidateStatusCount() {
+        // mock 职位数据
+        HrmRecruitPostDO targetPost = randomRecruitPostDO(o -> o.setOwnerEmployeeId(100L));
+        recruitPostMapper.insert(targetPost);
+        HrmRecruitPostDO otherOwnerPost = cloneIgnoreId(targetPost, o -> o.setOwnerEmployeeId(200L));
+        recruitPostMapper.insert(otherOwnerPost);
+        // mock 候选人数据
+        Long targetChannelId = randomLongId();
+        Long otherChannelId = randomLongId();
+        HrmRecruitCandidateDO targetCandidate = randomRecruitCandidateDO(o -> o
+                .setPostId(targetPost.getId()).setChannelId(targetChannelId)
+                .setStatus(HrmRecruitCandidateStatusEnum.NEW.getStatus()));
+        recruitCandidateMapper.insert(targetCandidate);
+        recruitCandidateMapper.insert(cloneIgnoreId(targetCandidate, o -> {}));
+        recruitCandidateMapper.insert(cloneIgnoreId(targetCandidate,
+                o -> o.setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())));
+        // 测试招聘渠道不匹配
+        recruitCandidateMapper.insert(cloneIgnoreId(targetCandidate,
+                o -> o.setChannelId(otherChannelId).setStatus(HrmRecruitCandidateStatusEnum.JOINED.getStatus())));
+        // 测试招聘负责人不匹配
+        recruitCandidateMapper.insert(cloneIgnoreId(targetCandidate, o -> o
+                .setPostId(otherOwnerPost.getId()).setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())));
+        // 准备参数，状态条件不影响分组统计
+        HrmRecruitCandidatePageReqVO reqVO = new HrmRecruitCandidatePageReqVO()
+                .setChannelId(targetChannelId).setOwnerEmployeeId(100L)
+                .setStatus(HrmRecruitCandidateStatusEnum.NEW.getStatus());
+
+        // 调用
+        Map<Integer, Long> countMap = recruitCandidateService.getRecruitCandidateStatusCount(reqVO);
+
+        // 断言
+        assertEquals(2L, countMap.get(HrmRecruitCandidateStatusEnum.NEW.getStatus()));
+        assertEquals(1L, countMap.get(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus()));
+        assertNull(countMap.get(HrmRecruitCandidateStatusEnum.JOINED.getStatus()));
+    }
+
+    @Test
+    public void testGetRecruitCandidateStatusCount_interviewDistinct() {
+        // mock 数据
+        LocalDateTime interviewTime = LocalDateTime.of(2026, 7, 17, 10, 0);
+        HrmRecruitCandidateDO newCandidate = randomRecruitCandidateDO(o -> o
+                .setStageNumber(1).setStatus(HrmRecruitCandidateStatusEnum.NEW.getStatus()));
+        recruitCandidateMapper.insert(newCandidate);
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(newCandidate.getId()).setStageNumber(1)
+                .setInterviewEmployeeId(10L).setInterviewTime(interviewTime)));
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(newCandidate.getId()).setStageNumber(1)
+                .setInterviewEmployeeId(10L).setInterviewTime(interviewTime.plusHours(1))
+                .setResult(HrmRecruitInterviewResultEnum.PASS.getResult())));
+        HrmRecruitCandidateDO passedCandidate = randomRecruitCandidateDO(o -> o
+                .setStageNumber(1).setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus()));
+        recruitCandidateMapper.insert(passedCandidate);
+        recruitInterviewMapper.insert(randomRecruitInterviewDO(o -> o
+                .setCandidateId(passedCandidate.getId()).setStageNumber(1)
+                .setInterviewEmployeeId(10L).setInterviewTime(interviewTime)));
+        // 准备参数
+        HrmRecruitCandidatePageReqVO reqVO = new HrmRecruitCandidatePageReqVO()
+                .setInterviewEmployeeId(10L)
+                .setInterviewTime(new LocalDateTime[]{interviewTime.minusDays(1), interviewTime.plusDays(1)});
+
+        // 调用
+        Map<Integer, Long> countMap = recruitCandidateService.getRecruitCandidateStatusCount(reqVO);
+
+        // 断言
+        assertEquals(1L, countMap.get(HrmRecruitCandidateStatusEnum.NEW.getStatus()));
+        assertEquals(1L, countMap.get(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus()));
+    }
+
+    // ========== 随机对象 ==========
+
+    @SafeVarargs
+    private static HrmRecruitCandidateDO randomRecruitCandidateDO(Consumer<HrmRecruitCandidateDO>... consumers) {
+        Consumer<HrmRecruitCandidateDO> consumer = o -> o
+                .setName(randomString()).setMobile(randomMobile()).setSex(1).setAge(28).setEmail(randomEmail())
+                .setStageNumber(0).setWorkTime(5).setEducation(5)
+                .setStatus(HrmRecruitCandidateStatusEnum.NEW.getStatus())
+                .setEliminate(null).setStatusUpdateTime(randomLocalDateTime()).setEntryTime(null)
+                .setResumeUrls(singletonList(randomURL()));
+        return randomPojo(HrmRecruitCandidateDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmRecruitPostDO randomRecruitPostDO(Consumer<HrmRecruitPostDO>... consumers) {
+        Consumer<HrmRecruitPostDO> consumer = o -> o
+                .setPostName(randomString()).setDeptId(randomLongId()).setAreaId(310100).setRecruitNum(1)
+                .setJobNature(1).setWorkTime(1).setEducationRequire(1)
+                .setMinSalary(new BigDecimal("10000.00")).setMaxSalary(new BigDecimal("20000.00")).setSalaryUnit(2)
+                .setMinAge(22).setMaxAge(35).setEmergencyLevel(2)
+                .setOwnerEmployeeId(null).setInterviewEmployeeIds(emptyList())
+                .setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus()).setStopReason(null);
+        return randomPojo(HrmRecruitPostDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmRecruitInterviewDO randomRecruitInterviewDO(Consumer<HrmRecruitInterviewDO>... consumers) {
+        Consumer<HrmRecruitInterviewDO> consumer = o -> o.setType(1).setStageNumber(1)
+                .setOtherInterviewEmployeeIds(emptyList())
+                .setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult());
+        return randomPojo(HrmRecruitInterviewDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmRecruitCandidateSaveReqVO randomRecruitCandidateSaveReqVO(
+            Consumer<HrmRecruitCandidateSaveReqVO>... consumers) {
+        Consumer<HrmRecruitCandidateSaveReqVO> consumer = o -> o.setId(null)
+                .setName(randomString()).setMobile(randomMobile()).setSex(1).setAge(28).setEmail(randomEmail())
+                .setPostId(randomLongId()).setWorkTime(5).setEducation(5)
+                .setChannelId(randomLongId()).setResumeUrls(singletonList(randomURL()));
+        return randomPojo(HrmRecruitCandidateSaveReqVO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    private static HrmRecruitCandidateEntryReqVO randomRecruitCandidateEntryReqVO(Long candidateId) {
+        return randomPojo(HrmRecruitCandidateEntryReqVO.class, o -> o
+                .setCandidateId(candidateId).setId(randomLongId()).setName("张三").setMobile(randomMobile())
+                .setJobNumber(null).setEntryTime(LocalDateTime.of(2026, 8, 1, 9, 30))
+                .setCompanyAgeStartTime(LocalDateTime.of(2026, 8, 1, 9, 30))
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus())
+                .setStatus(2).setType(1).setProbation(6)
+                .setDeptId(100L).setPostName("Java 开发工程师").setWorkCity("上海市 上海市")
+                .setChannelId(10L));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewServiceImplTest.java
new file mode 100644
index 0000000..4c6dde4
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/candidate/HrmRecruitInterviewServiceImplTest.java
@@ -0,0 +1,550 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.candidate;
+
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewResultReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.interview.HrmRecruitInterviewSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitCandidateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.candidate.HrmRecruitInterviewDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.candidate.HrmRecruitInterviewMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitCandidateStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.candidate.HrmRecruitInterviewResultEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.system.api.notify.dto.NotifySendSingleToUserReqDTO;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.*;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_FINISHED;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_NOT_CURRENT;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_RESULT_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_INTERVIEW_STATE_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.MessageTemplateConstants.RECRUIT_INTERVIEW_ARRANGED;
+import static java.util.Arrays.asList;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.emptyMap;
+import static java.util.Collections.singleton;
+import static java.util.Collections.singletonList;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.*;
+
+/**
+ * {@link HrmRecruitInterviewServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmRecruitInterviewServiceImpl.class)
+public class HrmRecruitInterviewServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmRecruitInterviewServiceImpl recruitInterviewService;
+
+    @Resource
+    private HrmRecruitInterviewMapper recruitInterviewMapper;
+
+    @MockitoBean
+    private HrmRecruitCandidateService recruitCandidateService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    @Test
+    public void testCreateRecruitInterview_success() {
+        // mock 数据
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewDO firstInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(candidateId).setStageNumber(1)
+                .setResult(HrmRecruitInterviewResultEnum.PASS.getResult()));
+        recruitInterviewMapper.insert(firstInterview);
+        // 准备参数
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setCandidateId(candidateId).setStageNumber(null));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(candidateId)))
+                .thenReturn(randomPojo(HrmRecruitCandidateDO.class, o -> o.setId(candidateId)
+                        .setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(emptyMap());
+
+        // 调用
+        Long interviewId = recruitInterviewService.createRecruitInterview(reqVO);
+
+        // 断言
+        assertNotNull(interviewId);
+        HrmRecruitInterviewDO interview = recruitInterviewMapper.selectById(interviewId);
+        assertPojoEquals(reqVO, interview, "id", "stageNumber");
+        assertEquals(firstInterview.getStageNumber() + 1, interview.getStageNumber());
+        assertEquals(HrmRecruitInterviewResultEnum.UNFINISHED.getResult(), interview.getResult());
+        verify(recruitCandidateService).updateRecruitCandidateInterview(candidateId, 2);
+        verify(employeeService).validateEmployeeListByEntryStatus(
+                anyCollection(), eq(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+    }
+
+    @Test
+    public void testCreateRecruitInterview_employeeNotExists() {
+        // 准备参数
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setCandidateId(candidateId));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(candidateId))
+                .thenReturn(randomPojo(HrmRecruitCandidateDO.class, o -> o.setId(candidateId)
+                        .setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())));
+        doThrow(exception(EMPLOYEE_NOT_EXISTS)).when(employeeService)
+                .validateEmployeeListByEntryStatus(anyCollection(),
+                        eq(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitInterviewService.createRecruitInterview(reqVO), EMPLOYEE_NOT_EXISTS);
+        assertEquals(0L, recruitInterviewMapper.selectCount());
+    }
+
+    @Test
+    public void testCreateRecruitInterview_normalizeOtherInterviewEmployeeIds() {
+        // 准备参数
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setCandidateId(candidateId).setInterviewEmployeeId(1L)
+                .setOtherInterviewEmployeeIds(asList(2L, 1L, 2L, 3L)));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(candidateId))
+                .thenReturn(randomPojo(HrmRecruitCandidateDO.class, o -> o.setId(candidateId)
+                        .setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(emptyMap());
+
+        // 调用
+        Long interviewId = recruitInterviewService.createRecruitInterview(reqVO);
+
+        // 断言
+        assertEquals(asList(2L, 3L),
+                recruitInterviewMapper.selectById(interviewId).getOtherInterviewEmployeeIds());
+        verify(employeeService).validateEmployeeListByEntryStatus(
+                new HashSet<>(asList(1L, 2L, 3L)), HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+    }
+
+    @Test
+    public void testCreateRecruitInterview_emptyOtherInterviewEmployeeIds() {
+        // 准备参数
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setCandidateId(candidateId).setInterviewEmployeeId(1L)
+                .setOtherInterviewEmployeeIds(null));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(candidateId))
+                .thenReturn(randomPojo(HrmRecruitCandidateDO.class, o -> o.setId(candidateId)
+                        .setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus())));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(emptyMap());
+
+        // 调用
+        Long interviewId = recruitInterviewService.createRecruitInterview(reqVO);
+
+        // 断言
+        assertEquals(emptyList(),
+                recruitInterviewMapper.selectById(interviewId).getOtherInterviewEmployeeIds());
+        verify(employeeService).validateEmployeeListByEntryStatus(
+                singleton(1L), HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+    }
+
+    @Test
+    public void testCreateRecruitInterview_candidateStateInvalid() {
+        // 准备参数
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setCandidateId(candidateId));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(candidateId))
+                .thenReturn(randomPojo(HrmRecruitCandidateDO.class, o -> o.setId(candidateId)
+                        .setStatus(HrmRecruitCandidateStatusEnum.OFFER_SENT.getStatus())));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitInterviewService.createRecruitInterview(reqVO),
+                RECRUIT_INTERVIEW_STATE_INVALID);
+        assertEquals(0L, recruitInterviewMapper.selectCount());
+        verifyNoInteractions(employeeService);
+    }
+
+    @Test
+    public void testUpdateRecruitInterview_success() {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO(o -> o
+                .setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult()));
+        recruitInterviewMapper.insert(dbInterview);
+        // 准备参数
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setId(dbInterview.getId()).setCandidateId(dbInterview.getCandidateId())
+                .setStageNumber(randomInteger()));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(dbInterview.getCandidateId())))
+                .thenReturn(currentInterviewCandidate(dbInterview));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(emptyMap());
+
+        // 调用
+        recruitInterviewService.updateRecruitInterview(reqVO);
+
+        // 断言
+        HrmRecruitInterviewDO interview = recruitInterviewMapper.selectById(dbInterview.getId());
+        assertPojoEquals(reqVO, interview, "result", "evaluate", "cancelReason");
+        assertEquals(HrmRecruitInterviewResultEnum.UNFINISHED.getResult(), interview.getResult());
+        assertNull(interview.getEvaluate());
+        assertNull(interview.getCancelReason());
+        verify(recruitCandidateService).validateRecruitCandidateExistsForUpdate(dbInterview.getCandidateId());
+        verify(recruitCandidateService, never()).updateRecruitCandidateInterview(anyLong(), anyInt());
+    }
+
+    @Test
+    public void testUpdateRecruitInterview_cancelled() {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO(o -> o
+                .setResult(HrmRecruitInterviewResultEnum.CANCEL.getResult())
+                .setEvaluate(randomString()).setCancelReason(randomString()));
+        recruitInterviewMapper.insert(dbInterview);
+        // 准备参数
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setId(dbInterview.getId()).setCandidateId(dbInterview.getCandidateId()));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(dbInterview.getCandidateId())))
+                .thenReturn(currentInterviewCandidate(dbInterview));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(emptyMap());
+
+        // 调用
+        recruitInterviewService.updateRecruitInterview(reqVO);
+
+        // 断言
+        HrmRecruitInterviewDO interview = recruitInterviewMapper.selectById(dbInterview.getId());
+        assertEquals(dbInterview.getStageNumber(), interview.getStageNumber());
+        assertEquals(HrmRecruitInterviewResultEnum.UNFINISHED.getResult(), interview.getResult());
+        assertNull(interview.getEvaluate());
+        assertNull(interview.getCancelReason());
+        verify(recruitCandidateService).updateRecruitCandidateInterview(
+                dbInterview.getCandidateId(), dbInterview.getStageNumber());
+    }
+
+    @Test
+    public void testUpdateRecruitInterview_finished() {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO(o -> o
+                .setResult(HrmRecruitInterviewResultEnum.PASS.getResult()));
+        recruitInterviewMapper.insert(dbInterview);
+        // 准备参数
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setId(dbInterview.getId()).setCandidateId(dbInterview.getCandidateId()));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(dbInterview.getCandidateId())))
+                .thenReturn(currentInterviewCandidate(dbInterview));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitInterviewService.updateRecruitInterview(reqVO),
+                RECRUIT_INTERVIEW_FINISHED);
+    }
+
+    @Test
+    public void testDeleteRecruitInterview_success() {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO();
+        recruitInterviewMapper.insert(dbInterview);
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(dbInterview.getCandidateId()))
+                .thenReturn(currentInterviewCandidate(dbInterview));
+
+        // 调用
+        recruitInterviewService.deleteRecruitInterview(dbInterview.getId());
+
+        // 断言
+        assertNull(recruitInterviewMapper.selectById(dbInterview.getId()));
+        verify(recruitCandidateService).updateRecruitCandidateInterviewState(
+                dbInterview.getCandidateId(), HrmRecruitCandidateStatusEnum.NEW.getStatus(), 0);
+    }
+
+    @Test
+    public void testDeleteRecruitInterview_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitInterviewService.deleteRecruitInterview(id),
+                RECRUIT_INTERVIEW_NOT_EXISTS);
+        verifyNoInteractions(recruitCandidateService);
+    }
+
+    @Test
+    public void testGetRecruitInterview() {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO();
+        recruitInterviewMapper.insert(dbInterview);
+
+        // 调用
+        HrmRecruitInterviewDO interview = recruitInterviewService.getRecruitInterview(dbInterview.getId());
+
+        // 断言
+        assertPojoEquals(dbInterview, interview);
+        verifyNoInteractions(recruitCandidateService);
+    }
+
+    @Test
+    public void testGetRecruitInterviewListByCandidateId() {
+        // mock 数据
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewDO firstInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(candidateId).setStageNumber(1));
+        recruitInterviewMapper.insert(firstInterview);
+        HrmRecruitInterviewDO secondInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(candidateId).setStageNumber(2));
+        recruitInterviewMapper.insert(secondInterview);
+        // 测试 candidateId 不匹配
+        recruitInterviewMapper.insert(randomRecruitInterviewDO());
+
+        // 调用
+        List<HrmRecruitInterviewDO> interviews = recruitInterviewService
+                .getRecruitInterviewListByCandidateId(candidateId);
+
+        // 断言
+        assertEquals(asList(secondInterview.getId(), firstInterview.getId()),
+                convertList(interviews, HrmRecruitInterviewDO::getId));
+        verifyNoInteractions(recruitCandidateService);
+    }
+
+    @Test
+    public void testGetLatestRecruitInterviewMapByCandidateIds() {
+        // mock 数据
+        Long firstCandidateId = randomLongId();
+        HrmRecruitInterviewDO historyInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(firstCandidateId).setStageNumber(1));
+        recruitInterviewMapper.insert(historyInterview);
+        HrmRecruitInterviewDO latestInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(firstCandidateId).setStageNumber(2));
+        recruitInterviewMapper.insert(latestInterview);
+        Long secondCandidateId = randomLongId();
+        HrmRecruitInterviewDO secondInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(secondCandidateId).setStageNumber(1));
+        recruitInterviewMapper.insert(secondInterview);
+
+        // 调用
+        Map<Long, HrmRecruitInterviewDO> interviewMap = recruitInterviewService
+                .getLatestRecruitInterviewMapByCandidateIds(asList(firstCandidateId, secondCandidateId));
+
+        // 断言
+        assertEquals(2, interviewMap.size());
+        assertPojoEquals(latestInterview, interviewMap.get(firstCandidateId));
+        assertPojoEquals(secondInterview, interviewMap.get(secondCandidateId));
+    }
+
+    @Test
+    public void testGetLatestRecruitInterviewMapByCandidateIds_empty() {
+        // 调用
+        Map<Long, HrmRecruitInterviewDO> interviewMap = recruitInterviewService
+                .getLatestRecruitInterviewMapByCandidateIds(emptyList());
+
+        // 断言
+        assertTrue(interviewMap.isEmpty());
+    }
+
+    @Test
+    public void testDeleteRecruitInterviewByCandidateId_success() {
+        // mock 数据
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewDO firstInterview = randomRecruitInterviewDO(o -> o.setCandidateId(candidateId));
+        recruitInterviewMapper.insert(firstInterview);
+        HrmRecruitInterviewDO secondInterview = randomRecruitInterviewDO(o -> o.setCandidateId(candidateId));
+        recruitInterviewMapper.insert(secondInterview);
+        // 测试 candidateId 不匹配
+        HrmRecruitInterviewDO retainedInterview = randomRecruitInterviewDO();
+        recruitInterviewMapper.insert(retainedInterview);
+
+        // 调用
+        recruitInterviewService.deleteRecruitInterviewByCandidateId(candidateId);
+
+        // 断言
+        assertNull(recruitInterviewMapper.selectById(firstInterview.getId()));
+        assertNull(recruitInterviewMapper.selectById(secondInterview.getId()));
+        assertNotNull(recruitInterviewMapper.selectById(retainedInterview.getId()));
+    }
+
+    @Test
+    public void testFinishCurrentRecruitInterviewForElimination_success() {
+        // mock 数据
+        HrmRecruitInterviewDO interview = randomRecruitInterviewDO();
+        recruitInterviewMapper.insert(interview);
+
+        // 调用
+        recruitInterviewService.finishCurrentRecruitInterviewForElimination(
+                interview.getCandidateId(), "专业能力不匹配");
+
+        // 断言
+        HrmRecruitInterviewDO dbInterview = recruitInterviewMapper.selectById(interview.getId());
+        assertEquals(HrmRecruitInterviewResultEnum.NOT_PASS.getResult(), dbInterview.getResult());
+        assertEquals("专业能力不匹配", dbInterview.getEvaluate());
+        assertNull(dbInterview.getCancelReason());
+    }
+
+    @Test
+    public void testUpdateRecruitInterviewResult_pass() {
+        testUpdateRecruitInterviewResult(HrmRecruitInterviewResultEnum.PASS.getResult(),
+                HrmRecruitCandidateStatusEnum.INTERVIEW_PASS.getStatus());
+    }
+
+    @Test
+    public void testUpdateRecruitInterviewResult_notPass() {
+        testUpdateRecruitInterviewResult(HrmRecruitInterviewResultEnum.NOT_PASS.getResult(),
+                HrmRecruitCandidateStatusEnum.ELIMINATED.getStatus());
+    }
+
+    private void testUpdateRecruitInterviewResult(Integer interviewResult, Integer candidateStatus) {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO();
+        recruitInterviewMapper.insert(dbInterview);
+        // 准备参数
+        HrmRecruitInterviewResultReqVO reqVO = randomPojo(HrmRecruitInterviewResultReqVO.class, o -> o
+                .setId(dbInterview.getId()).setResult(interviewResult));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(dbInterview.getCandidateId())))
+                .thenReturn(currentInterviewCandidate(dbInterview));
+
+        // 调用
+        recruitInterviewService.updateRecruitInterviewResult(reqVO);
+
+        // 断言
+        HrmRecruitInterviewDO interview = recruitInterviewMapper.selectById(dbInterview.getId());
+        assertPojoEquals(reqVO, interview);
+        verify(recruitCandidateService).updateRecruitCandidateStatusByInterviewResult(
+                dbInterview.getCandidateId(), candidateStatus);
+    }
+
+    @Test
+    public void testUpdateRecruitInterviewResult_cancel() {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO();
+        recruitInterviewMapper.insert(dbInterview);
+        // 准备参数
+        HrmRecruitInterviewResultReqVO reqVO = randomPojo(HrmRecruitInterviewResultReqVO.class, o -> o
+                .setId(dbInterview.getId()).setResult(HrmRecruitInterviewResultEnum.CANCEL.getResult())
+                .setCancelReason(randomString()));
+        // mock 方法
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(dbInterview.getCandidateId())))
+                .thenReturn(currentInterviewCandidate(dbInterview));
+
+        // 调用
+        recruitInterviewService.updateRecruitInterviewResult(reqVO);
+
+        // 断言
+        HrmRecruitInterviewDO interview = recruitInterviewMapper.selectById(dbInterview.getId());
+        assertPojoEquals(reqVO, interview);
+        verify(recruitCandidateService, never()).updateRecruitCandidateStatusByInterviewResult(anyLong(), anyInt());
+        verify(recruitCandidateService).updateRecruitCandidateInterviewState(
+                dbInterview.getCandidateId(), HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus(),
+                dbInterview.getStageNumber());
+    }
+
+    @Test
+    public void testUpdateRecruitInterviewResult_unfinishedResult() {
+        // mock 数据
+        HrmRecruitInterviewDO dbInterview = randomRecruitInterviewDO();
+        recruitInterviewMapper.insert(dbInterview);
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(dbInterview.getCandidateId())))
+                .thenReturn(currentInterviewCandidate(dbInterview));
+        // 准备参数
+        HrmRecruitInterviewResultReqVO reqVO = new HrmRecruitInterviewResultReqVO()
+                .setId(dbInterview.getId()).setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult());
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitInterviewService.updateRecruitInterviewResult(reqVO),
+                RECRUIT_INTERVIEW_RESULT_INVALID);
+        verify(recruitCandidateService, never()).updateRecruitCandidateStatusByInterviewResult(anyLong(), anyInt());
+    }
+
+    @Test
+    public void testUpdateRecruitInterviewResult_historicalInterview() {
+        // mock 数据
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewDO historicalInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(candidateId).setStageNumber(1));
+        recruitInterviewMapper.insert(historicalInterview);
+        HrmRecruitInterviewDO currentInterview = randomRecruitInterviewDO(o -> o
+                .setCandidateId(candidateId).setStageNumber(2));
+        recruitInterviewMapper.insert(currentInterview);
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(candidateId))
+                .thenReturn(currentInterviewCandidate(currentInterview));
+        HrmRecruitInterviewResultReqVO reqVO = new HrmRecruitInterviewResultReqVO()
+                .setId(historicalInterview.getId()).setResult(HrmRecruitInterviewResultEnum.PASS.getResult());
+
+        // 调用、断言
+        assertServiceException(() -> recruitInterviewService.updateRecruitInterviewResult(reqVO),
+                RECRUIT_INTERVIEW_NOT_CURRENT);
+        assertEquals(HrmRecruitInterviewResultEnum.UNFINISHED.getResult(),
+                recruitInterviewMapper.selectById(historicalInterview.getId()).getResult());
+        verify(recruitCandidateService, never()).updateRecruitCandidateStatusByInterviewResult(anyLong(), anyInt());
+    }
+
+    @Test
+    public void testCreateRecruitInterview_sendNotify() {
+        // 准备参数
+        Long candidateId = randomLongId();
+        HrmRecruitInterviewSaveReqVO reqVO = randomRecruitInterviewSaveReqVO(o -> o
+                .setCandidateId(candidateId)
+                .setInterviewEmployeeId(1L).setOtherInterviewEmployeeIds(asList(2L, 3L)));
+        // mock 方法
+        HrmRecruitCandidateDO candidate = randomPojo(HrmRecruitCandidateDO.class, o -> o
+                .setId(candidateId).setName(randomString())
+                .setStatus(HrmRecruitCandidateStatusEnum.PRIMARY_PASS.getStatus()));
+        when(recruitCandidateService.validateRecruitCandidateExistsForUpdate(eq(candidateId))).thenReturn(candidate);
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(1L, randomPojo(HrmEmployeeDO.class, o -> o.setId(1L).setUserId(11L)));
+        employeeMap.put(2L, randomPojo(HrmEmployeeDO.class, o -> o.setId(2L).setUserId(12L)));
+        employeeMap.put(3L, randomPojo(HrmEmployeeDO.class, o -> o.setId(3L).setUserId(11L)));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(employeeMap);
+
+        // 调用
+        recruitInterviewService.createRecruitInterview(reqVO);
+
+        // 断言
+        ArgumentCaptor<NotifySendSingleToUserReqDTO> notifyCaptor =
+                ArgumentCaptor.forClass(NotifySendSingleToUserReqDTO.class);
+        verify(notifyMessageSendApi, times(2)).sendSingleMessageToAdmin(notifyCaptor.capture());
+        assertEquals(RECRUIT_INTERVIEW_ARRANGED, notifyCaptor.getAllValues().get(0).getTemplateCode());
+        assertEquals(candidate.getName(),
+                notifyCaptor.getAllValues().get(0).getTemplateParams().get("candidateName"));
+    }
+
+    // ========== 随机对象 ==========
+
+    @SafeVarargs
+    private static HrmRecruitInterviewDO randomRecruitInterviewDO(Consumer<HrmRecruitInterviewDO>... consumers) {
+        Consumer<HrmRecruitInterviewDO> consumer = o -> o.setType(1).setStageNumber(1)
+                .setOtherInterviewEmployeeIds(emptyList())
+                .setResult(HrmRecruitInterviewResultEnum.UNFINISHED.getResult());
+        return randomPojo(HrmRecruitInterviewDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmRecruitInterviewSaveReqVO randomRecruitInterviewSaveReqVO(
+            Consumer<HrmRecruitInterviewSaveReqVO>... consumers) {
+        Consumer<HrmRecruitInterviewSaveReqVO> consumer = o -> o.setId(null).setType(1).setStageNumber(null)
+                .setOtherInterviewEmployeeIds(singletonList(randomLongId()));
+        return randomPojo(HrmRecruitInterviewSaveReqVO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    private static HrmRecruitCandidateDO currentInterviewCandidate(HrmRecruitInterviewDO interview) {
+        return randomPojo(HrmRecruitCandidateDO.class, candidate -> candidate
+                .setId(interview.getCandidateId())
+                .setStatus(HrmRecruitCandidateStatusEnum.INTERVIEW.getStatus())
+                .setStageNumber(interview.getStageNumber()));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelServiceImplTest.java
new file mode 100644
index 0000000..9153307
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitChannelServiceImplTest.java
@@ -0,0 +1,307 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.config;
+
+import cn.iocoder.yudao.module.hrm.service.recruit.candidate.HrmRecruitCandidateService;
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelDeleteReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.channel.HrmRecruitChannelStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.config.HrmRecruitChannelDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.config.HrmRecruitChannelMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.HashSet;
+import java.util.List;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.cloneIgnoreId;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.*;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.*;
+import static java.util.Arrays.asList;
+import static java.util.Collections.emptyList;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+
+/**
+ * {@link HrmRecruitChannelServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmRecruitChannelServiceImpl.class)
+public class HrmRecruitChannelServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmRecruitChannelServiceImpl recruitChannelService;
+
+    @Resource
+    private HrmRecruitChannelMapper recruitChannelMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private HrmRecruitCandidateService recruitCandidateService;
+
+    @Test
+    public void testCreateRecruitChannel_success() {
+        // 准备参数
+        HrmRecruitChannelSaveReqVO reqVO = randomRecruitChannelSaveReqVO();
+
+        // 调用
+        Long channelId = recruitChannelService.createRecruitChannel(reqVO);
+
+        // 断言
+        assertNotNull(channelId);
+        HrmRecruitChannelDO channel = recruitChannelMapper.selectById(channelId);
+        assertPojoEquals(reqVO, channel, "id");
+        assertFalse(channel.getSystemFlag());
+        assertEquals(CommonStatusEnum.ENABLE.getStatus(), channel.getStatus());
+    }
+
+    @Test
+    public void testUpdateRecruitChannel_success() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o.setSystemFlag(false));
+        recruitChannelMapper.insert(dbChannel);
+        // 准备参数
+        HrmRecruitChannelSaveReqVO reqVO = randomRecruitChannelSaveReqVO(o -> o.setId(dbChannel.getId()));
+
+        // 调用
+        recruitChannelService.updateRecruitChannel(reqVO);
+
+        // 断言
+        HrmRecruitChannelDO channel = recruitChannelMapper.selectById(dbChannel.getId());
+        assertPojoEquals(reqVO, channel);
+        assertFalse(channel.getSystemFlag());
+    }
+
+    @Test
+    public void testUpdateRecruitChannel_systemNameUpdateForbidden() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o
+                .setName("人才招聘会").setSystemFlag(true));
+        recruitChannelMapper.insert(dbChannel);
+        // 准备参数
+        HrmRecruitChannelSaveReqVO reqVO = randomRecruitChannelSaveReqVO(o -> o
+                .setId(dbChannel.getId()).setName("招聘会"));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitChannelService.updateRecruitChannel(reqVO),
+                RECRUIT_CHANNEL_SYSTEM_NAME_UPDATE_FORBIDDEN);
+    }
+
+    @Test
+    public void testUpdateRecruitChannel_notExists() {
+        // 准备参数
+        HrmRecruitChannelSaveReqVO reqVO = randomRecruitChannelSaveReqVO(o -> o.setId(randomLongId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitChannelService.updateRecruitChannel(reqVO),
+                RECRUIT_CHANNEL_NOT_EXISTS);
+    }
+
+    @Test
+    public void testUpdateRecruitChannelStatus_success() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o
+                .setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        recruitChannelMapper.insert(dbChannel);
+        // 准备参数
+        HrmRecruitChannelStatusReqVO reqVO = randomPojo(HrmRecruitChannelStatusReqVO.class, o -> o
+                .setId(dbChannel.getId()).setStatus(CommonStatusEnum.DISABLE.getStatus()));
+
+        // 调用
+        recruitChannelService.updateRecruitChannelStatus(reqVO);
+
+        // 断言
+        assertEquals(reqVO.getStatus(), recruitChannelMapper.selectById(dbChannel.getId()).getStatus());
+    }
+
+    @Test
+    public void testDeleteRecruitChannel_success() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o.setSystemFlag(false));
+        recruitChannelMapper.insert(dbChannel);
+        HrmRecruitChannelDO transferChannel = randomRecruitChannelDO(o -> o
+                .setSystemFlag(true).setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        recruitChannelMapper.insert(transferChannel);
+        // 准备参数
+        HrmRecruitChannelDeleteReqVO reqVO = randomPojo(HrmRecruitChannelDeleteReqVO.class, o -> o
+                .setId(dbChannel.getId()).setTransferChannelId(transferChannel.getId()));
+
+        // 调用
+        recruitChannelService.deleteRecruitChannel(reqVO);
+
+        // 断言
+        assertNull(recruitChannelMapper.selectById(dbChannel.getId()));
+        assertNotNull(recruitChannelMapper.selectById(transferChannel.getId()));
+        verify(employeeService).updateEmployeeChannelByChannelId(dbChannel.getId(), transferChannel.getId());
+        verify(recruitCandidateService).updateRecruitCandidateChannelByChannelId(
+                dbChannel.getId(), transferChannel.getId());
+    }
+
+    @Test
+    public void testDeleteRecruitChannel_systemDeleteForbidden() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o.setSystemFlag(true));
+        recruitChannelMapper.insert(dbChannel);
+        // 准备参数
+        HrmRecruitChannelDeleteReqVO reqVO = randomPojo(HrmRecruitChannelDeleteReqVO.class, o -> o
+                .setId(dbChannel.getId()).setTransferChannelId(randomLongId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitChannelService.deleteRecruitChannel(reqVO),
+                RECRUIT_CHANNEL_SYSTEM_DELETE_FORBIDDEN);
+        verifyNoInteractions(employeeService, recruitCandidateService);
+    }
+
+    @Test
+    public void testDeleteRecruitChannel_transferSelf() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o.setSystemFlag(false));
+        recruitChannelMapper.insert(dbChannel);
+        // 准备参数
+        HrmRecruitChannelDeleteReqVO reqVO = randomPojo(HrmRecruitChannelDeleteReqVO.class, o -> o
+                .setId(dbChannel.getId()).setTransferChannelId(dbChannel.getId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitChannelService.deleteRecruitChannel(reqVO),
+                RECRUIT_CHANNEL_TRANSFER_SELF);
+        verifyNoInteractions(employeeService, recruitCandidateService);
+    }
+
+    @Test
+    public void testDeleteRecruitChannel_transferDisabled() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o.setSystemFlag(false));
+        recruitChannelMapper.insert(dbChannel);
+        HrmRecruitChannelDO transferChannel = randomRecruitChannelDO(o -> o
+                .setStatus(CommonStatusEnum.DISABLE.getStatus()));
+        recruitChannelMapper.insert(transferChannel);
+        // 准备参数
+        HrmRecruitChannelDeleteReqVO reqVO = randomPojo(HrmRecruitChannelDeleteReqVO.class, o -> o
+                .setId(dbChannel.getId()).setTransferChannelId(transferChannel.getId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitChannelService.deleteRecruitChannel(reqVO),
+                RECRUIT_CHANNEL_TRANSFER_DISABLED);
+        verifyNoInteractions(employeeService, recruitCandidateService);
+    }
+
+    @Test
+    public void testGetRecruitChannel() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO();
+        recruitChannelMapper.insert(dbChannel);
+
+        // 调用
+        HrmRecruitChannelDO channel = recruitChannelService.getRecruitChannel(dbChannel.getId());
+
+        // 断言
+        assertPojoEquals(dbChannel, channel);
+    }
+
+    @Test
+    public void testGetRecruitChannelList() {
+        // mock 数据
+        HrmRecruitChannelDO firstChannel = randomRecruitChannelDO();
+        recruitChannelMapper.insert(firstChannel);
+        HrmRecruitChannelDO secondChannel = randomRecruitChannelDO();
+        recruitChannelMapper.insert(secondChannel);
+        HrmRecruitChannelDO otherChannel = randomRecruitChannelDO();
+        recruitChannelMapper.insert(otherChannel);
+        // 准备参数
+        List<Long> ids = asList(firstChannel.getId(), secondChannel.getId());
+
+        // 调用
+        List<HrmRecruitChannelDO> channels = recruitChannelService.getRecruitChannelList(ids);
+
+        // 断言
+        assertEquals(2, channels.size());
+        assertEquals(new HashSet<>(ids), convertSet(channels, HrmRecruitChannelDO::getId));
+    }
+
+    @Test
+    public void testGetRecruitChannelList_empty() {
+        // 调用
+        List<HrmRecruitChannelDO> channels = recruitChannelService.getRecruitChannelList(emptyList());
+
+        // 断言
+        assertTrue(channels.isEmpty());
+    }
+
+    @Test
+    public void testGetRecruitChannelPage() {
+        // mock 数据
+        HrmRecruitChannelDO dbChannel = randomRecruitChannelDO(o -> o
+                .setName("BOSS 直聘").setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        recruitChannelMapper.insert(dbChannel);
+        // 测试 name 不匹配
+        recruitChannelMapper.insert(cloneIgnoreId(dbChannel, o -> o.setName("猎聘网")));
+        // 测试 status 不匹配
+        recruitChannelMapper.insert(cloneIgnoreId(dbChannel,
+                o -> o.setStatus(CommonStatusEnum.DISABLE.getStatus())));
+        // 准备参数
+        HrmRecruitChannelPageReqVO reqVO = new HrmRecruitChannelPageReqVO();
+        reqVO.setName("BOSS");
+        reqVO.setStatus(CommonStatusEnum.ENABLE.getStatus());
+
+        // 调用
+        PageResult<HrmRecruitChannelDO> pageResult = recruitChannelService.getRecruitChannelPage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(1, pageResult.getList().size());
+        assertPojoEquals(dbChannel, pageResult.getList().get(0));
+    }
+
+    @Test
+    public void testGetRecruitChannelSimpleList() {
+        // mock 数据
+        HrmRecruitChannelDO secondChannel = randomRecruitChannelDO(o -> o
+                .setSort(20).setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        recruitChannelMapper.insert(secondChannel);
+        HrmRecruitChannelDO firstChannel = randomRecruitChannelDO(o -> o
+                .setSort(10).setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        recruitChannelMapper.insert(firstChannel);
+        // 测试 status 不匹配
+        recruitChannelMapper.insert(randomRecruitChannelDO(o -> o
+                .setSort(1).setStatus(CommonStatusEnum.DISABLE.getStatus())));
+
+        // 调用
+        List<HrmRecruitChannelDO> channels = recruitChannelService.getRecruitChannelSimpleList();
+
+        // 断言
+        assertEquals(asList(firstChannel.getId(), secondChannel.getId()),
+                convertList(channels, HrmRecruitChannelDO::getId));
+    }
+
+    // ========== 随机对象 ==========
+
+    @SafeVarargs
+    private static HrmRecruitChannelDO randomRecruitChannelDO(Consumer<HrmRecruitChannelDO>... consumers) {
+        Consumer<HrmRecruitChannelDO> consumer = o -> o.setName(randomString()).setSort(randomInteger())
+                .setStatus(randomCommonStatus()).setSystemFlag(false);
+        return randomPojo(HrmRecruitChannelDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmRecruitChannelSaveReqVO randomRecruitChannelSaveReqVO(
+            Consumer<HrmRecruitChannelSaveReqVO>... consumers) {
+        Consumer<HrmRecruitChannelSaveReqVO> consumer = o -> o.setId(null)
+                .setName(randomString()).setSort(randomInteger());
+        return randomPojo(HrmRecruitChannelSaveReqVO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigServiceImplTest.java
new file mode 100644
index 0000000..095488d
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/config/HrmRecruitConfigServiceImplTest.java
@@ -0,0 +1,52 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.config.HrmRecruitEliminateReasonSaveReqVO;
+import cn.iocoder.yudao.module.hrm.service.config.HrmConfigService;
+import cn.iocoder.yudao.module.hrm.enums.config.HrmConfigTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.List;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmRecruitConfigServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmRecruitConfigServiceImpl.class)
+public class HrmRecruitConfigServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmRecruitConfigServiceImpl recruitConfigService;
+    @MockitoBean
+    private HrmConfigService configService;
+
+    @Test
+    public void testSaveRecruitEliminateReason_success() {
+        // 准备参数
+        HrmRecruitEliminateReasonSaveReqVO saveReqVO = new HrmRecruitEliminateReasonSaveReqVO();
+        saveReqVO.setReasons(Arrays.asList("简历不匹配", "薪资不匹配", "简历不匹配", "  面试未通过  "));
+
+        // 调用
+        recruitConfigService.saveRecruitEliminateReason(saveReqVO);
+
+        // 断言
+        List<String> reasons = Arrays.asList("简历不匹配", "薪资不匹配", "面试未通过");
+        verify(configService).replaceConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType(), reasons);
+
+        // mock 方法
+        when(configService.getConfigValueList(HrmConfigTypeEnum.RECRUIT_ELIMINATE.getType())).thenReturn(reasons);
+
+        // 调用，并断言
+        assertEquals(reasons, recruitConfigService.getRecruitEliminateReasonList());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostServiceImplTest.java
new file mode 100644
index 0000000..57fa81d
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostServiceImplTest.java
@@ -0,0 +1,419 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.post;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostSaveReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.recruit.vo.post.HrmRecruitPostStatusReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.post.HrmRecruitPostMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.recruit.post.HrmRecruitPostStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.common.exception.util.ServiceExceptionUtil.exception;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.buildTime;
+import static cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils.getDateTimeRange;
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.cloneIgnoreId;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.*;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.EMPLOYEE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_POST_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_POST_TYPE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.system.enums.ErrorCodeConstants.DEPT_NOT_FOUND;
+import static java.util.Arrays.asList;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.singleton;
+import static java.util.Collections.singletonList;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.doThrow;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+
+/**
+ * {@link HrmRecruitPostServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmRecruitPostServiceImpl.class)
+public class HrmRecruitPostServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmRecruitPostServiceImpl recruitPostService;
+
+    @Resource
+    private HrmRecruitPostMapper recruitPostMapper;
+
+    @MockitoBean
+    private HrmRecruitPostTypeService recruitPostTypeService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private DeptApi deptApi;
+
+    @Test
+    public void testCreateRecruitPost_success() {
+        // 准备参数
+        HrmRecruitPostSaveReqVO reqVO = randomRecruitPostSaveReqVO(o -> o
+                .setDeptId(100L).setOwnerEmployeeId(200L)
+                .setInterviewEmployeeIds(asList(201L, 202L)));
+
+        // 调用
+        Long postId = recruitPostService.createRecruitPost(reqVO);
+
+        // 断言
+        assertNotNull(postId);
+        HrmRecruitPostDO recruitPost = recruitPostMapper.selectById(postId);
+        assertPojoEquals(reqVO, recruitPost, "id", "status");
+        assertEquals(HrmRecruitPostStatusEnum.RECRUITING.getStatus(), recruitPost.getStatus());
+        verify(recruitPostTypeService).validateRecruitPostTypeExists(reqVO.getPostTypeId());
+        verify(deptApi).validateDeptList(singleton(reqVO.getDeptId()));
+        verify(employeeService).validateEmployeeListByEntryStatus(
+                new HashSet<>(asList(reqVO.getOwnerEmployeeId(), 201L, 202L)),
+                HrmEmployeeEntryStatusEnum.ACTIVE.getStatus());
+    }
+
+    @Test
+    public void testCreateRecruitPost_postTypeNotExists() {
+        // 准备参数
+        HrmRecruitPostSaveReqVO reqVO = randomRecruitPostSaveReqVO();
+        // mock 方法
+        doThrow(exception(RECRUIT_POST_TYPE_NOT_EXISTS)).when(recruitPostTypeService)
+                .validateRecruitPostTypeExists(reqVO.getPostTypeId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitPostService.createRecruitPost(reqVO), RECRUIT_POST_TYPE_NOT_EXISTS);
+        assertEquals(0L, recruitPostMapper.selectCount());
+    }
+
+    @Test
+    public void testCreateRecruitPost_employeeNotExists() {
+        // 准备参数
+        HrmRecruitPostSaveReqVO reqVO = randomRecruitPostSaveReqVO();
+        // mock 方法
+        doThrow(exception(EMPLOYEE_NOT_EXISTS)).when(employeeService)
+                .validateEmployeeListByEntryStatus(anyCollection(),
+                        eq(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitPostService.createRecruitPost(reqVO), EMPLOYEE_NOT_EXISTS);
+        assertEquals(0L, recruitPostMapper.selectCount());
+    }
+
+    @Test
+    public void testCreateRecruitPost_deptNotExists() {
+        // 准备参数
+        HrmRecruitPostSaveReqVO reqVO = randomRecruitPostSaveReqVO();
+        // mock 方法
+        doThrow(exception(DEPT_NOT_FOUND)).when(deptApi)
+                .validateDeptList(singleton(reqVO.getDeptId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitPostService.createRecruitPost(reqVO), DEPT_NOT_FOUND);
+        assertEquals(0L, recruitPostMapper.selectCount());
+    }
+
+    @Test
+    public void testUpdateRecruitPost_success() {
+        // mock 数据
+        HrmRecruitPostDO dbRecruitPost = randomRecruitPostDO(o -> o
+                .setStatus(HrmRecruitPostStatusEnum.STOPPED.getStatus()));
+        recruitPostMapper.insert(dbRecruitPost);
+        // 准备参数
+        HrmRecruitPostSaveReqVO reqVO = randomRecruitPostSaveReqVO(o -> o.setId(dbRecruitPost.getId()));
+
+        // 调用
+        recruitPostService.updateRecruitPost(reqVO);
+
+        // 断言
+        HrmRecruitPostDO recruitPost = recruitPostMapper.selectById(dbRecruitPost.getId());
+        assertPojoEquals(reqVO, recruitPost);
+        assertEquals(HrmRecruitPostStatusEnum.STOPPED.getStatus(), recruitPost.getStatus());
+        verify(recruitPostTypeService).validateRecruitPostTypeExists(reqVO.getPostTypeId());
+    }
+
+    @Test
+    public void testUpdateRecruitPost_clearOptionalFields() {
+        // mock 数据
+        HrmRecruitPostDO dbRecruitPost = randomRecruitPostDO();
+        recruitPostMapper.insert(dbRecruitPost);
+        // 准备参数
+        HrmRecruitPostSaveReqVO reqVO = randomRecruitPostSaveReqVO(o -> o.setId(dbRecruitPost.getId())
+                .setDeptId(null).setAreaId(null).setRecruitNum(null).setReason(null)
+                .setWorkTime(null).setEducationRequire(null).setMinSalary(null).setMaxSalary(null)
+                .setSalaryUnit(null).setMinAge(null).setMaxAge(null).setLatestEntryTime(null)
+                .setOwnerEmployeeId(null).setInterviewEmployeeIds(null).setDescription(null)
+                .setEmergencyLevel(null).setPostTypeId(null));
+
+        // 调用
+        recruitPostService.updateRecruitPost(reqVO);
+
+        // 断言
+        HrmRecruitPostDO recruitPost = recruitPostMapper.selectById(dbRecruitPost.getId());
+        assertNull(recruitPost.getDeptId());
+        assertNull(recruitPost.getAreaId());
+        assertNull(recruitPost.getRecruitNum());
+        assertNull(recruitPost.getLatestEntryTime());
+        assertNull(recruitPost.getOwnerEmployeeId());
+        assertNull(recruitPost.getInterviewEmployeeIds());
+        assertNull(recruitPost.getPostTypeId());
+        assertEquals(dbRecruitPost.getStatus(), recruitPost.getStatus());
+    }
+
+    @Test
+    public void testUpdateRecruitPost_notExists() {
+        // 准备参数
+        HrmRecruitPostSaveReqVO reqVO = randomRecruitPostSaveReqVO(o -> o.setId(randomLongId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitPostService.updateRecruitPost(reqVO), RECRUIT_POST_NOT_EXISTS);
+        verifyNoInteractions(recruitPostTypeService);
+    }
+
+    @Test
+    public void testGetRecruitPost() {
+        // mock 数据
+        HrmRecruitPostDO dbRecruitPost = randomRecruitPostDO();
+        recruitPostMapper.insert(dbRecruitPost);
+
+        // 调用
+        HrmRecruitPostDO recruitPost = recruitPostService.getRecruitPost(dbRecruitPost.getId());
+
+        // 断言
+        assertPojoEquals(dbRecruitPost, recruitPost);
+    }
+
+    @Test
+    public void testValidateRecruitPostExists_success() {
+        // mock 数据
+        HrmRecruitPostDO dbRecruitPost = randomRecruitPostDO();
+        recruitPostMapper.insert(dbRecruitPost);
+
+        // 调用
+        HrmRecruitPostDO recruitPost = recruitPostService.validateRecruitPostExists(dbRecruitPost.getId());
+
+        // 断言
+        assertPojoEquals(dbRecruitPost, recruitPost);
+    }
+
+    @Test
+    public void testValidateRecruitPostExists_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitPostService.validateRecruitPostExists(id), RECRUIT_POST_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetRecruitPostList() {
+        // mock 数据
+        HrmRecruitPostDO firstPost = randomRecruitPostDO();
+        recruitPostMapper.insert(firstPost);
+        HrmRecruitPostDO secondPost = randomRecruitPostDO();
+        recruitPostMapper.insert(secondPost);
+        // 测试 id 不匹配
+        recruitPostMapper.insert(randomRecruitPostDO());
+        // 准备参数
+        List<Long> ids = asList(firstPost.getId(), secondPost.getId());
+
+        // 调用
+        List<HrmRecruitPostDO> posts = recruitPostService.getRecruitPostList(ids);
+
+        // 断言
+        assertEquals(2, posts.size());
+        assertEquals(new HashSet<>(ids), convertSet(posts, HrmRecruitPostDO::getId));
+    }
+
+    @Test
+    public void testGetRecruitPostList_empty() {
+        // 调用
+        List<HrmRecruitPostDO> posts = recruitPostService.getRecruitPostList(emptyList());
+
+        // 断言
+        assertTrue(posts.isEmpty());
+    }
+
+    @Test
+    public void testGetRecruitPostPage() {
+        // mock 数据
+        HrmRecruitPostDO dbRecruitPost = randomRecruitPostDO(o -> o.setPostName("Java 开发工程师")
+                .setJobNature(1).setAreaId(310100).setDeptId(100L).setOwnerEmployeeId(200L)
+                .setPostTypeId(300L).setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus())
+                .setCreateTime(buildTime(2026, 1, 20).plusHours(12)));
+        recruitPostMapper.insert(dbRecruitPost);
+        // 测试 postName 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost, o -> o.setPostName("产品经理")));
+        // 测试 jobNature 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost, o -> o.setJobNature(2)));
+        // 测试 areaId 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost, o -> o.setAreaId(110100)));
+        // 测试 deptId 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost, o -> o.setDeptId(101L)));
+        // 测试 ownerEmployeeId 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost, o -> o.setOwnerEmployeeId(201L)));
+        // 测试 postTypeId 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost, o -> o.setPostTypeId(301L)));
+        // 测试 status 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost,
+                o -> o.setStatus(HrmRecruitPostStatusEnum.STOPPED.getStatus())));
+        // 测试 createTime 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(dbRecruitPost, o -> o.setCreateTime(buildTime(2026, 1, 1))));
+        // 准备参数
+        HrmRecruitPostPageReqVO reqVO = new HrmRecruitPostPageReqVO();
+        reqVO.setPostName("Java");
+        reqVO.setJobNature(1);
+        reqVO.setAreaId(310100);
+        reqVO.setDeptId(100L);
+        reqVO.setOwnerEmployeeId(200L);
+        reqVO.setPostTypeId(300L);
+        reqVO.setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus());
+        reqVO.setCreateTime(getDateTimeRange(
+                LocalDate.of(2026, 1, 10), LocalDate.of(2026, 1, 20)));
+
+        // 调用
+        PageResult<HrmRecruitPostDO> pageResult = recruitPostService.getRecruitPostPage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(1, pageResult.getList().size());
+        assertPojoEquals(dbRecruitPost, pageResult.getList().get(0));
+    }
+
+    @Test
+    public void testGetRecruitPostSimpleList() {
+        // mock 数据
+        HrmRecruitPostDO firstPost = randomRecruitPostDO(o -> o
+                .setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus()));
+        recruitPostMapper.insert(firstPost);
+        HrmRecruitPostDO secondPost = randomRecruitPostDO(o -> o
+                .setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus()));
+        recruitPostMapper.insert(secondPost);
+        // 测试 status 不匹配
+        recruitPostMapper.insert(randomRecruitPostDO(o -> o
+                .setStatus(HrmRecruitPostStatusEnum.STOPPED.getStatus())));
+
+        // 调用
+        List<HrmRecruitPostDO> posts = recruitPostService.getRecruitPostSimpleList();
+
+        // 断言
+        assertEquals(new HashSet<>(asList(firstPost.getId(), secondPost.getId())),
+                convertSet(posts, HrmRecruitPostDO::getId));
+        assertTrue(posts.get(0).getId() > posts.get(1).getId());
+    }
+
+    @Test
+    public void testUpdateRecruitPostStatus_stopped() {
+        // mock 数据
+        HrmRecruitPostDO dbRecruitPost = randomRecruitPostDO(o -> o
+                .setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus()).setStopReason(null));
+        recruitPostMapper.insert(dbRecruitPost);
+        // 准备参数
+        HrmRecruitPostStatusReqVO reqVO = randomPojo(HrmRecruitPostStatusReqVO.class, o -> o
+                .setId(dbRecruitPost.getId()).setStatus(HrmRecruitPostStatusEnum.STOPPED.getStatus())
+                .setStopReason(randomString()));
+
+        // 调用
+        recruitPostService.updateRecruitPostStatus(reqVO);
+
+        // 断言
+        HrmRecruitPostDO recruitPost = recruitPostMapper.selectById(dbRecruitPost.getId());
+        assertEquals(reqVO.getStatus(), recruitPost.getStatus());
+        assertEquals(reqVO.getStopReason(), recruitPost.getStopReason());
+    }
+
+    @Test
+    public void testUpdateRecruitPostStatus_recruiting() {
+        // mock 数据
+        HrmRecruitPostDO dbRecruitPost = randomRecruitPostDO(o -> o
+                .setStatus(HrmRecruitPostStatusEnum.STOPPED.getStatus()).setStopReason(randomString()));
+        recruitPostMapper.insert(dbRecruitPost);
+        // 准备参数
+        HrmRecruitPostStatusReqVO reqVO = randomPojo(HrmRecruitPostStatusReqVO.class, o -> o
+                .setId(dbRecruitPost.getId()).setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus()));
+
+        // 调用
+        recruitPostService.updateRecruitPostStatus(reqVO);
+
+        // 断言
+        HrmRecruitPostDO recruitPost = recruitPostMapper.selectById(dbRecruitPost.getId());
+        assertEquals(reqVO.getStatus(), recruitPost.getStatus());
+        assertEquals("", recruitPost.getStopReason());
+    }
+
+    @Test
+    public void testUpdateRecruitPostStatus_notExists() {
+        // 准备参数
+        HrmRecruitPostStatusReqVO reqVO = randomPojo(HrmRecruitPostStatusReqVO.class, o -> o
+                .setId(randomLongId()).setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitPostService.updateRecruitPostStatus(reqVO), RECRUIT_POST_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetRecruitPostStatusCount() {
+        // mock 数据
+        HrmRecruitPostDO recruitingPost = randomRecruitPostDO(o -> o.setPostName("Java 开发工程师")
+                .setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus()));
+        recruitPostMapper.insert(recruitingPost);
+        recruitPostMapper.insert(cloneIgnoreId(recruitingPost, o -> {}));
+        HrmRecruitPostDO stoppedPost = cloneIgnoreId(recruitingPost, o -> o
+                .setStatus(HrmRecruitPostStatusEnum.STOPPED.getStatus()));
+        recruitPostMapper.insert(stoppedPost);
+        // 测试 postName 不匹配
+        recruitPostMapper.insert(cloneIgnoreId(recruitingPost, o -> o.setPostName("产品经理")));
+        // 准备参数
+        HrmRecruitPostPageReqVO reqVO = new HrmRecruitPostPageReqVO();
+        reqVO.setPostName("开发工程师");
+        reqVO.setStatus(HrmRecruitPostStatusEnum.STOPPED.getStatus());
+
+        // 调用
+        Map<Integer, Long> countMap = recruitPostService.getRecruitPostStatusCount(reqVO);
+
+        // 断言
+        assertEquals(2L, countMap.get(HrmRecruitPostStatusEnum.RECRUITING.getStatus()));
+        assertEquals(1L, countMap.get(HrmRecruitPostStatusEnum.STOPPED.getStatus()));
+    }
+
+    // ========== 随机对象 ==========
+
+    @SafeVarargs
+    private static HrmRecruitPostDO randomRecruitPostDO(Consumer<HrmRecruitPostDO>... consumers) {
+        Consumer<HrmRecruitPostDO> consumer = o -> o.setPostName(randomString()).setRecruitNum(randomInteger())
+                .setJobNature(1).setWorkTime(1).setEducationRequire(1)
+                .setMinSalary(new BigDecimal("10000.00")).setMaxSalary(new BigDecimal("20000.00")).setSalaryUnit(2)
+                .setMinAge(22).setMaxAge(35).setInterviewEmployeeIds(singletonList(randomLongId()))
+                .setEmergencyLevel(2).setStatus(HrmRecruitPostStatusEnum.RECRUITING.getStatus());
+        return randomPojo(HrmRecruitPostDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmRecruitPostSaveReqVO randomRecruitPostSaveReqVO(
+            Consumer<HrmRecruitPostSaveReqVO>... consumers) {
+        Consumer<HrmRecruitPostSaveReqVO> consumer = o -> o.setId(null).setPostName(randomString())
+                .setRecruitNum(randomInteger()).setJobNature(1).setWorkTime(1).setEducationRequire(1)
+                .setMinSalary(new BigDecimal("10000.00")).setMaxSalary(new BigDecimal("20000.00")).setSalaryUnit(2)
+                .setMinAge(22).setMaxAge(35).setInterviewEmployeeIds(singletonList(randomLongId()))
+                .setEmergencyLevel(2).setPostTypeId(randomLongId());
+        return randomPojo(HrmRecruitPostSaveReqVO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeServiceImplTest.java
new file mode 100644
index 0000000..a0bed32
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/recruit/post/HrmRecruitPostTypeServiceImplTest.java
@@ -0,0 +1,126 @@
+package cn.iocoder.yudao.module.hrm.service.recruit.post;
+
+import cn.iocoder.yudao.framework.common.enums.CommonStatusEnum;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.recruit.post.HrmRecruitPostTypeDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.recruit.post.HrmRecruitPostTypeMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.util.HashSet;
+import java.util.List;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertList;
+import static cn.iocoder.yudao.framework.common.util.collection.CollectionUtils.convertSet;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.*;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.RECRUIT_POST_TYPE_NOT_EXISTS;
+import static java.util.Arrays.asList;
+import static java.util.Collections.emptyList;
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * {@link HrmRecruitPostTypeServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmRecruitPostTypeServiceImpl.class)
+public class HrmRecruitPostTypeServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmRecruitPostTypeServiceImpl recruitPostTypeService;
+
+    @Resource
+    private HrmRecruitPostTypeMapper recruitPostTypeMapper;
+
+    @Test
+    public void testValidateRecruitPostTypeExists_null() {
+        // 调用，无需断言
+        recruitPostTypeService.validateRecruitPostTypeExists(null);
+    }
+
+    @Test
+    public void testValidateRecruitPostTypeExists_success() {
+        // mock 数据
+        HrmRecruitPostTypeDO dbPostType = randomRecruitPostTypeDO();
+        recruitPostTypeMapper.insert(dbPostType);
+
+        // 调用，无需断言
+        recruitPostTypeService.validateRecruitPostTypeExists(dbPostType.getId());
+    }
+
+    @Test
+    public void testValidateRecruitPostTypeExists_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> recruitPostTypeService.validateRecruitPostTypeExists(id),
+                RECRUIT_POST_TYPE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetRecruitPostTypeList() {
+        // mock 数据
+        HrmRecruitPostTypeDO secondPostType = randomRecruitPostTypeDO(o -> o
+                .setSort(20).setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        recruitPostTypeMapper.insert(secondPostType);
+        HrmRecruitPostTypeDO firstPostType = randomRecruitPostTypeDO(o -> o
+                .setSort(10).setStatus(CommonStatusEnum.ENABLE.getStatus()));
+        recruitPostTypeMapper.insert(firstPostType);
+        // 测试 status 不匹配
+        recruitPostTypeMapper.insert(randomRecruitPostTypeDO(o -> o
+                .setSort(1).setStatus(CommonStatusEnum.DISABLE.getStatus())));
+
+        // 调用
+        List<HrmRecruitPostTypeDO> postTypes = recruitPostTypeService.getRecruitPostTypeList(
+                CommonStatusEnum.ENABLE.getStatus());
+
+        // 断言
+        assertEquals(asList(firstPostType.getId(), secondPostType.getId()),
+                convertList(postTypes, HrmRecruitPostTypeDO::getId));
+    }
+
+    @Test
+    public void testGetRecruitPostTypeListByIds() {
+        // mock 数据
+        HrmRecruitPostTypeDO firstPostType = randomRecruitPostTypeDO();
+        recruitPostTypeMapper.insert(firstPostType);
+        HrmRecruitPostTypeDO secondPostType = randomRecruitPostTypeDO();
+        recruitPostTypeMapper.insert(secondPostType);
+        // 测试 id 不匹配
+        recruitPostTypeMapper.insert(randomRecruitPostTypeDO());
+        // 准备参数
+        List<Long> ids = asList(firstPostType.getId(), secondPostType.getId());
+
+        // 调用
+        List<HrmRecruitPostTypeDO> postTypes = recruitPostTypeService.getRecruitPostTypeListByIds(ids);
+
+        // 断言
+        assertEquals(2, postTypes.size());
+        assertEquals(new HashSet<>(ids), convertSet(postTypes, HrmRecruitPostTypeDO::getId));
+    }
+
+    @Test
+    public void testGetRecruitPostTypeListByIds_empty() {
+        // 调用
+        List<HrmRecruitPostTypeDO> postTypes = recruitPostTypeService.getRecruitPostTypeListByIds(emptyList());
+
+        // 断言
+        assertTrue(postTypes.isEmpty());
+    }
+
+    // ========== 随机对象 ==========
+
+    @SafeVarargs
+    private static HrmRecruitPostTypeDO randomRecruitPostTypeDO(
+            Consumer<HrmRecruitPostTypeDO>... consumers) {
+        Consumer<HrmRecruitPostTypeDO> consumer = o -> o.setName(randomString()).setParentId(0L)
+                .setSort(randomInteger()).setStatus(randomCommonStatus());
+        return randomPojo(HrmRecruitPostTypeDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateServiceImplTest.java
new file mode 100644
index 0000000..6771341
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryChangeTemplateServiceImplTest.java
@@ -0,0 +1,150 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.framework.common.util.object.BeanUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate.HrmSalaryChangeOptionVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.changetemplate.HrmSalaryChangeTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryChangeTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryChangeTemplateMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_TEMPLATE_DEFAULT_CANNOT_DELETE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_TEMPLATE_OPTION_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalaryChangeTemplateServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryChangeTemplateServiceImpl.class)
+public class HrmSalaryChangeTemplateServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryChangeTemplateServiceImpl salaryChangeTemplateService;
+    @Resource
+    private HrmSalaryChangeTemplateMapper salaryChangeTemplateMapper;
+    @MockitoBean
+    private HrmSalaryOptionService salaryOptionService;
+
+    @Test
+    public void testCreateSalaryChangeTemplate_default_success() {
+        // mock 数据
+        List<HrmSalaryOptionDO> salaryOptions = Collections.singletonList(
+                createSalaryOption(10101, 10, "基本工资", true));
+        when(salaryOptionService.getSalaryOptionList(true)).thenReturn(salaryOptions);
+
+        // 调用
+        List<HrmSalaryChangeOptionVO> optionReqVOs = BeanUtils.toBean(
+                salaryOptions, HrmSalaryChangeOptionVO.class);
+        optionReqVOs.get(0).setName("伪造的薪资项名称");
+        Long defaultTemplateId = salaryChangeTemplateService.createSalaryChangeTemplate(
+                createSalaryChangeTemplateReqVO("默认调薪模板", true, optionReqVOs));
+        Long newDefaultTemplateId = salaryChangeTemplateService.createSalaryChangeTemplate(
+                createSalaryChangeTemplateReqVO("研发调薪模板", true, optionReqVOs));
+
+        // 断言
+        assertEquals(false, salaryChangeTemplateMapper.selectById(defaultTemplateId).getDefaultStatus());
+        assertEquals(true, salaryChangeTemplateMapper.selectById(newDefaultTemplateId).getDefaultStatus());
+        assertEquals(2, salaryChangeTemplateService.getSalaryChangeTemplateList().size());
+        assertEquals("基本工资", salaryChangeTemplateMapper.selectById(newDefaultTemplateId)
+                .getOptions().get(0).getName());
+        assertEquals(10101, salaryChangeTemplateService.getSalaryChangeTemplateList().get(0)
+                .getOptions().get(0).getCode());
+    }
+
+    @Test
+    public void testCreateSalaryChangeTemplate_optionInvalid() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(true)).thenReturn(Collections.singletonList(
+                createSalaryOption(10101, 10, "基本工资", true)));
+        // 准备参数
+        HrmSalaryChangeOptionVO option = new HrmSalaryChangeOptionVO();
+        option.setCode(99999);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryChangeTemplateService.createSalaryChangeTemplate(
+                createSalaryChangeTemplateReqVO("研发调薪模板", false, Collections.singletonList(option))),
+                SALARY_CHANGE_TEMPLATE_OPTION_INVALID);
+    }
+
+    @Test
+    public void testCreateSalaryChangeTemplate_optionDuplicate() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(true)).thenReturn(Collections.singletonList(
+                createSalaryOption(10101, 10, "基本工资", true)));
+        // 准备参数
+        HrmSalaryChangeOptionVO option = new HrmSalaryChangeOptionVO();
+        option.setCode(10101);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryChangeTemplateService.createSalaryChangeTemplate(
+                createSalaryChangeTemplateReqVO("研发调薪模板", false, Arrays.asList(option, option))),
+                SALARY_CHANGE_TEMPLATE_OPTION_INVALID);
+    }
+
+    @Test
+    public void testGetSalaryChangeTemplateList_empty() {
+        // 调用
+        List<HrmSalaryChangeTemplateDO> templates = salaryChangeTemplateService.getSalaryChangeTemplateList();
+
+        // 断言
+        assertEquals(0, templates.size());
+        assertEquals(0L, salaryChangeTemplateMapper.selectCount());
+    }
+
+    @Test
+    public void testDeleteSalaryChangeTemplate_success() {
+        // mock 数据
+        HrmSalaryChangeTemplateDO template = HrmSalaryChangeTemplateDO.builder()
+                .name("普通调薪模板").defaultStatus(false).options(Collections.emptyList()).build();
+        salaryChangeTemplateMapper.insert(template);
+
+        // 调用
+        salaryChangeTemplateService.deleteSalaryChangeTemplate(template.getId());
+
+        // 断言
+        assertNull(salaryChangeTemplateMapper.selectById(template.getId()));
+    }
+
+    @Test
+    public void testDeleteSalaryChangeTemplate_default() {
+        // mock 数据
+        HrmSalaryChangeTemplateDO template = HrmSalaryChangeTemplateDO.builder()
+                .name("默认调薪模板").defaultStatus(true).options(Collections.emptyList()).build();
+        salaryChangeTemplateMapper.insert(template);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryChangeTemplateService.deleteSalaryChangeTemplate(template.getId()),
+                SALARY_CHANGE_TEMPLATE_DEFAULT_CANNOT_DELETE);
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalaryOptionDO createSalaryOption(Integer code, Integer parentCode, String name, Boolean enabled) {
+        return HrmSalaryOptionDO.builder().code(code).parentCode(parentCode).name(name)
+                .systemFlag(true).templateId(1L).type(1).taxEnabled(true).visible(true)
+                .calculateEnabled(true).enabled(enabled).build();
+    }
+
+    private HrmSalaryChangeTemplateSaveReqVO createSalaryChangeTemplateReqVO(
+            String name, Boolean defaultStatus, List<HrmSalaryChangeOptionVO> options) {
+        HrmSalaryChangeTemplateSaveReqVO reqVO = new HrmSalaryChangeTemplateSaveReqVO();
+        reqVO.setName(name);
+        reqVO.setDefaultStatus(defaultStatus);
+        reqVO.setOptions(options == null ? Collections.emptyList() : options);
+        return reqVO;
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigServiceImplTest.java
new file mode 100644
index 0000000..3304337
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryConfigServiceImplTest.java
@@ -0,0 +1,119 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.config.HrmSalaryConfigUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryConfigDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryConfigMapper;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalarySocialSecurityMonthTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CONFIG_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CONFIG_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+
+/**
+ * {@link HrmSalaryConfigServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryConfigServiceImpl.class)
+public class HrmSalaryConfigServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryConfigServiceImpl salaryConfigService;
+
+    @Resource
+    private HrmSalaryConfigMapper salaryConfigMapper;
+
+    @MockitoBean
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+
+    @Test
+    public void testCreateSalaryConfig_success() {
+        // 准备参数
+        HrmSalaryConfigCreateReqVO createReqVO = randomPojo(HrmSalaryConfigCreateReqVO.class, o -> {
+            o.setCycleStartDay(26);
+            o.setSocialSecurityMonthType(HrmSalarySocialSecurityMonthTypeEnum.CURRENT_MONTH.getType());
+            o.setStartYear(2026);
+            o.setStartMonth(7);
+        });
+
+        // 调用
+        Long id = salaryConfigService.createSalaryConfig(createReqVO);
+
+        // 断言
+        assertNotNull(id);
+        HrmSalaryConfigDO config = salaryConfigMapper.selectById(id);
+        assertPojoEquals(createReqVO, config, "id", "cycleEndDay");
+        assertEquals(25, config.getCycleEndDay());
+        assertEquals(1L, salaryConfigMapper.selectCount());
+        verify(salaryMonthRecordService).createMonthRecord(argThat(reqVO ->
+                reqVO.getYear() == 2026 && reqVO.getMonth() == 7));
+    }
+
+    @Test
+    public void testCreateSalaryConfig_exists() {
+        // mock 数据
+        salaryConfigMapper.insert(randomSalaryConfigDO());
+        // 准备参数
+        HrmSalaryConfigCreateReqVO reqVO = randomPojo(HrmSalaryConfigCreateReqVO.class);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryConfigService.createSalaryConfig(reqVO), SALARY_CONFIG_EXISTS);
+        verifyNoInteractions(salaryMonthRecordService);
+    }
+
+    @Test
+    public void testUpdateSalaryConfig_success() {
+        // mock 数据
+        HrmSalaryConfigDO dbConfig = randomSalaryConfigDO();
+        salaryConfigMapper.insert(dbConfig);
+        // 准备参数
+        HrmSalaryConfigUpdateReqVO updateReqVO = new HrmSalaryConfigUpdateReqVO()
+                .setSocialSecurityMonthType(HrmSalarySocialSecurityMonthTypeEnum.NEXT_MONTH.getType());
+
+        // 调用
+        salaryConfigService.updateSalaryConfig(updateReqVO);
+
+        // 断言
+        HrmSalaryConfigDO updatedConfig = salaryConfigMapper.selectById(dbConfig.getId());
+        assertEquals(HrmSalarySocialSecurityMonthTypeEnum.NEXT_MONTH.getType(), updatedConfig.getSocialSecurityMonthType());
+        assertEquals(dbConfig.getCycleStartDay(), updatedConfig.getCycleStartDay());
+        assertEquals(dbConfig.getCycleEndDay(), updatedConfig.getCycleEndDay());
+        assertEquals(dbConfig.getStartYear(), updatedConfig.getStartYear());
+        assertEquals(dbConfig.getStartMonth(), updatedConfig.getStartMonth());
+        assertEquals(1L, salaryConfigMapper.selectCount());
+        verifyNoInteractions(salaryMonthRecordService);
+    }
+
+    @Test
+    public void testUpdateSalaryConfig_notExists() {
+        // 准备参数
+        HrmSalaryConfigUpdateReqVO reqVO = randomPojo(HrmSalaryConfigUpdateReqVO.class);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryConfigService.updateSalaryConfig(reqVO), SALARY_CONFIG_NOT_EXISTS);
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalaryConfigDO randomSalaryConfigDO() {
+        return randomPojo(HrmSalaryConfigDO.class, o -> {
+            o.setCycleStartDay(1).setCycleEndDay(31);
+            o.setSocialSecurityMonthType(HrmSalarySocialSecurityMonthTypeEnum.CURRENT_MONTH.getType()).setStartYear(2026).setStartMonth(7);
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupServiceImplTest.java
new file mode 100644
index 0000000..8030fc7
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryGroupServiceImplTest.java
@@ -0,0 +1,300 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.collection.ArrayUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.group.HrmSalaryGroupSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryGroupMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.dept.DeptApi;
+import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.common.util.object.ObjectUtils.cloneIgnoreId;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.*;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.*;
+import static java.util.Collections.emptyList;
+import static java.util.Collections.singletonList;
+import static org.junit.jupiter.api.Assertions.*;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalaryGroupServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryGroupServiceImpl.class)
+public class HrmSalaryGroupServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryGroupServiceImpl salaryGroupService;
+
+    @Resource
+    private HrmSalaryGroupMapper salaryGroupMapper;
+
+    @MockitoBean
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private DeptApi deptApi;
+
+    @Test
+    public void testCreateSalaryGroup_success() {
+        // 准备参数
+        HrmSalaryGroupSaveReqVO reqVO = randomSalaryGroupSaveReqVO();
+        // mock 方法
+        mockSalaryTaxRule(reqVO.getTaxRuleId());
+
+        // 调用
+        Long salaryGroupId = salaryGroupService.createSalaryGroup(reqVO);
+
+        // 断言
+        assertNotNull(salaryGroupId);
+        HrmSalaryGroupDO salaryGroup = salaryGroupMapper.selectById(salaryGroupId);
+        assertPojoEquals(reqVO, salaryGroup, "id");
+        assertEquals(HrmSalaryGroupDO.DEFAULT_SALARY_STANDARD, salaryGroup.getSalaryStandard());
+        assertEquals(HrmSalaryGroupDO.DEFAULT_CHANGE_RULE, salaryGroup.getChangeRule());
+    }
+
+    @Test
+    public void testCreateSalaryGroup_nameDuplicate() {
+        // mock 数据
+        HrmSalaryGroupDO dbSalaryGroup = randomSalaryGroupDO();
+        salaryGroupMapper.insert(dbSalaryGroup);
+        // 准备参数
+        HrmSalaryGroupSaveReqVO reqVO = randomSalaryGroupSaveReqVO(o -> o.setName(dbSalaryGroup.getName()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryGroupService.createSalaryGroup(reqVO),
+                SALARY_GROUP_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testCreateSalaryGroup_employeeBelongsToOtherGroup() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmSalaryGroupDO dbSalaryGroup = randomSalaryGroupDO(
+                o -> o.setEmployeeIds(singletonList(employeeId)));
+        salaryGroupMapper.insert(dbSalaryGroup);
+        // 准备参数
+        HrmSalaryGroupSaveReqVO reqVO = randomSalaryGroupSaveReqVO(o -> o
+                .setDeptIds(emptyList()).setEmployeeIds(singletonList(employeeId)));
+        // mock 方法
+        mockSalaryTaxRule(reqVO.getTaxRuleId());
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryGroupService.createSalaryGroup(reqVO),
+                SALARY_GROUP_EMPLOYEE_CONFLICT);
+    }
+
+    @Test
+    public void testCreateSalaryGroup_deptHierarchyBelongsToOtherGroup() {
+        // mock 数据
+        Long parentDeptId = randomLongId();
+        Long childDeptId = randomLongId();
+        HrmSalaryGroupDO dbSalaryGroup = randomSalaryGroupDO(o -> o.setDeptIds(singletonList(parentDeptId)));
+        salaryGroupMapper.insert(dbSalaryGroup);
+        // 准备参数
+        HrmSalaryGroupSaveReqVO reqVO = randomSalaryGroupSaveReqVO(o -> o
+                .setDeptIds(singletonList(childDeptId)).setEmployeeIds(emptyList()));
+        // mock 方法
+        mockSalaryTaxRule(reqVO.getTaxRuleId());
+        when(deptApi.getChildDeptList(Collections.singleton(parentDeptId)))
+                .thenReturn(singletonList(new DeptRespDTO().setId(childDeptId)));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryGroupService.createSalaryGroup(reqVO),
+                SALARY_GROUP_DEPT_CONFLICT);
+    }
+
+    @Test
+    public void testUpdateSalaryGroup_success() {
+        // mock 数据
+        HrmSalaryGroupDO dbSalaryGroup = randomSalaryGroupDO();
+        salaryGroupMapper.insert(dbSalaryGroup);
+        // 准备参数
+        HrmSalaryGroupSaveReqVO reqVO = randomSalaryGroupSaveReqVO(o -> o.setId(dbSalaryGroup.getId()));
+        // mock 方法
+        mockSalaryTaxRule(reqVO.getTaxRuleId());
+
+        // 调用
+        salaryGroupService.updateSalaryGroup(reqVO);
+
+        // 断言
+        HrmSalaryGroupDO salaryGroup = salaryGroupMapper.selectById(dbSalaryGroup.getId());
+        assertPojoEquals(reqVO, salaryGroup);
+        assertEquals(HrmSalaryGroupDO.DEFAULT_SALARY_STANDARD, salaryGroup.getSalaryStandard());
+        assertEquals(HrmSalaryGroupDO.DEFAULT_CHANGE_RULE, salaryGroup.getChangeRule());
+    }
+
+    @Test
+    public void testUpdateSalaryGroup_notExists() {
+        // 准备参数
+        HrmSalaryGroupSaveReqVO reqVO = randomSalaryGroupSaveReqVO(o -> o.setId(randomLongId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryGroupService.updateSalaryGroup(reqVO),
+                SALARY_GROUP_NOT_EXISTS);
+    }
+
+    @Test
+    public void testDeleteSalaryGroup_success() {
+        // mock 数据
+        HrmSalaryGroupDO dbSalaryGroup = randomSalaryGroupDO();
+        salaryGroupMapper.insert(dbSalaryGroup);
+
+        // 调用
+        salaryGroupService.deleteSalaryGroup(dbSalaryGroup.getId());
+
+        // 断言
+        assertNull(salaryGroupMapper.selectById(dbSalaryGroup.getId()));
+    }
+
+    @Test
+    public void testDeleteSalaryGroup_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryGroupService.deleteSalaryGroup(id),
+                SALARY_GROUP_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetSalaryGroupPage() {
+        // mock 数据
+        HrmSalaryGroupDO dbSalaryGroup = randomSalaryGroupDO(o -> o
+                .setName("总部薪资组").setTaxRuleId(10L));
+        salaryGroupMapper.insert(dbSalaryGroup);
+        // 测试 name 不匹配
+        salaryGroupMapper.insert(cloneIgnoreId(dbSalaryGroup, o -> o.setName("分公司薪资组")));
+        // 测试 taxRuleId 不匹配
+        salaryGroupMapper.insert(cloneIgnoreId(dbSalaryGroup, o -> o.setTaxRuleId(20L)));
+        // 准备参数
+        HrmSalaryGroupPageReqVO reqVO = new HrmSalaryGroupPageReqVO().setName("总部").setTaxRuleId(10L);
+
+        // 调用
+        PageResult<HrmSalaryGroupDO> pageResult = salaryGroupService.getSalaryGroupPage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(1, pageResult.getList().size());
+        assertPojoEquals(dbSalaryGroup, pageResult.getList().get(0));
+    }
+
+    @Test
+    public void testGetEmployeeSalaryGroupMap_employeeAndDeptPriority() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        Long deptEmployeeId = randomLongId();
+        Long deptId = randomLongId();
+        HrmSalaryGroupDO deptSalaryGroup = randomSalaryGroupDO(o -> o
+                .setDeptIds(singletonList(deptId)).setEmployeeIds(emptyList()));
+        salaryGroupMapper.insert(deptSalaryGroup);
+        HrmSalaryGroupDO employeeSalaryGroup = randomSalaryGroupDO(o -> o
+                .setDeptIds(emptyList()).setEmployeeIds(singletonList(employeeId)));
+        salaryGroupMapper.insert(employeeSalaryGroup);
+        List<HrmEmployeeDO> employees = Arrays.asList(
+                new HrmEmployeeDO().setId(employeeId).setDeptId(deptId),
+                new HrmEmployeeDO().setId(deptEmployeeId).setDeptId(deptId));
+
+        // 调用
+        Map<Long, HrmSalaryGroupDO> result = salaryGroupService.getEmployeeSalaryGroupMap(employees);
+
+        // 断言
+        assertEquals(employeeSalaryGroup.getId(), result.get(employeeId).getId());
+        assertEquals(deptSalaryGroup.getId(), result.get(deptEmployeeId).getId());
+    }
+
+    @Test
+    public void testGetEmployeeSalaryGroupMap_nearestParentDeptPriority() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        Long employeeDeptId = randomLongId();
+        Long parentDeptId = randomLongId();
+        Long rootDeptId = randomLongId();
+        HrmSalaryGroupDO rootSalaryGroup = randomSalaryGroupDO(o -> o
+                .setDeptIds(singletonList(rootDeptId)).setEmployeeIds(emptyList()));
+        salaryGroupMapper.insert(rootSalaryGroup);
+        HrmSalaryGroupDO parentSalaryGroup = randomSalaryGroupDO(o -> o
+                .setDeptIds(singletonList(parentDeptId)).setEmployeeIds(emptyList()));
+        salaryGroupMapper.insert(parentSalaryGroup);
+        when(deptApi.getParentDeptList(employeeDeptId)).thenReturn(Arrays.asList(
+                new DeptRespDTO().setId(parentDeptId), new DeptRespDTO().setId(rootDeptId)));
+
+        // 调用
+        Map<Long, HrmSalaryGroupDO> result = salaryGroupService.getEmployeeSalaryGroupMap(
+                singletonList(new HrmEmployeeDO().setId(employeeId).setDeptId(employeeDeptId)));
+
+        // 断言
+        assertEquals(parentSalaryGroup.getId(), result.get(employeeId).getId());
+    }
+
+    @Test
+    public void testGetSalaryGroupCountMapByTaxRuleIds() {
+        // mock 数据
+        Long taxRuleId = randomLongId();
+        salaryGroupMapper.insert(randomSalaryGroupDO(o -> o.setTaxRuleId(taxRuleId)));
+        salaryGroupMapper.insert(randomSalaryGroupDO(o -> o.setTaxRuleId(taxRuleId)));
+        salaryGroupMapper.insert(randomSalaryGroupDO());
+
+        // 调用
+        Map<Long, Long> result = salaryGroupService.getSalaryGroupCountMapByTaxRuleIds(
+                singletonList(taxRuleId));
+
+        // 断言
+        assertEquals(2L, result.get(taxRuleId));
+    }
+
+    @Test
+    public void testGetSalaryGroupCountMapByTaxRuleIds_empty() {
+        // 调用
+        Map<Long, Long> result = salaryGroupService.getSalaryGroupCountMapByTaxRuleIds(emptyList());
+
+        // 断言
+        assertTrue(result.isEmpty());
+    }
+
+    // ========== 随机对象 ==========
+
+    @SafeVarargs
+    private static HrmSalaryGroupDO randomSalaryGroupDO(Consumer<HrmSalaryGroupDO>... consumers) {
+        Consumer<HrmSalaryGroupDO> consumer = o -> o.setId(null).setName(randomString())
+                .setSalaryStandard(HrmSalaryGroupDO.DEFAULT_SALARY_STANDARD)
+                .setChangeRule(HrmSalaryGroupDO.DEFAULT_CHANGE_RULE)
+                .setDeptIds(singletonList(randomLongId())).setEmployeeIds(emptyList())
+                .setTaxRuleId(randomLongId());
+        return randomPojo(HrmSalaryGroupDO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    @SafeVarargs
+    private static HrmSalaryGroupSaveReqVO randomSalaryGroupSaveReqVO(
+            Consumer<HrmSalaryGroupSaveReqVO>... consumers) {
+        Consumer<HrmSalaryGroupSaveReqVO> consumer = o -> o.setId(null).setName(randomString())
+                .setTaxRuleId(randomLongId()).setDeptIds(singletonList(randomLongId()))
+                .setEmployeeIds(emptyList());
+        return randomPojo(HrmSalaryGroupSaveReqVO.class, ArrayUtils.append(consumer, consumers));
+    }
+
+    private void mockSalaryTaxRule(Long taxRuleId) {
+        when(salaryTaxRuleService.validateSalaryTaxRuleExists(taxRuleId))
+                .thenReturn(new HrmSalaryTaxRuleDO().setId(taxRuleId));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionServiceImplTest.java
new file mode 100644
index 0000000..abf1e97
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryOptionServiceImplTest.java
@@ -0,0 +1,224 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryOptionMapper;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryOptionTemplateMapper;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.util.List;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_OPTION_STANDARD_CANNOT_MODIFY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_OPTION_CODE_OCCUPIED;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * {@link HrmSalaryOptionServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryOptionServiceImpl.class)
+public class HrmSalaryOptionServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryOptionServiceImpl salaryOptionService;
+
+    @Resource
+    private HrmSalaryOptionMapper salaryOptionMapper;
+    @Resource
+    private HrmSalaryOptionTemplateMapper salaryOptionTemplateMapper;
+
+    @Test
+    public void testCreateSalaryOption_success() {
+        // mock 数据
+        salaryOptionMapper.insert(createSalaryOption(30, 0, "浮动工资", false).setTemplateId(1L));
+        // 准备参数
+        HrmSalaryOptionSaveReqVO createReqVO = createSalaryOptionReqVO("绩效奖金");
+
+        // 调用
+        Long id = salaryOptionService.createSalaryOption(createReqVO);
+
+        // 断言
+        HrmSalaryOptionDO option = salaryOptionMapper.selectById(id);
+        assertEquals(Integer.valueOf(HrmSalaryOptionDO.CUSTOM_OPTION_CODE_BASE + 30 * 10_000 + 1),
+                option.getCode());
+        assertEquals(Integer.valueOf(30), option.getParentCode());
+        assertEquals("绩效奖金", option.getName());
+        assertFalse(option.getSystemFlag());
+        assertNull(option.getTemplateId());
+        assertTrue(option.getTaxEnabled());
+        assertTrue(option.getCalculateEnabled());
+        assertTrue(option.getVisible());
+        assertTrue(option.getEnabled());
+    }
+
+    @Test
+    public void testCreateSalaryOption_deletedCode() {
+        // mock 数据
+        salaryOptionMapper.insert(createSalaryOption(30, 0, "浮动工资", false).setTemplateId(1L));
+        HrmSalaryOptionDO deletedOption = createSalaryOption(30101, 30, "已删除奖金", false);
+        salaryOptionMapper.insert(deletedOption);
+        salaryOptionMapper.deleteById(deletedOption.getId());
+        // 准备参数
+        HrmSalaryOptionSaveReqVO createReqVO = createSalaryOptionReqVO("绩效奖金");
+
+        // 调用
+        Long id = salaryOptionService.createSalaryOption(createReqVO);
+
+        // 断言
+        assertEquals(Integer.valueOf(HrmSalaryOptionDO.CUSTOM_OPTION_CODE_BASE + 30 * 10_000 + 1),
+                salaryOptionMapper.selectById(id).getCode());
+    }
+
+    @Test
+    public void testUpdateSalaryOptionEnabled_success() {
+        // mock 数据
+        HrmSalaryOptionDO option = createSalaryOption(10101, 10, "基本工资", false);
+        salaryOptionMapper.insert(option);
+
+        // 调用
+        salaryOptionService.updateSalaryOptionEnabled(option.getId(), false);
+
+        // 断言
+        assertFalse(salaryOptionMapper.selectById(option.getId()).getEnabled());
+    }
+
+    @Test
+    public void testUpdateSalaryOptionVisible_success() {
+        // mock 数据
+        HrmSalaryOptionDO option = createSalaryOption(210101, 210, "应发工资", true);
+        salaryOptionMapper.insert(option);
+
+        // 调用
+        salaryOptionService.updateSalaryOptionVisible(option.getId(), false);
+
+        // 断言
+        assertFalse(salaryOptionMapper.selectById(option.getId()).getVisible());
+    }
+
+    @Test
+    public void testDeleteSalaryOption_success() {
+        // mock 数据
+        HrmSalaryOptionDO option = createSalaryOption(30101, 30, "绩效奖金", false);
+        salaryOptionMapper.insert(option);
+
+        // 调用
+        salaryOptionService.deleteSalaryOption(option.getId());
+
+        // 断言
+        assertNull(salaryOptionMapper.selectById(option.getId()));
+    }
+
+    @Test
+    public void testDeleteSalaryOption_standard() {
+        // mock 数据
+        HrmSalaryOptionDO option = createSalaryOption(30101, 30, "绩效奖金", false).setTemplateId(1L);
+        salaryOptionMapper.insert(option);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryOptionService.deleteSalaryOption(option.getId()),
+                SALARY_OPTION_STANDARD_CANNOT_MODIFY);
+    }
+
+    @Test
+    public void testGetSalaryOptionList_visible() {
+        // mock 数据
+        HrmSalaryOptionDO category = createSalaryOption(30, 0, "浮动工资", false);
+        salaryOptionMapper.insert(category);
+        salaryOptionMapper.insert(createSalaryOption(30101, 30, "绩效奖金", false));
+        salaryOptionMapper.insert(createSalaryOption(30102, 30, "隐藏奖金", false).setVisible(false));
+
+        // 调用
+        List<HrmSalaryOptionDO> list = salaryOptionService.getSalaryOptionList(false, true);
+
+        // 断言
+        assertEquals(2, list.size());
+        assertEquals(category.getId(), list.get(0).getId());
+        assertEquals(Integer.valueOf(30101), list.get(1).getCode());
+    }
+
+    @Test
+    public void testGetSalaryOptionList_adjustable() {
+        // mock 数据
+        salaryOptionMapper.insert(createSalaryOption(10, 0, "基本工资", false));
+        salaryOptionMapper.insert(createSalaryOption(10101, 10, "基本工资", false));
+        salaryOptionMapper.insert(createSalaryOption(100, 0, "社保", false));
+        salaryOptionMapper.insert(createSalaryOption(100101, 100, "个人社保", false));
+        salaryOptionMapper.insert(createSalaryOption(20, 0, "津贴", false).setEnabled(false));
+        salaryOptionMapper.insert(createSalaryOption(20101, 20, "交通补贴", false));
+
+        // 调用
+        List<HrmSalaryOptionDO> options = salaryOptionService.getSalaryOptionList(true);
+
+        // 断言
+        assertEquals(1, options.size());
+        assertEquals(Integer.valueOf(10101), options.get(0).getCode());
+    }
+
+    @Test
+    public void testSyncSalaryOption() {
+        // mock 数据
+        HrmSalaryOptionTemplateDO categoryTemplate = createSalaryOptionTemplate(10, 0, "基本工资");
+        salaryOptionTemplateMapper.insert(categoryTemplate);
+        HrmSalaryOptionTemplateDO optionTemplate = createSalaryOptionTemplate(10101, 10, "基本工资");
+        salaryOptionTemplateMapper.insert(optionTemplate);
+        HrmSalaryOptionDO disabledOption = createSalaryOption(10101, 10, "旧基本工资", false)
+                .setTemplateId(optionTemplate.getId()).setEnabled(false).setVisible(false);
+        salaryOptionMapper.insert(disabledOption);
+
+        // 调用
+        salaryOptionService.syncSalaryOption();
+        List<HrmSalaryOptionDO> list = salaryOptionService.getSalaryOptionList();
+
+        // 断言
+        assertEquals(2L, salaryOptionMapper.selectCount());
+        HrmSalaryOptionDO syncedOption = salaryOptionMapper.selectById(disabledOption.getId());
+        assertEquals("基本工资", syncedOption.getName());
+        assertFalse(syncedOption.getEnabled());
+        assertFalse(syncedOption.getVisible());
+        assertEquals(optionTemplate.getId(), syncedOption.getTemplateId());
+        assertEquals(2, list.size());
+        assertEquals(Integer.valueOf(10), list.get(0).getCode());
+        assertEquals(Integer.valueOf(10101), list.get(1).getCode());
+        assertEquals(categoryTemplate.getId(), list.get(0).getTemplateId());
+        assertEquals(optionTemplate.getId(), list.get(1).getTemplateId());
+    }
+
+    @Test
+    public void testSyncSalaryOption_customCodeOccupied() {
+        // mock 数据
+        salaryOptionTemplateMapper.insert(createSalaryOptionTemplate(10101, 10, "基本工资"));
+        salaryOptionMapper.insert(createSalaryOption(10101, 10, "租户自定义项", false));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryOptionService.syncSalaryOption(),
+                SALARY_OPTION_CODE_OCCUPIED, 10101);
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalaryOptionSaveReqVO createSalaryOptionReqVO(String name) {
+        return new HrmSalaryOptionSaveReqVO().setParentCode(30).setName(name);
+    }
+
+    private HrmSalaryOptionDO createSalaryOption(Integer code, Integer parentCode, String name,
+                                                  Boolean systemFlag) {
+        return HrmSalaryOptionDO.builder().code(code).parentCode(parentCode).name(name)
+                .systemFlag(systemFlag).type(1).taxEnabled(true).visible(true)
+                .calculateEnabled(true).enabled(true).build();
+    }
+
+    private HrmSalaryOptionTemplateDO createSalaryOptionTemplate(Integer code, Integer parentCode, String name) {
+        return HrmSalaryOptionTemplateDO.builder().code(code).parentCode(parentCode).name(name)
+                .systemFlag(false).type(1).taxEnabled(true).visible(true).calculateEnabled(true).build();
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleServiceImplTest.java
new file mode 100644
index 0000000..ec1271f
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/config/HrmSalaryTaxRuleServiceImplTest.java
@@ -0,0 +1,194 @@
+package cn.iocoder.yudao.module.hrm.service.salary.config;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.taxrule.HrmSalaryTaxRuleSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.config.HrmSalaryTaxRuleMapper;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Consumer;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertPojoEquals;
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomString;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_TAX_RULE_NAME_DUPLICATE;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_TAX_RULE_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_TAX_RULE_USED;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalaryTaxRuleServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryTaxRuleServiceImpl.class)
+public class HrmSalaryTaxRuleServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryTaxRuleServiceImpl salaryTaxRuleService;
+
+    @Resource
+    private HrmSalaryTaxRuleMapper salaryTaxRuleMapper;
+
+    @MockitoBean
+    private HrmSalaryGroupService salaryGroupService;
+
+    @Test
+    public void testCreateSalaryTaxRule_success() {
+        // 准备参数
+        HrmSalaryTaxRuleSaveReqVO reqVO = randomSalaryTaxRuleSaveReqVO();
+
+        // 调用
+        Long salaryTaxRuleId = salaryTaxRuleService.createSalaryTaxRule(reqVO);
+
+        // 断言
+        assertNotNull(salaryTaxRuleId);
+        assertPojoEquals(reqVO, salaryTaxRuleMapper.selectById(salaryTaxRuleId), "id");
+    }
+
+    @Test
+    public void testCreateSalaryTaxRule_nameDuplicate() {
+        // mock 数据
+        HrmSalaryTaxRuleDO dbSalaryTaxRule = randomSalaryTaxRuleDO();
+        salaryTaxRuleMapper.insert(dbSalaryTaxRule);
+        // 准备参数
+        HrmSalaryTaxRuleSaveReqVO reqVO = randomSalaryTaxRuleSaveReqVO(
+                o -> o.setName(dbSalaryTaxRule.getName()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryTaxRuleService.createSalaryTaxRule(reqVO),
+                SALARY_TAX_RULE_NAME_DUPLICATE);
+    }
+
+    @Test
+    public void testUpdateSalaryTaxRule_usedSuccess() {
+        // mock 数据
+        HrmSalaryTaxRuleDO dbSalaryTaxRule = randomSalaryTaxRuleDO();
+        salaryTaxRuleMapper.insert(dbSalaryTaxRule);
+        when(salaryGroupService.getSalaryGroupCountByTaxRuleId(dbSalaryTaxRule.getId())).thenReturn(1L);
+        // 准备参数
+        HrmSalaryTaxRuleSaveReqVO reqVO = randomSalaryTaxRuleSaveReqVO(o -> o
+                .setId(dbSalaryTaxRule.getId()).setType(HrmSalaryTaxTypeEnum.NONE.getType()).setTaxEnabled(false)
+                .setThreshold(new BigDecimal("0.00")).setDecimalScale(null).setCycleType(null));
+
+        // 调用
+        salaryTaxRuleService.updateSalaryTaxRule(reqVO);
+
+        // 断言
+        HrmSalaryTaxRuleDO salaryTaxRule = salaryTaxRuleMapper.selectById(dbSalaryTaxRule.getId());
+        assertPojoEquals(reqVO, salaryTaxRule);
+        assertNull(salaryTaxRule.getDecimalScale());
+        assertNull(salaryTaxRule.getCycleType());
+    }
+
+    @Test
+    public void testUpdateSalaryTaxRule_notExists() {
+        // 准备参数
+        HrmSalaryTaxRuleSaveReqVO reqVO = randomSalaryTaxRuleSaveReqVO(
+                o -> o.setId(randomLongId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryTaxRuleService.updateSalaryTaxRule(reqVO),
+                SALARY_TAX_RULE_NOT_EXISTS);
+    }
+
+    @Test
+    public void testDeleteSalaryTaxRule_success() {
+        // mock 数据
+        HrmSalaryTaxRuleDO dbSalaryTaxRule = randomSalaryTaxRuleDO();
+        salaryTaxRuleMapper.insert(dbSalaryTaxRule);
+        // mock 方法
+        when(salaryGroupService.getSalaryGroupCountByTaxRuleId(dbSalaryTaxRule.getId())).thenReturn(0L);
+
+        // 调用
+        salaryTaxRuleService.deleteSalaryTaxRule(dbSalaryTaxRule.getId());
+
+        // 断言
+        assertNull(salaryTaxRuleMapper.selectById(dbSalaryTaxRule.getId()));
+    }
+
+    @Test
+    public void testDeleteSalaryTaxRule_used() {
+        // mock 数据
+        HrmSalaryTaxRuleDO dbSalaryTaxRule = randomSalaryTaxRuleDO();
+        salaryTaxRuleMapper.insert(dbSalaryTaxRule);
+        // mock 方法
+        when(salaryGroupService.getSalaryGroupCountByTaxRuleId(dbSalaryTaxRule.getId())).thenReturn(1L);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryTaxRuleService.deleteSalaryTaxRule(dbSalaryTaxRule.getId()),
+                SALARY_TAX_RULE_USED);
+    }
+
+    @Test
+    public void testGetSalaryTaxRule() {
+        // mock 数据
+        HrmSalaryTaxRuleDO dbSalaryTaxRule = randomSalaryTaxRuleDO();
+        salaryTaxRuleMapper.insert(dbSalaryTaxRule);
+
+        // 调用
+        HrmSalaryTaxRuleDO salaryTaxRule = salaryTaxRuleService.getSalaryTaxRule(dbSalaryTaxRule.getId());
+
+        // 断言
+        assertPojoEquals(dbSalaryTaxRule, salaryTaxRule);
+    }
+
+    @Test
+    public void testGetSalaryTaxRuleList() {
+        // mock 数据
+        HrmSalaryTaxRuleDO firstSalaryTaxRule = randomSalaryTaxRuleDO();
+        salaryTaxRuleMapper.insert(firstSalaryTaxRule);
+        HrmSalaryTaxRuleDO secondSalaryTaxRule = randomSalaryTaxRuleDO();
+        salaryTaxRuleMapper.insert(secondSalaryTaxRule);
+
+        // 调用
+        List<HrmSalaryTaxRuleDO> salaryTaxRules = salaryTaxRuleService.getSalaryTaxRuleList();
+        Map<Long, HrmSalaryTaxRuleDO> salaryTaxRuleMap = salaryTaxRuleService.getSalaryTaxRuleMap(
+                Arrays.asList(firstSalaryTaxRule.getId(), secondSalaryTaxRule.getId()));
+
+        // 断言
+        assertEquals(Arrays.asList(firstSalaryTaxRule, secondSalaryTaxRule), salaryTaxRules);
+        assertPojoEquals(firstSalaryTaxRule, salaryTaxRuleMap.get(firstSalaryTaxRule.getId()));
+        assertEquals(2, salaryTaxRuleMap.size());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalaryTaxRuleDO randomSalaryTaxRuleDO(Consumer<HrmSalaryTaxRuleDO>... consumers) {
+        return randomPojo(HrmSalaryTaxRuleDO.class, o -> {
+            o.setId(null).setName(randomString()).setType(HrmSalaryTaxTypeEnum.SALARY.getType()).setTaxEnabled(true)
+                    .setThreshold(new BigDecimal("5000.00")).setDecimalScale(2)
+                    .setCycleType(HrmSalaryTaxCycleTypeEnum.DECEMBER_TO_NOVEMBER.getType());
+            for (Consumer<HrmSalaryTaxRuleDO> consumer : consumers) {
+                consumer.accept(o);
+            }
+        });
+    }
+
+    private HrmSalaryTaxRuleSaveReqVO randomSalaryTaxRuleSaveReqVO(
+            Consumer<HrmSalaryTaxRuleSaveReqVO>... consumers) {
+        return randomPojo(HrmSalaryTaxRuleSaveReqVO.class, o -> {
+            o.setId(null).setName(randomString()).setType(HrmSalaryTaxTypeEnum.SALARY.getType()).setTaxEnabled(true)
+                    .setThreshold(new BigDecimal("6000.00")).setDecimalScale(2)
+                    .setCycleType(HrmSalaryTaxCycleTypeEnum.JANUARY_TO_DECEMBER.getType());
+            for (Consumer<HrmSalaryTaxRuleSaveReqVO> consumer : consumers) {
+                consumer.accept(o);
+            }
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordServiceImplTest.java
new file mode 100644
index 0000000..dd0ac2a
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryChangeRecordServiceImplTest.java
@@ -0,0 +1,237 @@
+package cn.iocoder.yudao.module.hrm.service.salary.employee;
+
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.employee.HrmSalaryChangeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.Collections;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_RECORD_STATUS_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * {@link HrmSalaryChangeRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryChangeRecordServiceImpl.class)
+public class HrmSalaryChangeRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryChangeRecordServiceImpl salaryChangeRecordService;
+    @Resource
+    private HrmSalaryChangeRecordMapper salaryChangeRecordMapper;
+
+    @Test
+    public void testCreateSalaryChangeRecord_success() {
+        // 准备参数
+        HrmSalaryChangeRecordDO changeRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now().plusDays(1));
+
+        // 调用
+        Long id = salaryChangeRecordService.createSalaryChangeRecord(changeRecord);
+
+        // 断言
+        assertEquals(changeRecord.getId(), id);
+        assertEquals(changeRecord.getRemark(), salaryChangeRecordMapper.selectById(id).getRemark());
+    }
+
+    @Test
+    public void testUpdateSalaryChangeRecord_success() {
+        // mock 数据
+        HrmSalaryChangeRecordDO changeRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now().plusDays(1));
+        salaryChangeRecordMapper.insert(changeRecord);
+        // 准备参数
+        changeRecord.setRemark("调整后备注");
+
+        // 调用
+        salaryChangeRecordService.updateSalaryChangeRecord(changeRecord);
+
+        // 断言
+        assertEquals("调整后备注", salaryChangeRecordMapper.selectById(changeRecord.getId()).getRemark());
+    }
+
+    @Test
+    public void testUpdateSalaryChangeRecordStatus_compareAndSet() {
+        // mock 数据
+        HrmSalaryChangeRecordDO changeRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                        LocalDate.now().plusDays(1));
+        salaryChangeRecordMapper.insert(changeRecord);
+
+        // 调用
+        boolean firstUpdated = salaryChangeRecordService.updateSalaryChangeRecordStatus(
+                changeRecord.getId(), HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus());
+        boolean repeatedUpdated = salaryChangeRecordService.updateSalaryChangeRecordStatus(
+                changeRecord.getId(), HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus());
+
+        // 断言
+        assertTrue(firstUpdated);
+        assertFalse(repeatedUpdated);
+        assertEquals(HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus(),
+                salaryChangeRecordMapper.selectById(changeRecord.getId()).getStatus());
+    }
+
+    @Test
+    public void testValidateSalaryChangeRecordExists_notExists() {
+        // 准备参数
+        Long id = randomLongId();
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryChangeRecordService.validateSalaryChangeRecordExists(id),
+                SALARY_CHANGE_RECORD_NOT_EXISTS);
+    }
+
+    @Test
+    public void testHasPendingSalaryChangeRecord() {
+        // mock 数据
+        HrmSalaryChangeRecordDO pendingRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now().plusDays(1));
+        salaryChangeRecordMapper.insert(pendingRecord);
+
+        // 调用，并断言
+        assertTrue(salaryChangeRecordService.hasPendingSalaryChangeRecord(
+                pendingRecord.getEmployeeId(), null));
+        assertFalse(salaryChangeRecordService.hasPendingSalaryChangeRecord(
+                pendingRecord.getEmployeeId(), pendingRecord.getId()));
+    }
+
+    @Test
+    public void testGetSalarySetRecordByEmployeeId_duplicateReturnsLatest() {
+        // mock 数据
+        Long employeeId = randomLongId();
+        HrmSalaryChangeRecordDO firstRecord = createSalaryChangeRecord(
+                employeeId, HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus(), LocalDate.now().minusDays(1));
+        firstRecord.setType(HrmSalaryChangeRecordTypeEnum.SALARY_SET.getType());
+        salaryChangeRecordMapper.insert(firstRecord);
+        HrmSalaryChangeRecordDO latestRecord = createSalaryChangeRecord(
+                employeeId, HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus(), LocalDate.now());
+        latestRecord.setType(HrmSalaryChangeRecordTypeEnum.SALARY_SET.getType());
+        salaryChangeRecordMapper.insert(latestRecord);
+
+        // 调用
+        HrmSalaryChangeRecordDO result = salaryChangeRecordService.getSalarySetRecordByEmployeeId(employeeId);
+
+        // 断言
+        assertEquals(latestRecord.getId(), result.getId());
+    }
+
+    @Test
+    public void testGetDueSalaryChangeCount() {
+        // mock 数据
+        HrmSalaryChangeRecordDO dueRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now());
+        HrmSalaryChangeRecordDO futureRecord =
+                createSalaryChangeRecord(1002L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now().plusDays(1));
+        salaryChangeRecordMapper.insert(dueRecord);
+        salaryChangeRecordMapper.insert(futureRecord);
+
+        // 调用
+        long count = salaryChangeRecordService.getDueSalaryChangeCount(LocalDate.now());
+
+        // 断言
+        assertEquals(1, count);
+    }
+
+    @Test
+    public void testGetDueSalaryChangeRecordList() {
+        // mock 数据
+        HrmSalaryChangeRecordDO dueRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now());
+        salaryChangeRecordMapper.insert(dueRecord);
+        salaryChangeRecordMapper.insert(
+                createSalaryChangeRecord(1002L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now().plusDays(1)));
+
+        // 调用
+        HrmSalaryChangeRecordDO result =
+                salaryChangeRecordService.getDueSalaryChangeRecordList(LocalDate.now()).get(0);
+
+        // 断言
+        assertEquals(dueRecord.getId(),
+                result.getId());
+    }
+
+    @Test
+    public void testCancelChangeRecord_success() {
+        // mock 数据
+        HrmSalaryChangeRecordDO changeRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), LocalDate.now().plusDays(1));
+        salaryChangeRecordMapper.insert(changeRecord);
+
+        // 调用
+        salaryChangeRecordService.cancelSalaryChangeRecord(changeRecord.getId());
+
+        // 断言
+        assertEquals(HrmSalaryChangeRecordStatusEnum.CANCELLED.getStatus(),
+                salaryChangeRecordMapper.selectById(changeRecord.getId()).getStatus());
+    }
+
+    @Test
+    public void testDeleteChangeRecord_success() {
+        // mock 数据
+        HrmSalaryChangeRecordDO changeRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.CANCELLED.getStatus(), LocalDate.now().plusDays(1));
+        salaryChangeRecordMapper.insert(changeRecord);
+
+        // 调用
+        salaryChangeRecordService.deleteSalaryChangeRecord(changeRecord.getId());
+
+        // 断言
+        assertNull(salaryChangeRecordMapper.selectById(changeRecord.getId()));
+    }
+
+    @Test
+    public void testDeleteChangeRecord_effective() {
+        // mock 数据
+        HrmSalaryChangeRecordDO changeRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus(), LocalDate.now());
+        salaryChangeRecordMapper.insert(changeRecord);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryChangeRecordService.deleteSalaryChangeRecord(changeRecord.getId()),
+                SALARY_CHANGE_RECORD_STATUS_INVALID);
+    }
+
+    @Test
+    public void testCancelChangeRecord_effective() {
+        // mock 数据
+        HrmSalaryChangeRecordDO changeRecord =
+                createSalaryChangeRecord(1001L, HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus(), LocalDate.now());
+        salaryChangeRecordMapper.insert(changeRecord);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryChangeRecordService.cancelSalaryChangeRecord(changeRecord.getId()),
+                SALARY_CHANGE_RECORD_STATUS_INVALID);
+    }
+
+    // ========== 随机对象 ==========
+
+    private static HrmSalaryChangeRecordDO createSalaryChangeRecord(
+            Long employeeId, Integer status, LocalDate effectDate) {
+        return HrmSalaryChangeRecordDO.builder()
+                .employeeId(employeeId).type(HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType()).reason(3)
+                .effectTime(effectDate.atStartOfDay())
+                .beforeTotal(new BigDecimal("8000.00")).afterTotal(new BigDecimal("9000.00"))
+                .probationBeforeTotal(new BigDecimal("6000.00"))
+                .probationAfterTotal(new BigDecimal("7000.00"))
+                .salaryOptions(Collections.emptyList()).probationSalaryOptions(Collections.emptyList())
+                .status(status).remark("测试调薪").build();
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoServiceImplTest.java
new file mode 100644
index 0000000..064fae2
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/employee/HrmSalaryEmployeeInfoServiceImplTest.java
@@ -0,0 +1,533 @@
+package cn.iocoder.yudao.module.hrm.service.salary.employee;
+
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeePageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoImportRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.employeeinfo.HrmSalaryEmployeeInfoUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.employee.HrmSalaryEmployeeInfoMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryBatchAdjustTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeReasonEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryChangeRecordTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeInfoChangeTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_EFFECT_DATE_INVALID;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CHANGE_RECORD_STATUS_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.doAnswer;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.verifyNoInteractions;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalaryEmployeeInfoServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryEmployeeInfoServiceImpl.class)
+public class HrmSalaryEmployeeInfoServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryEmployeeInfoServiceImpl salaryEmployeeInfoService;
+
+    @Resource
+    private HrmSalaryEmployeeInfoMapper salaryEmployeeInfoMapper;
+
+    @MockitoBean
+    private HrmSalaryOptionService salaryOptionService;
+    @MockitoBean
+    private HrmSalaryChangeRecordService salaryChangeRecordService;
+    @MockitoBean
+    private HrmSalaryMonthRecordService salaryMonthRecordService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testGetSalaryEmployeeInfoPage_noMatchedEmployee() {
+        // mock 数据
+        salaryEmployeeInfoMapper.insert(HrmSalaryEmployeeInfoDO.builder()
+                .employeeId(1L).changeType(HrmSalaryEmployeeInfoChangeTypeEnum.SET.getType()).build());
+        // 准备参数
+        HrmSalaryEmployeeInfoPageReqVO reqVO = new HrmSalaryEmployeeInfoPageReqVO();
+        reqVO.setEmployeeId(2L);
+        reqVO.setChangeType(HrmSalaryEmployeeInfoChangeTypeEnum.SET.getType());
+
+        // 调用
+        PageResult<HrmEmployeeDO> result =
+                salaryEmployeeInfoService.getSalaryEmployeeInfoPage(reqVO);
+
+        // 断言
+        assertTrue(result.getList().isEmpty());
+        assertEquals(0L, result.getTotal());
+        verifyNoInteractions(employeeService);
+    }
+
+    @Test
+    public void testGetSalaryEmployeeInfoPage_unsetSalary() {
+        // mock 数据
+        salaryEmployeeInfoMapper.insert(HrmSalaryEmployeeInfoDO.builder()
+                .employeeId(1L).changeType(HrmSalaryEmployeeInfoChangeTypeEnum.SET.getType()).build());
+        when(employeeService.getEmployeePage(any())).thenReturn(PageResult.empty());
+        // 准备参数
+        HrmSalaryEmployeeInfoPageReqVO reqVO = new HrmSalaryEmployeeInfoPageReqVO();
+        reqVO.setEmployeeIds(Arrays.asList(2L, 3L));
+        reqVO.setChangeType(HrmSalaryEmployeeInfoChangeTypeEnum.UNSET.getType());
+
+        // 调用
+        salaryEmployeeInfoService.getSalaryEmployeeInfoPage(reqVO);
+
+        // 断言
+        ArgumentCaptor<HrmEmployeePageReqVO> reqVOCaptor =
+                ArgumentCaptor.forClass(HrmEmployeePageReqVO.class);
+        verify(employeeService).getEmployeePage(reqVOCaptor.capture());
+        assertEquals(Arrays.asList(2L, 3L), reqVOCaptor.getValue().getIds());
+        assertEquals(Collections.singletonList(1L), reqVOCaptor.getValue().getExcludeIds());
+    }
+
+    @Test
+    public void testGetSalaryEmployeeInfoStatusCount() {
+        // mock 数据
+        Map<Integer, Long> expectedCountMap = Collections.singletonMap(
+                HrmEmployeeStatusEnum.REGULAR.getStatus(), 2L);
+        when(employeeService.getEmployeeStatusCount(any())).thenReturn(expectedCountMap);
+        // 准备参数
+        HrmSalaryEmployeeInfoPageReqVO reqVO = new HrmSalaryEmployeeInfoPageReqVO();
+        reqVO.setEmployeeIds(Arrays.asList(1L, 2L));
+
+        // 调用
+        Map<Integer, Long> countMap =
+                salaryEmployeeInfoService.getSalaryEmployeeInfoStatusCount(reqVO);
+
+        // 断言
+        assertEquals(expectedCountMap, countMap);
+    }
+
+    @Test
+    public void testUpdateSalaryEmployeeInfo_setSalary() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        mockCreateChangeRecord();
+        // 准备参数
+        HrmSalaryEmployeeInfoUpdateReqVO reqVO =
+                buildSetSalaryReqVO(employee.getId(), new BigDecimal("8000"),
+                        new BigDecimal("2000"), new BigDecimal("6000"));
+
+        // 调用
+        Long changeRecordId = salaryEmployeeInfoService.updateSalaryEmployeeInfo(reqVO);
+
+        // 断言
+        assertEquals(99L, changeRecordId);
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                salaryEmployeeInfoMapper.selectByEmployeeId(employee.getId());
+        assertNotNull(salaryEmployeeInfo);
+        assertEquals(HrmSalaryEmployeeInfoChangeTypeEnum.SET.getType(), salaryEmployeeInfo.getChangeType());
+        assertAmount("10000.00", salaryEmployeeInfo.getRegularSalary());
+        assertAmount("6000.00", salaryEmployeeInfo.getProbationSalary());
+        ArgumentCaptor<HrmSalaryChangeRecordDO> recordCaptor =
+                ArgumentCaptor.forClass(HrmSalaryChangeRecordDO.class);
+        verify(salaryChangeRecordService).createSalaryChangeRecord(recordCaptor.capture());
+        HrmSalaryChangeRecordDO changeRecord = recordCaptor.getValue();
+        assertEquals(HrmSalaryChangeReasonEnum.ENTRY_SALARY.getReason(), changeRecord.getReason());
+        assertEquals(HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus(), changeRecord.getStatus());
+        assertAmount("0", changeRecord.getBeforeTotal());
+        assertAmount("10000.00", changeRecord.getAfterTotal());
+    }
+
+    @Test
+    public void testUpdateSalaryEmployeeInfo_adjustmentPending() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        salaryEmployeeInfoMapper.insert(buildSalaryEmployeeInfo(employee.getId()));
+        mockCreateChangeRecord();
+        // 准备参数
+        HrmSalaryEmployeeInfoUpdateReqVO reqVO =
+                buildAdjustmentReqVO(employee.getId(), LocalDate.now().plusDays(1));
+
+        // 调用
+        salaryEmployeeInfoService.updateSalaryEmployeeInfo(reqVO);
+
+        // 断言
+        assertAmount("10000.00", salaryEmployeeInfoMapper
+                .selectByEmployeeId(employee.getId()).getRegularSalary());
+        ArgumentCaptor<HrmSalaryChangeRecordDO> recordCaptor =
+                ArgumentCaptor.forClass(HrmSalaryChangeRecordDO.class);
+        verify(salaryChangeRecordService).createSalaryChangeRecord(recordCaptor.capture());
+        assertEquals(HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(), recordCaptor.getValue().getStatus());
+        assertAmount("10000.00", recordCaptor.getValue().getBeforeTotal());
+        assertAmount("11000.00", recordCaptor.getValue().getAfterTotal());
+    }
+
+    @Test
+    public void testUpdateSalaryEmployeeInfo_adjustmentEffective() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        salaryEmployeeInfoMapper.insert(buildSalaryEmployeeInfo(employee.getId()));
+        mockCreateChangeRecord();
+        // 准备参数
+        HrmSalaryEmployeeInfoUpdateReqVO reqVO =
+                buildAdjustmentReqVO(employee.getId(), LocalDate.now());
+        reqVO.setEffectTime(LocalDate.now().atTime(15, 30));
+
+        // 调用
+        salaryEmployeeInfoService.updateSalaryEmployeeInfo(reqVO);
+
+        // 断言
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo =
+                salaryEmployeeInfoMapper.selectByEmployeeId(employee.getId());
+        assertEquals(HrmSalaryEmployeeInfoChangeTypeEnum.ADJUSTED.getType(), salaryEmployeeInfo.getChangeType());
+        assertAmount("11000.00", salaryEmployeeInfo.getRegularSalary());
+        ArgumentCaptor<HrmSalaryChangeRecordDO> recordCaptor =
+                ArgumentCaptor.forClass(HrmSalaryChangeRecordDO.class);
+        verify(salaryChangeRecordService).createSalaryChangeRecord(recordCaptor.capture());
+        assertEquals(HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus(), recordCaptor.getValue().getStatus());
+        assertEquals(LocalDate.now().atStartOfDay(), recordCaptor.getValue().getEffectTime());
+        assertEquals(LocalDate.now().atStartOfDay(), salaryEmployeeInfo.getEffectTime());
+    }
+
+    @Test
+    public void testUpdateSalaryEmployeeInfoList_percentPrecision() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        salaryEmployeeInfoMapper.insert(buildSalaryEmployeeInfo(employee.getId()));
+        when(employeeService.getEmployeeListByDeptIds(Collections.emptyList()))
+                .thenReturn(Collections.emptyList());
+        mockCreateChangeRecord();
+        // 准备参数
+        HrmSalaryEmployeeInfoUpdateListReqVO reqVO = new HrmSalaryEmployeeInfoUpdateListReqVO()
+                .setEmployeeIds(Collections.singletonList(employee.getId()))
+                .setDeptIds(Collections.emptyList())
+                .setType(HrmSalaryBatchAdjustTypeEnum.PERCENT.getType())
+                .setChangeReason(HrmSalaryChangeReasonEnum.PROMOTION.getReason())
+                .setEffectTime(LocalDate.now().atStartOfDay())
+                .setSalaryOptions(Collections.singletonList(
+                        optionValue(10101, "基本工资", new BigDecimal("2.5"))));
+
+        // 调用
+        salaryEmployeeInfoService.updateSalaryEmployeeInfoList(reqVO);
+
+        // 断言
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo = salaryEmployeeInfoMapper
+                .selectByEmployeeId(employee.getId());
+        assertAmount("10200.00", salaryEmployeeInfo.getRegularSalary());
+        assertAmount("8200.00", salaryEmployeeInfo.getSalaryOptions().get(0).getValue());
+    }
+
+    @Test
+    public void testUpdateSalaryEmployeeInfoList_smallPercentPrecision() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        salaryEmployeeInfoMapper.insert(buildSalaryEmployeeInfo(employee.getId()));
+        when(employeeService.getEmployeeListByDeptIds(Collections.emptyList()))
+                .thenReturn(Collections.emptyList());
+        mockCreateChangeRecord();
+        // 准备参数
+        HrmSalaryEmployeeInfoUpdateListReqVO reqVO = new HrmSalaryEmployeeInfoUpdateListReqVO()
+                .setEmployeeIds(Collections.singletonList(employee.getId()))
+                .setDeptIds(Collections.emptyList())
+                .setType(HrmSalaryBatchAdjustTypeEnum.PERCENT.getType())
+                .setChangeReason(HrmSalaryChangeReasonEnum.PROMOTION.getReason())
+                .setEffectTime(LocalDate.now().atStartOfDay())
+                .setSalaryOptions(Collections.singletonList(
+                        optionValue(10101, "基本工资", new BigDecimal("0.01"))));
+
+        // 调用
+        salaryEmployeeInfoService.updateSalaryEmployeeInfoList(reqVO);
+
+        // 断言
+        HrmSalaryEmployeeInfoDO salaryEmployeeInfo = salaryEmployeeInfoMapper
+                .selectByEmployeeId(employee.getId());
+        assertAmount("10000.80", salaryEmployeeInfo.getRegularSalary());
+        assertAmount("8000.80", salaryEmployeeInfo.getSalaryOptions().get(0).getValue());
+    }
+
+    @Test
+    public void testUpdateSalaryEmployeeInfo_fixedSalaryWithAdjustment() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        when(salaryChangeRecordService.hasUncancelledSalaryAdjustmentRecord(employee.getId()))
+                .thenReturn(true);
+        // 准备参数
+        HrmSalaryEmployeeInfoUpdateReqVO reqVO =
+                buildSetSalaryReqVO(employee.getId(), new BigDecimal("8000"),
+                        new BigDecimal("2000"), new BigDecimal("6000"));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryEmployeeInfoService.updateSalaryEmployeeInfo(reqVO),
+                SALARY_CHANGE_RECORD_STATUS_INVALID);
+    }
+
+    @Test
+    public void testUpdateSalaryEmployeeInfo_effectDateBeforeLastSalaryMonth() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        salaryEmployeeInfoMapper.insert(buildSalaryEmployeeInfo(employee.getId()));
+        LocalDate latestSalaryMonthBeginDate = LocalDate.now().withDayOfMonth(1);
+        when(salaryMonthRecordService.getLastMonthRecord()).thenReturn(
+                HrmSalaryMonthRecordDO.builder()
+                        .year(latestSalaryMonthBeginDate.getYear())
+                        .month(latestSalaryMonthBeginDate.getMonthValue()).build());
+        // 准备参数
+        HrmSalaryEmployeeInfoUpdateReqVO reqVO =
+                buildAdjustmentReqVO(employee.getId(), latestSalaryMonthBeginDate.minusDays(1));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salaryEmployeeInfoService.updateSalaryEmployeeInfo(reqVO),
+                SALARY_CHANGE_EFFECT_DATE_INVALID);
+    }
+
+    @Test
+    public void testGetSalaryImportOptionList() {
+        // mock 数据
+        List<HrmSalaryOptionDO> options = buildSalaryOptions();
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(options);
+
+        // 调用
+        List<HrmSalaryOptionDO> result =
+                salaryEmployeeInfoService.getSalaryImportOptionList();
+
+        // 断言
+        assertEquals(2, result.size());
+        assertEquals(Arrays.asList(10101, 10102),
+                Arrays.asList(result.get(0).getCode(), result.get(1).getCode()));
+    }
+
+    @Test
+    public void testImportFixSalaryList_successAndFailure() {
+        // mock 数据
+        mockSalaryOptions();
+        HrmEmployeeDO employee = mockEmployee(1L, HrmEmployeeStatusEnum.REGULAR.getStatus());
+        employee.setJobNumber("NO-导入定薪");
+        when(employeeService.getEmployeeByJobNumber(employee.getJobNumber())).thenReturn(employee);
+        mockCreateChangeRecord();
+        Map<Integer, String> successRow = row(
+                1, employee.getJobNumber(), 4, "6000", 5, "0",
+                6, "8000", 7, "2000", 8, "导入定薪");
+        Map<Integer, String> failureRow = row(1, "NO-不存在");
+
+        // 调用
+        HrmSalaryEmployeeInfoImportRespVO result =
+                salaryEmployeeInfoService.importFixSalaryList(
+                        Arrays.asList(successRow, failureRow));
+
+        // 断言
+        assertEquals(Collections.singletonList(employee.getJobNumber()),
+                result.getSuccessJobNumbers());
+        assertEquals("工号对应的员工不存在",
+                result.getFailureJobNumbers().get("NO-不存在"));
+        assertAmount("10000.00", salaryEmployeeInfoMapper
+                .selectByEmployeeId(employee.getId()).getRegularSalary());
+    }
+
+    @Test
+    public void testApplyDueSalaryChanges_success() {
+        // mock 数据
+        mockSalaryOptions();
+        Long employeeId = 1L;
+        salaryEmployeeInfoMapper.insert(buildSalaryEmployeeInfo(employeeId));
+        HrmSalaryChangeRecordDO changeRecord = HrmSalaryChangeRecordDO.builder()
+                .id(99L).employeeId(employeeId).type(HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType())
+                .reason(HrmSalaryChangeReasonEnum.PROMOTION.getReason()).effectTime(LocalDate.now().atStartOfDay())
+                .salaryOptions(Arrays.asList(
+                        changeRecordOption(10101, "基本工资", new BigDecimal("9000")),
+                        changeRecordOption(10102, "岗位工资", new BigDecimal("2000"))))
+                .probationSalaryOptions(Collections.singletonList(
+                        changeRecordOption(10101, "基本工资", new BigDecimal("6500"))))
+                .status(HrmSalaryChangeRecordStatusEnum.PENDING.getStatus()).build();
+        when(salaryChangeRecordService.getDueSalaryChangeRecordList(LocalDate.now()))
+                .thenReturn(Collections.singletonList(changeRecord));
+        when(salaryChangeRecordService.updateSalaryChangeRecordStatus(
+                changeRecord.getId(), HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus())).thenReturn(true);
+
+        // 调用
+        List<Long> employeeIds =
+                salaryEmployeeInfoService.applyDueSalaryChanges(LocalDate.now());
+
+        // 断言
+        assertEquals(Collections.singletonList(employeeId), employeeIds);
+        assertAmount("11000.00", salaryEmployeeInfoMapper
+                .selectByEmployeeId(employeeId).getRegularSalary());
+        verify(salaryChangeRecordService).updateSalaryChangeRecordStatus(
+                changeRecord.getId(), HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus());
+        verify(salaryChangeRecordService, never()).updateSalaryChangeRecord(any());
+    }
+
+    @Test
+    public void testApplyDueSalaryChanges_statusChanged() {
+        // mock 数据
+        Long employeeId = 1L;
+        salaryEmployeeInfoMapper.insert(buildSalaryEmployeeInfo(employeeId));
+        HrmSalaryChangeRecordDO changeRecord = HrmSalaryChangeRecordDO.builder()
+                .id(99L).employeeId(employeeId)
+                .status(HrmSalaryChangeRecordStatusEnum.PENDING.getStatus()).build();
+        when(salaryChangeRecordService.getDueSalaryChangeRecordList(LocalDate.now()))
+                .thenReturn(Collections.singletonList(changeRecord));
+        when(salaryChangeRecordService.updateSalaryChangeRecordStatus(
+                changeRecord.getId(), HrmSalaryChangeRecordStatusEnum.PENDING.getStatus(),
+                HrmSalaryChangeRecordStatusEnum.EFFECTIVE.getStatus())).thenReturn(false);
+
+        // 调用
+        List<Long> employeeIds = salaryEmployeeInfoService.applyDueSalaryChanges(LocalDate.now());
+
+        // 断言
+        assertTrue(employeeIds.isEmpty());
+        assertAmount("10000.00", salaryEmployeeInfoMapper
+                .selectByEmployeeId(employeeId).getRegularSalary());
+    }
+
+    @Test
+    public void testGetSalaryEmployeeInfoList_empty() {
+        // 调用
+        List<HrmSalaryEmployeeInfoDO> result =
+                salaryEmployeeInfoService.getSalaryEmployeeInfoList(Collections.emptyList());
+
+        // 断言
+        assertTrue(result.isEmpty());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmEmployeeDO mockEmployee(Long id, Integer status) {
+        HrmEmployeeDO employee = HrmEmployeeDO.builder()
+                .id(id).name("测试员工").jobNumber("NO-" + id).status(status).build();
+        when(employeeService.validateEmployeeExists(id)).thenReturn(employee);
+        when(employeeService.getEmployee(id)).thenReturn(employee);
+        return employee;
+    }
+
+    private void mockSalaryOptions() {
+        when(salaryOptionService.getSalaryOptionList(false))
+                .thenReturn(buildSalaryOptions());
+    }
+
+    private void mockCreateChangeRecord() {
+        doAnswer(invocation -> {
+            HrmSalaryChangeRecordDO record = invocation.getArgument(0);
+            record.setId(99L);
+            return record.getId();
+        }).when(salaryChangeRecordService).createSalaryChangeRecord(
+                any(HrmSalaryChangeRecordDO.class));
+    }
+
+    private static HrmSalaryEmployeeInfoUpdateReqVO buildSetSalaryReqVO(
+            Long employeeId, BigDecimal regularBase,
+            BigDecimal regularPost, BigDecimal probationBase) {
+        return new HrmSalaryEmployeeInfoUpdateReqVO()
+                .setEmployeeId(employeeId).setRecordType(HrmSalaryChangeRecordTypeEnum.SALARY_SET.getType())
+                .setChangeReason(HrmSalaryChangeReasonEnum.ENTRY_SALARY.getReason())
+                .setEffectTime(LocalDate.of(2026, 7, 1).atStartOfDay())
+                .setSalaryOptions(Arrays.asList(
+                        optionValue(10101, "基本工资", regularBase),
+                        optionValue(10102, "岗位工资", regularPost)))
+                .setProbationSalaryOptions(Collections.singletonList(
+                        optionValue(10101, "基本工资", probationBase)));
+    }
+
+    private static HrmSalaryEmployeeInfoUpdateReqVO buildAdjustmentReqVO(
+            Long employeeId, LocalDate effectDate) {
+        return new HrmSalaryEmployeeInfoUpdateReqVO()
+                .setEmployeeId(employeeId).setRecordType(HrmSalaryChangeRecordTypeEnum.SALARY_ADJUSTMENT.getType())
+                .setChangeReason(HrmSalaryChangeReasonEnum.PROMOTION.getReason()).setEffectTime(effectDate.atStartOfDay())
+                .setSalaryOptions(Arrays.asList(
+                        optionValue(10101, "基本工资", new BigDecimal("9000")),
+                        optionValue(10102, "岗位工资", new BigDecimal("2000"))))
+                .setProbationSalaryOptions(Collections.singletonList(
+                        optionValue(10101, "基本工资", new BigDecimal("6500"))));
+    }
+
+    private static HrmSalaryEmployeeInfoDO buildSalaryEmployeeInfo(Long employeeId) {
+        return HrmSalaryEmployeeInfoDO.builder().employeeId(employeeId)
+                .changeType(HrmSalaryEmployeeInfoChangeTypeEnum.SET.getType()).effectTime(LocalDate.of(2026, 7, 1).atStartOfDay())
+                .regularSalary(new BigDecimal("10000"))
+                .probationSalary(new BigDecimal("6000"))
+                .salaryOptions(Arrays.asList(
+                        salaryOption(10101, "基本工资", new BigDecimal("8000")),
+                        salaryOption(10102, "岗位工资", new BigDecimal("2000"))))
+                .probationSalaryOptions(Collections.singletonList(
+                        salaryOption(10101, "基本工资", new BigDecimal("6000"))))
+                .build();
+    }
+
+    private static List<HrmSalaryOptionDO> buildSalaryOptions() {
+        return Arrays.asList(
+                optionDO(10, 0, "工资", false),
+                optionDO(10101, 10, "基本工资", true),
+                optionDO(10102, 10, "岗位工资", true));
+    }
+
+    private static HrmSalaryOptionDO optionDO(
+            Integer code, Integer parentCode, String name, boolean calculateEnabled) {
+        return new HrmSalaryOptionDO().setCode(code).setParentCode(parentCode)
+                .setName(name).setType(1).setTaxEnabled(true)
+                .setCalculateEnabled(calculateEnabled).setVisible(true).setEnabled(true);
+    }
+
+    private static HrmSalaryOptionValueVO optionValue(
+            Integer code, String name, BigDecimal value) {
+        return new HrmSalaryOptionValueVO().setCode(code).setName(name).setValue(value);
+    }
+
+    private static HrmSalaryEmployeeInfoDO.SalaryOption salaryOption(
+            Integer code, String name, BigDecimal value) {
+        return HrmSalaryEmployeeInfoDO.SalaryOption.builder()
+                .code(code).name(name).value(value).build();
+    }
+
+    private static HrmSalaryChangeRecordDO.SalaryOption changeRecordOption(
+            Integer code, String name, BigDecimal value) {
+        return HrmSalaryChangeRecordDO.SalaryOption.builder()
+                .code(code).name(name).value(value).build();
+    }
+
+    private static Map<Integer, String> row(Object... values) {
+        Map<Integer, String> row = new LinkedHashMap<>();
+        for (int i = 0; i < values.length; i += 2) {
+            row.put((Integer) values[i], String.valueOf(values[i + 1]));
+        }
+        return row;
+    }
+
+    private static void assertAmount(String expected, BigDecimal actual) {
+        assertEquals(0, new BigDecimal(expected).compareTo(actual));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordServiceImplTest.java
new file mode 100644
index 0000000..0df0686
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthEmployeeRecordServiceImplTest.java
@@ -0,0 +1,506 @@
+package cn.iocoder.yudao.module.hrm.service.salary.monthrecord;
+
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryGroupService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryTaxRuleService;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryEmployeeMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordUpdateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryPerformanceCoefficientReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.performance.plan.HrmPerformancePlanDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.monthrecord.HrmSalaryMonthEmployeeRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.employee.HrmSalaryEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionCodeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxCycleTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryTaxTypeEnum;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.performance.assessment.HrmPerformanceAssessmentService;
+import cn.iocoder.yudao.module.hrm.service.performance.plan.HrmPerformancePlanService;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalaryMonthEmployeeRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryMonthEmployeeRecordServiceImpl.class)
+public class HrmSalaryMonthEmployeeRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryMonthEmployeeRecordServiceImpl monthEmployeeRecordService;
+
+    @Resource
+    private HrmSalaryMonthEmployeeRecordMapper monthEmployeeRecordMapper;
+
+    @MockitoBean
+    private HrmSalaryMonthRecordService monthRecordService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @MockitoBean
+    private HrmPerformanceAssessmentService performanceAssessmentService;
+    @MockitoBean
+    private HrmPerformancePlanService performancePlanService;
+    @MockitoBean
+    private HrmSalaryOptionService salaryOptionService;
+    @MockitoBean
+    private HrmSalaryGroupService salaryGroupService;
+    @MockitoBean
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+
+    @Test
+    public void testUpdateMonthEmployeeRecordList_success() {
+        // mock 数据
+        HrmSalaryMonthEmployeeRecordDO firstRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        HrmSalaryMonthEmployeeRecordDO secondRecord = randomMonthEmployeeRecord(2001L, 1002L);
+        monthEmployeeRecordMapper.insert(firstRecord);
+        monthEmployeeRecordMapper.insert(secondRecord);
+        when(monthRecordService.validateMonthRecordEditableForUpdate(2001L))
+                .thenReturn(new HrmSalaryMonthRecordDO().setId(2001L));
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Collections.singletonList(
+                new HrmSalaryOptionDO().setCode(10101).setName("基本工资").setParentCode(10)));
+        HrmSalaryOptionValueVO salaryOption = new HrmSalaryOptionValueVO()
+                .setCode(10101).setName("基本工资").setValue(BigDecimal.valueOf(9000));
+        // 准备参数
+        HrmSalaryMonthEmployeeRecordUpdateReqVO firstReqVO = new HrmSalaryMonthEmployeeRecordUpdateReqVO();
+        firstReqVO.setId(firstRecord.getId()).setOptionValues(Collections.singletonList(salaryOption));
+        HrmSalaryMonthEmployeeRecordUpdateReqVO secondReqVO = new HrmSalaryMonthEmployeeRecordUpdateReqVO();
+        secondReqVO.setId(secondRecord.getId()).setOptionValues(Collections.singletonList(salaryOption));
+
+        // 调用
+        monthEmployeeRecordService.updateMonthEmployeeRecordList(Arrays.asList(firstReqVO, secondReqVO));
+
+        // 断言
+        assertEquals(0, BigDecimal.valueOf(9000).compareTo(
+                monthEmployeeRecordMapper.selectById(firstRecord.getId()).getExpectedPaySalary()));
+        assertEquals(0, BigDecimal.valueOf(9000).compareTo(
+                monthEmployeeRecordMapper.selectById(secondRecord.getId()).getExpectedPaySalary()));
+        verify(monthRecordService).validateMonthRecordEditableForUpdate(2001L);
+        verify(monthRecordService).updateMonthRecordSummary(2001L);
+    }
+
+    @Test
+    public void testSaveMonthEmployeeRecordList_keepIdAndDeleteRemovedRecord() {
+        // mock 数据
+        HrmSalaryMonthEmployeeRecordDO retainedRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        HrmSalaryMonthEmployeeRecordDO removedRecord = randomMonthEmployeeRecord(2001L, 1002L);
+        monthEmployeeRecordMapper.insert(retainedRecord);
+        monthEmployeeRecordMapper.insert(removedRecord);
+        HrmSalaryMonthEmployeeRecordDO updatedRecord = randomMonthEmployeeRecord(2001L, 1001L)
+                .setRealPaySalary(new BigDecimal("9000.00"));
+        HrmSalaryMonthEmployeeRecordDO addedRecord = randomMonthEmployeeRecord(2001L, 1003L);
+
+        // 调用
+        monthEmployeeRecordService.saveMonthEmployeeRecordList(
+                2001L, Arrays.asList(updatedRecord, addedRecord));
+
+        // 断言
+        assertEquals(retainedRecord.getId(), updatedRecord.getId());
+        assertEquals(0, new BigDecimal("9000.00").compareTo(
+                monthEmployeeRecordMapper.selectById(retainedRecord.getId()).getRealPaySalary()));
+        assertNull(monthEmployeeRecordMapper.selectById(removedRecord.getId()));
+        assertNotNull(addedRecord.getId());
+    }
+
+    @Test
+    public void testSaveMonthEmployeeRecordList_insertAfterDeletedRecord() {
+        // mock 数据
+        HrmSalaryMonthEmployeeRecordDO deletedRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        monthEmployeeRecordMapper.insert(deletedRecord);
+        monthEmployeeRecordMapper.deleteById(deletedRecord.getId());
+        HrmSalaryMonthEmployeeRecordDO newRecord = randomMonthEmployeeRecord(2001L, 1001L)
+                .setRealPaySalary(new BigDecimal("9100.00"));
+
+        // 调用
+        monthEmployeeRecordService.saveMonthEmployeeRecordList(
+                2001L, Collections.singletonList(newRecord));
+
+        // 断言
+        assertNotEquals(deletedRecord.getId(), newRecord.getId());
+        assertNull(monthEmployeeRecordMapper.selectById(deletedRecord.getId()));
+        HrmSalaryMonthEmployeeRecordDO result = monthEmployeeRecordMapper.selectById(newRecord.getId());
+        assertNotNull(result);
+        assertEquals(0, new BigDecimal("9100.00").compareTo(result.getRealPaySalary()));
+    }
+
+    @Test
+    public void testCalculateMonthEmployeeRecord_remunerationBelowThreshold() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Collections.singletonList(
+                salaryOption(10101, 10, "劳务报酬", true, true)));
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap = Collections.singletonMap(
+                employeeRecord.getEmployeeId(), Collections.singletonList(
+                        salaryOptionValue(10101, "劳务报酬", "500")));
+        HrmSalaryTaxRuleDO taxRule = HrmSalaryTaxRuleDO.builder()
+                .type(HrmSalaryTaxTypeEnum.REMUNERATION.getType()).taxEnabled(true)
+                .threshold(new BigDecimal("800")).decimalScale(2).build();
+
+        // 调用
+        monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                Collections.singletonList(employeeRecord), employeeOptionValueMap,
+                Collections.singletonMap(employeeRecord.getEmployeeId(), taxRule));
+
+        // 断言
+        assertAmount("500.00", employeeRecord.getExpectedPaySalary());
+        assertAmount("0.00", employeeRecord.getTaxableSalary());
+        assertAmount("0.00", employeeRecord.getPersonalTax());
+        assertAmount("500.00", employeeRecord.getRealPaySalary());
+    }
+
+    @Test
+    public void testCalculateMonthEmployeeRecord_remunerationIgnoresTaxDisabledOption() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Arrays.asList(
+                salaryOption(10101, 10, "计税劳务报酬", true, true),
+                salaryOption(20101, 20, "免税劳务补贴", true, false)));
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap = Collections.singletonMap(
+                employeeRecord.getEmployeeId(), Arrays.asList(
+                        salaryOptionValue(10101, "计税劳务报酬", "10000"),
+                        salaryOptionValue(20101, "免税劳务补贴", "5000")));
+        HrmSalaryTaxRuleDO taxRule = HrmSalaryTaxRuleDO.builder()
+                .type(HrmSalaryTaxTypeEnum.REMUNERATION.getType()).taxEnabled(true)
+                .threshold(new BigDecimal("800")).decimalScale(2).build();
+
+        // 调用
+        monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                Collections.singletonList(employeeRecord), employeeOptionValueMap,
+                Collections.singletonMap(employeeRecord.getEmployeeId(), taxRule));
+
+        // 断言
+        assertAmount("15000.00", employeeRecord.getExpectedPaySalary());
+        assertAmount("8000.00", employeeRecord.getTaxableSalary());
+        assertAmount("1600.00", employeeRecord.getPersonalTax());
+        assertAmount("13400.00", employeeRecord.getRealPaySalary());
+    }
+
+    @Test
+    public void testCalculateMonthEmployeeRecord_taxEnabledAndAfterTaxAdjustment() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Arrays.asList(
+                salaryOption(10101, 10, "计税工资", true, true),
+                salaryOption(20101, 20, "免税补贴", true, false),
+                salaryOption(150101, 150, "税后增加", false, false),
+                salaryOption(160101, 160, "税后扣减", false, false)));
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap = Collections.singletonMap(
+                employeeRecord.getEmployeeId(), Arrays.asList(
+                        salaryOptionValue(10101, "计税工资", "10000"),
+                        salaryOptionValue(20101, "免税补贴", "5000"),
+                        salaryOptionValue(150101, "税后增加", "200"),
+                        salaryOptionValue(160101, "税后扣减", "50")));
+        HrmSalaryTaxRuleDO taxRule = HrmSalaryTaxRuleDO.builder()
+                .type(HrmSalaryTaxTypeEnum.SALARY.getType()).taxEnabled(true)
+                .threshold(BigDecimal.ZERO).decimalScale(2)
+                .cycleType(HrmSalaryTaxCycleTypeEnum.JANUARY_TO_DECEMBER.getType()).build();
+
+        // 调用
+        monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                Collections.singletonList(employeeRecord), employeeOptionValueMap,
+                Collections.singletonMap(employeeRecord.getEmployeeId(), taxRule));
+
+        // 断言
+        assertAmount("15000.00", employeeRecord.getExpectedPaySalary());
+        assertAmount("10000.00", employeeRecord.getTaxableSalary());
+        assertAmount("300.00", employeeRecord.getPersonalTax());
+        assertAmount("14850.00", employeeRecord.getRealPaySalary());
+    }
+
+    @Test
+    public void testCalculateMonthEmployeeRecord_negativePersonalTaxRefund() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Collections.singletonList(
+                salaryOption(10101, 10, "基本工资", true, true)));
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap = Collections.singletonMap(
+                employeeRecord.getEmployeeId(), Arrays.asList(
+                        salaryOptionValue(10101, "基本工资", "1000"),
+                        salaryOptionValue(HrmSalaryOptionCodeEnum.LAST_MONTH_PREPAID_TAX.getCode(),
+                                "累计已预缴税额", "100")));
+        HrmSalaryTaxRuleDO taxRule = HrmSalaryTaxRuleDO.builder()
+                .type(HrmSalaryTaxTypeEnum.SALARY.getType()).taxEnabled(true)
+                .threshold(new BigDecimal("5000.00")).decimalScale(2)
+                .cycleType(HrmSalaryTaxCycleTypeEnum.JANUARY_TO_DECEMBER.getType()).build();
+
+        // 调用
+        monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                Collections.singletonList(employeeRecord), employeeOptionValueMap,
+                Collections.singletonMap(employeeRecord.getEmployeeId(), taxRule));
+
+        // 断言
+        assertAmount("1000.00", employeeRecord.getExpectedPaySalary());
+        assertAmount("0.00", employeeRecord.getTaxableSalary());
+        assertAmount("-100.00", employeeRecord.getPersonalTax());
+        assertAmount("1100.00", employeeRecord.getRealPaySalary());
+    }
+
+    @Test
+    public void testCalculateMonthEmployeeRecord_attendanceDeductionReducesSalary() {
+        // mock 数据
+        HrmSalaryOptionDO attendanceDeductionOption = salaryOption(
+                HrmSalaryOptionCodeEnum.ATTENDANCE_DEDUCTION_TOTAL.getCode(), 200,
+                "考勤扣款合计", true, false).setType(HrmSalaryOptionTypeEnum.MINUS.getType());
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Arrays.asList(
+                salaryOption(10101, 10, "基本工资", true, true), attendanceDeductionOption));
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        Map<Long, List<HrmSalaryOptionValueVO>> employeeOptionValueMap = Collections.singletonMap(
+                employeeRecord.getEmployeeId(), Arrays.asList(
+                        salaryOptionValue(10101, "基本工资", "1000"),
+                        salaryOptionValue(HrmSalaryOptionCodeEnum.ATTENDANCE_DEDUCTION_TOTAL.getCode(),
+                                "考勤扣款合计", "100")));
+        HrmSalaryTaxRuleDO taxRule = HrmSalaryTaxRuleDO.builder()
+                .type(HrmSalaryTaxTypeEnum.NONE.getType()).taxEnabled(false).decimalScale(2).build();
+
+        // 调用
+        monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                Collections.singletonList(employeeRecord), employeeOptionValueMap,
+                Collections.singletonMap(employeeRecord.getEmployeeId(), taxRule));
+
+        // 断言
+        assertAmount("900.00", employeeRecord.getExpectedPaySalary());
+        assertAmount("0.00", employeeRecord.getPersonalTax());
+        assertAmount("900.00", employeeRecord.getRealPaySalary());
+    }
+
+    @Test
+    public void testCalculateMonthEmployeeRecord_naturalYearReset() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Collections.singletonList(
+                salaryOption(10101, 10, "基本工资", true, true)));
+        HrmSalaryMonthEmployeeRecordDO lastRecord = randomMonthEmployeeRecord(2000L, 1001L)
+                .setYear(2025).setMonth(12).setOptionValues(Collections.singletonList(
+                        monthOptionValue(HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_INCOME.getCode(),
+                                "累计收入额", "120000")));
+        monthEmployeeRecordMapper.insert(lastRecord);
+        HrmSalaryMonthEmployeeRecordDO currentRecord = randomMonthEmployeeRecord(2001L, 1001L)
+                .setYear(2026).setMonth(1);
+        HrmSalaryTaxRuleDO taxRule = HrmSalaryTaxRuleDO.builder()
+                .type(HrmSalaryTaxTypeEnum.SALARY.getType()).taxEnabled(true)
+                .threshold(BigDecimal.ZERO).decimalScale(2)
+                .cycleType(HrmSalaryTaxCycleTypeEnum.JANUARY_TO_DECEMBER.getType()).build();
+
+        // 调用
+        monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                Collections.singletonList(currentRecord),
+                Collections.singletonMap(currentRecord.getEmployeeId(), Collections.singletonList(
+                        salaryOptionValue(10101, "基本工资", "10000"))),
+                Collections.singletonMap(currentRecord.getEmployeeId(), taxRule));
+
+        // 断言
+        HrmSalaryMonthEmployeeRecordDO.OptionValue cumulativeIncome = currentRecord.getOptionValues().stream()
+                .filter(value -> HrmSalaryOptionCodeEnum.CURRENT_CUMULATIVE_INCOME.getCode().equals(value.getCode()))
+                .findFirst().orElse(null);
+        assertNotNull(cumulativeIncome);
+        assertAmount("10000.00", cumulativeIncome.getValue());
+    }
+
+    @Test
+    public void testGetMonthEmployeeRecordPage_filtersEmployee() {
+        // mock 数据
+        HrmSalaryMonthEmployeeRecordDO matchedRecord = randomMonthEmployeeRecord(2001L, 1001L);
+        HrmSalaryMonthEmployeeRecordDO anotherRecord = randomMonthEmployeeRecord(2001L, 1002L);
+        monthEmployeeRecordMapper.insert(matchedRecord);
+        monthEmployeeRecordMapper.insert(anotherRecord);
+        HrmSalaryMonthRecordDO monthRecord = randomMonthRecord(2001L);
+        when(monthRecordService.getMonthRecord(monthRecord.getId())).thenReturn(monthRecord);
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(matchedRecord.getEmployeeId(), new HrmEmployeeDO().setId(matchedRecord.getEmployeeId())
+                .setName("张三").setJobNumber("HRM-001").setDeptId(3001L).setPostName("开发工程师"));
+        employeeMap.put(anotherRecord.getEmployeeId(), new HrmEmployeeDO().setId(anotherRecord.getEmployeeId())
+                .setName("李四").setJobNumber("HRM-002").setDeptId(3002L).setPostName("测试工程师"));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(employeeMap);
+        // 准备参数
+        HrmSalaryMonthEmployeeRecordPageReqVO reqVO = new HrmSalaryMonthEmployeeRecordPageReqVO();
+        reqVO.setMonthRecordId(monthRecord.getId());
+        reqVO.setEmployeeName("张");
+        reqVO.setDeptId(3001L);
+
+        // 调用
+        PageResult<HrmSalaryMonthEmployeeRecordDO> pageResult =
+                monthEmployeeRecordService.getMonthEmployeeRecordPage(reqVO);
+
+        // 断言
+        assertEquals(1, pageResult.getTotal());
+        assertEquals(matchedRecord.getEmployeeId(), pageResult.getList().get(0).getEmployeeId());
+    }
+
+    @Test
+    public void testGetMonthEmployeeChangeCount() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord = randomMonthRecord(2001L);
+        when(monthRecordService.getMonthRecord(monthRecord.getId())).thenReturn(monthRecord);
+        List<HrmSalaryMonthEmployeeRecordDO> employeeRecords = Arrays.asList(
+                randomMonthEmployeeRecord(monthRecord.getId(), 1001L),
+                randomMonthEmployeeRecord(monthRecord.getId(), 1002L),
+                randomMonthEmployeeRecord(monthRecord.getId(), 1003L),
+                randomMonthEmployeeRecord(monthRecord.getId(), 1004L));
+        employeeRecords.forEach(monthEmployeeRecordMapper::insert);
+        Map<Long, HrmEmployeeDO> employeeMap = new HashMap<>();
+        employeeMap.put(1001L, new HrmEmployeeDO().setId(1001L)
+                .setEntryTime(LocalDate.of(2026, 7, 3).atStartOfDay()));
+        employeeMap.put(1002L, new HrmEmployeeDO().setId(1002L)
+                .setLeaveTime(LocalDate.of(2026, 7, 20).atStartOfDay()));
+        employeeMap.put(1003L, new HrmEmployeeDO().setId(1003L));
+        employeeMap.put(1004L, new HrmEmployeeDO().setId(1004L));
+        when(employeeService.getEmployeeMap(anyCollection())).thenReturn(employeeMap);
+        List<HrmEmployeeChangeRecordDO> changeRecords = Arrays.asList(
+                new HrmEmployeeChangeRecordDO().setEmployeeId(1003L)
+                        .setType(HrmEmployeeChangeTypeEnum.REGULAR.getType()),
+                new HrmEmployeeChangeRecordDO().setEmployeeId(1004L)
+                        .setType(HrmEmployeeChangeTypeEnum.TRANSFER.getType()));
+        when(employeeChangeRecordService.getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                anyCollection(), any(LocalDateTime[].class)))
+                .thenReturn(changeRecords);
+        // 准备参数
+        HrmSalaryMonthEmployeeRecordPageReqVO reqVO = new HrmSalaryMonthEmployeeRecordPageReqVO();
+        reqVO.setMonthRecordId(monthRecord.getId());
+
+        // 调用
+        Map<Integer, Long> countMap = monthEmployeeRecordService.getMonthEmployeeChangeCount(reqVO);
+
+        // 断言
+        assertEquals(4L, countMap.get(HrmSalaryEmployeeChangeTypeEnum.ALL.getType()));
+        assertEquals(1L, countMap.get(HrmSalaryEmployeeChangeTypeEnum.ENTRY.getType()));
+        assertEquals(1L, countMap.get(HrmSalaryEmployeeChangeTypeEnum.LEAVE.getType()));
+        assertEquals(1L, countMap.get(HrmSalaryEmployeeChangeTypeEnum.REGULAR.getType()));
+        assertEquals(1L, countMap.get(HrmSalaryEmployeeChangeTypeEnum.TRANSFER.getType()));
+    }
+
+    @Test
+    public void testGetMonthEmployeeRecord_monthRecordNotExists() {
+        // 准备参数
+        HrmSalaryMonthEmployeeRecordPageReqVO pageReqVO = new HrmSalaryMonthEmployeeRecordPageReqVO();
+        pageReqVO.setMonthRecordId(2001L);
+        HrmSalaryMonthEmployeeRecordListReqVO listReqVO = new HrmSalaryMonthEmployeeRecordListReqVO();
+        listReqVO.setMonthRecordId(2001L);
+
+        // 调用，并断言
+        assertEquals(0L, monthEmployeeRecordService.getMonthEmployeeRecordPage(pageReqVO).getTotal());
+        assertTrue(monthEmployeeRecordService.getMonthEmployeeRecordList(listReqVO).isEmpty());
+        assertTrue(monthEmployeeRecordService.getMonthEmployeeChangeCount(pageReqVO).isEmpty());
+    }
+
+    @Test
+    public void testGetPerformanceCoefficientMap() {
+        // mock 方法
+        when(performancePlanService.getPerformancePlanListByPaidForMonth("2026-07"))
+                .thenReturn(Arrays.asList(
+                        new HrmPerformancePlanDO().setId(2001L).setSyncToSalary(true),
+                        new HrmPerformancePlanDO().setId(2002L).setSyncToSalary(false)));
+        when(performanceAssessmentService.getPerformanceArchiveEmployeeCoefficientMap(
+                eq(Collections.singleton(2001L)), anyCollection()))
+                .thenReturn(Collections.singletonMap(1001L, BigDecimal.valueOf(1.1)));
+        // 准备参数
+        HrmSalaryPerformanceCoefficientReqVO reqVO = new HrmSalaryPerformanceCoefficientReqVO();
+        reqVO.setYear(2026);
+        reqVO.setMonth(7);
+        reqVO.setEmployeeIds(Collections.singletonList(1001L));
+
+        // 调用
+        Map<Long, BigDecimal> coefficientMap = monthEmployeeRecordService.getPerformanceCoefficientMap(reqVO);
+
+        // 断言
+        assertEquals(0, BigDecimal.valueOf(1.1).compareTo(coefficientMap.get(1001L)));
+    }
+
+    @Test
+    public void testGetEmployeeMonthRecordPage() {
+        // mock 数据
+        HrmSalaryMonthRecordDO historyMonthRecord = randomMonthRecord(2001L).setStatus(HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus());
+        when(monthRecordService.getMonthRecordListByStatus(HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus()))
+                .thenReturn(Collections.singletonList(historyMonthRecord));
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = randomMonthEmployeeRecord(historyMonthRecord.getId(), 1001L);
+        monthEmployeeRecordMapper.insert(employeeRecord);
+        // 准备参数
+        HrmSalaryEmployeeMonthRecordPageReqVO reqVO = new HrmSalaryEmployeeMonthRecordPageReqVO();
+        reqVO.setEmployeeId(employeeRecord.getEmployeeId());
+        reqVO.setMonthRecordStatus(HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus());
+
+        // 调用
+        PageResult<HrmSalaryMonthEmployeeRecordDO> pageResult =
+                monthEmployeeRecordService.getEmployeeMonthRecordPage(reqVO);
+
+        // 断言
+        assertEquals(1, pageResult.getTotal());
+        assertEquals(employeeRecord.getId(), pageResult.getList().get(0).getId());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalaryMonthEmployeeRecordDO randomMonthEmployeeRecord(Long monthRecordId, Long employeeId) {
+        return randomPojo(HrmSalaryMonthEmployeeRecordDO.class, record -> record.setId(null)
+                .setMonthRecordId(monthRecordId).setEmployeeId(employeeId).setYear(2026).setMonth(7)
+                .setActualWorkDay(BigDecimal.valueOf(20)).setNeedWorkDay(BigDecimal.valueOf(22))
+                .setExpectedPaySalary(BigDecimal.valueOf(8000)).setTaxableSalary(BigDecimal.valueOf(7000))
+                .setPersonalTax(BigDecimal.valueOf(200)).setRealPaySalary(BigDecimal.valueOf(7800))
+                .setOptionValues(Collections.emptyList()));
+    }
+
+    private HrmSalaryMonthRecordDO randomMonthRecord(Long id) {
+        return randomPojo(HrmSalaryMonthRecordDO.class, record -> record.setId(id).setYear(2026).setMonth(7)
+                .setStartTime(LocalDate.of(2026, 7, 1).atStartOfDay())
+                .setEndTime(LocalDate.of(2026, 7, 31).atStartOfDay()));
+    }
+
+    private static HrmSalaryOptionDO salaryOption(Integer code, Integer parentCode, String name,
+                                                   boolean calculateEnabled, boolean taxEnabled) {
+        return new HrmSalaryOptionDO().setCode(code).setParentCode(parentCode).setName(name)
+                .setType(1).setCalculateEnabled(calculateEnabled).setTaxEnabled(taxEnabled)
+                .setEnabled(true).setVisible(true);
+    }
+
+    private static HrmSalaryOptionValueVO salaryOptionValue(Integer code, String name, String value) {
+        return new HrmSalaryOptionValueVO().setCode(code).setName(name).setValue(new BigDecimal(value));
+    }
+
+    private static HrmSalaryMonthEmployeeRecordDO.OptionValue monthOptionValue(
+            Integer code, String name, String value) {
+        return HrmSalaryMonthEmployeeRecordDO.OptionValue.builder()
+                .code(code).name(name).value(new BigDecimal(value)).build();
+    }
+
+    private static void assertAmount(String expected, BigDecimal actual) {
+        assertEquals(0, new BigDecimal(expected).compareTo(actual));
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordServiceImplTest.java
new file mode 100644
index 0000000..40b7c04
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/monthrecord/HrmSalaryMonthRecordServiceImplTest.java
@@ -0,0 +1,569 @@
+package cn.iocoder.yudao.module.hrm.service.salary.monthrecord;
+
+import cn.hutool.core.collection.CollUtil;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.common.util.date.LocalDateTimeUtils;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.attendance.vo.statistics.HrmAttendanceMonthRecordRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordCreateReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryMonthRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.HrmSalaryPayrollReadinessRespVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.option.HrmSalaryOptionValueVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.employment.HrmEmployeeChangeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryConfigDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.employee.HrmSalaryEmployeeInfoDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryGroupDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryTaxRuleDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.monthrecord.HrmSalaryMonthRecordMapper;
+import cn.iocoder.yudao.module.hrm.enums.employee.employment.HrmEmployeeChangeTypeEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeEntryStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.employee.info.HrmEmployeeStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionCodeEnum;
+import cn.iocoder.yudao.module.hrm.service.attendance.statistics.HrmAttendanceStatisticsService;
+import cn.iocoder.yudao.module.hrm.service.employee.employment.HrmEmployeeChangeRecordService;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.insurance.monthrecord.HrmInsuranceMonthRecordService;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryConfigService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryGroupService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryTaxRuleService;
+import cn.iocoder.yudao.module.hrm.service.salary.employee.HrmSalaryEmployeeInfoService;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.mockito.ArgumentCaptor;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.LocalDate;
+import java.time.LocalDateTime;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collection;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomLongId;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_CONFIG_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_CANNOT_DELETE_ONLY;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_NOT_LATEST;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_RECORD_STATUS_INVALID;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.ArgumentMatchers.anyCollection;
+import static org.mockito.ArgumentMatchers.eq;
+import static org.mockito.Mockito.never;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalaryMonthRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalaryMonthRecordServiceImpl.class)
+public class HrmSalaryMonthRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalaryMonthRecordServiceImpl monthRecordService;
+
+    @Resource
+    private HrmSalaryMonthRecordMapper monthRecordMapper;
+
+    @MockitoBean
+    private HrmSalaryOptionService salaryOptionService;
+    @MockitoBean
+    private HrmSalaryConfigService salaryConfigService;
+    @MockitoBean
+    private HrmSalaryEmployeeInfoService salaryEmployeeInfoService;
+    @MockitoBean
+    private HrmSalaryGroupService salaryGroupService;
+    @MockitoBean
+    private HrmSalaryTaxRuleService salaryTaxRuleService;
+    @MockitoBean
+    private HrmSalaryMonthEmployeeRecordService monthEmployeeRecordService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private HrmEmployeeChangeRecordService employeeChangeRecordService;
+    @MockitoBean
+    private HrmAttendanceStatisticsService attendanceStatisticsService;
+    @MockitoBean
+    private HrmInsuranceMonthEmployeeRecordService insuranceMonthEmployeeRecordService;
+    @MockitoBean
+    private HrmInsuranceMonthRecordService insuranceMonthRecordService;
+
+    @Test
+    public void testCreateMonthRecord_success() {
+        // 准备参数
+        HrmSalaryMonthRecordCreateReqVO reqVO =
+                new HrmSalaryMonthRecordCreateReqVO().setYear(2026).setMonth(7);
+        when(salaryOptionService.getSalaryOptionList(false, true))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        Long monthRecordId = monthRecordService.createMonthRecord(reqVO);
+
+        // 断言
+        assertNotNull(monthRecordId);
+        HrmSalaryMonthRecordDO monthRecord = monthRecordMapper.selectById(monthRecordId);
+        assertEquals("2026年7月工资表", monthRecord.getTitle());
+        assertEquals(LocalDate.of(2026, 7, 1).atStartOfDay(), monthRecord.getStartTime());
+        assertEquals(LocalDate.of(2026, 7, 31).atStartOfDay(), monthRecord.getEndTime());
+        assertEquals(HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus(), monthRecord.getStatus());
+        assertEquals(0, monthRecord.getEmployeeCount());
+    }
+
+    @Test
+    public void testCreateMonthRecord_salaryConfigCycle() {
+        // mock 数据
+        when(salaryConfigService.getSalaryConfig()).thenReturn(
+                HrmSalaryConfigDO.builder().cycleStartDay(26).cycleEndDay(25).build());
+        when(salaryOptionService.getSalaryOptionList(false, true))
+                .thenReturn(Collections.emptyList());
+        // 准备参数
+        HrmSalaryMonthRecordCreateReqVO reqVO =
+                new HrmSalaryMonthRecordCreateReqVO().setYear(2026).setMonth(7);
+
+        // 调用
+        Long monthRecordId = monthRecordService.createMonthRecord(reqVO);
+
+        // 断言
+        HrmSalaryMonthRecordDO monthRecord = monthRecordMapper.selectById(monthRecordId);
+        assertEquals(LocalDate.of(2026, 7, 26).atStartOfDay(), monthRecord.getStartTime());
+        assertEquals(LocalDate.of(2026, 8, 25).atStartOfDay(), monthRecord.getEndTime());
+    }
+
+    @Test
+    public void testCreateMonthRecord_exists() {
+        // mock 数据
+        monthRecordMapper.insert(buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus()));
+        // 准备参数
+        HrmSalaryMonthRecordCreateReqVO reqVO =
+                new HrmSalaryMonthRecordCreateReqVO().setYear(2026).setMonth(7);
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.createMonthRecord(reqVO),
+                SALARY_MONTH_RECORD_EXISTS);
+    }
+
+    @Test
+    public void testCreateMonthRecord_insertAfterDeletedRecord() {
+        // mock 数据
+        HrmSalaryMonthRecordDO deletedRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        monthRecordMapper.insert(deletedRecord);
+        monthRecordMapper.deleteById(deletedRecord.getId());
+        when(salaryOptionService.getSalaryOptionList(false, true))
+                .thenReturn(Collections.emptyList());
+        // 准备参数
+        HrmSalaryMonthRecordCreateReqVO reqVO =
+                new HrmSalaryMonthRecordCreateReqVO().setYear(2026).setMonth(7);
+
+        // 调用
+        Long monthRecordId = monthRecordService.createMonthRecord(reqVO);
+
+        // 断言
+        assertNotEquals(deletedRecord.getId(), monthRecordId);
+        assertNull(monthRecordMapper.selectById(deletedRecord.getId()));
+        assertNotNull(monthRecordMapper.selectById(monthRecordId));
+    }
+
+    @Test
+    public void testCreateNextMonthRecord_firstMonth() {
+        // mock 数据
+        when(salaryConfigService.getSalaryConfig()).thenReturn(
+                HrmSalaryConfigDO.builder().startYear(2026).startMonth(7).build());
+        when(salaryOptionService.getSalaryOptionList(false, true))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        Long monthRecordId = monthRecordService.createNextMonthRecord();
+
+        // 断言
+        HrmSalaryMonthRecordDO monthRecord = monthRecordMapper.selectById(monthRecordId);
+        assertEquals(2026, monthRecord.getYear());
+        assertEquals(7, monthRecord.getMonth());
+    }
+
+    @Test
+    public void testCreateNextMonthRecord_salaryConfigNotExists() {
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.createNextMonthRecord(),
+                SALARY_CONFIG_NOT_EXISTS);
+    }
+
+    @Test
+    public void testCreateNextMonthRecord_archivePrevious() {
+        // mock 数据
+        HrmSalaryMonthRecordDO previousMonthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus());
+        monthRecordMapper.insert(previousMonthRecord);
+        when(salaryOptionService.getSalaryOptionList(false, true))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        Long monthRecordId = monthRecordService.createNextMonthRecord();
+
+        // 断言
+        assertEquals(HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus(),
+                monthRecordMapper.selectById(previousMonthRecord.getId()).getStatus());
+        HrmSalaryMonthRecordDO monthRecord = monthRecordMapper.selectById(monthRecordId);
+        assertEquals(2026, monthRecord.getYear());
+        assertEquals(8, monthRecord.getMonth());
+    }
+
+    @Test
+    public void testComputeMonthRecord_success() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        monthRecordMapper.insert(monthRecord);
+        HrmEmployeeDO employee = buildActiveEmployee(1L, "NO-001");
+        when(employeeService.getEmployeeList(any())).thenReturn(
+                Collections.singletonList(employee));
+        HrmSalaryGroupDO salaryGroup = HrmSalaryGroupDO.builder()
+                .id(10L).taxRuleId(20L).salaryStandard(new BigDecimal("21.75")).build();
+        when(salaryGroupService.getEmployeeSalaryGroupMap(any()))
+                .thenReturn(Collections.singletonMap(employee.getId(), salaryGroup));
+        HrmSalaryTaxRuleDO taxRule = HrmSalaryTaxRuleDO.builder().id(20L).name("默认计税").build();
+        when(salaryTaxRuleService.getSalaryTaxRuleMap(anyCollection()))
+                .thenReturn(Collections.singletonMap(taxRule.getId(), taxRule));
+        when(salaryTaxRuleService.getSalaryTaxRuleList())
+                .thenReturn(Collections.singletonList(taxRule));
+        HrmSalaryOptionDO basicSalaryOption = new HrmSalaryOptionDO()
+                .setCode(10101).setName("基本工资").setParentCode(10)
+                .setType(1).setCalculateEnabled(true).setEnabled(true);
+        when(salaryOptionService.getSalaryOptionList(false))
+                .thenReturn(Collections.singletonList(basicSalaryOption));
+        when(salaryOptionService.getSalaryOptionList(false, true))
+                .thenReturn(Collections.singletonList(basicSalaryOption));
+        when(salaryEmployeeInfoService.getEffectiveSalaryOptionList(
+                eq(employee), any(LocalDateTime[].class)))
+                .thenReturn(Collections.singletonList(
+                        HrmSalaryEmployeeInfoDO.SalaryOption.builder()
+                                .code(10101).name("基本工资")
+                                .value(new BigDecimal("10000")).build()));
+        when(monthEmployeeRecordService.calculateMonthEmployeeRecordList(
+                any(), any(), any())).thenAnswer(invocation -> {
+            List<HrmSalaryMonthEmployeeRecordDO> records = invocation.getArgument(0);
+            records.forEach(record -> record
+                    .setExpectedPaySalary(new BigDecimal("10000"))
+                    .setPersonalTax(new BigDecimal("500"))
+                    .setRealPaySalary(new BigDecimal("9500"))
+                    .setOptionValues(Collections.emptyList()));
+            return records;
+        });
+        when(monthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(
+                monthRecord.getId())).thenAnswer(invocation -> Collections.singletonList(
+                HrmSalaryMonthEmployeeRecordDO.builder()
+                        .monthRecordId(monthRecord.getId()).employeeId(employee.getId())
+                        .expectedPaySalary(new BigDecimal("10000"))
+                        .personalTax(new BigDecimal("500"))
+                        .realPaySalary(new BigDecimal("9500"))
+                        .optionValues(Collections.emptyList()).build()));
+        when(monthEmployeeRecordService.getMonthOptionSummary(any()))
+                .thenReturn(Collections.emptyList());
+
+        // 调用
+        monthRecordService.computeMonthRecord(monthRecord.getId());
+
+        // 断言
+        ArgumentCaptor<LocalDateTime[]> salaryTimesCaptor = ArgumentCaptor.forClass(LocalDateTime[].class);
+        verify(salaryEmployeeInfoService).getEffectiveSalaryOptionList(eq(employee), salaryTimesCaptor.capture());
+        LocalDateTime[] salaryTimes = salaryTimesCaptor.getValue();
+        assertTrue(LocalDateTimeUtils.isBetween(salaryTimes[0], salaryTimes[1],
+                monthRecord.getEndTime().toLocalDate().atTime(12, 0)));
+        @SuppressWarnings("unchecked")
+        ArgumentCaptor<Collection<HrmSalaryMonthEmployeeRecordDO>> recordCaptor =
+                ArgumentCaptor.forClass(Collection.class);
+        verify(monthEmployeeRecordService)
+                .saveMonthEmployeeRecordList(eq(monthRecord.getId()), recordCaptor.capture());
+        assertEquals(1, recordCaptor.getValue().size());
+        HrmSalaryMonthRecordDO result = monthRecordMapper.selectById(monthRecord.getId());
+        assertEquals(HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus(), result.getStatus());
+        assertEquals(1, result.getEmployeeCount());
+        assertAmount("10000.00", result.getExpectedPaySalary());
+        assertAmount("500.00", result.getPersonalTax());
+        assertAmount("9500.00", result.getRealPaySalary());
+    }
+
+    @Test
+    public void testComputeMonthRecord_syncAttendanceData() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        monthRecordMapper.insert(monthRecord);
+        HrmEmployeeDO employee = buildActiveEmployee(1L, "NO-001");
+        when(employeeService.getEmployeeList(any())).thenReturn(Collections.singletonList(employee));
+        HrmSalaryGroupDO salaryGroup = HrmSalaryGroupDO.builder()
+                .id(10L).taxRuleId(20L).salaryStandard(new BigDecimal("21.75")).build();
+        when(salaryGroupService.getEmployeeSalaryGroupMap(any()))
+                .thenReturn(Collections.singletonMap(employee.getId(), salaryGroup));
+        when(salaryTaxRuleService.getSalaryTaxRuleMap(anyCollection())).thenReturn(Collections.emptyMap());
+        when(salaryTaxRuleService.getSalaryTaxRuleList()).thenReturn(Collections.emptyList());
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Collections.emptyList());
+        when(salaryOptionService.getSalaryOptionList(false, true)).thenReturn(Collections.emptyList());
+        when(salaryEmployeeInfoService.getEffectiveSalaryOptionList(
+                eq(employee), any(LocalDateTime[].class))).thenReturn(Collections.emptyList());
+        HrmAttendanceMonthRecordRespVO attendance = new HrmAttendanceMonthRecordRespVO()
+                .setEmployeeId(employee.getId()).setActualDays(new BigDecimal("20.50"))
+                .setLateDeductAmount(new BigDecimal("10.00"))
+                .setEarlyDeductAmount(new BigDecimal("20.00"))
+                .setAbsenteeismDeductAmount(new BigDecimal("30.00"))
+                .setMisscardDeductAmount(new BigDecimal("40.00"))
+                .setAttendanceDeductAmount(new BigDecimal("100.00"));
+        when(attendanceStatisticsService.getAttendanceMonthRecordMap(
+                2026, 7, Collections.singletonList(employee.getId())))
+                .thenReturn(Collections.singletonMap(employee.getId(), attendance));
+        when(monthEmployeeRecordService.calculateMonthEmployeeRecordList(any(), any(), any()))
+                .thenAnswer(invocation -> invocation.getArgument(0));
+        when(monthEmployeeRecordService.getMonthEmployeeRecordListByMonthRecordId(monthRecord.getId()))
+                .thenReturn(Collections.emptyList());
+        when(monthEmployeeRecordService.getMonthOptionSummary(any())).thenReturn(Collections.emptyList());
+
+        // 调用
+        monthRecordService.computeMonthRecord(monthRecord.getId(), false, true,
+                Collections.emptyList(), Collections.emptyList(), Collections.emptyList());
+
+        // 断言
+        @SuppressWarnings("unchecked")
+        ArgumentCaptor<List<HrmSalaryMonthEmployeeRecordDO>> employeeRecordsCaptor =
+                ArgumentCaptor.forClass(List.class);
+        @SuppressWarnings("unchecked")
+        ArgumentCaptor<Map<Long, List<HrmSalaryOptionValueVO>>> optionValueMapCaptor =
+                ArgumentCaptor.forClass(Map.class);
+        verify(monthEmployeeRecordService).calculateMonthEmployeeRecordList(
+                employeeRecordsCaptor.capture(), optionValueMapCaptor.capture(), any());
+        assertAmount("20.50", CollUtil.getFirst(employeeRecordsCaptor.getValue()).getActualWorkDay());
+        List<HrmSalaryOptionValueVO> optionValues = optionValueMapCaptor.getValue().get(employee.getId());
+        assertOptionAmount("10.00", optionValues, HrmSalaryOptionCodeEnum.LATE_DEDUCTION);
+        assertOptionAmount("20.00", optionValues, HrmSalaryOptionCodeEnum.EARLY_DEDUCTION);
+        assertOptionAmount("30.00", optionValues, HrmSalaryOptionCodeEnum.ABSENTEEISM_DEDUCTION);
+        assertOptionAmount("0.00", optionValues, HrmSalaryOptionCodeEnum.LEAVE_DEDUCTION);
+        assertOptionAmount("40.00", optionValues, HrmSalaryOptionCodeEnum.MISSING_CARD_DEDUCTION);
+        assertOptionAmount("100.00", optionValues, HrmSalaryOptionCodeEnum.ATTENDANCE_DEDUCTION_TOTAL);
+    }
+
+    @Test
+    public void testGetPayrollEmployeeList() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        HrmEmployeeDO activeEmployee = buildActiveEmployee(3L, "NO-003");
+        HrmEmployeeDO pendingEntryEmployee = buildActiveEmployee(1L, "NO-001")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.PENDING_ENTRY.getStatus());
+        HrmEmployeeDO leftBeforeCycleEmployee = buildActiveEmployee(2L, "NO-002")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setLeaveTime(monthRecord.getStartTime().minusDays(1));
+        HrmEmployeeDO leftInCycleEmployee = buildActiveEmployee(4L, "NO-004")
+                .setEntryStatus(HrmEmployeeEntryStatusEnum.LEFT.getStatus())
+                .setLeaveTime(monthRecord.getStartTime());
+        when(employeeService.getEmployeeList(any())).thenReturn(Arrays.asList(
+                activeEmployee, pendingEntryEmployee, leftBeforeCycleEmployee, leftInCycleEmployee));
+
+        // 调用
+        List<HrmEmployeeDO> employees =
+                monthRecordService.getPayrollEmployeeList(monthRecord);
+
+        // 断言
+        assertEquals(Arrays.asList(activeEmployee.getId(), leftInCycleEmployee.getId()),
+                Arrays.asList(employees.get(0).getId(), employees.get(1).getId()));
+    }
+
+    @Test
+    public void testDeleteMonthRecord_success() {
+        // mock 数据
+        HrmSalaryMonthRecordDO previousMonthRecord =
+                buildMonthRecord(2026, 6, HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus());
+        monthRecordMapper.insert(previousMonthRecord);
+        HrmSalaryMonthRecordDO currentMonthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        monthRecordMapper.insert(currentMonthRecord);
+
+        // 调用
+        monthRecordService.deleteMonthRecord(currentMonthRecord.getId());
+
+        // 断言
+        assertNull(monthRecordMapper.selectById(currentMonthRecord.getId()));
+        assertEquals(HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus(),
+                monthRecordMapper.selectById(previousMonthRecord.getId()).getStatus());
+        verify(monthEmployeeRecordService)
+                .deleteMonthEmployeeRecordListByMonthRecordId(currentMonthRecord.getId());
+    }
+
+    @Test
+    public void testDeleteMonthRecord_notLatest() {
+        // mock 数据
+        HrmSalaryMonthRecordDO previousMonthRecord =
+                buildMonthRecord(2026, 6, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        monthRecordMapper.insert(previousMonthRecord);
+        monthRecordMapper.insert(buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.deleteMonthRecord(
+                previousMonthRecord.getId()), SALARY_MONTH_RECORD_NOT_LATEST);
+    }
+
+    @Test
+    public void testDeleteMonthRecord_onlyOne() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        monthRecordMapper.insert(monthRecord);
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.deleteMonthRecord(
+                monthRecord.getId()), SALARY_MONTH_RECORD_CANNOT_DELETE_ONLY);
+    }
+
+    @Test
+    public void testGetPayrollReadiness() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus());
+        monthRecordMapper.insert(monthRecord);
+        HrmEmployeeDO salaryMissingEmployee = buildActiveEmployee(1L, "NO-001");
+        HrmEmployeeDO groupMissingEmployee = buildActiveEmployee(2L, "NO-002");
+        List<HrmEmployeeDO> employees =
+                Arrays.asList(salaryMissingEmployee, groupMissingEmployee);
+        when(employeeService.getEmployeeList(any())).thenReturn(employees);
+        when(salaryGroupService.getEmployeeSalaryGroupMap(employees)).thenReturn(
+                Collections.singletonMap(salaryMissingEmployee.getId(),
+                        HrmSalaryGroupDO.builder().id(10L).taxRuleId(20L).build()));
+        when(salaryEmployeeInfoService.getSalaryEmployeeInfoMap(
+                Collections.singleton(salaryMissingEmployee.getId())))
+                .thenReturn(Collections.emptyMap());
+        HrmEmployeeChangeRecordDO changeRecord = HrmEmployeeChangeRecordDO.builder()
+                .employeeId(salaryMissingEmployee.getId())
+                .type(HrmEmployeeChangeTypeEnum.TRANSFER.getType()).build();
+        when(employeeChangeRecordService.getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                anyCollection(), any(LocalDateTime[].class)))
+                .thenReturn(Collections.singletonList(changeRecord));
+
+        // 调用
+        HrmSalaryPayrollReadinessRespVO result =
+                monthRecordService.getPayrollReadiness(monthRecord.getId());
+
+        // 断言
+        assertEquals(1L, result.getPayrollEmployeeCount());
+        assertEquals(0L, result.getSalaryEmployeeCount());
+        assertEquals(1L, result.getNoSalaryEmployeeCount());
+        assertEquals(1L, result.getNoSalaryGroupEmployeeCount());
+        assertEquals(1L, result.getChangeEmployeeCount());
+        ArgumentCaptor<LocalDateTime[]> effectTimesCaptor = ArgumentCaptor.forClass(LocalDateTime[].class);
+        verify(employeeChangeRecordService).getEmployeeChangeRecordListByEmployeeIdsAndEffectTimeBetween(
+                anyCollection(), effectTimesCaptor.capture());
+        LocalDateTime[] effectTimes = effectTimesCaptor.getValue();
+        assertTrue(LocalDateTimeUtils.isBetween(effectTimes[0], effectTimes[1],
+                monthRecord.getEndTime().toLocalDate().atTime(12, 0)));
+    }
+
+    @Test
+    public void testGetPayrollReadiness_monthRecordNotExists() {
+        // 准备参数
+        Long monthRecordId = randomLongId();
+
+        // 调用，并断言
+        assertNull(monthRecordService.getPayrollReadiness(monthRecordId));
+    }
+
+    @Test
+    public void testValidateMonthRecordEditable_history() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.HISTORY.getStatus());
+        monthRecordMapper.insert(monthRecord);
+
+        // 调用，并断言异常
+        assertServiceException(() -> monthRecordService.validateMonthRecordEditable(
+                monthRecord.getId()), SALARY_MONTH_RECORD_STATUS_INVALID);
+    }
+
+    @Test
+    public void testGetMonthRecordPage() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus());
+        monthRecordMapper.insert(monthRecord);
+        // 测试 status 不匹配
+        monthRecordMapper.insert(buildMonthRecord(2026, 8, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus()));
+        // 准备参数
+        HrmSalaryMonthRecordPageReqVO reqVO = new HrmSalaryMonthRecordPageReqVO();
+        reqVO.setStatus(HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus());
+
+        // 调用
+        PageResult<HrmSalaryMonthRecordDO> result =
+                monthRecordService.getMonthRecordPage(reqVO);
+
+        // 断言
+        assertEquals(1L, result.getTotal());
+        assertEquals(monthRecord.getId(), result.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetMonthRecordListByStatus() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord =
+                buildMonthRecord(2026, 7, HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus());
+        monthRecordMapper.insert(monthRecord);
+        // 测试 status 不匹配
+        monthRecordMapper.insert(buildMonthRecord(2026, 8, HrmSalaryMonthRecordStatusEnum.UNCOMPUTED.getStatus()));
+
+        // 调用
+        List<HrmSalaryMonthRecordDO> result =
+                monthRecordService.getMonthRecordListByStatus(HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus());
+
+        // 断言
+        assertEquals(1, result.size());
+        assertEquals(monthRecord.getId(), result.get(0).getId());
+    }
+
+    // ========== 随机对象 ==========
+
+    private static HrmSalaryMonthRecordDO buildMonthRecord(
+            Integer year, Integer month, Integer status) {
+        YearMonth yearMonth = YearMonth.of(year, month);
+        return HrmSalaryMonthRecordDO.builder()
+                .title(year + "年" + month + "月工资表")
+                .year(year).month(month).employeeCount(0)
+                .startTime(yearMonth.atDay(1).atStartOfDay())
+                .endTime(yearMonth.atEndOfMonth().atStartOfDay())
+                .expectedPaySalary(BigDecimal.ZERO)
+                .personalTax(BigDecimal.ZERO).realPaySalary(BigDecimal.ZERO)
+                .optionHeaders(Collections.emptyList()).status(status).build();
+    }
+
+    private static HrmEmployeeDO buildActiveEmployee(Long id, String jobNumber) {
+        return HrmEmployeeDO.builder().id(id).name("员工" + id).jobNumber(jobNumber)
+                .entryStatus(HrmEmployeeEntryStatusEnum.ACTIVE.getStatus())
+                .status(HrmEmployeeStatusEnum.REGULAR.getStatus())
+                .entryTime(LocalDate.of(2026, 1, 1).atStartOfDay()).build();
+    }
+
+    private static void assertAmount(String expected, BigDecimal actual) {
+        assertEquals(0, new BigDecimal(expected).compareTo(actual));
+    }
+
+    private static void assertOptionAmount(
+            String expected, List<HrmSalaryOptionValueVO> optionValues, HrmSalaryOptionCodeEnum optionCode) {
+        HrmSalaryOptionValueVO optionValue = CollUtil.findOne(optionValues,
+                value -> optionCode.getCode().equals(value.getCode()));
+        assertNotNull(optionValue);
+        assertAmount(expected, optionValue.getValue());
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordServiceImplTest.java
new file mode 100644
index 0000000..4bd3447
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipSendRecordServiceImplTest.java
@@ -0,0 +1,278 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthEmployeeRecordService;
+import cn.iocoder.yudao.module.hrm.service.salary.monthrecord.HrmSalaryMonthRecordService;
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.employee.vo.employee.HrmEmployeeListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.monthrecord.employee.HrmSalaryMonthEmployeeRecordListReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendRecordPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendEmployeeReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.sendrecord.HrmSalarySlipSendReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipSendRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip.HrmSalarySlipSendRecordMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.hrm.enums.salary.monthrecord.HrmSalaryMonthRecordStatusEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.util.Arrays;
+import java.util.Collections;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_MONTH_EMP_RECORD_NOT_EXISTS;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_EMPLOYEE_ACCOUNT_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.mockito.ArgumentMatchers.any;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalarySlipSendRecordServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalarySlipSendRecordServiceImpl.class)
+public class HrmSalarySlipSendRecordServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalarySlipSendRecordServiceImpl salarySlipSendRecordService;
+    @Resource
+    private HrmSalarySlipSendRecordMapper salarySlipSendRecordMapper;
+
+    @MockitoBean
+    private HrmSalaryMonthRecordService monthRecordService;
+    @MockitoBean
+    private HrmSalaryMonthEmployeeRecordService monthEmployeeRecordService;
+    @MockitoBean
+    private HrmSalarySlipTemplateService salarySlipTemplateService;
+    @MockitoBean
+    private HrmSalarySlipService salarySlipService;
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+
+    @Test
+    public void testSendSalarySlip_selectedEmployees_success() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord = createMonthRecord(2026, 8, 2);
+        HrmSalaryMonthEmployeeRecordDO employeeRecord =
+                createMonthEmployeeRecord(monthRecord.getId(), 1002L);
+        HrmSalarySlipTemplateDO template = new HrmSalarySlipTemplateDO()
+                .setHideEmpty(false).setOptions(Collections.emptyList());
+        when(monthRecordService.validateMonthRecordExistsForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(salarySlipTemplateService.buildSalarySlipTemplateSnapshot(false, Collections.emptyList()))
+                .thenReturn(template);
+        when(monthEmployeeRecordService.getMonthEmployeeRecordList(
+                any(HrmSalaryMonthEmployeeRecordListReqVO.class)))
+                .thenReturn(Collections.singletonList(employeeRecord));
+        when(employeeService.getEmployeeMap(Collections.singleton(employeeRecord.getEmployeeId())))
+                .thenReturn(Collections.singletonMap(employeeRecord.getEmployeeId(),
+                        new HrmEmployeeDO().setId(employeeRecord.getEmployeeId()).setUserId(10002L)));
+        HrmSalarySlipSendReqVO reqVO = new HrmSalarySlipSendReqVO();
+        reqVO.setMonthRecordId(monthRecord.getId());
+        reqVO.setHideEmpty(false);
+        reqVO.setOptions(Collections.emptyList());
+        reqVO.setAll(false);
+        reqVO.setEmployeeIds(Collections.singletonList(employeeRecord.getEmployeeId()));
+
+        // 调用
+        Long sendRecordId = salarySlipSendRecordService.sendSalarySlip(reqVO);
+
+        // 断言
+        HrmSalarySlipSendRecordDO sendRecord = salarySlipSendRecordMapper.selectById(sendRecordId);
+        assertEquals(monthRecord.getEmployeeCount(), sendRecord.getEmployeeCount());
+        assertEquals(1, sendRecord.getSendEmployeeCount());
+        verify(salarySlipService).createSalarySlipList(
+                sendRecordId, Collections.singletonList(employeeRecord), template);
+    }
+
+    @Test
+    public void testSendSalarySlip_employeeNotInMonthRecord() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord = createMonthRecord(2026, 9, 1);
+        when(monthRecordService.validateMonthRecordExistsForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(salarySlipTemplateService.buildSalarySlipTemplateSnapshot(false, null))
+                .thenReturn(new HrmSalarySlipTemplateDO().setHideEmpty(false).setOptions(Collections.emptyList()));
+        when(monthEmployeeRecordService.getMonthEmployeeRecordList(
+                any(HrmSalaryMonthEmployeeRecordListReqVO.class))).thenReturn(Collections.emptyList());
+        HrmSalarySlipSendReqVO reqVO = new HrmSalarySlipSendReqVO();
+        reqVO.setMonthRecordId(monthRecord.getId());
+        reqVO.setHideEmpty(false);
+        reqVO.setAll(false);
+        reqVO.setEmployeeIds(Collections.singletonList(2999L));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipSendRecordService.sendSalarySlip(reqVO),
+                SALARY_MONTH_EMP_RECORD_NOT_EXISTS);
+    }
+
+    @Test
+    public void testSendSalarySlip_selectedEmployeeWithoutAccount() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord = createMonthRecord(2026, 9, 1);
+        HrmSalaryMonthEmployeeRecordDO employeeRecord =
+                createMonthEmployeeRecord(monthRecord.getId(), 2101L);
+        when(monthRecordService.validateMonthRecordExistsForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(salarySlipTemplateService.buildSalarySlipTemplateSnapshot(false, null))
+                .thenReturn(new HrmSalarySlipTemplateDO().setHideEmpty(false).setOptions(Collections.emptyList()));
+        when(monthEmployeeRecordService.getMonthEmployeeRecordList(
+                any(HrmSalaryMonthEmployeeRecordListReqVO.class)))
+                .thenReturn(Collections.singletonList(employeeRecord));
+        when(employeeService.getEmployeeMap(Collections.singleton(employeeRecord.getEmployeeId())))
+                .thenReturn(Collections.singletonMap(employeeRecord.getEmployeeId(),
+                        new HrmEmployeeDO().setId(employeeRecord.getEmployeeId())));
+        HrmSalarySlipSendReqVO reqVO = new HrmSalarySlipSendReqVO()
+                .setMonthRecordId(monthRecord.getId()).setHideEmpty(false).setAll(false)
+                .setEmployeeIds(Collections.singletonList(employeeRecord.getEmployeeId()));
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipSendRecordService.sendSalarySlip(reqVO),
+                SALARY_SLIP_EMPLOYEE_ACCOUNT_NOT_EXISTS);
+    }
+
+    @Test
+    public void testSendSalarySlip_allSkipEmployeeWithoutAccount() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord = createMonthRecord(2026, 9, 2);
+        HrmSalaryMonthEmployeeRecordDO boundEmployeeRecord =
+                createMonthEmployeeRecord(monthRecord.getId(), 2201L);
+        HrmSalaryMonthEmployeeRecordDO unboundEmployeeRecord =
+                createMonthEmployeeRecord(monthRecord.getId(), 2202L);
+        HrmSalarySlipTemplateDO template = new HrmSalarySlipTemplateDO()
+                .setHideEmpty(false).setOptions(Collections.emptyList());
+        when(monthRecordService.validateMonthRecordExistsForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(salarySlipTemplateService.buildSalarySlipTemplateSnapshot(false, null)).thenReturn(template);
+        when(monthEmployeeRecordService.getMonthEmployeeRecordList(
+                any(HrmSalaryMonthEmployeeRecordListReqVO.class)))
+                .thenReturn(Arrays.asList(boundEmployeeRecord, unboundEmployeeRecord));
+        when(employeeService.getEmployeeMap(any())).thenReturn(Collections.singletonMap(
+                boundEmployeeRecord.getEmployeeId(), new HrmEmployeeDO()
+                        .setId(boundEmployeeRecord.getEmployeeId()).setUserId(12201L)));
+        HrmSalarySlipSendReqVO reqVO = new HrmSalarySlipSendReqVO()
+                .setMonthRecordId(monthRecord.getId()).setHideEmpty(false).setAll(true);
+
+        // 调用
+        Long sendRecordId = salarySlipSendRecordService.sendSalarySlip(reqVO);
+
+        // 断言
+        assertEquals(1, salarySlipSendRecordMapper.selectById(sendRecordId).getSendEmployeeCount());
+        verify(salarySlipService).createSalarySlipList(
+                sendRecordId, Collections.singletonList(boundEmployeeRecord), template);
+    }
+
+    @Test
+    public void testSendSalarySlip_allFiltered_success() {
+        // mock 数据
+        HrmSalaryMonthRecordDO monthRecord = createMonthRecord(2026, 10, 2);
+        HrmSalaryMonthEmployeeRecordDO employeeRecord =
+                createMonthEmployeeRecord(monthRecord.getId(), 2202L);
+        HrmEmployeeDO employee = randomPojo(HrmEmployeeDO.class, o -> {
+            o.setId(employeeRecord.getEmployeeId()).setUserId(12202L)
+                    .setName("全部发放员工").setDeptId(200L);
+        });
+        HrmSalarySlipTemplateDO template = new HrmSalarySlipTemplateDO()
+                .setHideEmpty(false).setOptions(Collections.emptyList());
+        when(monthRecordService.validateMonthRecordExistsForUpdate(monthRecord.getId())).thenReturn(monthRecord);
+        when(salarySlipTemplateService.buildSalarySlipTemplateSnapshot(false, null)).thenReturn(template);
+        when(employeeService.getEmployeeList(any(HrmEmployeeListReqVO.class)))
+                .thenReturn(Collections.singletonList(employee));
+        when(monthEmployeeRecordService.getMonthEmployeeRecordList(
+                any(HrmSalaryMonthEmployeeRecordListReqVO.class)))
+                .thenReturn(Collections.singletonList(employeeRecord));
+        when(employeeService.getEmployeeMap(Collections.singleton(employeeRecord.getEmployeeId())))
+                .thenReturn(Collections.singletonMap(employeeRecord.getEmployeeId(), employee));
+        HrmSalarySlipSendReqVO reqVO = new HrmSalarySlipSendReqVO();
+        reqVO.setMonthRecordId(monthRecord.getId());
+        reqVO.setHideEmpty(false);
+        reqVO.setAll(true);
+        reqVO.setDeptId(employee.getDeptId());
+
+        // 调用
+        Long sendRecordId = salarySlipSendRecordService.sendSalarySlip(reqVO);
+
+        // 断言
+        assertEquals(1, salarySlipSendRecordMapper.selectById(sendRecordId).getSendEmployeeCount());
+        verify(salarySlipService).createSalarySlipList(
+                sendRecordId, Collections.singletonList(employeeRecord), template);
+    }
+
+    @Test
+    public void testDeleteSalarySlipSendRecord_success() {
+        // mock 数据
+        HrmSalarySlipSendRecordDO sendRecord = HrmSalarySlipSendRecordDO.builder()
+                .monthRecordId(1001L).employeeCount(2).sendEmployeeCount(1)
+                .year(2026).month(8).build();
+        salarySlipSendRecordMapper.insert(sendRecord);
+
+        // 调用
+        salarySlipSendRecordService.deleteSalarySlipSendRecord(sendRecord.getId());
+
+        // 断言
+        assertNull(salarySlipSendRecordMapper.selectById(sendRecord.getId()));
+        verify(salarySlipService).deleteSalarySlipListBySendRecordId(sendRecord.getId());
+    }
+
+    @Test
+    public void testGetSalarySlipSendRecordPage_success() {
+        // mock 数据
+        HrmSalarySlipSendRecordDO matchedRecord = HrmSalarySlipSendRecordDO.builder()
+                .monthRecordId(1001L).employeeCount(2).sendEmployeeCount(1)
+                .year(2026).month(8).build();
+        salarySlipSendRecordMapper.insert(matchedRecord);
+        salarySlipSendRecordMapper.insert(HrmSalarySlipSendRecordDO.builder()
+                .monthRecordId(1002L).employeeCount(2).sendEmployeeCount(2)
+                .year(2026).month(9).build());
+        HrmSalarySlipSendRecordPageReqVO reqVO = new HrmSalarySlipSendRecordPageReqVO();
+        reqVO.setYear(2026);
+        reqVO.setMonth(8);
+
+        // 调用
+        PageResult<HrmSalarySlipSendRecordDO> pageResult =
+                salarySlipSendRecordService.getSalarySlipSendRecordPage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(matchedRecord.getId(), pageResult.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetSalarySlipSendEmployeePage_monthRecordNotExists() {
+        // 准备参数
+        HrmSalarySlipSendEmployeeReqVO reqVO = new HrmSalarySlipSendEmployeeReqVO();
+        reqVO.setMonthRecordId(1001L);
+
+        // 调用
+        PageResult<HrmSalaryMonthEmployeeRecordDO> pageResult =
+                salarySlipSendRecordService.getSalarySlipSendEmployeePage(reqVO);
+
+        // 断言
+        assertEquals(0L, pageResult.getTotal());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalaryMonthRecordDO createMonthRecord(Integer year, Integer month, Integer employeeCount) {
+        return randomPojo(HrmSalaryMonthRecordDO.class, o -> {
+            o.setId((long) (year * 100 + month));
+            o.setYear(year).setMonth(month).setEmployeeCount(employeeCount);
+            o.setStatus(HrmSalaryMonthRecordStatusEnum.COMPUTED.getStatus());
+        });
+    }
+
+    private HrmSalaryMonthEmployeeRecordDO createMonthEmployeeRecord(Long monthRecordId, Long employeeId) {
+        return randomPojo(HrmSalaryMonthEmployeeRecordDO.class, o -> {
+            o.setId(employeeId + 10000L).setMonthRecordId(monthRecordId).setEmployeeId(employeeId);
+            o.setYear(2026).setMonth(8).setRealPaySalary(new BigDecimal("7910.00"));
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipServiceImplTest.java
new file mode 100644
index 0000000..ef7c37e
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipServiceImplTest.java
@@ -0,0 +1,345 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.framework.common.pojo.PageResult;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipPageReqVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.HrmSalarySlipRemarkReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.employee.info.HrmEmployeeDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.monthrecord.HrmSalaryMonthEmployeeRecordDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip.HrmSalarySlipMapper;
+import cn.iocoder.yudao.module.hrm.service.employee.info.HrmEmployeeService;
+import cn.iocoder.yudao.module.system.api.notify.NotifyMessageSendApi;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipReadStatusEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipTemplateOptionTypeEnum;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.Test;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.math.BigDecimal;
+import java.time.YearMonth;
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_ALREADY_SENT;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_SLIP_NOT_EXISTS;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.ArgumentMatchers.argThat;
+import static org.mockito.Mockito.verify;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalarySlipServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import(HrmSalarySlipServiceImpl.class)
+public class HrmSalarySlipServiceImplTest extends BaseDbUnitTest {
+
+    @Resource
+    private HrmSalarySlipServiceImpl salarySlipService;
+    @Resource
+    private HrmSalarySlipMapper salarySlipMapper;
+
+    @MockitoBean
+    private HrmEmployeeService employeeService;
+    @MockitoBean
+    private NotifyMessageSendApi notifyMessageSendApi;
+
+    @Test
+    public void testCreateSalarySlipList_success() {
+        // mock 数据
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = new HrmSalaryMonthEmployeeRecordDO()
+                .setId(1001L).setEmployeeId(2001L).setYear(2026).setMonth(8)
+                .setRealPaySalary(new BigDecimal("7910.00"))
+                .setOptionValues(Arrays.asList(
+                        createMonthOptionValue(10101, "基本工资", new BigDecimal("8000.00")),
+                        createMonthOptionValue(24001, "实发工资", new BigDecimal("7910.00"))));
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(employeeRecord.getEmployeeId())
+                .setName("测试员工").setUserId(3001L);
+        when(employeeService.getEmployeeMap(Collections.singleton(employee.getId())))
+                .thenReturn(Collections.singletonMap(employee.getId(), employee));
+        HrmSalarySlipTemplateDO.Option category = createTemplateOption(
+                "工资明细", HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType(), -1);
+        category.setChildren(Arrays.asList(
+                createTemplateOption("基本工资", HrmSalarySlipTemplateOptionTypeEnum.ITEM.getType(), 10101),
+                createTemplateOption("实发工资", HrmSalarySlipTemplateOptionTypeEnum.ITEM.getType(), 24001)));
+        HrmSalarySlipTemplateDO template = new HrmSalarySlipTemplateDO()
+                .setHideEmpty(false).setOptions(Collections.singletonList(category));
+
+        // 调用
+        salarySlipService.createSalarySlipList(3001L, Collections.singletonList(employeeRecord), template);
+
+        // 断言
+        HrmSalarySlipPageReqVO reqVO = new HrmSalarySlipPageReqVO();
+        reqVO.setSendRecordId(3001L);
+        PageResult<HrmSalarySlipDO> pageResult = salarySlipService.getSalarySlipPage(reqVO);
+        assertEquals(1L, pageResult.getTotal());
+        HrmSalarySlipDO salarySlip = pageResult.getList().get(0);
+        assertEquals(employeeRecord.getEmployeeId(), salarySlip.getEmployeeId());
+        assertEquals(1, salarySlip.getOptions().size());
+        assertEquals(2, salarySlip.getOptions().get(0).getChildren().size());
+        verify(notifyMessageSendApi).sendSingleMessageToAdmin(argThat(sendReqVO ->
+                employee.getUserId().equals(sendReqVO.getUserId())
+                        && "7910.00".equals(sendReqVO.getTemplateParams().get("realSalary"))));
+    }
+
+    @Test
+    public void testCreateSalarySlipList_insertAfterDeletedSlip() {
+        // mock 数据
+        HrmSalarySlipDO deletedSlip = createSalarySlip(1001L, 2001L, "历史工资条");
+        salarySlipMapper.deleteById(deletedSlip.getId());
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = new HrmSalaryMonthEmployeeRecordDO()
+                .setId(deletedSlip.getMonthEmployeeRecordId()).setEmployeeId(deletedSlip.getEmployeeId())
+                .setYear(2026).setMonth(8).setRealPaySalary(new BigDecimal("8000.00"))
+                .setOptionValues(Collections.emptyList());
+        HrmEmployeeDO employee = new HrmEmployeeDO().setId(employeeRecord.getEmployeeId())
+                .setName("测试员工").setUserId(3001L);
+        when(employeeService.getEmployeeMap(Collections.singleton(employee.getId())))
+                .thenReturn(Collections.singletonMap(employee.getId(), employee));
+        HrmSalarySlipTemplateDO template = new HrmSalarySlipTemplateDO()
+                .setHideEmpty(false).setOptions(Collections.emptyList());
+
+        // 调用
+        salarySlipService.createSalarySlipList(
+                4001L, Collections.singletonList(employeeRecord), template);
+
+        // 断言
+        assertNull(salarySlipMapper.selectById(deletedSlip.getId()));
+        HrmSalarySlipPageReqVO reqVO = new HrmSalarySlipPageReqVO();
+        reqVO.setSendRecordId(4001L);
+        HrmSalarySlipDO newSlip = salarySlipService.getSalarySlipPage(reqVO).getList().get(0);
+        assertNotEquals(deletedSlip.getId(), newSlip.getId());
+        assertEquals(Long.valueOf(4001L), newSlip.getSendRecordId());
+        assertEquals(0, new BigDecimal("8000.00").compareTo(newSlip.getRealPaySalary()));
+    }
+
+    @Test
+    public void testCreateSalarySlipList_employeeYearMonthAlreadySent() {
+        // mock 数据
+        HrmSalarySlipDO sentSlip = createSalarySlip(1001L, 2001L, "已发放");
+        HrmSalaryMonthEmployeeRecordDO employeeRecord = new HrmSalaryMonthEmployeeRecordDO()
+                .setId(1002L).setEmployeeId(sentSlip.getEmployeeId())
+                .setYear(sentSlip.getYear()).setMonth(sentSlip.getMonth())
+                .setRealPaySalary(new BigDecimal("8000.00")).setOptionValues(Collections.emptyList());
+        when(employeeService.getEmployeeMap(Collections.singleton(employeeRecord.getEmployeeId())))
+                .thenReturn(Collections.singletonMap(employeeRecord.getEmployeeId(),
+                        new HrmEmployeeDO().setId(employeeRecord.getEmployeeId()).setUserId(3001L)));
+        HrmSalarySlipTemplateDO template = new HrmSalarySlipTemplateDO()
+                .setHideEmpty(false).setOptions(Collections.emptyList());
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipService.createSalarySlipList(
+                4001L, Collections.singletonList(employeeRecord), template),
+                SALARY_SLIP_ALREADY_SENT);
+    }
+
+    @Test
+    public void testGetSalarySlipPage() {
+        // mock 数据
+        HrmSalarySlipDO matchedSlip = createSalarySlip(1001L, 2001L, "已确认无误");
+        // 测试查询条件不匹配
+        createSalarySlip(1002L, 2002L, "待确认");
+
+        // 准备参数
+        HrmSalarySlipPageReqVO reqVO = new HrmSalarySlipPageReqVO();
+        reqVO.setSendRecordId(matchedSlip.getSendRecordId());
+        reqVO.setEmployeeIds(Collections.singletonList(matchedSlip.getEmployeeId()));
+        reqVO.setRemark("无误");
+
+        // 调用
+        PageResult<HrmSalarySlipDO> pageResult = salarySlipService.getSalarySlipPage(reqVO);
+
+        // 断言
+        assertEquals(1L, pageResult.getTotal());
+        assertEquals(matchedSlip.getId(), pageResult.getList().get(0).getId());
+    }
+
+    @Test
+    public void testGetSalarySlipListByEmployeeId_orderBySendSequence() {
+        // mock 数据：先发 2026-08，之后补发 2025-12
+        Long employeeId = 2001L;
+        HrmSalarySlipDO firstSentSlip = createSalarySlip(
+                1001L, employeeId, 2026, 8, new BigDecimal("8000.00"));
+        HrmSalarySlipDO laterSentOldMonthSlip = createSalarySlip(
+                1002L, employeeId, 2025, 12, new BigDecimal("7000.00"));
+
+        // 调用：排序类型 1、方向 1 按发放时序倒序
+        List<HrmSalarySlipDO> salarySlips = salarySlipService.getSalarySlipListByEmployeeId(
+                employeeId, YearMonth.of(2025, 1), YearMonth.of(2026, 12), 1, 1);
+
+        // 断言：后补发的旧月份仍排在前面，不能按工资年月重排
+        assertEquals(Arrays.asList(laterSentOldMonthSlip.getId(), firstSentSlip.getId()),
+                Arrays.asList(salarySlips.get(0).getId(), salarySlips.get(1).getId()));
+    }
+
+    @Test
+    public void testGetSalarySlipListByEmployeeId_orderByRealPaySalaryStable() {
+        // mock 数据
+        Long employeeId = 2001L;
+        HrmSalarySlipDO firstSlip = createSalarySlip(
+                1001L, employeeId, 2026, 7, new BigDecimal("8000.00"));
+        HrmSalarySlipDO secondSlip = createSalarySlip(
+                1002L, employeeId, 2026, 8, new BigDecimal("8000.00"));
+
+        // 调用：相同实发工资按工资条编号稳定倒序
+        List<HrmSalarySlipDO> salarySlips = salarySlipService.getSalarySlipListByEmployeeId(
+                employeeId, null, null, 2, 1);
+
+        // 断言
+        assertEquals(Arrays.asList(secondSlip.getId(), firstSlip.getId()),
+                Arrays.asList(salarySlips.get(0).getId(), salarySlips.get(1).getId()));
+    }
+
+    @Test
+    public void testUpdateSalarySlipRemark_success() {
+        // mock 数据
+        HrmSalarySlipDO salarySlip = createSalarySlip(1001L, 2001L, "待确认");
+        // 准备参数
+        HrmSalarySlipRemarkReqVO remarkReqVO = new HrmSalarySlipRemarkReqVO();
+        remarkReqVO.setId(salarySlip.getId());
+        remarkReqVO.setRemark("复核通过");
+
+        // 调用
+        salarySlipService.updateSalarySlipRemark(remarkReqVO);
+
+        // 断言
+        assertEquals("复核通过",
+                salarySlipMapper.selectById(salarySlip.getId()).getRemark());
+    }
+
+    @Test
+    public void testMarkSalarySlipListRead_success() {
+        // mock 数据
+        HrmSalarySlipDO salarySlip = createSalarySlip(1001L, 2001L, "待确认");
+
+        // 调用
+        salarySlipService.markSalarySlipListRead(
+                salarySlip.getEmployeeId(), Collections.singletonList(salarySlip.getId()));
+
+        // 断言
+        assertEquals(HrmSalarySlipReadStatusEnum.READ.getStatus(),
+                salarySlipMapper.selectById(salarySlip.getId()).getReadStatus());
+    }
+
+    @Test
+    public void testGetSalarySlipReadCountMap() {
+        // mock 数据
+        HrmSalarySlipDO salarySlip = createSalarySlip(1001L, 2001L, "待确认");
+        salarySlipMapper.updateById(new HrmSalarySlipDO().setId(salarySlip.getId())
+                .setReadStatus(HrmSalarySlipReadStatusEnum.READ.getStatus()));
+        // 准备参数
+        List<Long> sendRecordIds = Collections.singletonList(salarySlip.getSendRecordId());
+
+        // 调用
+        Map<Long, Long> readCountMap = salarySlipService.getSalarySlipReadCountMap(
+                sendRecordIds);
+
+        // 断言
+        assertEquals(1L, readCountMap.get(salarySlip.getSendRecordId()));
+    }
+
+    @Test
+    public void testGetSentMonthEmployeeRecordIdSet() {
+        // mock 数据
+        HrmSalarySlipDO firstSlip = createSalarySlip(1001L, 2001L, "已确认");
+        HrmSalarySlipDO secondSlip = createSalarySlip(1002L, 2002L, "待确认");
+        // 准备参数
+        List<Long> monthEmployeeRecordIds = Arrays.asList(
+                firstSlip.getMonthEmployeeRecordId(), secondSlip.getMonthEmployeeRecordId());
+
+        // 调用
+        Set<Long> sentRecordIds = salarySlipService.getSentMonthEmployeeRecordIdSet(
+                monthEmployeeRecordIds);
+
+        // 断言
+        assertEquals(2, sentRecordIds.size());
+    }
+
+    @Test
+    public void testGetSalarySlipByIdAndEmployeeId_success() {
+        // mock 数据
+        HrmSalarySlipDO salarySlip = createSalarySlip(1001L, 2001L, "本人工资条");
+
+        // 调用
+        HrmSalarySlipDO result = salarySlipService.getSalarySlipByIdAndEmployeeId(
+                salarySlip.getId(), salarySlip.getEmployeeId());
+
+        // 断言
+        assertEquals(salarySlip.getId(), result.getId());
+        assertEquals(salarySlip.getEmployeeId(), result.getEmployeeId());
+        assertEquals("本人工资条", result.getRemark());
+    }
+
+    @Test
+    public void testGetSalarySlipByIdAndEmployeeId_notOwner() {
+        // mock 数据
+        HrmSalarySlipDO salarySlip = createSalarySlip(1001L, 2001L, "");
+
+        // 调用，并断言异常（非本人不可查看）
+        assertServiceException(() -> salarySlipService.getSalarySlipByIdAndEmployeeId(
+                salarySlip.getId(), 9999L), SALARY_SLIP_NOT_EXISTS);
+    }
+
+    @Test
+    public void testGetSalarySlipByIdAndEmployeeId_notExists() {
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipService.getSalarySlipByIdAndEmployeeId(
+                9999L, 2001L), SALARY_SLIP_NOT_EXISTS);
+    }
+
+    @Test
+    public void testMarkSalarySlipListRead_notOwner() {
+        // mock 数据
+        HrmSalarySlipDO salarySlip = createSalarySlip(1001L, 2001L, "");
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipService.markSalarySlipListRead(
+                9999L, Collections.singletonList(salarySlip.getId())), SALARY_SLIP_NOT_EXISTS);
+        assertEquals(HrmSalarySlipReadStatusEnum.UNREAD.getStatus(), salarySlipMapper.selectById(salarySlip.getId()).getReadStatus());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalarySlipDO createSalarySlip(Long monthEmployeeRecordId, Long employeeId, String remark) {
+        HrmSalarySlipDO salarySlip = createSalarySlip(
+                monthEmployeeRecordId, employeeId, 2026, 8, new BigDecimal("7910.00"));
+        salarySlipMapper.updateById(new HrmSalarySlipDO().setId(salarySlip.getId()).setRemark(remark));
+        salarySlip.setRemark(remark);
+        return salarySlip;
+    }
+
+    private HrmSalarySlipDO createSalarySlip(Long monthEmployeeRecordId, Long employeeId,
+                                             Integer year, Integer month, BigDecimal realPaySalary) {
+        HrmSalarySlipDO salarySlip = HrmSalarySlipDO.builder()
+                .sendRecordId(3001L).monthEmployeeRecordId(monthEmployeeRecordId).employeeId(employeeId)
+                .year(year).month(month).readStatus(HrmSalarySlipReadStatusEnum.UNREAD.getStatus())
+                .realPaySalary(realPaySalary).remark("")
+                .options(Collections.emptyList()).build();
+        salarySlipMapper.insert(salarySlip);
+        return salarySlip;
+    }
+
+    private HrmSalaryMonthEmployeeRecordDO.OptionValue createMonthOptionValue(
+            Integer code, String name, BigDecimal value) {
+        return HrmSalaryMonthEmployeeRecordDO.OptionValue.builder()
+                .code(code).name(name).value(value).build();
+    }
+
+    private HrmSalarySlipTemplateDO.Option createTemplateOption(
+            String name, Integer type, Integer code) {
+        return HrmSalarySlipTemplateDO.Option.builder()
+                .name(name).type(type).code(code).hidden(false).sort(code).children(Collections.emptyList()).build();
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateServiceImplTest.java b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateServiceImplTest.java
new file mode 100644
index 0000000..9da2b15
--- /dev/null
+++ b/yudao-module-hrm/src/test/java/cn/iocoder/yudao/module/hrm/service/salary/slip/HrmSalarySlipTemplateServiceImplTest.java
@@ -0,0 +1,357 @@
+package cn.iocoder.yudao.module.hrm.service.salary.slip;
+
+import cn.iocoder.yudao.module.hrm.service.salary.config.HrmSalaryOptionService;
+import cn.iocoder.yudao.framework.test.core.ut.BaseDbUnitTest;
+import cn.iocoder.yudao.framework.mybatis.core.util.MyBatisUtils;
+import cn.iocoder.yudao.framework.tenant.config.TenantProperties;
+import cn.iocoder.yudao.framework.tenant.core.context.TenantContextHolder;
+import cn.iocoder.yudao.framework.tenant.core.db.TenantDatabaseInterceptor;
+import cn.iocoder.yudao.framework.tenant.core.util.TenantUtils;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateOptionVO;
+import cn.iocoder.yudao.module.hrm.controller.admin.salary.vo.slip.template.HrmSalarySlipTemplateSaveReqVO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.config.HrmSalaryOptionDO;
+import cn.iocoder.yudao.module.hrm.dal.dataobject.salary.slip.HrmSalarySlipTemplateDO;
+import cn.iocoder.yudao.module.hrm.dal.mysql.salary.slip.HrmSalarySlipTemplateMapper;
+import cn.iocoder.yudao.module.hrm.enums.salary.config.HrmSalaryOptionCodeEnum;
+import cn.iocoder.yudao.module.hrm.enums.salary.slip.HrmSalarySlipTemplateOptionTypeEnum;
+import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
+import com.baomidou.mybatisplus.extension.plugins.inner.TenantLineInnerInterceptor;
+import jakarta.annotation.Resource;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.springframework.beans.factory.config.BeanPostProcessor;
+import org.springframework.boot.test.context.TestConfiguration;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Import;
+import org.springframework.test.context.bean.override.mockito.MockitoBean;
+
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+
+import static cn.iocoder.yudao.framework.test.core.util.AssertUtils.assertServiceException;
+import static cn.iocoder.yudao.framework.test.core.util.RandomUtils.randomPojo;
+import static cn.iocoder.yudao.module.hrm.enums.ErrorCodeConstants.SALARY_DATA_ILLEGAL;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertFalse;
+import static org.junit.jupiter.api.Assertions.assertNotNull;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.mockito.Mockito.when;
+
+/**
+ * {@link HrmSalarySlipTemplateServiceImpl} 的单元测试类
+ *
+ * @author 芋道源码
+ */
+@Import({HrmSalarySlipTemplateServiceImpl.class,
+        HrmSalarySlipTemplateServiceImplTest.TenantTestConfiguration.class})
+public class HrmSalarySlipTemplateServiceImplTest extends BaseDbUnitTest {
+
+    private static final Long TENANT_ID = 2L;
+
+    @TestConfiguration(proxyBeanMethods = false)
+    static class TenantTestConfiguration {
+
+        @Bean
+        static BeanPostProcessor tenantMybatisPlusInterceptorPostProcessor() {
+            return new BeanPostProcessor() {
+
+                @Override
+                public Object postProcessBeforeInitialization(Object bean, String beanName) {
+                    if (bean instanceof MybatisPlusInterceptor) {
+                        TenantLineInnerInterceptor inner = new TenantLineInnerInterceptor(
+                                new TenantDatabaseInterceptor(new TenantProperties()));
+                        MyBatisUtils.addInterceptor((MybatisPlusInterceptor) bean, inner, 0);
+                    }
+                    return bean;
+                }
+
+            };
+        }
+
+    }
+
+    @Resource
+    private HrmSalarySlipTemplateServiceImpl salarySlipTemplateService;
+    @Resource
+    private HrmSalarySlipTemplateMapper salarySlipTemplateMapper;
+
+    @MockitoBean
+    private HrmSalaryOptionService salaryOptionService;
+
+    @BeforeEach
+    public void setUpTenantContext() {
+        TenantContextHolder.setTenantId(TENANT_ID);
+    }
+
+    @AfterEach
+    public void clearTenantContext() {
+        TenantContextHolder.clear();
+    }
+
+    @Test
+    public void testCreateSalarySlipTemplate_success() {
+        // 准备参数
+        HrmSalarySlipTemplateSaveReqVO reqVO = randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+            o.setId(null);
+            o.setName("研发工资条");
+            o.setHideEmpty(null);
+            o.setOptions(Collections.singletonList(createTemplateOption("基本工资", 10101, 1)));
+        });
+
+        // 调用
+        Long templateId = salarySlipTemplateService.createSalarySlipTemplate(reqVO);
+
+        // 断言
+        assertNotNull(templateId);
+        HrmSalarySlipTemplateDO template = salarySlipTemplateService.getSalarySlipTemplate(templateId);
+        assertEquals("研发工资条", template.getName());
+        assertFalse(template.getHideEmpty());
+        assertFalse(template.getDefaultStatus());
+        assertEquals(2, template.getOptions().size());
+        assertTrue(template.getOptions().stream().anyMatch(
+                option -> Objects.equals(option.getCode(), HrmSalaryOptionCodeEnum.REAL_PAY.getCode())
+                        && Boolean.FALSE.equals(option.getHidden())));
+
+    }
+
+    @Test
+    public void testUpdateSalarySlipTemplate_success() {
+        // mock 数据
+        Long templateId = salarySlipTemplateService.createSalarySlipTemplate(
+                randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+                    o.setId(null).setName("研发工资条").setHideEmpty(false);
+                    o.setOptions(Collections.singletonList(
+                            createTemplateOption("基本工资", 10101, 1)));
+                }));
+        // 准备参数
+        HrmSalarySlipTemplateSaveReqVO reqVO = randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+            o.setId(templateId);
+            o.setName("研发工资条（新版）");
+            o.setHideEmpty(true);
+            o.setOptions(Collections.singletonList(
+                    createTemplateOption("应发工资", HrmSalaryOptionCodeEnum.EXPECTED_PAY.getCode(), 2)));
+        });
+
+        // 调用
+        salarySlipTemplateService.updateSalarySlipTemplate(reqVO);
+
+        // 断言
+        HrmSalarySlipTemplateDO template =
+                salarySlipTemplateService.getSalarySlipTemplate(templateId);
+        assertEquals("研发工资条（新版）", template.getName());
+        assertTrue(template.getOptions().stream().anyMatch(
+                option -> Objects.equals(option.getCode(), HrmSalaryOptionCodeEnum.EXPECTED_PAY.getCode())));
+        assertTrue(template.getOptions().stream().anyMatch(
+                option -> Objects.equals(option.getCode(), HrmSalaryOptionCodeEnum.REAL_PAY.getCode())));
+        assertEquals(1, salarySlipTemplateService.getSalarySlipTemplateList().size());
+    }
+
+    @Test
+    public void testDeleteSalarySlipTemplate_success() {
+        // mock 数据
+        Long templateId = salarySlipTemplateService.createSalarySlipTemplate(
+                randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+                    o.setId(null).setName("研发工资条").setHideEmpty(false);
+                    o.setOptions(Collections.singletonList(
+                            createTemplateOption("基本工资", 10101, 1)));
+                }));
+
+        // 调用
+        salarySlipTemplateService.deleteSalarySlipTemplate(templateId);
+
+        // 断言
+        assertNull(salarySlipTemplateMapper.selectById(templateId));
+    }
+
+    @Test
+    public void testDeleteSalarySlipTemplate_default() {
+        // mock 数据
+        HrmSalarySlipTemplateDO template = randomPojo(HrmSalarySlipTemplateDO.class, o -> {
+            o.setId(null).setName("默认工资条模板").setHideEmpty(false).setDefaultStatus(true);
+            o.setOptions(Collections.emptyList());
+        });
+        salarySlipTemplateMapper.insert(template);
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipTemplateService.deleteSalarySlipTemplate(template.getId()),
+                SALARY_DATA_ILLEGAL);
+    }
+
+    @Test
+    public void testCreateSalarySlipTemplate_category_success() {
+        // 准备参数
+        HrmSalarySlipTemplateOptionVO category = createTemplateOption("固定工资", -1, 1);
+        category.setType(HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType());
+        HrmSalarySlipTemplateOptionVO item = createTemplateOption("基本工资", 10101, 2);
+        item.setParentCode(category.getCode());
+        HrmSalarySlipTemplateSaveReqVO reqVO = randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+            o.setId(null);
+            o.setName("分类工资条");
+            o.setHideEmpty(false);
+            o.setOptions(Arrays.asList(category, item));
+        });
+
+        // 调用
+        Long templateId = salarySlipTemplateService.createSalarySlipTemplate(reqVO);
+
+        // 断言
+        HrmSalarySlipTemplateDO template = salarySlipTemplateMapper.selectById(templateId);
+        assertEquals(2, template.getOptions().size());
+        assertEquals("固定工资", template.getOptions().get(0).getName());
+        assertEquals(1, template.getOptions().get(0).getChildren().size());
+        assertEquals("基本工资", template.getOptions().get(0).getChildren().get(0).getName());
+    }
+
+    @Test
+    public void testCreateSalarySlipTemplate_orphanItem() {
+        // 准备参数
+        HrmSalarySlipTemplateOptionVO item = createTemplateOption("基本工资", 10101, 1);
+        item.setParentCode(-1);
+        HrmSalarySlipTemplateSaveReqVO reqVO = randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+            o.setId(null);
+            o.setOptions(Collections.singletonList(item));
+        });
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipTemplateService.createSalarySlipTemplate(reqVO),
+                SALARY_DATA_ILLEGAL);
+    }
+
+    @Test
+    public void testCreateSalarySlipTemplate_nestedCategory() {
+        // 准备参数
+        HrmSalarySlipTemplateOptionVO category = createTemplateOption("固定工资", -1, 1);
+        category.setType(HrmSalarySlipTemplateOptionTypeEnum.CATEGORY.getType());
+        category.setParentCode(-2);
+        HrmSalarySlipTemplateSaveReqVO reqVO = randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+            o.setId(null);
+            o.setOptions(Collections.singletonList(category));
+        });
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipTemplateService.createSalarySlipTemplate(reqVO),
+                SALARY_DATA_ILLEGAL);
+    }
+
+    @Test
+    public void testCreateSalarySlipTemplate_duplicateCode() {
+        // 准备参数
+        HrmSalarySlipTemplateOptionVO firstItem = createTemplateOption("基本工资", 10101, 1);
+        HrmSalarySlipTemplateOptionVO secondItem = createTemplateOption("重复基本工资", 10101, 2);
+        HrmSalarySlipTemplateSaveReqVO reqVO = randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+            o.setId(null);
+            o.setOptions(Arrays.asList(firstItem, secondItem));
+        });
+
+        // 调用，并断言异常
+        assertServiceException(() -> salarySlipTemplateService.createSalarySlipTemplate(reqVO),
+                SALARY_DATA_ILLEGAL);
+    }
+
+    @Test
+    public void testGetSalarySlipTemplate_defaultDynamicOptions() {
+        // mock 数据
+        HrmSalarySlipTemplateDO defaultTemplate = randomPojo(HrmSalarySlipTemplateDO.class, o -> {
+            o.setId(null).setName("默认工资条模板").setHideEmpty(false).setDefaultStatus(true);
+            o.setOptions(Collections.emptyList());
+        });
+        salarySlipTemplateMapper.insert(defaultTemplate);
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Arrays.asList(
+                createSalaryOption(HrmSalaryOptionCodeEnum.EXPECTED_PAY.getCode(), 210, "应发工资"),
+                createSalaryOption(HrmSalaryOptionCodeEnum.PERSONAL_TAX.getCode(), 230, "个人所得税"),
+                createSalaryOption(HrmSalaryOptionCodeEnum.REAL_PAY.getCode(), 240, "实发工资"),
+                createSalaryOption(10101, 10, "基本工资"),
+                createSalaryOption(20101, 20, "奖金")));
+
+        // 调用
+        HrmSalarySlipTemplateDO template = salarySlipTemplateService.getSalarySlipTemplateList().stream()
+                .filter(item -> Boolean.TRUE.equals(item.getDefaultStatus()))
+                .findFirst().orElseThrow(AssertionError::new);
+
+        // 断言
+        assertEquals(2, template.getOptions().size());
+        assertEquals("基本项", template.getOptions().get(0).getName());
+        assertEquals(3, template.getOptions().get(0).getChildren().size());
+        assertEquals("明细项", template.getOptions().get(1).getName());
+        assertEquals(2, template.getOptions().get(1).getChildren().size());
+    }
+
+    @Test
+    public void testGetSalarySlipTemplateList_fallbackGlobalDefaultForTenant() {
+        // mock 数据：平台默认模板固定保存到 tenant_id = 0，租户只创建自己的自定义模板
+        HrmSalarySlipTemplateDO globalDefaultTemplate = randomPojo(HrmSalarySlipTemplateDO.class, o -> {
+            o.setId(null).setName("平台默认工资条模板").setHideEmpty(false).setDefaultStatus(true);
+            o.setOptions(Collections.emptyList());
+        });
+        TenantUtils.executeIgnore(() -> salarySlipTemplateMapper.insert(globalDefaultTemplate));
+        HrmSalarySlipTemplateDO tenantTemplate = randomPojo(HrmSalarySlipTemplateDO.class, o -> {
+            o.setId(null).setName("租户自定义工资条模板").setHideEmpty(false).setDefaultStatus(false);
+            o.setOptions(Collections.emptyList());
+        });
+        salarySlipTemplateMapper.insert(tenantTemplate);
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Collections.emptyList());
+
+        // 调用
+        List<HrmSalarySlipTemplateDO> templates =
+                salarySlipTemplateService.getSalarySlipTemplateList();
+
+        // 断言：普通查询被租户隔离，但 Service 可只读回退平台默认模板
+        assertNull(salarySlipTemplateMapper.selectById(globalDefaultTemplate.getId()));
+        assertEquals(globalDefaultTemplate.getId(),
+                TenantUtils.executeIgnore(salarySlipTemplateMapper::selectGlobalDefaultTemplate).getId());
+        assertEquals(globalDefaultTemplate.getId(), salarySlipTemplateService
+                .getSalarySlipTemplate(globalDefaultTemplate.getId()).getId());
+        assertEquals(2, templates.size());
+        assertEquals(globalDefaultTemplate.getId(), templates.get(0).getId());
+        assertEquals(tenantTemplate.getId(), templates.get(1).getId());
+    }
+
+    @Test
+    public void testGetSalarySlipTemplate_customAppendUnclassifiedOptions() {
+        // mock 数据
+        when(salaryOptionService.getSalaryOptionList(false)).thenReturn(Arrays.asList(
+                createSalaryOption(10101, 10, "基本工资"),
+                createSalaryOption(10102, 10, "岗位工资"),
+                createSalaryOption(HrmSalaryOptionCodeEnum.REAL_PAY.getCode(), 240, "实发工资")));
+        HrmSalarySlipTemplateSaveReqVO reqVO = randomPojo(HrmSalarySlipTemplateSaveReqVO.class, o -> {
+            o.setId(null);
+            o.setName("自定义工资条");
+            o.setHideEmpty(false);
+            o.setOptions(Collections.singletonList(createTemplateOption("基本工资", 10101, 1)));
+        });
+        Long templateId = salarySlipTemplateService.createSalarySlipTemplate(reqVO);
+
+        // 调用
+        HrmSalarySlipTemplateDO template = salarySlipTemplateService.getSalarySlipTemplate(templateId);
+
+        // 断言
+        HrmSalarySlipTemplateDO.Option unclassifiedOption = template.getOptions().stream()
+                .filter(option -> Objects.equals(option.getName(), "未分类科目"))
+                .findFirst().orElseThrow(AssertionError::new);
+        assertEquals(1, unclassifiedOption.getChildren().size());
+        assertEquals(Integer.valueOf(10102), unclassifiedOption.getChildren().get(0).getCode());
+    }
+
+    // ========== 随机对象 ==========
+
+    private HrmSalaryOptionDO createSalaryOption(Integer code, Integer parentCode, String name) {
+        return HrmSalaryOptionDO.builder().code(code).parentCode(parentCode).name(name).build();
+    }
+
+    private HrmSalarySlipTemplateOptionVO createTemplateOption(String name, Integer code, Integer sort) {
+        return randomPojo(HrmSalarySlipTemplateOptionVO.class, o -> {
+            o.setName(name);
+            o.setType(2);
+            o.setCode(code);
+            o.setRemark(null);
+            o.setParentCode(null);
+            o.setHidden(null);
+            o.setSort(sort);
+        });
+    }
+
+}
diff --git a/yudao-module-hrm/src/test/resources/application-unit-test.yaml b/yudao-module-hrm/src/test/resources/application-unit-test.yaml
new file mode 100644
index 0000000..f0fcc54
--- /dev/null
+++ b/yudao-module-hrm/src/test/resources/application-unit-test.yaml
@@ -0,0 +1,36 @@
+spring:
+  main:
+    lazy-initialization: true
+    banner-mode: off
+    allow-bean-definition-overriding: true
+
+--- #################### 数据库相关配置 ####################
+
+spring:
+  datasource:
+    name: ruoyi-vue-pro
+    url: jdbc:h2:mem:testdb;MODE=MYSQL;DATABASE_TO_UPPER=false;NON_KEYWORDS=value,day,year,month;
+    driver-class-name: org.h2.Driver
+    username: sa
+    password:
+    druid:
+      async-init: true
+      initial-size: 1
+  sql:
+    init:
+      schema-locations: classpath:/sql/create_tables.sql
+
+  data:
+    redis:
+      host: 127.0.0.1
+      port: 16379
+      database: 0
+
+mybatis:
+  lazy-initialization: true
+
+--- #################### 芋道相关配置 ####################
+
+yudao:
+  info:
+    base-package: cn.iocoder.yudao.module
diff --git a/yudao-module-hrm/src/test/resources/logback.xml b/yudao-module-hrm/src/test/resources/logback.xml
new file mode 100644
index 0000000..8313843
--- /dev/null
+++ b/yudao-module-hrm/src/test/resources/logback.xml
@@ -0,0 +1,2 @@
+<configuration>
+</configuration>
diff --git a/yudao-module-hrm/src/test/resources/sql/clean.sql b/yudao-module-hrm/src/test/resources/sql/clean.sql
new file mode 100644
index 0000000..3adc0aa
--- /dev/null
+++ b/yudao-module-hrm/src/test/resources/sql/clean.sql
@@ -0,0 +1,48 @@
+DELETE FROM "hrm_salary_option_template";
+DELETE FROM "hrm_salary_change_template";
+DELETE FROM "hrm_config";
+DELETE FROM "hrm_employee_personal_note";
+DELETE FROM "hrm_performance_assessment_quota_score";
+DELETE FROM "hrm_performance_assessment_appeal_record";
+DELETE FROM "hrm_performance_assessment_stage";
+DELETE FROM "hrm_performance_assessment_quota";
+DELETE FROM "hrm_performance_assessment_dimension";
+DELETE FROM "hrm_performance_assessment";
+DELETE FROM "hrm_performance_plan";
+DELETE FROM "hrm_performance_result_template";
+DELETE FROM "hrm_performance_assessment_template";
+DELETE FROM "hrm_insurance_month_employee_record";
+DELETE FROM "hrm_insurance_month_record";
+DELETE FROM "hrm_insurance_employee_info";
+DELETE FROM "hrm_employee_salary_card";
+DELETE FROM "hrm_insurance_scheme_project";
+DELETE FROM "hrm_insurance_scheme";
+DELETE FROM "hrm_salary_slip";
+DELETE FROM "hrm_salary_slip_template";
+DELETE FROM "hrm_salary_slip_send_record";
+DELETE FROM "hrm_salary_month_employee_record";
+DELETE FROM "hrm_salary_month_record";
+DELETE FROM "hrm_salary_change_record";
+DELETE FROM "hrm_salary_employee_info";
+DELETE FROM "hrm_salary_group";
+DELETE FROM "hrm_salary_tax_rule";
+DELETE FROM "hrm_salary_option";
+DELETE FROM "hrm_salary_config";
+DELETE FROM "hrm_attendance_leave";
+DELETE FROM "hrm_employee_quit_info";
+DELETE FROM "hrm_employee_change_record";
+DELETE FROM "hrm_employee_contract";
+DELETE FROM "hrm_employee_contact";
+DELETE FROM "hrm_employee_certificate";
+DELETE FROM "hrm_employee_training_experience";
+DELETE FROM "hrm_employee_work_experience";
+DELETE FROM "hrm_employee_education_experience";
+DELETE FROM "hrm_employee";
+DELETE FROM "hrm_attendance_clock";
+DELETE FROM "hrm_attendance_holiday";
+DELETE FROM "hrm_attendance_group";
+DELETE FROM "hrm_recruit_interview";
+DELETE FROM "hrm_recruit_candidate";
+DELETE FROM "hrm_recruit_post";
+DELETE FROM "hrm_recruit_channel";
+DELETE FROM "hrm_recruit_post_type";
diff --git a/yudao-module-hrm/src/test/resources/sql/create_tables.sql b/yudao-module-hrm/src/test/resources/sql/create_tables.sql
new file mode 100644
index 0000000..0849b18
--- /dev/null
+++ b/yudao-module-hrm/src/test/resources/sql/create_tables.sql
@@ -0,0 +1,1048 @@
+CREATE TABLE IF NOT EXISTS "hrm_employee" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) NOT NULL,
+    "job_number" varchar(64) DEFAULT NULL,
+    "user_id" bigint DEFAULT NULL,
+    "mobile" varchar(255) DEFAULT NULL,
+    "country" varchar(64) DEFAULT NULL,
+    "nation" varchar(64) DEFAULT NULL,
+    "id_type" tinyint DEFAULT NULL,
+    "id_number" varchar(255) DEFAULT NULL,
+    "sex" tinyint DEFAULT NULL,
+    "email" varchar(255) DEFAULT NULL,
+    "native_place" varchar(128) DEFAULT NULL,
+    "birthday" timestamp DEFAULT NULL,
+    "age" int DEFAULT NULL,
+    "address" varchar(255) DEFAULT NULL,
+    "highest_education" tinyint DEFAULT NULL,
+    "dept_id" bigint DEFAULT NULL,
+    "leader_employee_id" bigint DEFAULT NULL,
+    "entry_status" tinyint DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "type" tinyint DEFAULT NULL,
+    "entry_time" timestamp DEFAULT NULL,
+    "probation" int DEFAULT NULL,
+    "regular_time" timestamp DEFAULT NULL,
+    "leave_time" timestamp DEFAULT NULL,
+    "post_name" varchar(255) DEFAULT NULL,
+    "post_level" varchar(255) DEFAULT NULL,
+    "work_city" varchar(64) DEFAULT NULL,
+    "work_address" varchar(255) DEFAULT NULL,
+    "work_detail_address" varchar(255) DEFAULT NULL,
+    "channel_id" bigint DEFAULT NULL,
+    "company_age_start_time" timestamp DEFAULT NULL,
+    "company_age" int DEFAULT NULL,
+    "candidate_id" bigint DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+CREATE TABLE IF NOT EXISTS "hrm_employee_education_experience" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "education" tinyint DEFAULT NULL,
+    "graduate_school" varchar(255) DEFAULT NULL,
+    "major" varchar(255) DEFAULT NULL,
+    "admission_time" timestamp DEFAULT NULL,
+    "graduation_time" timestamp DEFAULT NULL,
+    "teaching_methods" tinyint DEFAULT NULL,
+    "first_degree" boolean DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_work_experience" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "work_unit" varchar(255) DEFAULT NULL,
+    "post_name" varchar(255) DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "end_time" timestamp DEFAULT NULL,
+    "reason" varchar(1024) DEFAULT NULL,
+    "witness_name" varchar(255) DEFAULT NULL,
+    "witness_phone" varchar(32) DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_training_experience" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "course" varchar(128) DEFAULT NULL,
+    "organization_name" varchar(128) DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "end_time" timestamp DEFAULT NULL,
+    "duration" varchar(64) DEFAULT NULL,
+    "result" varchar(64) DEFAULT NULL,
+    "certificate_name" varchar(128) DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_certificate" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "name" varchar(255) DEFAULT NULL,
+    "level" varchar(255) DEFAULT NULL,
+    "no" varchar(255) DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "end_time" timestamp DEFAULT NULL,
+    "issuing_authority" varchar(255) DEFAULT NULL,
+    "issuing_time" timestamp DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_contact" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "name" varchar(64) DEFAULT NULL,
+    "relation" varchar(64) DEFAULT NULL,
+    "phone" varchar(40) DEFAULT NULL,
+    "work_unit" varchar(128) DEFAULT NULL,
+    "post_name" varchar(128) DEFAULT NULL,
+    "address" varchar(255) DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_contract" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "no" varchar(128) DEFAULT NULL,
+    "type" tinyint DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "end_time" timestamp DEFAULT NULL,
+    "term" int DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "sign_company" varchar(255) DEFAULT NULL,
+    "sign_time" timestamp DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "expire_remind" boolean DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "file_urls" varchar(2048) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_file" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "type" tinyint NOT NULL,
+    "url" varchar(512) NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_change_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "type" tinyint DEFAULT NULL,
+    "reason" tinyint DEFAULT NULL,
+    "old_dept_id" bigint DEFAULT NULL,
+    "new_dept_id" bigint DEFAULT NULL,
+    "old_post_name" varchar(255) DEFAULT NULL,
+    "new_post_name" varchar(255) DEFAULT NULL,
+    "old_post_level" varchar(255) DEFAULT NULL,
+    "new_post_level" varchar(255) DEFAULT NULL,
+    "old_work_address" varchar(255) DEFAULT NULL,
+    "new_work_address" varchar(255) DEFAULT NULL,
+    "old_leader_employee_id" bigint DEFAULT NULL,
+    "new_leader_employee_id" bigint DEFAULT NULL,
+    "probation" int DEFAULT NULL,
+    "effect_time" timestamp DEFAULT NULL,
+    "applied_time" timestamp DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_quit_info" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "plan_quit_time" timestamp DEFAULT NULL,
+    "apply_quit_time" timestamp DEFAULT NULL,
+    "salary_settlement_time" timestamp DEFAULT NULL,
+    "type" tinyint DEFAULT NULL,
+    "reason" tinyint DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "old_employee_status" tinyint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_attendance_leave" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "type" varchar(64) DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "end_time" timestamp DEFAULT NULL,
+    "day" decimal(10, 2) DEFAULT NULL,
+    "reason" varchar(300) DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "approval_status" tinyint NOT NULL,
+    "process_instance_id" varchar(64) DEFAULT NULL,
+    "approval_time" timestamp DEFAULT NULL,
+    "approval_reason" varchar(500) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    CONSTRAINT "uk_hrm_attendance_leave_process_instance_id" UNIQUE ("process_instance_id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_config" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "type" tinyint NOT NULL,
+    "value" varchar(255) NOT NULL,
+    "sort" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_personal_note" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "content" varchar(1024) NOT NULL,
+    "reminder_time" timestamp NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_recruit_post_type" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(40) DEFAULT NULL,
+    "parent_id" bigint DEFAULT NULL,
+    "sort" int DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_recruit_channel" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "system_flag" bit DEFAULT FALSE,
+    "status" tinyint DEFAULT NULL,
+    "name" varchar(255) NOT NULL,
+    "sort" int DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_recruit_post" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "post_name" varchar(255) NOT NULL,
+    "dept_id" bigint DEFAULT NULL,
+    "job_nature" tinyint DEFAULT NULL,
+    "area_id" int DEFAULT NULL,
+    "recruit_num" int DEFAULT NULL,
+    "reason" varchar(255) DEFAULT NULL,
+    "work_time" tinyint DEFAULT NULL,
+    "education_require" tinyint DEFAULT NULL,
+    "min_salary" decimal(10, 2) DEFAULT NULL,
+    "max_salary" decimal(10, 2) DEFAULT NULL,
+    "salary_unit" tinyint DEFAULT NULL,
+    "min_age" int DEFAULT NULL,
+    "max_age" int DEFAULT NULL,
+    "latest_entry_time" timestamp DEFAULT NULL,
+    "owner_employee_id" bigint DEFAULT NULL,
+    "interview_employee_ids" varchar(255) DEFAULT NULL,
+    "description" varchar(4000) DEFAULT NULL,
+    "emergency_level" tinyint DEFAULT NULL,
+    "post_type_id" bigint DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "stop_reason" varchar(255) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_recruit_candidate" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) NOT NULL,
+    "mobile" varchar(255) NOT NULL,
+    "sex" tinyint NOT NULL,
+    "age" int DEFAULT NULL,
+    "email" varchar(255) DEFAULT NULL,
+    "post_id" bigint NOT NULL,
+    "stage_number" int DEFAULT NULL,
+    "work_time" int DEFAULT NULL,
+    "education" tinyint NOT NULL,
+    "graduate_school" varchar(255) DEFAULT NULL,
+    "latest_work_place" varchar(255) DEFAULT NULL,
+    "channel_id" bigint DEFAULT NULL,
+    "remark" varchar(255) DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "eliminate" varchar(255) DEFAULT NULL,
+    "status_update_time" timestamp DEFAULT NULL,
+    "entry_time" timestamp DEFAULT NULL,
+    "resume_urls" varchar(4000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_recruit_interview" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "candidate_id" bigint NOT NULL,
+    "type" tinyint DEFAULT NULL,
+    "stage_number" int DEFAULT NULL,
+    "interview_employee_id" bigint DEFAULT NULL,
+    "other_interview_employee_ids" varchar(255) DEFAULT NULL,
+    "interview_time" timestamp DEFAULT NULL,
+    "address" varchar(255) DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "result" tinyint DEFAULT NULL,
+    "evaluate" varchar(255) DEFAULT NULL,
+    "cancel_reason" varchar(255) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_attendance_group" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(50) NOT NULL,
+    "dept_ids" varchar(4000) DEFAULT NULL,
+    "employee_ids" varchar(4000) DEFAULT NULL,
+    "open_wifi_card" boolean NOT NULL DEFAULT FALSE,
+    "open_point_card" boolean NOT NULL DEFAULT FALSE,
+    "shifts" varchar(10000) NOT NULL,
+    "rest" boolean NOT NULL DEFAULT TRUE,
+    "special_dates" varchar(4000) NOT NULL,
+    "points" varchar(10000) NOT NULL,
+    "wifis" varchar(10000) NOT NULL,
+    "deduct_rule" varchar(4000) NOT NULL,
+    "default_status" boolean NOT NULL DEFAULT FALSE,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_attendance_holiday" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "date" timestamp NOT NULL,
+    "type" tinyint DEFAULT 2,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_attendance_clock" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint DEFAULT NULL,
+    "clock_time" timestamp NOT NULL,
+    "type" tinyint NOT NULL,
+    "attendance_time" timestamp NOT NULL,
+    "source_type" tinyint DEFAULT 2,
+    "status" tinyint DEFAULT 0,
+    "stage" int DEFAULT 1,
+    "address" varchar(255) DEFAULT NULL,
+    "longitude" decimal(10, 6) DEFAULT NULL,
+    "latitude" decimal(10, 6) DEFAULT NULL,
+    "ssid" varchar(50) DEFAULT NULL,
+    "mac" varchar(50) DEFAULT NULL,
+    "remark" varchar(255) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_config" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "cycle_start_day" int DEFAULT NULL,
+    "cycle_end_day" int DEFAULT NULL,
+    "social_security_month_type" tinyint DEFAULT NULL,
+    "start_year" int DEFAULT NULL,
+    "start_month" int DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    CONSTRAINT "uk_hrm_salary_config_tenant_id" UNIQUE ("tenant_id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_tax_rule" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(64) NOT NULL,
+    "type" tinyint DEFAULT NULL,
+    "tax_enabled" bit DEFAULT NULL,
+    "threshold" decimal(12, 2) DEFAULT NULL,
+    "decimal_scale" int DEFAULT NULL,
+    "cycle_type" tinyint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_group" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(64) NOT NULL,
+    "salary_standard" decimal(12, 2) DEFAULT NULL,
+    "change_rule" varchar(255) DEFAULT NULL,
+    "dept_ids" varchar(20000) DEFAULT NULL,
+    "employee_ids" varchar(20000) DEFAULT NULL,
+    "tax_rule_id" bigint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_option_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "code" int NOT NULL,
+    "parent_code" int NOT NULL DEFAULT 0,
+    "name" varchar(64) NOT NULL,
+    "remark" varchar(255) DEFAULT NULL,
+    "system_flag" boolean NOT NULL DEFAULT FALSE,
+    "type" tinyint NOT NULL DEFAULT 1,
+    "tax_enabled" boolean NOT NULL DEFAULT TRUE,
+    "visible" boolean NOT NULL DEFAULT TRUE,
+    "calculate_enabled" boolean NOT NULL DEFAULT TRUE,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    PRIMARY KEY ("id"),
+    CONSTRAINT "uk_hrm_salary_option_template_code" UNIQUE ("code")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_option" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "code" int NOT NULL,
+    "parent_code" int NOT NULL DEFAULT 0,
+    "name" varchar(64) NOT NULL,
+    "remark" varchar(255) DEFAULT NULL,
+    "system_flag" boolean NOT NULL DEFAULT FALSE,
+    "template_id" bigint DEFAULT NULL,
+    "type" tinyint NOT NULL DEFAULT 1,
+    "tax_enabled" boolean NOT NULL DEFAULT TRUE,
+    "visible" boolean NOT NULL DEFAULT TRUE,
+    "calculate_enabled" boolean NOT NULL DEFAULT TRUE,
+    "enabled" boolean NOT NULL DEFAULT TRUE,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    CONSTRAINT "uk_hrm_salary_option_tenant_code" UNIQUE ("tenant_id", "code")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_employee_info" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "change_reason" tinyint DEFAULT NULL,
+    "effect_time" timestamp DEFAULT NULL,
+    "change_type" tinyint DEFAULT NULL,
+    "probation_salary" decimal(12, 2) DEFAULT NULL,
+    "regular_salary" decimal(12, 2) DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "salary_options" varchar(20000) DEFAULT NULL,
+    "probation_salary_options" varchar(20000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id"),
+    CONSTRAINT "uk_hrm_salary_employee_info_employee_id" UNIQUE ("employee_id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_change_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "type" tinyint DEFAULT NULL,
+    "reason" tinyint DEFAULT NULL,
+    "effect_time" timestamp DEFAULT NULL,
+    "before_total" decimal(12, 2) DEFAULT NULL,
+    "after_total" decimal(12, 2) DEFAULT NULL,
+    "probation_before_total" decimal(12, 2) DEFAULT NULL,
+    "probation_after_total" decimal(12, 2) DEFAULT NULL,
+    "salary_options" varchar(4000) DEFAULT NULL,
+    "probation_salary_options" varchar(4000) DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_change_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(64) NOT NULL,
+    "default_status" boolean NOT NULL DEFAULT FALSE,
+    "options" varchar(4000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_month_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "title" varchar(128) DEFAULT NULL,
+    "year" int NOT NULL,
+    "month" int NOT NULL,
+    "employee_count" int DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "end_time" timestamp DEFAULT NULL,
+    "expected_pay_salary" decimal(12, 2) DEFAULT NULL,
+    "personal_tax" decimal(12, 2) DEFAULT NULL,
+    "real_pay_salary" decimal(12, 2) DEFAULT NULL,
+    "personal_insurance_amount" decimal(12, 2) DEFAULT NULL,
+    "personal_provident_fund_amount" decimal(12, 2) DEFAULT NULL,
+    "corporate_insurance_amount" decimal(12, 2) DEFAULT NULL,
+    "corporate_provident_fund_amount" decimal(12, 2) DEFAULT NULL,
+    "option_headers" varchar(20000) DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_month_employee_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "month_record_id" bigint NOT NULL,
+    "employee_id" bigint NOT NULL,
+    "actual_work_day" decimal(10, 2) DEFAULT NULL,
+    "need_work_day" decimal(10, 2) DEFAULT NULL,
+    "year" int NOT NULL,
+    "month" int NOT NULL,
+    "expected_pay_salary" decimal(12, 2) DEFAULT NULL,
+    "taxable_salary" decimal(12, 2) DEFAULT NULL,
+    "personal_tax" decimal(12, 2) DEFAULT NULL,
+    "real_pay_salary" decimal(12, 2) DEFAULT NULL,
+    "option_values" varchar(20000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_slip_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(64) NOT NULL,
+    "hide_empty" boolean NOT NULL DEFAULT FALSE,
+    "default_status" boolean NOT NULL DEFAULT FALSE,
+    "options" varchar(20000) NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_slip_send_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "month_record_id" bigint NOT NULL,
+    "employee_count" int DEFAULT NULL,
+    "send_employee_count" int DEFAULT NULL,
+    "year" int NOT NULL,
+    "month" int NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_salary_slip" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "send_record_id" bigint NOT NULL,
+    "month_employee_record_id" bigint NOT NULL,
+    "employee_id" bigint NOT NULL,
+    "year" int NOT NULL,
+    "month" int NOT NULL,
+    "read_status" tinyint DEFAULT NULL,
+    "real_pay_salary" decimal(12, 2) DEFAULT NULL,
+    "remark" varchar(500) DEFAULT NULL,
+    "options" varchar(20000) NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_insurance_scheme" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(64) NOT NULL,
+    "area_id" int DEFAULT NULL,
+    "household_type" varchar(64) DEFAULT NULL,
+    "type" tinyint NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_insurance_scheme_project" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "scheme_id" bigint NOT NULL,
+    "type" tinyint NOT NULL,
+    "name" varchar(64) NOT NULL,
+    "base_amount" decimal(12, 2) DEFAULT NULL,
+    "corporate_rate" decimal(10, 2) DEFAULT NULL,
+    "personal_rate" decimal(10, 2) DEFAULT NULL,
+    "corporate_amount" decimal(12, 2) DEFAULT NULL,
+    "personal_amount" decimal(12, 2) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_insurance_employee_info" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "first_social_security" boolean NOT NULL DEFAULT FALSE,
+    "first_accumulation_fund" boolean NOT NULL DEFAULT FALSE,
+    "social_security_number" varchar(64) DEFAULT NULL,
+    "accumulation_fund_number" varchar(64) DEFAULT NULL,
+    "social_security_start_month" timestamp DEFAULT NULL,
+    "scheme_id" bigint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_employee_salary_card" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "employee_id" bigint NOT NULL,
+    "bank_card_number" varchar(64) DEFAULT NULL,
+    "bank_area_id" int DEFAULT NULL,
+    "bank_name" varchar(64) DEFAULT NULL,
+    "bank_branch_name" varchar(128) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_insurance_month_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "title" varchar(128) DEFAULT NULL,
+    "year" int NOT NULL,
+    "month" int NOT NULL,
+    "insured_employee_count" int DEFAULT NULL,
+    "stopped_employee_count" int DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "personal_insurance_amount" decimal(12, 2) DEFAULT NULL,
+    "personal_provident_fund_amount" decimal(12, 2) DEFAULT NULL,
+    "corporate_insurance_amount" decimal(12, 2) DEFAULT NULL,
+    "corporate_provident_fund_amount" decimal(12, 2) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_insurance_month_employee_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "month_record_id" bigint NOT NULL,
+    "employee_id" bigint NOT NULL,
+    "scheme_id" bigint DEFAULT NULL,
+    "year" int NOT NULL,
+    "month" int NOT NULL,
+    "personal_insurance_amount" decimal(12, 2) DEFAULT NULL,
+    "personal_provident_fund_amount" decimal(12, 2) DEFAULT NULL,
+    "corporate_insurance_amount" decimal(12, 2) DEFAULT NULL,
+    "corporate_provident_fund_amount" decimal(12, 2) DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "projects" varchar(10000) NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(500) NOT NULL,
+    "illustrate" varchar(1000) DEFAULT NULL,
+    "score_calculation" tinyint DEFAULT 1,
+    "upper_limit_type" tinyint DEFAULT 0,
+    "upper_limit_score" decimal(10, 2) DEFAULT 100.00,
+    "dimension_count" int DEFAULT 0,
+    "quota_count" int DEFAULT 0,
+    "dimensions" varchar(20000) NOT NULL,
+    "status" tinyint DEFAULT 0,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_result_template" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) NOT NULL,
+    "levels" varchar(20000) NOT NULL,
+    "status" tinyint DEFAULT 0,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_plan" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "name" varchar(255) NOT NULL,
+    "cycle_type" tinyint DEFAULT NULL,
+    "cycle" varchar(255) DEFAULT NULL,
+    "quarter" tinyint DEFAULT NULL,
+    "start_time" timestamp DEFAULT NULL,
+    "end_time" timestamp DEFAULT NULL,
+    "description" varchar(1000) DEFAULT NULL,
+    "scopes" varchar(20000) NOT NULL,
+    "assessment_template_id" bigint NOT NULL,
+    "assessment_config" varchar(20000) NOT NULL,
+    "result_template_id" bigint NOT NULL,
+    "result_config" varchar(20000) NOT NULL,
+    "quota_setting_type" tinyint NOT NULL DEFAULT 1,
+    "target_confirmation" bit DEFAULT FALSE NOT NULL,
+    "target_confirmation_stage" varchar(20000) DEFAULT NULL,
+    "review_stages" varchar(20000) NOT NULL,
+    "result_audit" bit DEFAULT TRUE NOT NULL,
+    "result_audit_stages" varchar(20000) DEFAULT NULL,
+    "result_confirmation" bit DEFAULT TRUE NOT NULL,
+    "appeal_stages" varchar(20000) DEFAULT NULL,
+    "appeal_timeout_days" int DEFAULT 2 NOT NULL,
+    "appeal_timeout_action" tinyint DEFAULT 1 NOT NULL,
+    "sync_to_salary" bit DEFAULT FALSE,
+    "paid_for_month" varchar(20) DEFAULT NULL,
+    "stage_type" tinyint DEFAULT 0,
+    "status" tinyint DEFAULT 2,
+    "operation_type" tinyint DEFAULT NULL,
+    "terminate_time" timestamp DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "plan_id" bigint NOT NULL,
+    "employee_id" bigint NOT NULL,
+    "status" tinyint DEFAULT 2,
+    "process_status" tinyint DEFAULT 1,
+    "stage_type" tinyint DEFAULT 0,
+    "stage_sort" int DEFAULT 0,
+    "score" decimal(10, 2) DEFAULT 0.00,
+    "result_level" varchar(64) DEFAULT NULL,
+    "coefficient" decimal(10, 2) DEFAULT 1.00,
+    "target_confirmation_result" tinyint DEFAULT NULL,
+    "target_confirmation_comment" varchar(1000) DEFAULT NULL,
+    "target_confirmation_time" timestamp DEFAULT NULL,
+    "self_comment" varchar(2000) DEFAULT NULL,
+    "reviewer_comment" varchar(2000) DEFAULT NULL,
+    "result_comment" varchar(2000) DEFAULT NULL,
+    "result_confirmation_time" timestamp DEFAULT NULL,
+    "result_audit_status" tinyint DEFAULT NULL,
+    "result_audit_time" timestamp DEFAULT NULL,
+    "result_audit_reason" varchar(1000) DEFAULT NULL,
+    "appeal_reason" varchar(1000) DEFAULT NULL,
+    "appeal_file_urls" varchar(2000) DEFAULT NULL,
+    "appeal_submit_time" timestamp DEFAULT NULL,
+    "appeal_status" tinyint DEFAULT 0,
+    "appeal_time" timestamp DEFAULT NULL,
+    "appeal_comment" varchar(1000) DEFAULT NULL,
+    "archive_time" timestamp DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment_appeal_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "assessment_id" bigint NOT NULL,
+    "stage_id" bigint NOT NULL,
+    "status" tinyint NOT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment_action_record" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "assessment_id" bigint NOT NULL,
+    "stage_id" bigint DEFAULT NULL,
+    "employee_id" bigint DEFAULT NULL,
+    "type" tinyint NOT NULL,
+    "title" varchar(128) NOT NULL,
+    "content" varchar(2000) DEFAULT NULL,
+    "file_urls" varchar(2000) DEFAULT NULL,
+    "status" tinyint DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment_stage" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "assessment_id" bigint NOT NULL,
+    "type" tinyint NOT NULL,
+    "name" varchar(128) NOT NULL,
+    "handler_employee_id" bigint DEFAULT NULL,
+    "rater_type" tinyint DEFAULT NULL,
+    "weight" decimal(10, 2) DEFAULT NULL,
+    "scoring_type" tinyint DEFAULT NULL,
+    "visible_content" tinyint DEFAULT NULL,
+    "required_setting" bit DEFAULT NULL,
+    "reject_authority" bit DEFAULT NULL,
+    "sort" int NOT NULL DEFAULT 0,
+    "status" tinyint NOT NULL DEFAULT 0,
+    "score" decimal(10, 2) DEFAULT NULL,
+    "result_level" varchar(64) DEFAULT NULL,
+    "comment" varchar(2000) DEFAULT NULL,
+    "reject_reason" varchar(1000) DEFAULT NULL,
+    "submit_time" timestamp DEFAULT NULL,
+    "deadline_time" timestamp DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment_quota_score" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "assessment_stage_id" bigint NOT NULL,
+    "assessment_quota_id" bigint NOT NULL,
+    "score" decimal(10, 2) NOT NULL,
+    "comment" varchar(1000) DEFAULT NULL,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment_dimension" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "assessment_id" bigint NOT NULL,
+    "name" varchar(255) NOT NULL,
+    "quota_type" tinyint DEFAULT NULL,
+    "weight" decimal(10, 2) DEFAULT NULL,
+    "remark" varchar(255) DEFAULT NULL,
+    "allow_edit" bit NOT NULL DEFAULT FALSE,
+    "sort" int NOT NULL DEFAULT 0,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
+
+CREATE TABLE IF NOT EXISTS "hrm_performance_assessment_quota" (
+    "id" bigint NOT NULL GENERATED BY DEFAULT AS IDENTITY,
+    "assessment_id" bigint NOT NULL,
+    "dimension_id" bigint NOT NULL,
+    "preset" bit NOT NULL DEFAULT TRUE,
+    "name" varchar(255) DEFAULT NULL,
+    "description" varchar(1000) DEFAULT NULL,
+    "standard" varchar(1000) DEFAULT NULL,
+    "weight" decimal(10, 2) DEFAULT 100.00,
+    "score_type" tinyint DEFAULT NULL,
+    "target_value" varchar(1000) DEFAULT NULL,
+    "actual_value" varchar(1000) DEFAULT NULL,
+    "self_score" decimal(10, 2) DEFAULT 0.00,
+    "reviewer_score" decimal(10, 2) DEFAULT 0.00,
+    "final_score" decimal(10, 2) DEFAULT 0.00,
+    "sort" int DEFAULT 0,
+    "creator" varchar(64) DEFAULT '',
+    "create_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "updater" varchar(64) DEFAULT '',
+    "update_time" timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "deleted" bit NOT NULL DEFAULT FALSE,
+    "tenant_id" bigint NOT NULL DEFAULT 0,
+    PRIMARY KEY ("id")
+);
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApi.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApi.java
index bdc3ba5..974509d 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApi.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApi.java
@@ -1,9 +1,11 @@
 package cn.iocoder.yudao.module.system.api.dept;
 
+import cn.hutool.core.collection.CollUtil;
 import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
 import cn.iocoder.yudao.module.system.api.dept.dto.DeptRespDTO;
 
 import java.util.Collection;
+import java.util.Collections;
 import java.util.List;
 import java.util.Map;
 
@@ -46,6 +48,9 @@ public interface DeptApi {
      * @return 部门 Map
      */
     default Map<Long, DeptRespDTO> getDeptMap(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyMap();
+        }
         List<DeptRespDTO> list = getDeptList(ids);
         return CollectionUtils.convertMap(list, DeptRespDTO::getId);
     }
@@ -56,6 +61,26 @@ public interface DeptApi {
      * @param id 部门编号
      * @return 子部门列表
      */
-    List<DeptRespDTO> getChildDeptList(Long id);
+    default List<DeptRespDTO> getChildDeptList(Long id) {
+        return getChildDeptList(Collections.singleton(id));
+    }
+
+    /**
+     * 获得指定部门的所有子部门
+     *
+     * @param ids 部门编号数组
+     * @return 子部门列表
+     */
+    List<DeptRespDTO> getChildDeptList(Collection<Long> ids);
+
+    /**
+     * 获得指定部门的所有父部门
+     *
+     * 按直属父部门到根部门的顺序返回，不包含指定部门自身。
+     *
+     * @param id 部门编号
+     * @return 父部门列表
+     */
+    List<DeptRespDTO> getParentDeptList(Long id);
 
 }
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApiImpl.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApiImpl.java
index a37dc1b..11e6bfc 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApiImpl.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/dept/DeptApiImpl.java
@@ -39,9 +39,15 @@ public class DeptApiImpl implements DeptApi {
     }
 
     @Override
-    public List<DeptRespDTO> getChildDeptList(Long id) {
-        List<DeptDO> childDeptList = deptService.getChildDeptList(id);
-        return BeanUtils.toBean(childDeptList, DeptRespDTO.class);
+    public List<DeptRespDTO> getChildDeptList(Collection<Long> ids) {
+        List<DeptDO> childDepts = deptService.getChildDeptList(ids);
+        return BeanUtils.toBean(childDepts, DeptRespDTO.class);
+    }
+
+    @Override
+    public List<DeptRespDTO> getParentDeptList(Long id) {
+        List<DeptDO> parentDepts = deptService.getParentDeptList(id);
+        return BeanUtils.toBean(parentDepts, DeptRespDTO.class);
     }
 
 }
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApi.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApi.java
index 0092b27..ad30655 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApi.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApi.java
@@ -1,5 +1,6 @@
 package cn.iocoder.yudao.module.system.api.user;
 
+import cn.hutool.core.collection.CollUtil;
 import cn.iocoder.yudao.framework.common.util.collection.CollectionUtils;
 import cn.iocoder.yudao.module.system.api.user.dto.AdminUserRespDTO;
 
@@ -24,6 +25,14 @@ public interface AdminUserApi {
     AdminUserRespDTO getUser(Long id);
 
     /**
+     * 通过手机号查询用户
+     *
+     * @param mobile 手机号
+     * @return 用户对象信息
+     */
+    AdminUserRespDTO getUserByMobile(String mobile);
+
+    /**
      * 通过用户 ID 查询用户下属
      *
      * @param id 用户编号
@@ -70,6 +79,9 @@ public interface AdminUserApi {
      * @return 用户 Map
      */
     default Map<Long, AdminUserRespDTO> getUserMap(Collection<Long> ids) {
+        if (CollUtil.isEmpty(ids)) {
+            return Collections.emptyMap();
+        }
         List<AdminUserRespDTO> users = getUserList(ids);
         return CollectionUtils.convertMap(users, AdminUserRespDTO::getId);
     }
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApiImpl.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApiImpl.java
index 8bf1e19..dc790ed 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApiImpl.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/AdminUserApiImpl.java
@@ -41,6 +41,13 @@ public class AdminUserApiImpl implements AdminUserApi {
     }
 
     @Override
+    @DataPermission(enable = false) // 忽略数据权限，指定手机号的 API 查询用于跨模块数据拼接
+    public AdminUserRespDTO getUserByMobile(String mobile) {
+        AdminUserDO user = userService.getUserByMobile(mobile);
+        return BeanUtils.toBean(user, AdminUserRespDTO.class);
+    }
+
+    @Override
     public List<AdminUserRespDTO> getUserListBySubordinate(Long id) {
         // 1.1 获取用户负责的部门
         List<DeptDO> depts = deptService.getDeptListByLeaderUserId(id);
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/dto/AdminUserRespDTO.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/dto/AdminUserRespDTO.java
index d86f3e5..c0c7803 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/dto/AdminUserRespDTO.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/api/user/dto/AdminUserRespDTO.java
@@ -41,6 +41,14 @@ public class AdminUserRespDTO {
      */
     private String mobile;
     /**
+     * 用户邮箱
+     */
+    private String email;
+    /**
+     * 用户性别
+     */
+    private Integer sex;
+    /**
      * 用户头像
      */
     private String avatar;
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptService.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptService.java
index 06a688e..57cec8d 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptService.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptService.java
@@ -97,6 +97,16 @@ public interface DeptService {
     List<DeptDO> getChildDeptList(Collection<Long> ids);
 
     /**
+     * 获得指定部门的所有父部门
+     *
+     * 按直属父部门到根部门的顺序返回，不包含指定部门自身。
+     *
+     * @param id 部门编号
+     * @return 父部门列表
+     */
+    List<DeptDO> getParentDeptList(Long id);
+
+    /**
      * 获得指定领导者的部门列表
      *
      * @param id 领导者编号
diff --git a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptServiceImpl.java b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptServiceImpl.java
index 6086474..49db60e 100644
--- a/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptServiceImpl.java
+++ b/yudao-module-system/src/main/java/cn/iocoder/yudao/module/system/service/dept/DeptServiceImpl.java
@@ -204,6 +204,29 @@ public class DeptServiceImpl implements DeptService {
     }
 
     @Override
+    public List<DeptDO> getParentDeptList(Long id) {
+        List<DeptDO> parents = new ArrayList<>();
+        Set<Long> visitedDeptIds = new HashSet<>();
+        visitedDeptIds.add(id);
+        DeptDO dept = getDept(id);
+        // TODO DONE @AI：使用 Short.MAX_VALUE 限制父链遍历次数，并通过已访问集合提前结束脏数据环路。
+        for (int i = 0; i < Short.MAX_VALUE; i++) {
+            if (dept == null || dept.getParentId() == null
+                    || ObjectUtil.equal(dept.getParentId(), DeptDO.PARENT_ID_ROOT)
+                    || visitedDeptIds.contains(dept.getParentId())) {
+                break;
+            }
+            visitedDeptIds.add(dept.getParentId());
+            dept = getDept(dept.getParentId());
+            if (dept == null) {
+                break;
+            }
+            parents.add(dept);
+        }
+        return parents;
+    }
+
+    @Override
     public List<DeptDO> getDeptListByLeaderUserId(Long id) {
         return deptMapper.selectListByLeaderUserId(id);
     }
diff --git a/yudao-server/pom.xml b/yudao-server/pom.xml
index 041b20e..ca00806 100644
--- a/yudao-server/pom.xml
+++ b/yudao-server/pom.xml
@@ -45,7 +45,7 @@
 <!--            <artifactId>yudao-module-report</artifactId>-->
 <!--            <version>${revision}</version>-->
 <!--        </dependency>-->
-        <!-- 工作流。默认注释，保证编译速度 -->
+        <!-- 工作流 -->
 <!--        <dependency>-->
 <!--            <groupId>cn.iocoder.boot</groupId>-->
 <!--            <artifactId>yudao-module-bpm</artifactId>-->
@@ -115,20 +115,34 @@
 <!--            <version>${revision}</version>-->
 <!--        </dependency>-->
 
-        <!-- MES 制造执行系统相关模块 -->
+        <!-- MES 制造执行系统相关模块。默认注释，保证编译速度 -->
 <!--        <dependency>-->
 <!--            <groupId>cn.iocoder.boot</groupId>-->
 <!--            <artifactId>yudao-module-mes</artifactId>-->
 <!--            <version>${revision}</version>-->
 <!--        </dependency>-->
 
-        <!-- WMS 仓库管理模块 -->
+        <!-- WMS 仓库管理模块。默认注释，保证编译速度 -->
 <!--        <dependency>-->
 <!--            <groupId>cn.iocoder.boot</groupId>-->
 <!--            <artifactId>yudao-module-wms</artifactId>-->
 <!--            <version>${revision}</version>-->
 <!--        </dependency>-->
 
+        <!-- HRM 人力资源管理模块。默认注释，保证编译速度 -->
+<!--        <dependency>-->
+<!--            <groupId>cn.iocoder.boot</groupId>-->
+<!--            <artifactId>yudao-module-hrm</artifactId>-->
+<!--            <version>${revision}</version>-->
+<!--        </dependency>-->
+
+        <!-- FMS 财务管理模块。默认注释，保证编译速度 -->
+<!--        <dependency>-->
+<!--            <groupId>cn.iocoder.boot</groupId>-->
+<!--            <artifactId>yudao-module-fms</artifactId>-->
+<!--            <version>${revision}</version>-->
+<!--        </dependency>-->
+
         <!-- IM 相关模块。默认注释，保证编译速度 -->
 <!--        <dependency>-->
 <!--            <groupId>cn.iocoder.boot</groupId>-->